From dd91f9bc30ee3d0a605f653066bb4c68fcc861ed Mon Sep 17 00:00:00 2001 From: Boram Park Date: Tue, 28 Sep 2010 20:10:00 +0900 Subject: [PATCH] glib version up to 2.24.2 --- ChangeLog | 693 +- INSTALL | 122 + NEWS | 42 + README | 2 +- README.win32 | 57 +- build/win32/vs9/gio.vcproj | 57 +- build/win32/vs9/gio.vcprojin | 9 - config.h.win32 | 819 +++ configure | 38 +- configure.in | 4 +- debian/changelog | 6 + debian/libglib2.0-0.install | 0 debian/libglib2.0-dev.links | 0 debian/patches/01_gettext-desktopfiles.patch | 145 - .../patches/02_gettext-desktopfiles-ubuntu.patch | 40 - debian/patches/03_blacklist-directories.patch | 24 - debian/patches/04_homedir_env.patch | 59 - .../60_wait-longer-for-threads-to-die.patch | 26 - debian/patches/series | 5 - debian/rules | 10 +- docs/reference/gio/html/GAppInfo.html | 601 +- docs/reference/gio/html/GAsyncInitable.html | 287 +- docs/reference/gio/html/GAsyncResult.html | 203 +- docs/reference/gio/html/GBufferedInputStream.html | 277 +- docs/reference/gio/html/GBufferedOutputStream.html | 134 +- docs/reference/gio/html/GCancellable.html | 292 +- docs/reference/gio/html/GCharsetConverter.html | 122 +- docs/reference/gio/html/GConverter.html | 132 +- docs/reference/gio/html/GDataInputStream.html | 493 +- docs/reference/gio/html/GDataOutputStream.html | 310 +- docs/reference/gio/html/GDrive.html | 628 +- docs/reference/gio/html/GEmblem.html | 99 +- docs/reference/gio/html/GEmblemedIcon.html | 92 +- docs/reference/gio/html/GFile.html | 3829 +++++----- docs/reference/gio/html/GFileDescriptorBased.html | 51 +- docs/reference/gio/html/GFileEnumerator.html | 268 +- docs/reference/gio/html/GFileIOStream.html | 146 +- docs/reference/gio/html/GFileIcon.html | 67 +- docs/reference/gio/html/GFileInfo.html | 1325 ++-- docs/reference/gio/html/GFileInputStream.html | 135 +- docs/reference/gio/html/GFileMonitor.html | 146 +- docs/reference/gio/html/GFileOutputStream.html | 146 +- docs/reference/gio/html/GFilenameCompleter.html | 107 +- docs/reference/gio/html/GFilterInputStream.html | 83 +- docs/reference/gio/html/GFilterOutputStream.html | 83 +- docs/reference/gio/html/GIOModule.html | 108 +- docs/reference/gio/html/GIOStream.html | 193 +- docs/reference/gio/html/GIcon.html | 123 +- docs/reference/gio/html/GInetAddress.html | 306 +- docs/reference/gio/html/GInetSocketAddress.html | 81 +- docs/reference/gio/html/GInitable.html | 199 +- docs/reference/gio/html/GInputStream.html | 414 +- docs/reference/gio/html/GLoadableIcon.html | 148 +- docs/reference/gio/html/GMemoryInputStream.html | 97 +- docs/reference/gio/html/GMemoryOutputStream.html | 193 +- docs/reference/gio/html/GMount.html | 663 +- docs/reference/gio/html/GMountOperation.html | 352 +- docs/reference/gio/html/GNetworkAddress.html | 108 +- docs/reference/gio/html/GNetworkService.html | 102 +- docs/reference/gio/html/GOutputStream.html | 525 +- docs/reference/gio/html/GResolver.html | 406 +- docs/reference/gio/html/GSeekable.html | 164 +- docs/reference/gio/html/GSimpleAsyncResult.html | 553 +- docs/reference/gio/html/GSocket.html | 961 +-- docs/reference/gio/html/GSocketAddress.html | 118 +- docs/reference/gio/html/GSocketClient.html | 435 +- docs/reference/gio/html/GSocketConnectable.html | 303 +- docs/reference/gio/html/GSocketConnection.html | 253 +- docs/reference/gio/html/GSocketControlMessage.html | 115 +- docs/reference/gio/html/GSocketListener.html | 385 +- docs/reference/gio/html/GSocketService.html | 95 +- docs/reference/gio/html/GThemedIcon.html | 203 +- .../reference/gio/html/GThreadedSocketService.html | 72 +- docs/reference/gio/html/GUnixFDList.html | 152 +- docs/reference/gio/html/GUnixFDMessage.html | 108 +- docs/reference/gio/html/GUnixInputStream.html | 110 +- docs/reference/gio/html/GUnixOutputStream.html | 110 +- docs/reference/gio/html/GUnixSocketAddress.html | 124 +- docs/reference/gio/html/GVfs.html | 132 +- docs/reference/gio/html/GVolume.html | 445 +- docs/reference/gio/html/GVolumeMonitor.html | 256 +- docs/reference/gio/html/GZlibCompressor.html | 70 +- docs/reference/gio/html/GZlibDecompressor.html | 51 +- docs/reference/gio/html/api-index-2-18.html | 130 +- docs/reference/gio/html/api-index-2-20.html | 138 +- docs/reference/gio/html/api-index-2-22.html | 1050 ++- docs/reference/gio/html/api-index-2-24.html | 178 +- docs/reference/gio/html/api-index-deprecated.html | 86 +- docs/reference/gio/html/api-index-full.html | 4446 ++++++++--- docs/reference/gio/html/async.html | 34 +- docs/reference/gio/html/ch01.html | 36 +- docs/reference/gio/html/ch02.html | 36 +- docs/reference/gio/html/ch03.html | 36 +- docs/reference/gio/html/ch19.html | 36 +- docs/reference/gio/html/ch20.html | 145 +- docs/reference/gio/html/ch20s02.html | 38 +- docs/reference/gio/html/ch20s03.html | 40 +- docs/reference/gio/html/conversion.html | 34 +- docs/reference/gio/html/extending-gio.html | 34 +- docs/reference/gio/html/extending.html | 34 +- .../gio/html/failable_initialization.html | 34 +- docs/reference/gio/html/file_mon.html | 34 +- docs/reference/gio/html/file_ops.html | 34 +- .../gio/html/gio-Desktop-file-based-GAppInfo.html | 131 +- docs/reference/gio/html/gio-Extension-Points.html | 239 +- docs/reference/gio/html/gio-GContentType.html | 188 +- .../gio/html/gio-GConverterInputstream.html | 66 +- .../gio/html/gio-GConverterOutputstream.html | 66 +- docs/reference/gio/html/gio-GFileAttribute.html | 181 +- docs/reference/gio/html/gio-GIOError.html | 124 +- docs/reference/gio/html/gio-GIOScheduler.html | 168 +- docs/reference/gio/html/gio-GSrvTarget.html | 132 +- docs/reference/gio/html/gio-Unix-Mounts.html | 399 +- docs/reference/gio/html/gio-hierarchy.html | 38 +- docs/reference/gio/html/gio.devhelp | 2 +- docs/reference/gio/html/gio.devhelp2 | 2 +- docs/reference/gio/html/highlevel-socket.html | 34 +- docs/reference/gio/html/icons.html | 34 +- docs/reference/gio/html/index.html | 38 +- docs/reference/gio/html/index.sgml | 1 - docs/reference/gio/html/migrating.html | 36 +- docs/reference/gio/html/networking.html | 34 +- docs/reference/gio/html/pt01.html | 36 +- docs/reference/gio/html/pt02.html | 36 +- docs/reference/gio/html/resolver.html | 34 +- docs/reference/gio/html/streaming.html | 34 +- docs/reference/gio/html/style.css | 26 +- docs/reference/gio/html/types.html | 34 +- docs/reference/gio/html/utils.html | 34 +- docs/reference/gio/html/volume_mon.html | 34 +- docs/reference/gio/tmpl/extensionpoints.sgml | 5 + docs/reference/gio/tmpl/gappinfo.sgml | 7 + docs/reference/gio/tmpl/gasyncinitable.sgml | 5 + docs/reference/gio/tmpl/gasyncresult.sgml | 5 + docs/reference/gio/tmpl/gbufferedinputstream.sgml | 5 + docs/reference/gio/tmpl/gbufferedoutputstream.sgml | 5 + docs/reference/gio/tmpl/gcancellable.sgml | 7 + docs/reference/gio/tmpl/gcharsetconverter.sgml | 5 + docs/reference/gio/tmpl/gcontenttype.sgml | 6 + docs/reference/gio/tmpl/gconverter.sgml | 5 + docs/reference/gio/tmpl/gconverterinputstream.sgml | 5 + .../reference/gio/tmpl/gconverteroutputstream.sgml | 5 + docs/reference/gio/tmpl/gdatainputstream.sgml | 5 + docs/reference/gio/tmpl/gdataoutputstream.sgml | 5 + docs/reference/gio/tmpl/gdesktopappinfo.sgml | 5 + docs/reference/gio/tmpl/gdrive.sgml | 5 + docs/reference/gio/tmpl/gemblem.sgml | 5 + docs/reference/gio/tmpl/gemblemedicon.sgml | 5 + docs/reference/gio/tmpl/gfile.sgml | 5 + docs/reference/gio/tmpl/gfileattribute.sgml | 6 + docs/reference/gio/tmpl/gfiledescriptorbased.sgml | 5 + docs/reference/gio/tmpl/gfileenumerator.sgml | 5 + docs/reference/gio/tmpl/gfileicon.sgml | 5 + docs/reference/gio/tmpl/gfileinfo.sgml | 6 + docs/reference/gio/tmpl/gfileinputstream.sgml | 5 + docs/reference/gio/tmpl/gfileiostream.sgml | 5 + docs/reference/gio/tmpl/gfilemonitor.sgml | 5 + docs/reference/gio/tmpl/gfilenamecompleter.sgml | 6 + docs/reference/gio/tmpl/gfileoutputstream.sgml | 5 + docs/reference/gio/tmpl/gfilterinputstream.sgml | 5 + docs/reference/gio/tmpl/gfilteroutputstream.sgml | 5 + docs/reference/gio/tmpl/gicon.sgml | 5 + docs/reference/gio/tmpl/ginetaddress.sgml | 5 + docs/reference/gio/tmpl/ginetsocketaddress.sgml | 5 + docs/reference/gio/tmpl/ginitable.sgml | 5 + docs/reference/gio/tmpl/ginputstream.sgml | 5 + docs/reference/gio/tmpl/gioerror.sgml | 5 + docs/reference/gio/tmpl/giomodule.sgml | 6 + docs/reference/gio/tmpl/gioscheduler.sgml | 6 + docs/reference/gio/tmpl/giostream.sgml | 5 + docs/reference/gio/tmpl/gloadableicon.sgml | 5 + docs/reference/gio/tmpl/gmemoryinputstream.sgml | 6 + docs/reference/gio/tmpl/gmemoryoutputstream.sgml | 5 + docs/reference/gio/tmpl/gmount.sgml | 5 + docs/reference/gio/tmpl/gmountoperation.sgml | 6 + docs/reference/gio/tmpl/gnetworkaddress.sgml | 5 + docs/reference/gio/tmpl/gnetworkservice.sgml | 5 + docs/reference/gio/tmpl/goutputstream.sgml | 5 + docs/reference/gio/tmpl/gresolver.sgml | 6 + docs/reference/gio/tmpl/gseekable.sgml | 5 + docs/reference/gio/tmpl/gsimpleasyncresult.sgml | 5 + docs/reference/gio/tmpl/gsocket.sgml | 5 + docs/reference/gio/tmpl/gsocketaddress.sgml | 5 + docs/reference/gio/tmpl/gsocketclient.sgml | 6 + docs/reference/gio/tmpl/gsocketconnectable.sgml | 5 + docs/reference/gio/tmpl/gsocketconnection.sgml | 5 + docs/reference/gio/tmpl/gsocketcontrolmessage.sgml | 5 + docs/reference/gio/tmpl/gsocketlistener.sgml | 6 + docs/reference/gio/tmpl/gsocketservice.sgml | 6 + docs/reference/gio/tmpl/gsrvtarget.sgml | 5 + docs/reference/gio/tmpl/gthemedicon.sgml | 5 + .../reference/gio/tmpl/gthreadedsocketservice.sgml | 5 + docs/reference/gio/tmpl/gunixfdlist.sgml | 6 + docs/reference/gio/tmpl/gunixfdmessage.sgml | 6 + docs/reference/gio/tmpl/gunixinputstream.sgml | 5 + docs/reference/gio/tmpl/gunixmounts.sgml | 6 + docs/reference/gio/tmpl/gunixoutputstream.sgml | 5 + docs/reference/gio/tmpl/gunixsocketaddress.sgml | 6 + docs/reference/gio/tmpl/gvfs.sgml | 7 + docs/reference/gio/tmpl/gvolume.sgml | 5 + docs/reference/gio/tmpl/gvolumemonitor.sgml | 6 + docs/reference/gio/tmpl/gzcompressor.sgml | 5 + docs/reference/gio/tmpl/gzdecompressor.sgml | 5 + docs/reference/gio/version.xml | 1 + docs/reference/glib/gtester-report.1 | 6 +- docs/reference/glib/html/api-index-2-10.html | 144 +- docs/reference/glib/html/api-index-2-12.html | 276 +- docs/reference/glib/html/api-index-2-14.html | 524 +- docs/reference/glib/html/api-index-2-16.html | 320 +- docs/reference/glib/html/api-index-2-18.html | 72 +- docs/reference/glib/html/api-index-2-2.html | 88 +- docs/reference/glib/html/api-index-2-20.html | 56 +- docs/reference/glib/html/api-index-2-22.html | 152 +- docs/reference/glib/html/api-index-2-24.html | 396 +- docs/reference/glib/html/api-index-2-4.html | 332 +- docs/reference/glib/html/api-index-2-6.html | 368 +- docs/reference/glib/html/api-index-2-8.html | 116 +- docs/reference/glib/html/api-index-deprecated.html | 292 +- docs/reference/glib/html/api-index-full.html | 7760 +++++++++++++++----- docs/reference/glib/html/glib-Arrays.html | 447 +- .../glib/html/glib-Asynchronous-Queues.html | 337 +- .../glib/html/glib-Atomic-Operations.html | 205 +- .../html/glib-Automatic-String-Completion.html | 192 +- .../glib/html/glib-Balanced-Binary-Trees.html | 344 +- docs/reference/glib/html/glib-Base64-Encoding.html | 171 +- docs/reference/glib/html/glib-Basic-Types.html | 24 +- .../glib/html/glib-Bookmark-file-parser.html | 1006 +-- docs/reference/glib/html/glib-Byte-Arrays.html | 300 +- .../glib/html/glib-Byte-Order-Macros.html | 24 +- docs/reference/glib/html/glib-Caches.html | 195 +- .../glib/html/glib-Character-Set-Conversion.html | 428 +- .../glib/html/glib-Commandline-option-parser.html | 704 +- docs/reference/glib/html/glib-Data-Checksums.html | 177 +- docs/reference/glib/html/glib-Datasets.html | 232 +- .../glib/html/glib-Date-and-Time-Functions.html | 466 +- .../glib/html/glib-Double-ended-Queues.html | 579 +- .../glib/html/glib-Doubly-Linked-Lists.html | 614 +- .../glib/html/glib-Dynamic-Loading-of-Modules.html | 198 +- docs/reference/glib/html/glib-Error-Reporting.html | 685 +- docs/reference/glib/html/glib-File-Utilities.html | 539 +- docs/reference/glib/html/glib-GVariant.html | 1529 ++-- docs/reference/glib/html/glib-GVariantType.html | 473 +- .../html/glib-Glob-style-pattern-matching.html | 133 +- docs/reference/glib/html/glib-Hash-Tables.html | 644 +- docs/reference/glib/html/glib-Hook-Functions.html | 303 +- .../glib/html/glib-Hostname-Utilities.html | 72 +- docs/reference/glib/html/glib-I18N.html | 266 +- docs/reference/glib/html/glib-IO-Channels.html | 873 +-- .../glib/html/glib-Key-value-file-parser.html | 1166 +-- .../reference/glib/html/glib-Keyed-Data-Lists.html | 262 +- docs/reference/glib/html/glib-Lexical-Scanner.html | 248 +- .../glib/html/glib-Limits-of-Basic-Types.html | 24 +- .../glib/html/glib-Memory-Allocation.html | 175 +- .../glib/html/glib-Memory-Allocators.html | 56 +- docs/reference/glib/html/glib-Memory-Chunks.html | 356 +- docs/reference/glib/html/glib-Memory-Slices.html | 181 +- docs/reference/glib/html/glib-Message-Logging.html | 203 +- .../glib/html/glib-Miscellaneous-Macros.html | 184 +- .../html/glib-Miscellaneous-Utility-Functions.html | 470 +- docs/reference/glib/html/glib-N-ary-Trees.html | 596 +- .../glib/html/glib-Numerical-Definitions.html | 47 +- .../glib-Perl-compatible-regular-expressions.html | 1001 +-- docs/reference/glib/html/glib-Pointer-Arrays.html | 346 +- docs/reference/glib/html/glib-Quarks.html | 92 +- docs/reference/glib/html/glib-Random-Numbers.html | 246 +- .../glib/html/glib-Relations-and-Tuples.html | 225 +- docs/reference/glib/html/glib-Sequences.html | 599 +- .../glib/html/glib-Shell-related-Utilities.html | 87 +- .../glib/html/glib-Simple-XML-Subset-Parser.html | 545 +- .../glib/html/glib-Singly-Linked-Lists.html | 526 +- .../glib/html/glib-Spawning-Processes.html | 270 +- docs/reference/glib/html/glib-Standard-Macros.html | 44 +- docs/reference/glib/html/glib-String-Chunks.html | 108 +- .../glib/html/glib-String-Utility-Functions.html | 988 +-- docs/reference/glib/html/glib-Strings.html | 579 +- docs/reference/glib/html/glib-Testing.html | 624 +- .../glib/html/glib-The-Main-Event-Loop.html | 1358 ++-- docs/reference/glib/html/glib-Thread-Pools.html | 226 +- docs/reference/glib/html/glib-Threads.html | 1595 ++-- docs/reference/glib/html/glib-Timers.html | 99 +- docs/reference/glib/html/glib-Trash-Stacks.html | 44 +- .../glib/html/glib-Type-Conversion-Macros.html | 87 +- docs/reference/glib/html/glib-URI-Functions.html | 118 +- .../glib/html/glib-Unicode-Manipulation.html | 883 +-- .../glib/html/glib-Version-Information.html | 53 +- .../glib/html/glib-Warnings-and-Assertions.html | 155 +- .../html/glib-Windows-Compatibility-Functions.html | 116 +- docs/reference/glib/html/glib-building.html | 26 +- docs/reference/glib/html/glib-changes.html | 28 +- docs/reference/glib/html/glib-compiling.html | 26 +- docs/reference/glib/html/glib-core.html | 24 +- docs/reference/glib/html/glib-cross-compiling.html | 24 +- docs/reference/glib/html/glib-data-types.html | 24 +- docs/reference/glib/html/glib-fundamentals.html | 24 +- docs/reference/glib/html/glib-gettextize.html | 30 +- docs/reference/glib/html/glib-regex-syntax.html | 114 +- docs/reference/glib/html/glib-resources.html | 30 +- docs/reference/glib/html/glib-running.html | 34 +- docs/reference/glib/html/glib-utilities.html | 24 +- docs/reference/glib/html/glib.devhelp | 82 +- docs/reference/glib/html/glib.devhelp2 | 82 +- docs/reference/glib/html/glib.html | 24 +- docs/reference/glib/html/gtester-report.html | 30 +- docs/reference/glib/html/gtester.html | 30 +- .../glib/html/gvariant-format-strings.html | 606 +- docs/reference/glib/html/index.html | 26 +- docs/reference/glib/html/index.sgml | 1 - docs/reference/glib/html/style.css | 26 +- docs/reference/glib/html/tools.html | 24 +- docs/reference/glib/tmpl/allocators.sgml | 3 + docs/reference/glib/tmpl/arrays.sgml | 3 + docs/reference/glib/tmpl/arrays_byte.sgml | 4 + docs/reference/glib/tmpl/arrays_pointer.sgml | 4 + docs/reference/glib/tmpl/async_queues.sgml | 4 + docs/reference/glib/tmpl/atomic_operations.sgml | 33 +- docs/reference/glib/tmpl/base64.sgml | 3 + docs/reference/glib/tmpl/bookmarkfile.sgml | 4 + docs/reference/glib/tmpl/byte_order.sgml | 3 + docs/reference/glib/tmpl/caches.sgml | 3 + docs/reference/glib/tmpl/checksum.sgml | 3 + docs/reference/glib/tmpl/completion.sgml | 3 + docs/reference/glib/tmpl/conversions.sgml | 3 + docs/reference/glib/tmpl/datalist.sgml | 3 + docs/reference/glib/tmpl/datasets.sgml | 3 + docs/reference/glib/tmpl/date.sgml | 4 + docs/reference/glib/tmpl/error_reporting.sgml | 3 + docs/reference/glib/tmpl/fileutils.sgml | 3 + docs/reference/glib/tmpl/ghostutils.sgml | 3 + docs/reference/glib/tmpl/gregex.sgml | 3 + docs/reference/glib/tmpl/gurifuncs.sgml | 3 + docs/reference/glib/tmpl/gvariant.sgml | 3 + docs/reference/glib/tmpl/gvarianttype.sgml | 3 + docs/reference/glib/tmpl/hash_tables.sgml | 3 + docs/reference/glib/tmpl/hooks.sgml | 3 + docs/reference/glib/tmpl/i18n.sgml | 4 + docs/reference/glib/tmpl/iochannels.sgml | 3 + docs/reference/glib/tmpl/keyfile.sgml | 4 + docs/reference/glib/tmpl/limits.sgml | 3 + docs/reference/glib/tmpl/linked_lists_double.sgml | 5 + docs/reference/glib/tmpl/linked_lists_single.sgml | 5 + docs/reference/glib/tmpl/macros.sgml | 3 + docs/reference/glib/tmpl/macros_misc.sgml | 3 + docs/reference/glib/tmpl/main.sgml | 10 + docs/reference/glib/tmpl/markup.sgml | 3 + docs/reference/glib/tmpl/memory.sgml | 5 + docs/reference/glib/tmpl/memory_chunks.sgml | 5 + docs/reference/glib/tmpl/memory_slices.sgml | 3 + docs/reference/glib/tmpl/messages.sgml | 3 + docs/reference/glib/tmpl/misc_utils.sgml | 19 + docs/reference/glib/tmpl/modules.sgml | 5 + docs/reference/glib/tmpl/numerical.sgml | 3 + docs/reference/glib/tmpl/option.sgml | 3 + docs/reference/glib/tmpl/patterns.sgml | 3 + docs/reference/glib/tmpl/quarks.sgml | 3 + docs/reference/glib/tmpl/queue.sgml | 4 + docs/reference/glib/tmpl/random_numbers.sgml | 6 + docs/reference/glib/tmpl/relations.sgml | 3 + docs/reference/glib/tmpl/scanner.sgml | 3 + docs/reference/glib/tmpl/sequence.sgml | 3 + docs/reference/glib/tmpl/shell.sgml | 3 + docs/reference/glib/tmpl/spawn.sgml | 3 + docs/reference/glib/tmpl/string_chunks.sgml | 3 + docs/reference/glib/tmpl/string_utils.sgml | 3 + docs/reference/glib/tmpl/strings.sgml | 3 + docs/reference/glib/tmpl/testing.sgml | 22 +- docs/reference/glib/tmpl/thread_pools.sgml | 7 + docs/reference/glib/tmpl/threads.sgml | 5 + docs/reference/glib/tmpl/timers.sgml | 4 + docs/reference/glib/tmpl/trash_stack.sgml | 3 + docs/reference/glib/tmpl/trees-binary.sgml | 3 + docs/reference/glib/tmpl/trees-nary.sgml | 4 + docs/reference/glib/tmpl/type_conversion.sgml | 3 + docs/reference/glib/tmpl/types.sgml | 3 + docs/reference/glib/tmpl/unicode.sgml | 3 + docs/reference/glib/tmpl/version.sgml | 3 + docs/reference/glib/tmpl/warnings.sgml | 3 + docs/reference/glib/tmpl/windows.sgml | 5 + docs/reference/glib/version.xml | 1 + docs/reference/gobject/glib-genmarshal.1 | 6 +- docs/reference/gobject/glib-mkenums.1 | 6 +- docs/reference/gobject/gobject-query.1 | 6 +- docs/reference/gobject/gobject-sections.txt | 1 + docs/reference/gobject/html/GTypeModule.html | 398 +- docs/reference/gobject/html/GTypePlugin.html | 218 +- docs/reference/gobject/html/api-index-2-10.html | 74 +- docs/reference/gobject/html/api-index-2-12.html | 50 +- docs/reference/gobject/html/api-index-2-14.html | 46 +- docs/reference/gobject/html/api-index-2-18.html | 46 +- docs/reference/gobject/html/api-index-2-2.html | 38 +- docs/reference/gobject/html/api-index-2-22.html | 46 +- docs/reference/gobject/html/api-index-2-24.html | 65 +- docs/reference/gobject/html/api-index-2-4.html | 158 +- docs/reference/gobject/html/api-index-2-6.html | 42 +- docs/reference/gobject/html/api-index-2-8.html | 42 +- .../gobject/html/api-index-deprecated.html | 50 +- docs/reference/gobject/html/api-index-full.html | 2542 +++++-- docs/reference/gobject/html/ch01s02.html | 42 +- docs/reference/gobject/html/ch06s03.html | 36 +- docs/reference/gobject/html/chapter-gobject.html | 34 +- docs/reference/gobject/html/chapter-gtype.html | 38 +- docs/reference/gobject/html/chapter-intro.html | 38 +- docs/reference/gobject/html/chapter-signal.html | 50 +- docs/reference/gobject/html/glib-genmarshal.html | 52 +- docs/reference/gobject/html/glib-mkenums.html | 46 +- .../gobject/html/gobject-Boxed-Types.html | 201 +- docs/reference/gobject/html/gobject-Closures.html | 1439 ++-- .../html/gobject-Enumeration-and-Flag-Types.html | 341 +- .../reference/gobject/html/gobject-GParamSpec.html | 566 +- .../gobject/html/gobject-Generic-values.html | 403 +- docs/reference/gobject/html/gobject-Signals.html | 1357 ++-- ...gobject-Standard-Parameter-and-Value-Types.html | 2106 +++--- .../gobject/html/gobject-The-Base-Object-Type.html | 1267 ++-- .../gobject/html/gobject-Type-Information.html | 1871 +++-- .../gobject/html/gobject-Value-arrays.html | 200 +- .../html/gobject-Varargs-Value-Collection.html | 127 +- docs/reference/gobject/html/gobject-memory.html | 34 +- .../reference/gobject/html/gobject-properties.html | 42 +- docs/reference/gobject/html/gobject-query.html | 40 +- docs/reference/gobject/html/gobject.devhelp | 17 +- docs/reference/gobject/html/gobject.devhelp2 | 19 +- docs/reference/gobject/html/gtype-conventions.html | 38 +- .../gobject/html/gtype-instantiable-classed.html | 34 +- .../html/gtype-non-instantiable-classed.html | 34 +- .../gobject/html/gtype-non-instantiable.html | 34 +- .../gobject/html/howto-gobject-chainup.html | 38 +- .../reference/gobject/html/howto-gobject-code.html | 34 +- .../gobject/html/howto-gobject-construction.html | 34 +- .../gobject/html/howto-gobject-destruction.html | 34 +- .../gobject/html/howto-gobject-methods.html | 40 +- docs/reference/gobject/html/howto-gobject.html | 40 +- .../gobject/html/howto-interface-implement.html | 34 +- .../gobject/html/howto-interface-properties.html | 42 +- docs/reference/gobject/html/howto-interface.html | 34 +- docs/reference/gobject/html/howto-signals.html | 38 +- docs/reference/gobject/html/index.html | 48 +- docs/reference/gobject/html/index.sgml | 2 +- docs/reference/gobject/html/pr01.html | 36 +- docs/reference/gobject/html/pt01.html | 42 +- docs/reference/gobject/html/pt02.html | 42 +- docs/reference/gobject/html/pt03.html | 36 +- docs/reference/gobject/html/rn01.html | 36 +- docs/reference/gobject/html/rn02.html | 36 +- docs/reference/gobject/html/signal.html | 42 +- docs/reference/gobject/html/style.css | 26 +- docs/reference/gobject/html/tools-ginspector.html | 34 +- docs/reference/gobject/html/tools-gob.html | 34 +- docs/reference/gobject/html/tools-gtkdoc.html | 34 +- docs/reference/gobject/html/tools-refdb.html | 34 +- docs/reference/gobject/html/tools-vala.html | 34 +- .../reference/gobject/tmpl/enumerations_flags.sgml | 3 + docs/reference/gobject/tmpl/gboxed.sgml | 3 + docs/reference/gobject/tmpl/gclosure.sgml | 4 + docs/reference/gobject/tmpl/generic_values.sgml | 3 + docs/reference/gobject/tmpl/gobject-unused.sgml | 9 - docs/reference/gobject/tmpl/gparamspec.sgml | 3 + docs/reference/gobject/tmpl/gtype.sgml | 5 + docs/reference/gobject/tmpl/gtypemodule.sgml | 3 + docs/reference/gobject/tmpl/gtypeplugin.sgml | 3 + docs/reference/gobject/tmpl/objects.sgml | 3 + docs/reference/gobject/tmpl/param_value_types.sgml | 3 + docs/reference/gobject/tmpl/signals.sgml | 3 + docs/reference/gobject/tmpl/value_arrays.sgml | 3 + docs/reference/gobject/tmpl/value_collection.sgml | 15 + docs/reference/gobject/version.xml | 1 + gio/Makefile.am | 14 +- gio/Makefile.in | 14 +- gio/gasyncinitable.c | 2 +- gio/gcancellable.c | 30 +- gio/gconverteroutputstream.c | 12 +- gio/gio-marshal.c | 284 + gio/gio-marshal.h | 60 + gio/gio.rc | 30 + gio/tests/converter-stream.c | 54 + glib/glib.rc | 30 + glib/gmem.h | 4 +- glib/gstdio.c | 2 +- glib/gstdio.h | 2 +- glib/gstring.c | 2 +- glib/gtester.c | 9 + glib/gutils.c | 7 +- glib/gvariant.c | 31 +- glib/makefile.msc | 151 + glibconfig.h.win32 | 284 + gmodule/gmodule.rc | 30 + gmodule/makefile.msc | 37 + gobject/gobject.rc | 30 + gobject/gtype.c | 48 +- gobject/makefile.msc | 91 + gthread/gthread-impl.c | 2 +- gthread/gthread.rc | 30 + gthread/makefile.msc | 26 + gthread/tests/Makefile.am | 2 +- gthread/tests/Makefile.in | 2 +- po/af.gmo | Bin 4896 -> 4896 bytes po/af.po | 8 +- po/am.gmo | Bin 653 -> 666 bytes po/am.po | 7 +- po/ar.gmo | Bin 40092 -> 40105 bytes po/ar.po | 7 +- po/as.gmo | Bin 62489 -> 62502 bytes po/as.po | 7 +- po/ast.gmo | Bin 44970 -> 44984 bytes po/ast.po | 47 +- po/az.gmo | Bin 10930 -> 10941 bytes po/az.po | 7 +- po/be.gmo | Bin 19914 -> 19927 bytes po/be.po | 11 +- po/be@latin.gmo | Bin 35728 -> 35739 bytes po/be@latin.po | 11 +- po/bg.gmo | Bin 59530 -> 59543 bytes po/bg.po | 15 +- po/bn.gmo | Bin 69231 -> 70653 bytes po/bn.po | 228 +- po/bn_IN.gmo | Bin 67046 -> 67057 bytes po/bn_IN.po | 7 +- po/bs.gmo | Bin 10596 -> 10609 bytes po/bs.po | 15 +- po/ca.gmo | Bin 47620 -> 47635 bytes po/ca.po | 63 +- po/ca@valencia.gmo | Bin 40373 -> 47623 bytes po/ca@valencia.po | 371 +- po/cs.gmo | Bin 43927 -> 43940 bytes po/cs.po | 11 +- po/cy.gmo | Bin 25655 -> 25655 bytes po/cy.po | 12 +- po/da.gmo | Bin 43232 -> 43383 bytes po/da.po | 16 +- po/de.gmo | Bin 46536 -> 46547 bytes po/de.po | 51 +- po/dz.gmo | Bin 32283 -> 32294 bytes po/dz.po | 11 +- po/el.gmo | Bin 60368 -> 60379 bytes po/el.po | 23 +- po/en@shaw.gmo | Bin 63930 -> 63941 bytes po/en@shaw.po | 11 +- po/en_CA.gmo | Bin 32443 -> 32454 bytes po/en_CA.po | 7 +- po/en_GB.gmo | Bin 41565 -> 41565 bytes po/en_GB.po | 12 +- po/eo.gmo | Bin 9875 -> 9888 bytes po/eo.po | 7 +- po/es.gmo | Bin 46164 -> 46225 bytes po/es.po | 37 +- po/et.gmo | Bin 42531 -> 42592 bytes po/et.po | 21 +- po/eu.gmo | Bin 44820 -> 44833 bytes po/eu.po | 7 +- po/fa.gmo | Bin 21650 -> 21661 bytes po/fa.po | 29 +- po/fi.gmo | Bin 44942 -> 44955 bytes po/fi.po | 11 +- po/fr.gmo | Bin 48464 -> 48527 bytes po/fr.po | 77 +- po/ga.gmo | Bin 10691 -> 10704 bytes po/ga.po | 11 +- po/gl.gmo | Bin 46548 -> 46598 bytes po/gl.po | 25 +- po/glib20.pot | 7 +- po/gu.gmo | Bin 62068 -> 62079 bytes po/gu.po | 7 +- po/he.gmo | Bin 40383 -> 40396 bytes po/he.po | 11 +- po/hi.gmo | Bin 63720 -> 63733 bytes po/hi.po | 7 +- po/hr.gmo | Bin 15675 -> 15688 bytes po/hr.po | 15 +- po/hu.gmo | Bin 47068 -> 47079 bytes po/hu.po | 15 +- po/hy.gmo | Bin 2913 -> 2926 bytes po/hy.po | 7 +- po/id.gmo | Bin 15593 -> 43548 bytes po/id.po | 1438 ++-- po/is.gmo | Bin 10034 -> 10045 bytes po/is.po | 7 +- po/it.gmo | Bin 45780 -> 45842 bytes po/it.po | 21 +- po/ja.gmo | Bin 49397 -> 49410 bytes po/ja.po | 11 +- po/ka.gmo | Bin 32223 -> 32236 bytes po/ka.po | 11 +- po/kn.gmo | Bin 70151 -> 71424 bytes po/kn.po | 75 +- po/ko.gmo | Bin 48285 -> 48296 bytes po/ko.po | 7 +- po/ku.gmo | Bin 1107 -> 1120 bytes po/ku.po | 7 +- po/lt.gmo | Bin 44087 -> 44087 bytes po/lt.po | 20 +- po/lv.gmo | Bin 10291 -> 43513 bytes po/lv.po | 988 +-- po/mai.gmo | Bin 41277 -> 41288 bytes po/mai.po | 7 +- po/mg.gmo | Bin 17858 -> 17869 bytes po/mg.po | 11 +- po/mk.gmo | Bin 46623 -> 46636 bytes po/mk.po | 11 +- po/ml.gmo | Bin 75041 -> 75052 bytes po/ml.po | 7 +- po/mn.gmo | Bin 17308 -> 17321 bytes po/mn.po | 28 +- po/mr.gmo | Bin 62685 -> 62698 bytes po/mr.po | 7 +- po/ms.gmo | Bin 10220 -> 10231 bytes po/ms.po | 7 +- po/nb.gmo | Bin 43063 -> 43074 bytes po/nb.po | 28 +- po/nds.gmo | Bin 4710 -> 4721 bytes po/nds.po | 7 +- po/ne.gmo | Bin 23563 -> 23576 bytes po/ne.po | 7 +- po/nl.gmo | Bin 38034 -> 38047 bytes po/nl.po | 15 +- po/nn.gmo | Bin 33763 -> 33776 bytes po/nn.po | 30 +- po/oc.gmo | Bin 1249 -> 1262 bytes po/oc.po | 7 +- po/or.gmo | Bin 65787 -> 65800 bytes po/or.po | 7 +- po/pa.gmo | Bin 61870 -> 61881 bytes po/pa.po | 7 +- po/pl.gmo | Bin 46239 -> 46252 bytes po/pl.po | 11 +- po/ps.gmo | Bin 9790 -> 9803 bytes po/ps.po | 7 +- po/pt.gmo | Bin 44740 -> 44753 bytes po/pt.po | 11 +- po/pt_BR.gmo | Bin 44569 -> 44585 bytes po/pt_BR.po | 7 +- po/ro.gmo | Bin 46329 -> 46451 bytes po/ro.po | 116 +- po/ru.gmo | Bin 60196 -> 60209 bytes po/ru.po | 39 +- po/rw.gmo | Bin 443 -> 456 bytes po/rw.po | 7 +- po/si.gmo | Bin 9251 -> 9264 bytes po/si.po | 7 +- po/sk.gmo | Bin 21222 -> 21235 bytes po/sk.po | 7 +- po/sl.gmo | Bin 43611 -> 43622 bytes po/sl.po | 15 +- po/sq.gmo | Bin 36368 -> 36379 bytes po/sq.po | 11 +- po/sr.gmo | Bin 56690 -> 56703 bytes po/sr.po | 7 +- po/sr@ije.gmo | Bin 13747 -> 13758 bytes po/sr@ije.po | 7 +- po/sr@latin.gmo | Bin 44256 -> 44269 bytes po/sr@latin.po | 7 +- po/sv.gmo | Bin 43437 -> 43450 bytes po/sv.po | 11 +- po/ta.gmo | Bin 66878 -> 66889 bytes po/ta.po | 7 +- po/te.gmo | Bin 66976 -> 66989 bytes po/te.po | 7 +- po/th.gmo | Bin 67609 -> 67865 bytes po/th.po | 20 +- po/tl.gmo | Bin 16011 -> 16024 bytes po/tl.po | 19 +- po/tr.gmo | Bin 41560 -> 41573 bytes po/tr.po | 11 +- po/tt.gmo | Bin 5257 -> 5268 bytes po/tt.po | 7 +- po/uk.gmo | Bin 58382 -> 58393 bytes po/uk.po | 18 +- po/vi.gmo | Bin 48196 -> 48209 bytes po/vi.po | 11 +- po/wa.gmo | Bin 4486 -> 4497 bytes po/wa.po | 11 +- po/xh.gmo | Bin 14200 -> 14213 bytes po/xh.po | 11 +- po/yi.gmo | Bin 13844 -> 13857 bytes po/yi.po | 21 +- po/zh_CN.gmo | Bin 37744 -> 37755 bytes po/zh_CN.po | 7 +- po/zh_HK.gmo | Bin 41655 -> 41708 bytes po/zh_HK.po | 17 +- po/zh_TW.gmo | Bin 41631 -> 41684 bytes po/zh_TW.po | 17 +- tests/makefile.msc | 105 + 679 files changed, 52197 insertions(+), 39334 deletions(-) create mode 100644 INSTALL create mode 100644 config.h.win32 mode change 100755 => 100644 debian/libglib2.0-0.install mode change 100755 => 100644 debian/libglib2.0-dev.links delete mode 100644 debian/patches/01_gettext-desktopfiles.patch delete mode 100644 debian/patches/02_gettext-desktopfiles-ubuntu.patch delete mode 100644 debian/patches/03_blacklist-directories.patch delete mode 100644 debian/patches/04_homedir_env.patch delete mode 100644 debian/patches/60_wait-longer-for-threads-to-die.patch delete mode 100644 debian/patches/series create mode 100644 docs/reference/gio/version.xml create mode 100644 docs/reference/glib/version.xml create mode 100644 docs/reference/gobject/version.xml create mode 100644 gio/gio-marshal.c create mode 100644 gio/gio-marshal.h create mode 100644 gio/gio.rc create mode 100644 glib/glib.rc create mode 100644 glib/makefile.msc create mode 100644 glibconfig.h.win32 create mode 100644 gmodule/gmodule.rc create mode 100644 gmodule/makefile.msc create mode 100644 gobject/gobject.rc create mode 100644 gobject/makefile.msc create mode 100644 gthread/gthread.rc create mode 100644 gthread/makefile.msc create mode 100644 tests/makefile.msc diff --git a/ChangeLog b/ChangeLog index 4ba9c4e..eb4f481 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,690 @@ +commit 2d765e1533321b5421b410217fe2acbe183375eb +Author: Ryan Lortie +Date: Sat Aug 7 19:58:12 2010 -0400 + + Bug 578295 - gtester has a race condition + + Deal with the race in GMainLoop by installing a do-nothing timeout. + + glib/gtester.c | 9 +++++++++ + 1 files changed, 9 insertions(+), 0 deletions(-) + +commit 17bde58552d91d90536458e36445c1eff9d4f0d0 +Author: Andika Triwidada +Date: Fri Aug 6 15:58:03 2010 +0700 + + Updated Indonesian translation + + po/id.po | 2150 + +++++++++++++++++++++++++++++++++++++++++--------------------- + 1 files changed, 1425 insertions(+), 725 deletions(-) + +commit 0ca62609d72dff6b93f57be3a019ecb72f021869 +Author: Lucian Adrian Grijincu +Date: Thu Jul 15 02:07:08 2010 +0300 + + po: Updated Romanian translation + + po/ro.po | 1051 + +++++++++++++++++++++++++++++--------------------------------- + 1 files changed, 486 insertions(+), 565 deletions(-) + +commit 07ae0361da9347e4d2f5f6496b838b3dc4f2992c +Author: Rudolfs Mazurs +Date: Mon Jun 21 00:12:02 2010 +0300 + + Updated Latvian translation. + + po/lv.po | 1931 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 971 insertions(+), 960 deletions(-) + +commit 21ee3b69d3b47124950925beb79f237b8da6761f +Author: Christian Dywan +Date: Fri Jun 11 09:46:47 2010 +0200 + + Add a regression test for GConverterOutputStream corruption + + See bug #619945 for background + (cherry picked from commit 85ea72c0c5716b6ebd62272e17e8e4e3b9014f65) + + gio/tests/converter-stream.c | 54 + ++++++++++++++++++++++++++++++++++++++++++ + 1 files changed, 54 insertions(+), 0 deletions(-) + +commit 1f0694e51b8c8ed894cf2d7b690c666dc03bb145 +Author: Jürg Billeter +Date: Fri May 28 11:00:37 2010 +0200 + + Use correct offset for buffer data in GConverterOutputStream + + Otherwise we overwrite already converted data in the case that more + than one call to g_converter_convert is necessary in write() or + flush(). + + https://bugzilla.gnome.org/show_bug.cgi?id=619945 + (cherry picked from commit 6858ab20330ec31322dacbbdfaf66838fdcbfb78) + + gio/gconverteroutputstream.c | 4 ++-- + 1 files changed, 2 insertions(+), 2 deletions(-) + +commit efff840412e1de09f4dcc4d06aa8577a09dc7669 +Author: Jürg Billeter +Date: Thu May 27 16:55:53 2010 +0200 + + Ensure we always have some target space in GConverterOutputStream + + When the converter fills the whole buffer without reading all input, + we need to enlarge the buffer. Otherwise we get an assertion failure + for `outbuf_size > 0' in g_converter_convert. + + https://bugzilla.gnome.org/show_bug.cgi?id=619945 + (cherry picked from commit 86592d675ff8f1bf0f647fe926ea6085e7b1f2bc) + + gio/gconverteroutputstream.c | 8 ++++++++ + 1 files changed, 8 insertions(+), 0 deletions(-) + +commit f06f37e2b09763593ba840f7f99f427a42feefa4 +Author: Tor Lillqvist +Date: Thu Jun 10 11:52:25 2010 +0300 + + Plug memory leak on Windows + + Intern the string returned from g_win32_getlocale() and then free it. + Fixes bug #621168. + + glib/gutils.c | 7 +++++-- + 1 files changed, 5 insertions(+), 2 deletions(-) + +commit b5d200de7ef973bbbcf35fa55b5756a8480a8330 +Author: Ryan Lortie +Date: Fri May 14 17:06:24 2010 +0200 + + fix glaring inaccuracy in GVariant docs + + glib/gvariant.c | 12 ++++-------- + 1 files changed, 4 insertions(+), 8 deletions(-) + +commit 1fd2aa21e600384f2619e6899a15497c602eb1c9 +Author: Ivar Smolin +Date: Thu May 20 15:00:12 2010 +0300 + + Estonian translation updated + + po/et.po | 489 + ++------------------------------------------------------------ + 1 files changed, 9 insertions(+), 480 deletions(-) + +commit 770efbbd8976c617a735acc1194b2d20a03f0f2c +Merge: b3db4e4 2e43d1e +Author: Fran Diéguez +Date: Thu May 13 01:02:23 2010 +0200 + + Updated Galician translations + +commit b3db4e4551ff445af009a232284b42a470357472 +Author: Fran Diéguez +Date: Thu May 13 00:59:38 2010 +0200 + + Updated Galician translations + + po/gl.po | 949 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 479 insertions(+), 470 deletions(-) + +commit 2e43d1e614c328cf6514282307e06dfb63ca9ed7 +Author: Matthias Clasen +Date: Thu Apr 22 19:31:39 2010 -0400 + + Fix !srcdir build + + Bug 616216 + + gthread/tests/Makefile.am | 2 +- + 1 files changed, 1 insertions(+), 1 deletions(-) + +commit ad9ff29e0c286ec44b470ac6bd9d9a87b29cded3 +Author: Jorge González +Date: Mon May 10 19:55:45 2010 +0200 + + Updated Spanish translation + + po/es.po | 952 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 481 insertions(+), 471 deletions(-) + +commit 001fed0c1489a66cd8903f4c1f1f64ebe8655c6f +Author: Luca Ferretti +Date: Mon May 10 09:49:29 2010 +0200 + + Updated Italian translation + + po/it.po | 951 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 480 insertions(+), 471 deletions(-) + +commit 335ab181596368c82e143820c6c30376f86dd418 +Author: Claude Paroz +Date: Mon May 10 08:43:21 2010 +0200 + + Updated French translation + + po/fr.po | 951 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 480 insertions(+), 471 deletions(-) + +commit 4e44073e4640380a8dd409139f6b4b1c59be9c9d +Author: Tor Lillqvist +Date: Wed May 5 09:43:30 2010 +0300 + + Minor updates to README.win32. + + README.win32 | 57 + ++++++++++++++++++++++++++++++++------------------------- + 1 files changed, 32 insertions(+), 25 deletions(-) + +commit aa6beb3559ce09baecd6c6801a7728a5d4e401c8 +Author: Tor Lillqvist +Date: Mon May 3 20:07:20 2010 +0300 + + Fix list of sources in the gio Visual Studio project + + List the additional sources needed in gio/Makefile.am, not in + gio.vcprojin. Fix broken usage of sort. Filter out Unix-only source + files. + + build/win32/vs9/gio.vcprojin | 9 --------- + gio/Makefile.am | 14 ++++++++++++-- + 2 files changed, 12 insertions(+), 11 deletions(-) + +commit d6434b89f495c1f31e61a025f973f350537e67e3 +Author: Matthias Clasen +Date: Sun May 2 21:50:14 2010 -0400 + + Bump version + + configure.in | 4 ++-- + 1 files changed, 2 insertions(+), 2 deletions(-) + +commit 3c822b423db4ad6e612f68adefd5cb5899793ade +Author: Matthias Clasen +Date: Sun May 2 21:47:49 2010 -0400 + + 2.24.1 + + docs/reference/glib/gtester-report.1 | 6 +- + docs/reference/glib/tmpl/async_queues.sgml | 4 + + docs/reference/glib/tmpl/atomic_operations.sgml | 33 +- + docs/reference/glib/tmpl/bookmarkfile.sgml | 4 + + docs/reference/glib/tmpl/byte_order.sgml | 3 + + docs/reference/glib/tmpl/conversions.sgml | 3 + + docs/reference/glib/tmpl/date.sgml | 4 + + docs/reference/glib/tmpl/error_reporting.sgml | 3 + + docs/reference/glib/tmpl/fileutils.sgml | 3 + + docs/reference/glib/tmpl/gregex.sgml | 3 + + docs/reference/glib/tmpl/hooks.sgml | 3 + + docs/reference/glib/tmpl/i18n.sgml | 4 + + docs/reference/glib/tmpl/keyfile.sgml | 4 + + docs/reference/glib/tmpl/limits.sgml | 3 + + docs/reference/glib/tmpl/macros.sgml | 3 + + docs/reference/glib/tmpl/macros_misc.sgml | 3 + + docs/reference/glib/tmpl/main.sgml | 10 + + docs/reference/glib/tmpl/markup.sgml | 3 + + docs/reference/glib/tmpl/memory.sgml | 5 + + docs/reference/glib/tmpl/memory_slices.sgml | 3 + + docs/reference/glib/tmpl/messages.sgml | 3 + + docs/reference/glib/tmpl/misc_utils.sgml | 19 + + docs/reference/glib/tmpl/modules.sgml | 5 + + docs/reference/glib/tmpl/numerical.sgml | 3 + + docs/reference/glib/tmpl/queue.sgml | 4 + + docs/reference/glib/tmpl/scanner.sgml | 3 + + docs/reference/glib/tmpl/spawn.sgml | 3 + + docs/reference/glib/tmpl/string_utils.sgml | 3 + + docs/reference/glib/tmpl/strings.sgml | 3 + + docs/reference/glib/tmpl/testing.sgml | 22 +- + docs/reference/glib/tmpl/trash_stack.sgml | 3 + + docs/reference/glib/tmpl/type_conversion.sgml | 3 + + docs/reference/glib/tmpl/types.sgml | 3 + + docs/reference/glib/tmpl/unicode.sgml | 3 + + docs/reference/glib/tmpl/version.sgml | 3 + + docs/reference/glib/tmpl/warnings.sgml | 3 + + docs/reference/glib/tmpl/windows.sgml | 5 + + docs/reference/gobject/glib-genmarshal.1 | 6 +- + docs/reference/gobject/glib-mkenums.1 | 6 +- + po/af.po | 2 +- + po/am.po | 2 +- + po/ar.po | 2 +- + po/as.po | 2 +- + po/ast.po | 2 +- + po/az.po | 2 +- + po/be.po | 2 +- + po/be@latin.po | 2 +- + po/bg.po | 2 +- + po/bn.po | 978 + +++++++++++------------ + po/bn_IN.po | 2 +- + po/bs.po | 2 +- + po/ca.po | 952 + +++++++++++----------- + po/ca@valencia.po | 942 + +++++++++++----------- + po/cs.po | 2 +- + po/cy.po | 2 +- + po/da.po | 942 + +++++++++++----------- + po/de.po | 2 +- + po/dz.po | 2 +- + po/el.po | 2 +- + po/en@shaw.po | 2 +- + po/en_CA.po | 2 +- + po/en_GB.po | 2 +- + po/eo.po | 2 +- + po/es.po | 2 +- + po/et.po | 2 +- + po/eu.po | 2 +- + po/fa.po | 2 +- + po/fi.po | 2 +- + po/fr.po | 2 +- + po/ga.po | 2 +- + po/gl.po | 2 +- + po/gu.po | 2 +- + po/he.po | 2 +- + po/hi.po | 2 +- + po/hr.po | 2 +- + po/hu.po | 2 +- + po/hy.po | 2 +- + po/id.po | 2 +- + po/is.po | 2 +- + po/it.po | 2 +- + po/ja.po | 2 +- + po/ka.po | 2 +- + po/kn.po | 963 + +++++++++++----------- + po/ko.po | 2 +- + po/ku.po | 2 +- + po/lt.po | 2 +- + po/lv.po | 2 +- + po/mai.po | 2 +- + po/mg.po | 2 +- + po/mk.po | 2 +- + po/ml.po | 2 +- + po/mn.po | 2 +- + po/mr.po | 2 +- + po/ms.po | 2 +- + po/nb.po | 2 +- + po/nds.po | 2 +- + po/ne.po | 2 +- + po/nl.po | 2 +- + po/nn.po | 2 +- + po/oc.po | 2 +- + po/or.po | 2 +- + po/pa.po | 2 +- + po/pl.po | 2 +- + po/ps.po | 2 +- + po/pt.po | 2 +- + po/pt_BR.po | 2 +- + po/ro.po | 2 +- + po/ru.po | 2 +- + po/rw.po | 2 +- + po/si.po | 2 +- + po/sk.po | 2 +- + po/sl.po | 2 +- + po/sq.po | 2 +- + po/sr.po | 2 +- + po/sr@ije.po | 2 +- + po/sr@latin.po | 2 +- + po/sv.po | 2 +- + po/ta.po | 2 +- + po/te.po | 2 +- + po/th.po | 2 +- + po/tl.po | 2 +- + po/tr.po | 2 +- + po/tt.po | 2 +- + po/uk.po | 2 +- + po/vi.po | 2 +- + po/wa.po | 2 +- + po/xh.po | 2 +- + po/yi.po | 2 +- + po/zh_CN.po | 2 +- + po/zh_HK.po | 957 + +++++++++++----------- + po/zh_TW.po | 942 + +++++++++++----------- + 131 files changed, 3580 insertions(+), 3476 deletions(-) + +commit 87e4516650bb0f01033268e3f7f77ecd5d4cab2a +Author: Matthias Clasen +Date: Sun May 2 20:56:24 2010 -0400 + + Updates + + NEWS | 23 +++++++++++++++++++++++ + 1 files changed, 23 insertions(+), 0 deletions(-) + +commit 503949b12d100ff2d89b8bbb1771729f8a251688 +Author: Behdad Esfahbod +Date: Thu Apr 22 19:48:13 2010 -0400 + + Bug 615379 - g_new macros crash if sizeof(struct_type) == 0 + (cherry picked from commit 00a7c2e635a4fa95257779c271f0eaa5992e2b37) + + glib/gmem.h | 4 ++-- + 1 files changed, 2 insertions(+), 2 deletions(-) + +commit f2b4060717dc4bd63b21a6c1d554fe06ece59de7 +Author: Colin Walters +Date: Wed Apr 21 16:44:26 2010 -0400 + + Fix typo in GMutex error message + (cherry picked from commit 0d9a40b8943ec3b9926efad93a28687708cc2038) + + gthread/gthread-impl.c | 2 +- + 1 files changed, 1 insertions(+), 1 deletions(-) + +commit e7a7d6873cb49f6c8bba5c2a5d078dbe607d62bd +Author: Ryan Lortie +Date: Thu Apr 15 10:11:30 2010 -0400 + + g_string_append_len() accept NULL with length == 0 + (cherry picked from commit 056326c1e96db2c2101fa320062e0c9146f0d73f) + + glib/gstring.c | 2 +- + 1 files changed, 1 insertions(+), 1 deletions(-) + +commit 7fb9b876fa6ec63c05df1c5e441bcc87e48397e2 +Author: Ryan Lortie +Date: Wed Apr 14 23:35:56 2010 -0400 + + GVariant: fix for g_variant_iter_loop() + (cherry picked from commit d17f4bee175cd9149d5f2b1ed1ae6d262d6a1394) + + glib/gvariant.c | 14 +++++++++----- + 1 files changed, 9 insertions(+), 5 deletions(-) + +commit e61a90b9eea2eac924f66c1d137381daff6cedfd +Author: Benjamin Otte +Date: Fri Mar 26 20:37:09 2010 +0100 + + Fix race in g_cancellable_cancel() + + We need to check priv->cancelled after taking the lock. Previously we + only checked it just before taking the lock, which left a small chance + for a race. + (cherry picked from commit e7763678b56e3be073cc55d707a6e92fc2055ee0) + + gio/gcancellable.c | 5 +++++ + 1 files changed, 5 insertions(+), 0 deletions(-) + +commit c25c40fdd9be7612882c4d3162d3bf3917ee2e6d +Author: Benjamin Otte +Date: Fri Mar 26 20:36:10 2010 +0100 + + Remove unneccessary variable from g_cancellable_cancel() + + The variable makes a complicated function even more complicated. + (cherry picked from commit 5527a2ac2ce2b5bea10867fb2e39d2f1914cfbe6) + + gio/gcancellable.c | 25 ++++++++++--------------- + 1 files changed, 10 insertions(+), 15 deletions(-) + +commit b28b1e589e0464bb92aef75e7b03797410a7ec56 +Author: Carles Ferrando +Date: Fri Apr 23 00:42:04 2010 +0200 + + Updated Catalan (Valencian) translation + + po/ca@valencia.po | 1252 + +++++++++++++++++++++++++++-------------------------- + 1 files changed, 636 insertions(+), 616 deletions(-) + +commit d4f50a33d46e61fe065a1cdfc266159d4a612197 +Author: Shankar Prasad +Date: Thu Apr 22 16:21:42 2010 +0530 + + Updated Kannada translations + + po/kn.po | 1025 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 517 insertions(+), 508 deletions(-) + +commit f54c7f9c7736247b113bb643ac7e90150d8dd1b8 +Author: Javier Jardón +Date: Tue Apr 20 01:04:31 2010 +0200 + + [docs] Fix G_VALUE_COLLECT_INIT documentation + + Add the documentation to the corresponding section + + This macro was introduced in + commit 546fc0ca331c8d1b3393fe218a697b6a1a1c1072 + + docs/reference/gobject/gobject-sections.txt | 1 + + 1 files changed, 1 insertions(+), 0 deletions(-) + +commit 324f928af62d8a0aa132a5caaec107d4daa76429 +Author: David Zeuthen +Date: Mon Apr 19 10:42:42 2010 -0400 + + Bug 615111 – GAsyncInitable's default implementation is broken + + Signed-off-by: David Zeuthen + + gio/gasyncinitable.c | 2 +- + 1 files changed, 1 insertions(+), 1 deletions(-) + +commit e51ec13ab4bc629f73b41f2ad3e96b3a787a8760 +Author: Ryan Lortie +Date: Sat Apr 10 22:01:02 2010 -0400 + + Add g_return_if_fail()s to g_variant_new_from_data() + + also, document that @type must be definite + + glib/gvariant.c | 5 ++++- + 1 files changed, 4 insertions(+), 1 deletions(-) + +commit 48cfffc7b185f3e3367bac0beb04e66f536ec25d +Author: Jordi Serratosa +Date: Fri Apr 2 14:03:16 2010 +0200 + + Fixes to Catalan translation + + po/ca.po | 958 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 482 insertions(+), 476 deletions(-) + +commit 634fdaa4ba91ee49fa95f5f62e045f0901ae4e4f +Author: Theppitak Karoonboonyanan +Date: Tue Apr 6 14:41:11 2010 +0700 + + Updated Thai translation. + + po/th.po | 9 ++++----- + 1 files changed, 4 insertions(+), 5 deletions(-) + +commit 70a4217ba35492cd8e3549ca8da3fcc950421790 +Author: Tor Lillqvist +Date: Tue Mar 30 19:39:19 2010 +0300 + + Clarify _g_stat_struct mess + + Use "struct stat" instead of "struct _stat" in the MinGW-or-64-bit + case. Should fix bug #614372. + + glib/gstdio.c | 2 +- + glib/gstdio.h | 2 +- + 2 files changed, 2 insertions(+), 2 deletions(-) + +commit c3f1025c33ab295eedcf41beeea276171ae2dc27 +Author: Javier Jardón +Date: Mon Mar 29 18:20:03 2010 +0200 + + Remove g_type_class_get_private() public documentation + + This is a internal function needed for the documented + G_TYPE_CLASS_GET_PRIVATE() macro + + This was introduced by error in + commit 81e2aa941bbfd02bf1b6235da12834d282ceda0c + + docs/reference/gobject/tmpl/gobject-unused.sgml | 9 --------- + 1 files changed, 0 insertions(+), 9 deletions(-) + +commit 0f51e995658a50dbecb74b006f05a1ea69f43558 +Author: Javier Jardón +Date: Sun Mar 28 17:43:33 2010 +0200 + + Fix g_type_class_add_private() documentation + + This fixes commit 81e2aa941bbfd02bf1b6235da12834d282ceda0c + + Fixes https://bugzilla.gnome.org/show_bug.cgi?id=614185 + + gobject/gtype.c | 48 ++++++++++++++++++++++++++++++++++++++++++++---- + 1 files changed, 44 insertions(+), 4 deletions(-) + +commit 461a4097d1a0a10106254a8fe917fc4e78ccff92 +Author: Ask H. Larsen +Date: Sun Mar 28 00:13:28 2010 +0100 + + Updated Danish translation + + po/da.po | 951 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 479 insertions(+), 472 deletions(-) + +commit 2e27703a815e221052dd4db3e9e848e2401c3b8b +Author: Chao-Hsiung Liao +Date: Sat Mar 27 20:50:57 2010 +0800 + + Updated Traditional Chinese translation(Hong Kong and Taiwan) + + po/zh_HK.po | 966 + +++++++++++++++++++++++++++++----------------------------- + po/zh_TW.po | 951 + +++++++++++++++++++++++++++++----------------------------- + 2 files changed, 962 insertions(+), 955 deletions(-) + +commit 0e3c6ef848259051e4c8c8996a71c0d2d8c9b9f0 +Author: Jamil Ahmed +Date: Sat Mar 27 17:44:03 2010 +0600 + + Updated Bengali translation + + po/bn.po | 1181 + +++++++++++++++++++++++++++++++------------------------------- + 1 files changed, 594 insertions(+), 587 deletions(-) + +commit 22dc3dd6487e2c794376a5c6850c3a3e7c2beea9 +Author: Matthias Clasen +Date: Fri Mar 26 15:09:13 2010 -0400 + + Bump version + + configure.in | 4 ++-- + 1 files changed, 2 insertions(+), 2 deletions(-) + +commit ca631653acc1e1db0c3ebb05759d05f8bdc35ba6 +Author: Matthias Clasen +Date: Fri Mar 26 15:08:00 2010 -0400 + + 2.24.0 + + po/af.po | 24 +- + po/am.po | 24 +- + po/ar.po | 24 +- + po/as.po | 24 +- + po/ast.po | 24 +- + po/az.po | 24 +- + po/be.po | 24 +- + po/be@latin.po | 24 +- + po/bg.po | 24 +- + po/bn.po | 24 +- + po/bn_IN.po | 24 +- + po/bs.po | 24 +- + po/ca.po | 24 +- + po/ca@valencia.po | 24 +- + po/cs.po | 24 +- + po/cy.po | 24 +- + po/da.po | 24 +- + po/de.po | 24 +- + po/dz.po | 24 +- + po/el.po | 24 +- + po/en@shaw.po | 24 +- + po/en_CA.po | 24 +- + po/en_GB.po | 24 +- + po/eo.po | 24 +- + po/es.po | 24 +- + po/et.po | 24 +- + po/eu.po | 82 ++-- + po/fa.po | 24 +- + po/fi.po | 24 +- + po/fr.po | 24 +- + po/ga.po | 24 +- + po/gl.po | 24 +- + po/gu.po | 24 +- + po/he.po | 24 +- + po/hi.po | 24 +- + po/hr.po | 24 +- + po/hu.po | 24 +- + po/hy.po | 24 +- + po/id.po | 24 +- + po/is.po | 24 +- + po/it.po | 24 +- + po/ja.po | 24 +- + po/ka.po | 24 +- + po/kn.po | 24 +- + po/ko.po | 24 +- + po/ku.po | 24 +- + po/lt.po | 24 +- + po/lv.po | 24 +- + po/mai.po | 24 +- + po/mg.po | 24 +- + po/mk.po | 24 +- + po/ml.po | 24 +- + po/mn.po | 24 +- + po/mr.po | 24 +- + po/ms.po | 24 +- + po/nb.po | 24 +- + po/nds.po | 24 +- + po/ne.po | 24 +- + po/nl.po | 24 +- + po/nn.po | 24 +- + po/oc.po | 24 +- + po/or.po | 24 +- + po/pa.po | 24 +- + po/pl.po | 24 +- + po/ps.po | 24 +- + po/pt.po | 24 +- + po/pt_BR.po | 24 +- + po/ro.po | 24 +- + po/ru.po | 24 +- + po/rw.po | 24 +- + po/si.po | 24 +- + po/sk.po | 24 +- + po/sl.po | 24 +- + po/sq.po | 24 +- + po/sr.po | 24 +- + po/sr@ije.po | 24 +- + po/sr@latin.po | 24 +- + po/sv.po | 24 +- + po/ta.po | 24 +- + po/te.po | 24 +- + po/th.po | 24 +- + po/tl.po | 24 +- + po/tr.po | 24 +- + po/tt.po | 24 +- + po/uk.po | 946 +++++++++++++++++++------------------- + po/vi.po | 1311 + +++++++++++++++++++++++++---------------------------- + po/wa.po | 24 +- + po/xh.po | 24 +- + po/yi.po | 24 +- + po/zh_CN.po | 24 +- + po/zh_HK.po | 24 +- + po/zh_TW.po | 24 +- + 92 files changed, 2209 insertions(+), 2266 deletions(-) + commit 5ba8043f1217b338e220f0c6b427e58e28c241e8 Author: Matthias Clasen Date: Fri Mar 26 11:15:49 2010 -0400 @@ -1796,12 +2483,12 @@ Date: Mon Feb 22 00:39:01 2010 -0500 docs/reference/glib/tmpl/macros_misc.sgml | 5 +- docs/reference/glib/tmpl/version.sgml | 68 ++ glib/glib.symbols | 18 + - glib/gvariant.c | 1387 - +++++++++++++++++++++++------ + glib/gvariant.c | 1531 + ++++++++++++++++++++++------- glib/gvariant.h | 36 + glib/gvarianttype.c | 17 + glib/gvarianttype.h | 1 + - 9 files changed, 1295 insertions(+), 326 deletions(-) + 9 files changed, 1367 insertions(+), 398 deletions(-) commit b9d728474ebc51c0d4ff46cb44d97134730174fc Author: Ryan Lortie diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..3426b9a --- /dev/null +++ b/INSTALL @@ -0,0 +1,122 @@ +Simple install procedure +======================== + + % gzip -cd glib-2.24.2.tar.gz | tar xvf - # unpack the sources + % cd glib-2.24.2 # change to the toplevel directory + % ./configure # run the `configure' script + % make # build GLIB + + [ Become root if necessary ] + % rm -rf /install-prefix/include/glib.h /install-prefix/include/gmodule.h + % make install # install GLIB + +Requirements +============ + +GLib-2.0 requires pkg-config, which is tool for tracking the +compilation flags needed for libraries. (For each library, a small .pc +text file is installed in a standard location that contains the +compilation flags needed for that library along with version number +information.) Information about pkg-config can be found at: + + http://www.freedesktop.org/software/pkgconfig/ + +GNU make (http://www.gnu.org/software/make) is also recommended. + +In order to implement conversions between character sets, +GLib requires an implementation of the standard iconv() routine. +Most modern systems will have a suitable implementation, however +many older systems lack an iconv() implementation. On such systems, +you must install the libiconv library. This can be found at: + + http://www.gnu.org/software/libiconv/ + +If your system has an iconv implementation but you want to use +libiconv instead, you can pass the --with-libiconv option to +configure. This forces libiconv to be used. + +Note that if you have libiconv installed in your default include +search path (for instance, in /usr/local/), but don't enable +it, you will get an error while compiling GLib because the +iconv.h that libiconv installs hides the system iconv. + +If you are using the native iconv implementation on Solaris +instead of libiconv, you'll need to make sure that you have +the converters between locale encodings and UTF-8 installed. +At a minimum you'll need the SUNWuiu8 package. You probably +should also install the SUNWciu8, SUNWhiu8, SUNWjiu8, and +SUNWkiu8 packages. + +The native iconv on Compaq Tru64 doesn't contain support for +UTF-8, so you'll need to use GNU libiconv instead. (When +using GNU libiconv for GLib, you'll need to use GNU libiconv +for GNU gettext as well.) This probably applies to related +operating systems as well. + +Finally, for message catalog handling, GLib requires an implementation +of gettext(). If your system doesn't provide this functionality, +you should use the libintl library from the GNU gettext package, +available from: + + http://www.gnu.org/software/gettext/ + + +Support for extended attributes and SELinux in GIO requires +libattr and libselinux. + +Some of the mimetype-related functionality in GIO requires the +update-mime-database and update-desktop-database utilities, which +are part of shared-mime-info and desktop-file-utils, respectively. + + +The Nitty-Gritty +================ + +Complete information about installing GLib can be found +in the file: + + docs/reference/glib/html/glib-building.html + +Or online at: + + http://developer.gnome.org/doc/API/2.0/glib/glib-building.html + + +Installation directories +======================== + +The location of the installed files is determined by the --prefix +and --exec-prefix options given to configure. There are also more +detailed flags to control individual directories. However, the +use of these flags is not tested. + +One particular detail to note, is that the architecture-dependent +include file glibconfig.h is installed in: + + $exec_prefix/lib/glib/include/ + +if you have a version in $prefix/include, this is out of date +and should be deleted. + +.pc files for the various libraries are installed in +$exec_prefix/lib/pkgconfig to provide information when compiling +other packages that depend on GLib. If you set PKG_CONFIG_PATH +so that it points to this directory, then you can get the +correct include flags and library flags for compiling a GLib +application with: + + pkg-config --cflags glib-2.0 + pkg-config --libs glib-2.0 + + +Cross-compiling GLib +==================== + +Information about cross-compilation of GLib can be found +in the file: + + docs/reference/glib/html/glib-cross-compiling.html + +Or online at: + + http://library.gnome.org/devel/glib/stable/glib-cross-compiling.html diff --git a/NEWS b/NEWS index ad9d10a..a23ee89 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,45 @@ +Overview of Changes from GLib 2.24.1 to GLib 2.24.2 +=================================================== + +* Bugs fixed: + 578295 gtester has a race condition + 619945 GConverterOutputStream triggers assertion and corrupts data + 621168 GKeyFile memory leak on Windows platform + 616216 glib compile from remote directory fails + +* Translation updates: + Estonian + French + Galician + Indonesian + Italian + Latvian + Romanian + Spanish + +Overview of Changes from GLib 2.24.0 to GLib 2.24.1 +=================================================== + +* Bugs fixed: + 615379 g_new macros crash if sizeof(struct_type) == 0 + 614185 g_type_class_add_private() documentation is not correct + 614372 g_stat() is funny + 615111 GAsyncInitable's default implementation is broken + Fix race in g_cancellable_cancel() + Fix for g_variant_iter_loop() + Make g_string_append_len() accept NULL lf len == 0 + Fix typo in GMutex error message + +* Translation updates: + Bengali India + Catalan + Catalan (Valencian) + Danish + Kannada + Thai + Traditional Chinese + + Overview of Changes from GLib 2.23.6 to GLib 2.24.0 =================================================== diff --git a/README b/README index 94a3c2a..0275ced 100644 --- a/README +++ b/README @@ -1,7 +1,7 @@ General Information =================== -This is GLib version @GLIB_VERSION@. GLib is the low-level core +This is GLib version 2.24.2. GLib is the low-level core library that forms the basis for projects such as GTK+ and GNOME. It provides data structure handling for C, portability wrappers, and interfaces for such runtime functionality as an event loop, threads, diff --git a/README.win32 b/README.win32 index f5623d2..22300b2 100644 --- a/README.win32 +++ b/README.win32 @@ -1,8 +1,13 @@ Tor Lillqvist Hans Breuer -The general parts, and the section about gcc and autoconfiscated build -are by Tor Lillqvist. The sections about MSVC build is by Hans Breuer. +Note that this document is not really maintained in a serious +fashion. Lots of information here might be misleading or outdated. You +have been warned. + +The general parts, and the section about gcc and autoconfiscated +build, and about a Visual Studio build are by Tor Lillqvist. The +sections about MSVC build with NMAKE is by Hans Breuer. General ======= @@ -15,11 +20,11 @@ only. No POSIX (Unix) emulation layer like Cygwin in involved. To build GLib on Win32, you can use either gcc ("mingw") or the Microsoft compiler and tools. For the latter, MSVC6 and later have -been used successfully. Also the Digital Mars C/C++ compiler have been -used. +been used successfully. Also the Digital Mars C/C++ compiler has +reportedly been used. -People have also successfully cross-compiled GLib for Win32 from Linux -using the cross-mingw packages. +You can also cross-compile GLib for Windows from Linux using the +cross-compiling mingw packages for your distro. Note that to just *use* GLib on Windows, there is no need to build it yourself. @@ -141,25 +146,27 @@ For MSVC7 and later (Visual C++ .NET 2003, Visual C++ 2005, Visual C++ the same C runtime as the code that uses GLib. Such DLLs should be named differently than the ones that use msvcrt.dll. -For GLib, the DLL is called libglib-2.0-0.dll, and the import -libraries libglib-2.0.dll.a and glib-2.0.lib. Note that the "2.0" is -part of the "basename" of the library, it is not something that -libtool has added. The -0 suffix is added by libtool and is the value -of "LT_CURRENT - LT_AGE". The 0 is *not* part of the version number of -GLib, although, for GLib 2.x.0, it happens to be the same. The -LT_CURRENT - LT_AGE value will on purpose be kept as zero as long as -binary compatibility is maintained. For the gory details, see -configure.in and libtool documentation. - -Cross-compiling -=============== - -It is possible to build GLib using a cross compiler. See -docs/reference/glib/html/glib-cross-compiling.html (part of the GLib -reference manual) for more information. - -Building with MSVC -================== +For GLib, the DLL that uses msvcrt.dll is called libglib-2.0-0.dll, +and the import libraries libglib-2.0.dll.a and glib-2.0.lib. Note that +the "2.0" is part of the "basename" of the library, it is not +something that libtool has added. The -0 suffix is added by libtool +and is the value of "LT_CURRENT - LT_AGE". The 0 should *not* be +thought to be part of the version number of GLib. The LT_CURRENT - +LT_AGE value will on purpose be kept as zero as long as binary +compatibility is maintained. For the gory details, see configure.in +and libtool documentation. + +Building with Visual Studio +=========================== + +In an unpacked tarball, you will find in build\win32\vs9 a solution +file that can be used to build the GLib DLLs and some auxiliary +programs. Read the README.txt file in that folder for more +information. Note that you will need a libintl implementation, and +zlib. + +Building with MSVC and NMAKE +============================ If you are building from a GIT snapshot, you will not have all makefile.msc files. You should copy the corresponding makefile.msc.in diff --git a/build/win32/vs9/gio.vcproj b/build/win32/vs9/gio.vcproj index 38ca507..1d5d291 100644 --- a/build/win32/vs9/gio.vcproj +++ b/build/win32/vs9/gio.vcproj @@ -166,8 +166,8 @@ - + @@ -177,17 +177,17 @@ - + + - @@ -195,14 +195,26 @@ + + + - + + + + + + + + + + @@ -212,9 +224,9 @@ - + @@ -225,48 +237,15 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #include "libgio.sourcefiles" - - - - - - - - - and it should be used (not on Ultrix). + */ +/* #undef HAVE_ALLOCA_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_ARPA_NAMESER_COMPAT_H */ + +/* Define to 1 if you have the `atexit' function. */ +#define HAVE_ATEXIT 1 + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_ATTR_XATTR_H */ + +/* Define to 1 if you have the `bind_textdomain_codeset' function. */ +#define HAVE_BIND_TEXTDOMAIN_CODESET 1 + +/* Define if you have a version of the snprintf function with semantics as + specified by the ISO C99 standard. */ +/* #undef HAVE_C99_SNPRINTF */ + +/* Define if you have a version of the vsnprintf function with semantics as + specified by the ISO C99 standard. */ +/* #undef HAVE_C99_VSNPRINTF */ + +/* define to 1 if Carbon is available */ +/* #undef HAVE_CARBON */ + +/* Define to 1 if you have the `chown' function. */ +/* #undef HAVE_CHOWN */ + +/* Define to 1 if you have the `clock_gettime' function. */ +/* #undef HAVE_CLOCK_GETTIME */ + +/* Have nl_langinfo (CODESET) */ +/* #undef HAVE_CODESET */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_CRT_EXTERNS_H */ + +/* Define to 1 if you have the `dcgettext' function. */ +#define HAVE_DCGETTEXT 1 + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +#define HAVE_DIRENT_H 1 +#else +/* #undef HAVE_DIRENT_H */ +#endif + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_DLFCN_H */ + +/* Define to 1 if you don't have `vprintf' but do have `_doprnt.' */ +/* #undef HAVE_DOPRNT */ + +/* define for working do while(0) macros */ +#define HAVE_DOWHILE_MACROS 1 + +/* Define to 1 if you have the `endmntent' function. */ +/* #undef HAVE_ENDMNTENT */ + +/* Define to 1 if you have the `endservent' function. */ +/* #undef HAVE_ENDSERVENT */ + +/* Define if we have FAM */ +/* #undef HAVE_FAM */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_FAM_H */ + +/* Define if we have FAMNoExists in fam */ +/* #undef HAVE_FAM_NO_EXISTS */ + +/* Define to 1 if you have the `fchmod' function. */ +/* #undef HAVE_FCHMOD */ + +/* Define to 1 if you have the `fchown' function. */ +/* #undef HAVE_FCHOWN */ + +/* Define to 1 if you have the `fdwalk' function. */ +/* #undef HAVE_FDWALK */ + +/* Define to 1 if you have the header file. */ +#define HAVE_FLOAT_H 1 + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_FSTAB_H */ + +/* Define to 1 if you have the `fsync' function. */ +/* #undef HAVE_FSYNC */ + +/* we have the futex(2) system call */ +/* #undef HAVE_FUTEX */ + +/* Define to 1 if you have the `getcwd' function. */ +#define HAVE_GETCWD 1 + +/* Define to 1 if you have the `getc_unlocked' function. */ +/* #undef HAVE_GETC_UNLOCKED */ + +/* Define to 1 if you have the `getgrgid' function. */ +/* #undef HAVE_GETGRGID */ + +/* Define to 1 if you have the `getmntent_r' function. */ +/* #undef HAVE_GETMNTENT_R */ + +/* Define to 1 if you have the `getmntinfo' function. */ +/* #undef HAVE_GETMNTINFO */ + +/* Define to 1 if you have the `getprotobyname_r' function. */ +/* #undef HAVE_GETPROTOBYNAME_R */ + +/* Define to 1 if you have the `getpwuid' function. */ +/* #undef HAVE_GETPWUID */ + +/* Define if the GNU gettext() function is already present or preinstalled. */ +#define HAVE_GETTEXT 1 + +/* Define to 1 if you have the `gmtime_r' function. */ +/* #undef HAVE_GMTIME_R */ + +/* define to use system printf */ +/* #undef HAVE_GOOD_PRINTF */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_GRP_H */ + +/* Define to 1 if you have the `hasmntopt' function. */ +/* #undef HAVE_HASMNTOPT */ + +/* Define to 1 if you have the `inotify_init1' function. */ +/* #undef HAVE_INOTIFY_INIT1 */ + +/* define to support printing 64-bit integers with format I64 */ +#define HAVE_INT64_AND_I64 1 + +/* Define if you have the 'intmax_t' type in or . */ +#ifndef _MSC_VER +#define HAVE_INTMAX_T 1 +#else /* _MSC_VER */ +/* #undef HAVE_INTMAX_T */ +#endif /* _MSC_VER */ + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +#define HAVE_INTTYPES_H 1 +#else /* _MSC_VER */ +/* #undef HAVE_INTTYPES_H */ +#endif /* _MSC_VER */ + +/* Define if exists, doesn't clash with , and + declares uintmax_t. */ +#ifndef _MSC_VER +#define HAVE_INTTYPES_H_WITH_UINTMAX 1 +#else /* _MSC_VER */ +/* #undef HAVE_INTTYPES_H_WITH_UINTMAX */ +#endif /* _MSC_VER */ + +/* Define if you have and nl_langinfo(CODESET). */ +/* #undef HAVE_LANGINFO_CODESET */ + +/* Define to 1 if you have the `lchmod' function. */ +/* #undef HAVE_LCHMOD */ + +/* Define to 1 if you have the `lchown' function. */ +/* #undef HAVE_LCHOWN */ + +/* Define if your file defines LC_MESSAGES. */ +/* #undef HAVE_LC_MESSAGES */ + +/* Define to 1 if you have the header file. */ +#define HAVE_LIMITS_H 1 + +/* Define to 1 if you have the `link' function. */ +/* #undef HAVE_LINK */ + +/* Define to 1 if you have the header file. */ +#define HAVE_LOCALE_H 1 + +/* Define to 1 if you have the `localtime_r' function. */ +/* #undef HAVE_LOCALTIME_R */ + +/* Define if you have the 'long double' type. */ +#define HAVE_LONG_DOUBLE 1 + +/* Define if you have the 'long long' type. */ +#ifndef _MSC_VER +#define HAVE_LONG_LONG 1 +#else /* _MSC_VER */ +/* #undef HAVE_LONG_LONG */ +#endif /* _MSC_VER */ + +/* define if system printf can print long long */ +#define HAVE_LONG_LONG_FORMAT 1 + +/* Define to 1 if you have the `lstat' function. */ +/* #undef HAVE_LSTAT */ + +/* Define to 1 if you have the header file. */ +#define HAVE_MALLOC_H 1 + +/* Define to 1 if you have the `memalign' function. */ +/* #undef HAVE_MEMALIGN */ + +/* Define to 1 if you have the `memmove' function. */ +#define HAVE_MEMMOVE 1 + +/* Define to 1 if you have the header file. */ +#define HAVE_MEMORY_H 1 + +/* Define to 1 if you have the `mmap' function. */ +/* #undef HAVE_MMAP */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_MNTENT_H */ + +/* Have a monotonic clock */ +/* #undef HAVE_MONOTONIC_CLOCK */ + +/* Define to 1 if you have the `nanosleep' function. */ +/* #undef HAVE_NANOSLEEP */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_NETDB_H */ + +/* Have non-POSIX function getgrgid_r */ +/* #undef HAVE_NONPOSIX_GETGRGID_R */ + +/* Have non-POSIX function getpwuid_r */ +/* #undef HAVE_NONPOSIX_GETPWUID_R */ + +/* Define to 1 if you have the `nsleep' function. */ +/* #undef HAVE_NSLEEP */ + +/* Define to 1 if you have the `on_exit' function. */ +/* #undef HAVE_ON_EXIT */ + +/* Define to 1 if you have the `pipe2' function. */ +/* #undef HAVE_PIPE2 */ + +/* Define to 1 if you have the `poll' function. */ +/* #undef HAVE_POLL */ + +/* Have POSIX function getgrgid_r */ +/* #undef HAVE_POSIX_GETGRGID_R */ + +/* Have POSIX function getpwuid_r */ +/* #undef HAVE_POSIX_GETPWUID_R */ + +/* Define to 1 if you have the `posix_memalign' function. */ +/* #undef HAVE_POSIX_MEMALIGN */ + +/* Have function pthread_attr_setstacksize */ +/* #undef HAVE_PTHREAD_ATTR_SETSTACKSIZE */ + +/* Define to 1 if the system has the type `ptrdiff_t'. */ +#define HAVE_PTRDIFF_T 1 + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_PWD_H */ + +/* Define to 1 if you have the `readlink' function. */ +/* #undef HAVE_READLINK */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SCHED_H */ + +/* Define to 1 if libselinux is available */ +/* #undef HAVE_SELINUX */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SELINUX_SELINUX_H */ + +/* Define to 1 if you have the `setenv' function. */ +/* #undef HAVE_SETENV */ + +/* Define to 1 if you have the `setlocale' function. */ +#define HAVE_SETLOCALE 1 + +/* Define to 1 if you have the `setmntent' function. */ +/* #undef HAVE_SETMNTENT */ + +/* Define to 1 if you have the `setresuid' function. */ +/* #undef HAVE_SETRESUID */ + +/* Define to 1 if you have the `setreuid' function. */ +/* #undef HAVE_SETREUID */ + +/* Define to 1 if you have the `snprintf' function. */ +#ifndef _MSC_VER +#define HAVE_SNPRINTF 1 +#ifdef __DMC__ +#define snprintf _snprintf +#endif +#else /* _MSC_VER */ +/* #undef HAVE_SNPRINTF */ +#endif /* _MSC_VER */ + +/* Define to 1 if you have the `splice' function. */ +/* #undef HAVE_SPLICE */ + +/* Define to 1 if you have the `statfs' function. */ +/* #undef HAVE_STATFS */ + +/* Define to 1 if you have the `statvfs' function. */ +/* #undef HAVE_STATVFS */ + +/* Define to 1 if you have the header file. */ +#define HAVE_STDDEF_H 1 + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +#define HAVE_STDINT_H 1 +#else /* _MSC_VER */ +/* #undef HAVE_STDINT_H */ +#endif /* _MSC_VER */ + +/* Define if exists, doesn't clash with , and + declares uintmax_t. */ +#ifndef _MSC_VER +#define HAVE_STDINT_H_WITH_UINTMAX 1 +#else /* _MSC_VER */ +/* #undef HAVE_STDINT_H_WITH_UINTMAX */ +#endif /* _MSC_VER */ + +/* Define to 1 if you have the header file. */ +#define HAVE_STDLIB_H 1 + +/* Define to 1 if you have the `stpcpy' function. */ +/* #undef HAVE_STPCPY */ + +/* Define to 1 if you have the `strcasecmp' function. */ +#if !defined(_MSC_VER) && !defined(__DMC__) +#define HAVE_STRCASECMP 1 +#else /* _MSC_VER or __DMC__ */ +/* #undef HAVE_STRCASECMP */ +#endif /* _MSC_VER or __DMC__ */ + +/* Define to 1 if you have the `strerror' function. */ +#define HAVE_STRERROR 1 + +/* Define to 1 if you have the header file. */ +#if !defined(_MSC_VER) && !defined(__DMC__) +#define HAVE_STRINGS_H 1 +#else /* _MSC_VER or __DMC__ */ +/* #undef HAVE_STRINGS_H */ +#endif /* _MSC_VER or __DMC__ */ + +/* Define to 1 if you have the header file. */ +#define HAVE_STRING_H 1 + +/* Have functions strlcpy and strlcat */ +/* #undef HAVE_STRLCPY */ + +/* Define to 1 if you have the `strncasecmp' function. */ +#if !defined(_MSC_VER) && !defined(__DMC__) +#define HAVE_STRNCASECMP 1 +#else /* _MSC_VER or __DMC__ */ +/* #undef HAVE_STRNCASECMP */ +#endif /* _MSC_VER or __DMC__ */ + +/* Define to 1 if you have the `strndup' function. */ +/* #undef HAVE_STRNDUP */ + +/* Define to 1 if you have the `strsignal' function. */ +/* #undef HAVE_STRSIGNAL */ + +/* Define to 1 if `f_bavail' is member of `struct statfs'. */ +/* #undef HAVE_STRUCT_STATFS_F_BAVAIL */ + +/* Define to 1 if `f_fstypename' is member of `struct statfs'. */ +/* #undef HAVE_STRUCT_STATFS_F_FSTYPENAME */ + +/* Define to 1 if `f_basetype' is member of `struct statvfs'. */ +/* #undef HAVE_STRUCT_STATVFS_F_BASETYPE */ + +/* Define to 1 if `st_atimensec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_ATIMENSEC */ + +/* Define to 1 if `st_atim.tv_nsec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_ATIM_TV_NSEC */ + +/* Define to 1 if `st_blksize' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_BLKSIZE */ + +/* Define to 1 if `st_blocks' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_BLOCKS */ + +/* Define to 1 if `st_ctimensec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_CTIMENSEC */ + +/* Define to 1 if `st_ctim.tv_nsec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_CTIM_TV_NSEC */ + +/* Define to 1 if `st_mtimensec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_MTIMENSEC */ + +/* Define to 1 if `st_mtim.tv_nsec' is member of `struct stat'. */ +/* #undef HAVE_STRUCT_STAT_ST_MTIM_TV_NSEC */ + +/* Define to 1 if you have the `symlink' function. */ +/* #undef HAVE_SYMLINK */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_INOTIFY_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_MNTCTL_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_MNTTAB_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_MOUNT_H */ + +/* Define to 1 if you have the header file. */ +#if !defined(_MSC_VER) && !defined(__DMC__) +#define HAVE_SYS_PARAM_H 1 +#else /* _MSC_VER or __DMC__ */ +/* #undef HAVE_SYS_PARAM_H */ +#endif /* _MSC_VER or __DMC__ */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_POLL_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_PRCTL_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_RESOURCE_H */ + +/* found fd_set in sys/select.h */ +/* #undef HAVE_SYS_SELECT_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_STATFS_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_STATVFS_H */ + +/* Define to 1 if you have the header file. */ +#define HAVE_SYS_STAT_H 1 + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_SYSCTL_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_TIMES_H */ + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +#define HAVE_SYS_TIME_H 1 +#else /* _MSC_VER */ +/* #undef HAVE_SYS_TIME_H */ +#endif /* _MSC_VER */ + +/* Define to 1 if you have the header file. */ +#define HAVE_SYS_TYPES_H 1 + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_UIO_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_VFSTAB_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_VFS_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_VMOUNT_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_WAIT_H */ + +/* Define to 1 if you have the header file. */ +/* #undef HAVE_SYS_XATTR_H */ + +/* Define to 1 if you have the `timegm' function. */ +/* #undef HAVE_TIMEGM */ + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +#define HAVE_UNISTD_H 1 +#else /* _MSC_VER */ +/* #undef HAVE_UNISTD_H */ +#endif /* _MSC_VER */ + +/* Define if your printf function family supports positional parameters as + specified by Unix98. */ +/* #undef HAVE_UNIX98_PRINTF */ + +/* Define to 1 if you have the `unsetenv' function. */ +/* #undef HAVE_UNSETENV */ + +/* Define to 1 if you have the `utimes' function. */ +/* #undef HAVE_UTIMES */ + +/* Define to 1 if you have the `valloc' function. */ +/* #undef HAVE_VALLOC */ + +/* Define to 1 if you have the header file. */ +#if !defined(_MSC_VER) && !defined(__DMC__) +#define HAVE_VALUES_H 1 +#else /* _MSC_VER or __DMC__ */ +/* #undef HAVE_VALUES_H */ +#endif /* _MSC_VER or __DMC__ */ + +/* Define to 1 if you have the `vasprintf' function. */ +#define HAVE_VASPRINTF 1 + +/* Define to 1 if you have the `vprintf' function. */ +#define HAVE_VPRINTF 1 + +/* Define to 1 if you have the `vsnprintf' function. */ +#ifndef _MSC_VER +#define HAVE_VSNPRINTF 1 +#ifdef __DMC__ +#define vsnprintf _vsnprintf +#endif +#else /* _MSC_VER */ +/* #undef HAVE_VSNPRINTF */ +#endif /* _MSC_VER */ + +/* Define if you have the 'wchar_t' type. */ +#define HAVE_WCHAR_T 1 + +/* Define to 1 if you have the `wcslen' function. */ +#define HAVE_WCSLEN 1 + +/* Define if you have the 'wint_t' type. */ +#define HAVE_WINT_T 1 + +/* Have a working bcopy */ +/* #undef HAVE_WORKING_BCOPY */ + +/* Define to 1 if you have the header file. */ +#ifndef _MSC_VER +/* #undef HAVE_WSPIAPI_H */ +#else +#define HAVE_WSPIAPI_H 1 +#endif + +/* Define to 1 if xattr is available */ +/* #undef HAVE_XATTR */ + +/* Define to 1 if xattr API uses XATTR_NOFOLLOW */ +/* #undef HAVE_XATTR_NOFOLLOW */ + +/* Define to 1 if you have the `_NSGetEnviron' function. */ +/* #undef HAVE__NSGETENVIRON */ + +/* Define to the sub-directory in which libtool stores uninstalled libraries. + */ +#define LT_OBJDIR ".libs/" + +/* Do we cache iconv descriptors */ +#define NEED_ICONV_CACHE 1 + +/* didn't find fd_set */ +#define NO_FD_SET 1 + +/* Define to 1 if your C compiler doesn't accept -c and -o together. */ +/* #undef NO_MINUS_C_MINUS_O */ + +/* global 'sys_errlist' not found */ +#define NO_SYS_ERRLIST 1 + +/* global 'sys_siglist' not found */ +#define NO_SYS_SIGLIST 1 + +/* global 'sys_siglist' not declared */ +#define NO_SYS_SIGLIST_DECL 1 + +/* Define to the address where bug reports for this package should be sent. */ +#define PACKAGE_BUGREPORT "http://bugzilla.gnome.org/enter_bug.cgi?product=glib" + +/* Define to the full name of this package. */ +#define PACKAGE_NAME "glib" + +/* Define to the full name and version of this package. */ +#define PACKAGE_STRING "glib 2.24.2" + +/* Define to the one symbol short name of this package. */ +#define PACKAGE_TARNAME "glib" + +/* Define to the version of this package. */ +#define PACKAGE_VERSION "2.24.2" + +/* Maximum POSIX RT priority */ +/* #undef POSIX_MAX_PRIORITY */ + +/* define if posix_memalign() can allocate any size */ +/* #undef POSIX_MEMALIGN_WITH_COMPLIANT_ALLOCS */ + +/* Minimum POSIX RT priority */ +/* #undef POSIX_MIN_PRIORITY */ + +/* The POSIX RT yield function */ +/* #undef POSIX_YIELD_FUNC */ + +/* whether realloc (NULL,) works */ +#define REALLOC_0_WORKS 1 + +/* Define if you have correct malloc prototypes */ +#ifndef _MSC_VER +#define SANE_MALLOC_PROTOS 1 +#else /* _MSC_VER */ +/* #undef SANE_MALLOC_PROTOS */ +#endif /* _MSC_VER */ + +/* The size of `char', as computed by sizeof. */ +#define SIZEOF_CHAR 1 + +/* The size of `int', as computed by sizeof. */ +#define SIZEOF_INT 4 + +/* The size of `long', as computed by sizeof. */ +#define SIZEOF_LONG 4 + +/* The size of `long long', as computed by sizeof. */ +#ifndef _MSC_VER +#define SIZEOF_LONG_LONG 8 +#else /* _MSC_VER */ +#define SIZEOF_LONG_LONG 0 +#endif /* _MSC_VER */ + +/* The size of `short', as computed by sizeof. */ +#define SIZEOF_SHORT 2 + +/* The size of `size_t', as computed by sizeof. */ +#define SIZEOF_SIZE_T 4 + +/* The size of `void *', as computed by sizeof. */ +#define SIZEOF_VOID_P 4 + +/* The size of `__int64', as computed by sizeof. */ +#define SIZEOF___INT64 8 + +/* If using the C implementation of alloca, define if you know the + direction of stack growth for your system; otherwise it will be + automatically deduced at runtime. + STACK_DIRECTION > 0 => grows toward higher addresses + STACK_DIRECTION < 0 => grows toward lower addresses + STACK_DIRECTION = 0 => direction of growth unknown */ +/* #undef STACK_DIRECTION */ + +/* Number of arguments to statfs() */ +/* #undef STATFS_ARGS */ + +/* Define to 1 if you have the ANSI C header files. */ +#define STDC_HEADERS 1 + +/* Using GNU libiconv */ +/* #undef USE_LIBICONV_GNU */ + +/* Using a native implementation of iconv in a separate library */ +#define USE_LIBICONV_NATIVE 1 + +/* using the system-supplied PCRE library */ +/* #undef USE_SYSTEM_PCRE */ + +/* Define WORDS_BIGENDIAN to 1 if your processor stores words with the most + significant byte first (like Motorola and SPARC, unlike Intel). */ +/* #undef WORDS_BIGENDIAN */ + +/* Number of bits in a file offset, on hosts where this is settable. */ +/* #undef _FILE_OFFSET_BITS */ + +/* Define for large files, on AIX-style hosts. */ +/* #undef _LARGE_FILES */ + +/* Needed to get declarations for msg_control and msg_controllen on Solaris */ +/* #undef _XOPEN_SOURCE */ + +/* Needed to get declarations for msg_control and msg_controllen on Solaris */ +/* #undef _XOPEN_SOURCE_EXTENDED */ + +/* Needed to get declarations for msg_control and msg_controllen on Solaris */ +/* #undef __EXTENSIONS__ */ + +/* Define to empty if `const' does not conform to ANSI C. */ +/* #undef const */ + +/* Define to long or long long if and don't define. */ +/* #undef intmax_t */ + +/* Define to empty if the C compiler doesn't support this keyword. */ +/* #undef signed */ + +/* Define to `unsigned int' if does not define. */ +/* #undef size_t */ diff --git a/configure b/configure index df09121..c7d1d36 100755 --- a/configure +++ b/configure @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.65 for glib 2.24.0. +# Generated by GNU Autoconf 2.65 for glib 2.24.2. # # Report bugs to . # @@ -702,8 +702,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='glib' PACKAGE_TARNAME='glib' -PACKAGE_VERSION='2.24.0' -PACKAGE_STRING='glib 2.24.0' +PACKAGE_VERSION='2.24.2' +PACKAGE_STRING='glib 2.24.2' PACKAGE_BUGREPORT='http://bugzilla.gnome.org/enter_bug.cgi?product=glib' PACKAGE_URL='' @@ -1609,7 +1609,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures glib 2.24.0 to adapt to many kinds of systems. +\`configure' configures glib 2.24.2 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1679,7 +1679,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of glib 2.24.0:";; + short | recursive ) echo "Configuration of glib 2.24.2:";; esac cat <<\_ACEOF @@ -1824,7 +1824,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -glib configure 2.24.0 +glib configure 2.24.2 generated by GNU Autoconf 2.65 Copyright (C) 2009 Free Software Foundation, Inc. @@ -2605,7 +2605,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by glib $as_me 2.24.0, which was +It was created by glib $as_me 2.24.2, which was generated by GNU Autoconf 2.65. Invocation command line was $ $0 $@ @@ -3419,7 +3419,7 @@ fi # Define the identity of the package. PACKAGE='glib' - VERSION='2.24.0' + VERSION='2.24.2' # Some tools Automake needs. @@ -3473,10 +3473,10 @@ AM_BACKSLASH='\' GLIB_MAJOR_VERSION=2 GLIB_MINOR_VERSION=24 -GLIB_MICRO_VERSION=0 -GLIB_INTERFACE_AGE=0 -GLIB_BINARY_AGE=2400 -GLIB_VERSION=2.24.0 +GLIB_MICRO_VERSION=2 +GLIB_INTERFACE_AGE=2 +GLIB_BINARY_AGE=2402 +GLIB_VERSION=2.24.2 @@ -3492,19 +3492,19 @@ $as_echo "#define GLIB_MAJOR_VERSION 2" >>confdefs.h $as_echo "#define GLIB_MINOR_VERSION 24" >>confdefs.h -$as_echo "#define GLIB_MICRO_VERSION 0" >>confdefs.h +$as_echo "#define GLIB_MICRO_VERSION 2" >>confdefs.h -$as_echo "#define GLIB_INTERFACE_AGE 0" >>confdefs.h +$as_echo "#define GLIB_INTERFACE_AGE 2" >>confdefs.h -$as_echo "#define GLIB_BINARY_AGE 2400" >>confdefs.h +$as_echo "#define GLIB_BINARY_AGE 2402" >>confdefs.h # libtool versioning LT_RELEASE=2.24 LT_CURRENT=2400 -LT_REVISION=0 +LT_REVISION=2 LT_AGE=2400 LT_CURRENT_MINUS_AGE=0 @@ -19711,7 +19711,7 @@ Usage: $0 [OPTIONS] Report bugs to ." lt_cl_version="\ -glib config.lt 2.24.0 +glib config.lt 2.24.2 configured by $0, generated by GNU Autoconf 2.65. Copyright (C) 2008 Free Software Foundation, Inc. @@ -28538,7 +28538,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by glib $as_me 2.24.0, which was +This file was extended by glib $as_me 2.24.2, which was generated by GNU Autoconf 2.65. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -28604,7 +28604,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -glib config.status 2.24.0 +glib config.status 2.24.2 configured by $0, generated by GNU Autoconf 2.65, with options \\"\$ac_cs_config\\" diff --git a/configure.in b/configure.in index 3e2f677..a8d3068 100644 --- a/configure.in +++ b/configure.in @@ -23,8 +23,8 @@ m4_define(glib_configure_in) # m4_define([glib_major_version], [2]) m4_define([glib_minor_version], [24]) -m4_define([glib_micro_version], [0]) -m4_define([glib_interface_age], [0]) +m4_define([glib_micro_version], [2]) +m4_define([glib_interface_age], [2]) m4_define([glib_binary_age], [m4_eval(100 * glib_minor_version + glib_micro_version)]) m4_define([glib_version], diff --git a/debian/changelog b/debian/changelog index 0b21d7d..b62a717 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,9 @@ +glib2.0 (2.24.2-1slp2) unstable; urgency=low + + * Update glib2.0 to 2.24.2 + + -- Boram Park Mon, 13 Sep 2010 11:04:39 +0900 + glib2.0 (2.24.0-3slp2) unstable; urgency=low * Remove udeb from debian/control file diff --git a/debian/libglib2.0-0.install b/debian/libglib2.0-0.install old mode 100755 new mode 100644 diff --git a/debian/libglib2.0-dev.links b/debian/libglib2.0-dev.links old mode 100755 new mode 100644 diff --git a/debian/patches/01_gettext-desktopfiles.patch b/debian/patches/01_gettext-desktopfiles.patch deleted file mode 100644 index 76b4ee4..0000000 --- a/debian/patches/01_gettext-desktopfiles.patch +++ /dev/null @@ -1,145 +0,0 @@ -# Description: If a .desktop file does not have inline translations, fall back to calling gettext. -# Ubuntu: https://launchpad.net/bugs/3935 -# Upstream: http://bugzilla.gnome.org/show_bug.cgi?id=569829 -Index: glib2.0-2.19.5/glib/gkeyfile.c -=================================================================== ---- glib2.0-2.19.5.orig/glib/gkeyfile.c 2009-01-30 15:34:03.000000000 +0100 -+++ glib2.0-2.19.5/glib/gkeyfile.c 2009-01-30 15:34:32.000000000 +0100 -@@ -83,6 +83,7 @@ - GKeyFileFlags flags; - - gchar **locales; -+ gchar *gettext_domain; - }; - - typedef struct _GKeyFileKeyValuePair GKeyFileKeyValuePair; -@@ -209,6 +210,7 @@ - key_file->list_separator = ';'; - key_file->flags = 0; - key_file->locales = g_strdupv ((gchar **)g_get_language_names ()); -+ key_file->gettext_domain = NULL; - } - - static void -@@ -228,6 +230,12 @@ - key_file->parse_buffer = NULL; - } - -+ if (key_file->gettext_domain) -+ { -+ g_free (key_file->gettext_domain); -+ key_file->gettext_domain = NULL; -+ } -+ - tmp = key_file->groups; - while (tmp != NULL) - { -@@ -448,6 +456,11 @@ - return FALSE; - } - -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ G_KEY_FILE_DESKTOP_KEY_GETTEXT_DOMAIN, -+ NULL); -+ - return TRUE; - } - -@@ -554,6 +567,11 @@ - return FALSE; - } - -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ G_KEY_FILE_DESKTOP_KEY_GETTEXT_DOMAIN, -+ NULL); -+ - return TRUE; - } - -@@ -1662,6 +1680,8 @@ - GError *key_file_error; - gchar **languages; - gboolean free_languages = FALSE; -+ gboolean try_gettext = FALSE; -+ const gchar *msg_locale; - gint i; - - g_return_val_if_fail (key_file != NULL, NULL); -@@ -1692,6 +1712,23 @@ - free_languages = FALSE; - } - -+ /* we're only interested in gettext translation if we don't have a -+ * translation in the .desktop file itself and if the key is one of the keys -+ * we know we want to translate: Name, GenericName, Comment. Blindly doing -+ * this for all keys can give strange result for the icons, since the Icon is -+ * a locale string in the spec, eg. We also only get translation in the mo -+ * file if the requested locale is the LC_MESSAGES one. Ideally, we should do -+ * more and change LC_MESSAGES to use the requested locale, but there's no -+ * guarantee it's installed on the system and it might have some -+ * side-effects. Since this is a corner case, let's ignore it. */ -+ -+ msg_locale = setlocale (LC_MESSAGES, NULL); -+ try_gettext = msg_locale && key_file->gettext_domain && -+ strcmp (group_name, G_KEY_FILE_DESKTOP_GROUP) == 0 && -+ (strcmp (key, G_KEY_FILE_DESKTOP_KEY_NAME) == 0 || -+ strcmp (key, G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME) == 0 || -+ strcmp (key, G_KEY_FILE_DESKTOP_KEY_COMMENT) == 0); -+ - for (i = 0; languages[i]; i++) - { - candidate_key = g_strdup_printf ("%s[%s]", key, languages[i]); -@@ -1708,6 +1745,39 @@ - translated_value = NULL; - } - -+ /* Fallback to gettext */ -+ if (try_gettext && !translated_value) -+ { -+ gchar *orig_value = g_key_file_get_string (key_file, group_name, key, NULL); -+ -+ if (orig_value) -+ { -+ gboolean codeset_set; -+ const gchar *translated; -+ gboolean has_gettext; -+ -+ codeset_set = bind_textdomain_codeset (key_file->gettext_domain, "UTF-8") != NULL; -+ translated = NULL; -+ -+ translated = g_dgettext (key_file->gettext_domain, -+ orig_value); -+ has_gettext = translated != orig_value; -+ -+ g_free (orig_value); -+ -+ if (has_gettext) -+ { -+ if (codeset_set) -+ translated_value = g_strdup (translated); -+ else -+ translated_value = g_locale_to_utf8 (translated, -+ -1, NULL, NULL, NULL); -+ } -+ else -+ translated_value = NULL; -+ } -+ } -+ - /* Fallback to untranslated key - */ - if (!translated_value) -Index: glib2.0-2.19.5/glib/gkeyfile.h -=================================================================== ---- glib2.0-2.19.5.orig/glib/gkeyfile.h 2009-01-30 15:34:03.000000000 +0100 -+++ glib2.0-2.19.5/glib/gkeyfile.h 2009-01-30 15:34:32.000000000 +0100 -@@ -240,6 +240,7 @@ - #define G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY "StartupNotify" - #define G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS "StartupWMClass" - #define G_KEY_FILE_DESKTOP_KEY_URL "URL" -+#define G_KEY_FILE_DESKTOP_KEY_GETTEXT_DOMAIN "X-GNOME-Gettext-Domain" - - #define G_KEY_FILE_DESKTOP_TYPE_APPLICATION "Application" - #define G_KEY_FILE_DESKTOP_TYPE_LINK "Link" diff --git a/debian/patches/02_gettext-desktopfiles-ubuntu.patch b/debian/patches/02_gettext-desktopfiles-ubuntu.patch deleted file mode 100644 index b493861..0000000 --- a/debian/patches/02_gettext-desktopfiles-ubuntu.patch +++ /dev/null @@ -1,40 +0,0 @@ -# Description: Provide backwards compatibility for 01_gettext-desktopfiles.patch for X-{Debian,Ubuntu}-Gettext-Domain -# UbuntuSpecific: 01_gettext-desktopfiles.patch was changed to use X-GNOME-, so this is necessary until all our .desktop files are converted -Index: glib2.0-2.19.5/glib/gkeyfile.c -=================================================================== ---- glib2.0-2.19.5.orig/glib/gkeyfile.c 2009-01-30 15:53:09.000000000 +0100 -+++ glib2.0-2.19.5/glib/gkeyfile.c 2009-01-30 15:55:46.000000000 +0100 -@@ -460,6 +460,16 @@ - G_KEY_FILE_DESKTOP_GROUP, - G_KEY_FILE_DESKTOP_KEY_GETTEXT_DOMAIN, - NULL); -+ if (!key_file->gettext_domain) -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ "X-Ubuntu-Gettext-Domain", -+ NULL); -+ if (!key_file->gettext_domain) -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ "X-Debian-Gettext-Domain", -+ NULL); - - return TRUE; - } -@@ -571,6 +581,16 @@ - G_KEY_FILE_DESKTOP_GROUP, - G_KEY_FILE_DESKTOP_KEY_GETTEXT_DOMAIN, - NULL); -+ if (!key_file->gettext_domain) -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ "X-Ubuntu-Gettext-Domain", -+ NULL); -+ if (!key_file->gettext_domain) -+ key_file->gettext_domain = g_key_file_get_string (key_file, -+ G_KEY_FILE_DESKTOP_GROUP, -+ "X-Debian-Gettext-Domain", -+ NULL); - - return TRUE; - } diff --git a/debian/patches/03_blacklist-directories.patch b/debian/patches/03_blacklist-directories.patch deleted file mode 100644 index fb386a7..0000000 --- a/debian/patches/03_blacklist-directories.patch +++ /dev/null @@ -1,24 +0,0 @@ ---- glib2.0-2.18.0.orig/gio/gunixmounts.c 2008-09-02 17:09:19.000000000 +0200 -+++ glib2.0-2.18.0/gio/gunixmounts.c 2008-09-03 00:53:29.000000000 +0200 -@@ -221,6 +221,8 @@ - "/home", - "/lib", - "/lib64", -+ "/live/cow", -+ "/live/image", - "/media", - "/mnt", - "/opt", -@@ -231,7 +233,12 @@ - "/usr", - "/usr/local", - "/var", -+ "/var/crash", -+ "/var/local", -+ "/var/log", - "/var/log/audit", /* https://bugzilla.redhat.com/show_bug.cgi?id=333041 */ -+ "/var/mail", -+ "/var/run", - "/var/tmp", /* https://bugzilla.redhat.com/show_bug.cgi?id=335241 */ - "/proc", - "/sbin", diff --git a/debian/patches/04_homedir_env.patch b/debian/patches/04_homedir_env.patch deleted file mode 100644 index 84768a9..0000000 --- a/debian/patches/04_homedir_env.patch +++ /dev/null @@ -1,59 +0,0 @@ -Index: glib-2.18.3/docs/reference/glib/running.sgml -=================================================================== ---- glib-2.18.3.orig/docs/reference/glib/running.sgml 2008-11-26 12:01:53.559365436 +0100 -+++ glib-2.18.3/docs/reference/glib/running.sgml 2008-11-26 12:25:58.155366255 +0100 -@@ -194,6 +194,22 @@ variables like LANG, - - -+ -+ <envar>G_HOME</envar> -+ -+ -+ For various reasons, GLib applications ignore the HOME -+ environment variable on Unix systems and will use the user directory -+ as specified by the passwd entry, which is more -+ reliable. -+ -+ -+ The G_HOME environment variable will override any -+ other setting for the home directory. It is not meant for daily usage, -+ but it is useful in testing or building environments. -+ -+ -+ - - - -Index: glib-2.18.3/glib/gutils.c -=================================================================== ---- glib-2.18.3.orig/glib/gutils.c 2008-11-26 11:50:38.607861683 +0100 -+++ glib-2.18.3/glib/gutils.c 2008-11-26 12:00:29.035360081 +0100 -@@ -1520,11 +1520,14 @@ g_get_any_init_do (void) - } - #endif /* !G_OS_WIN32 */ - -+ g_home_dir = g_strdup (g_getenv ("G_HOME")); -+ - #ifdef G_OS_WIN32 - /* We check $HOME first for Win32, though it is a last resort for Unix - * where we prefer the results of getpwuid(). - */ -- g_home_dir = g_strdup (g_getenv ("HOME")); -+ if (!g_home_dir) -+ g_home_dir = g_strdup (g_getenv ("HOME")); - - /* Only believe HOME if it is an absolute path and exists */ - if (g_home_dir) -@@ -1820,6 +1823,11 @@ g_get_real_name (void) - * homedir = g_get_home_dir (); - * ]| - * -+ * However, to allow changing this value for testing and development -+ * purposes, the value of the G_HOME environment -+ * variable, if set, will override the passwd -+ * entry. -+ * - * Returns: the current user's home directory - */ - G_CONST_RETURN gchar* diff --git a/debian/patches/60_wait-longer-for-threads-to-die.patch b/debian/patches/60_wait-longer-for-threads-to-die.patch deleted file mode 100644 index 02fe9ff..0000000 --- a/debian/patches/60_wait-longer-for-threads-to-die.patch +++ /dev/null @@ -1,26 +0,0 @@ ---- glib/tests/threadpool-test.c.old 2008-02-12 06:11:21.000000000 +0100 -+++ glib/tests/threadpool-test.c 2008-02-12 06:11:52.000000000 +0100 -@@ -5,8 +5,8 @@ - - #include - --#define DEBUG_MSG(x) --/* #define DEBUG_MSG(args) g_printerr args ; g_printerr ("\n"); */ -+/* #define DEBUG_MSG(x) */ -+#define DEBUG_MSG(args) g_printerr args ; g_printerr ("\n"); - - #define WAIT 5 /* seconds */ - #define MAX_THREADS 10 -@@ -124,10 +124,10 @@ - DEBUG_MSG (("[unused] stopping unused threads")); - g_thread_pool_stop_unused_threads (); - -- DEBUG_MSG (("[unused] waiting ONE second for threads to die")); -+ DEBUG_MSG (("[unused] waiting FIVE second for threads to die")); - - /* Some time for threads to die. */ -- g_usleep (G_USEC_PER_SEC); -+ g_usleep (5 * G_USEC_PER_SEC); - - DEBUG_MSG (("[unused] stopped idle threads, %d remain, %d threads still exist", - g_thread_pool_get_num_unused_threads (), diff --git a/debian/patches/series b/debian/patches/series deleted file mode 100644 index d144e2e..0000000 --- a/debian/patches/series +++ /dev/null @@ -1,5 +0,0 @@ -01_gettext-desktopfiles.patch -02_gettext-desktopfiles-ubuntu.patch -03_blacklist-directories.patch -04_homedir_env.patch -60_wait-longer-for-threads-to-die.patch diff --git a/debian/rules b/debian/rules index 0523017..c9e0d86 100755 --- a/debian/rules +++ b/debian/rules @@ -8,8 +8,6 @@ GNOME_MODULE := glib STAMP_DIR := debian/stampdir -PATCH_DIR := debian/patches - # rules in this debian/rules Makefile can be built concurrently as well as # upstream rules in Makefile; all $(MAKE) invocations will inherit this flag, # if you recurse into debian/rules ($(MAKE) @@ -44,7 +42,7 @@ LDFLAGS += -Wl,-O1 APIVER := 2.0 SONAME := 0 -SHVER := 2.24.0 +SHVER := 2.24.2 # package names SHARED_PKG := libglib$(APIVER)-$(SONAME) @@ -107,9 +105,6 @@ $(STAMP_DIR)/patch-stamp: # backup the original files to restore them in the clean target -test -r config.sub && cp config.sub config.sub.orig -test -r config.guess && cp config.guess config.guess.orig - # apply patches - QUILT_PATCHES=$(PATCH_DIR) \ - quilt --quiltrc /dev/null push -a || test $$? = 2 -test -r /usr/share/misc/config.sub && \ cp -f /usr/share/misc/config.sub config.sub -test -r /usr/share/misc/config.guess && \ @@ -188,9 +183,6 @@ clean: debian/control # restore files from backup (before unpatching) -test -r config.sub.orig && mv -f config.sub.orig config.sub -test -r config.guess.orig && mv -f config.guess.orig config.guess - # unapply patches, if any - QUILT_PATCHES=$(PATCH_DIR) \ - quilt --quiltrc /dev/null pop -a -R || test $$? = 2 -rm -rf .pc -rm -rf $(STAMP_DIR) dh_clean diff --git a/docs/reference/gio/html/GAppInfo.html b/docs/reference/gio/html/GAppInfo.html index 4254ce7..7e5c96c 100644 --- a/docs/reference/gio/html/GAppInfo.html +++ b/docs/reference/gio/html/GAppInfo.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -80,67 +50,67 @@ enum GAppInfo; GAppInfoIface; GAppLaunchContext; -GAppInfo * g_app_info_create_from_commandline (const char *commandline, - const char *application_name, - GAppInfoCreateFlags flags, - GError **error); -GAppInfo * g_app_info_dup (GAppInfo *appinfo); -gbooleang_app_info_equal (GAppInfo *appinfo1, - GAppInfo *appinfo2); -const char * g_app_info_get_id (GAppInfo *appinfo); -const char * g_app_info_get_name (GAppInfo *appinfo); -const char * g_app_info_get_display_name (GAppInfo *appinfo); -const char * g_app_info_get_description (GAppInfo *appinfo); -const char * g_app_info_get_executable (GAppInfo *appinfo); -const char * g_app_info_get_commandline (GAppInfo *appinfo); -GIcon * g_app_info_get_icon (GAppInfo *appinfo); -gbooleang_app_info_launch (GAppInfo *appinfo, - GList *files, - GAppLaunchContext *launch_context, - GError **error); -gbooleang_app_info_supports_files (GAppInfo *appinfo); -gbooleang_app_info_supports_uris (GAppInfo *appinfo); -gbooleang_app_info_launch_uris (GAppInfo *appinfo, - GList *uris, - GAppLaunchContext *launch_context, - GError **error); -gbooleang_app_info_should_show (GAppInfo *appinfo); -gbooleang_app_info_can_delete (GAppInfo *appinfo); -gbooleang_app_info_delete (GAppInfo *appinfo); -voidg_app_info_reset_type_associations (const char *content_type); -gbooleang_app_info_set_as_default_for_type (GAppInfo *appinfo, - const char *content_type, - GError **error); -gbooleang_app_info_set_as_default_for_extension - (GAppInfo *appinfo, - const char *extension, - GError **error); -gbooleang_app_info_add_supports_type (GAppInfo *appinfo, - const char *content_type, - GError **error); -gbooleang_app_info_can_remove_supports_type (GAppInfo *appinfo); -gbooleang_app_info_remove_supports_type (GAppInfo *appinfo, - const char *content_type, - GError **error); -GList * g_app_info_get_all (void); -GList * g_app_info_get_all_for_type (const char *content_type); -GAppInfo * g_app_info_get_default_for_type (const char *content_type, - gboolean must_support_uris); +GAppInfo * g_app_info_create_from_commandline (const char *commandline, + const char *application_name, + GAppInfoCreateFlags flags, + GError **error); +GAppInfo * g_app_info_dup (GAppInfo *appinfo); +gbooleang_app_info_equal (GAppInfo *appinfo1, + GAppInfo *appinfo2); +const char * g_app_info_get_id (GAppInfo *appinfo); +const char * g_app_info_get_name (GAppInfo *appinfo); +const char * g_app_info_get_display_name (GAppInfo *appinfo); +const char * g_app_info_get_description (GAppInfo *appinfo); +const char * g_app_info_get_executable (GAppInfo *appinfo); +const char * g_app_info_get_commandline (GAppInfo *appinfo); +GIcon * g_app_info_get_icon (GAppInfo *appinfo); +gbooleang_app_info_launch (GAppInfo *appinfo, + GList *files, + GAppLaunchContext *launch_context, + GError **error); +gbooleang_app_info_supports_files (GAppInfo *appinfo); +gbooleang_app_info_supports_uris (GAppInfo *appinfo); +gbooleang_app_info_launch_uris (GAppInfo *appinfo, + GList *uris, + GAppLaunchContext *launch_context, + GError **error); +gbooleang_app_info_should_show (GAppInfo *appinfo); +gbooleang_app_info_can_delete (GAppInfo *appinfo); +gbooleang_app_info_delete (GAppInfo *appinfo); +voidg_app_info_reset_type_associations (const char *content_type); +gbooleang_app_info_set_as_default_for_type (GAppInfo *appinfo, + const char *content_type, + GError **error); +gbooleang_app_info_set_as_default_for_extension + (GAppInfo *appinfo, + const char *extension, + GError **error); +gbooleang_app_info_add_supports_type (GAppInfo *appinfo, + const char *content_type, + GError **error); +gbooleang_app_info_can_remove_supports_type (GAppInfo *appinfo); +gbooleang_app_info_remove_supports_type (GAppInfo *appinfo, + const char *content_type, + GError **error); +GList * g_app_info_get_all (void); +GList * g_app_info_get_all_for_type (const char *content_type); +GAppInfo * g_app_info_get_default_for_type (const char *content_type, + gboolean must_support_uris); GAppInfo * g_app_info_get_default_for_uri_scheme - (const char *uri_scheme); -gbooleang_app_info_launch_default_for_uri (const char *uri, - GAppLaunchContext *launch_context, - GError **error); -char * g_app_launch_context_get_display (GAppLaunchContext *context, - GAppInfo *info, - GList *files); + (const char *uri_scheme); +gbooleang_app_info_launch_default_for_uri (const char *uri, + GAppLaunchContext *launch_context, + GError **error); +char * g_app_launch_context_get_display (GAppLaunchContext *context, + GAppInfo *info, + GList *files); char * g_app_launch_context_get_startup_notify_id - (GAppLaunchContext *context, - GAppInfo *info, - GList *files); -voidg_app_launch_context_launch_failed (GAppLaunchContext *context, - const char *startup_notify_id); -GAppLaunchContext * g_app_launch_context_new (void); + (GAppLaunchContext *context, + GAppInfo *info, + GList *files); +voidg_app_launch_context_launch_failed (GAppLaunchContext *context, + const char *startup_notify_id); +GAppLaunchContext * g_app_launch_context_new (void);
@@ -150,7 +120,7 @@ const char * - GObject + GObject +----GAppLaunchContext
@@ -158,7 +128,7 @@ const char *

Prerequisites

GAppInfo requires - GObject.

+ GObject.

Known Implementations

@@ -224,7 +194,8 @@ This code will work when both cdda://sr0/Track 1.wav is passed to the application. It should be noted that it's generally not safe for applications to rely on the format of a particular URIs. Different launcher applications (e.g. file -managers) may have different ideas of what a given URI means.

+managers) may have different ideas of what a given URI means. +

Details

@@ -237,23 +208,24 @@ managers) may have different ideas of what a given URI means.

} GAppInfoCreateFlags;

-Flags used when creating a GAppInfo.

+Flags used when creating a GAppInfo. +

- - - @@ -265,7 +237,8 @@ Flags used when creating a typedef struct _GAppInfo GAppInfo;

Information about an installed application and methods to launch -it (with file arguments).

+it (with file arguments). +


@@ -316,120 +289,121 @@ it (with file arguments).

} GAppInfoIface;

-Application Information interface, for operating system portability.

+Application Information interface, for operating system portability. +

G_APP_INFO_CREATE_NONE

No flags. +No flags.

G_APP_INFO_CREATE_NEEDS_TERMINAL

Application opens in a terminal window. +Application opens in a terminal window.

G_APP_INFO_CREATE_SUPPORTS_URIS

Application supports URI arguments. +Application supports URI arguments.
- - + - - - - - - - - - - - - - - - - - - - - - @@ -442,7 +416,8 @@ Application Information interface, for operating system portability.

Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application -on the same screen as the launching window.

+on the same screen as the launching window. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

dup ()

Copies a GAppInfo. +Copies a GAppInfo.

equal ()

Checks two GAppInfos for equality. +Checks two GAppInfos for equality.

get_id ()

Gets a string identifier for a GAppInfo. +Gets a string identifier for a GAppInfo.

get_name ()

Gets the name of the application for a GAppInfo. +Gets the name of the application for a GAppInfo.

get_description ()

Gets a short description for the application described by the GAppInfo. +Gets a short description for the application described by the GAppInfo.

get_executable ()

Gets the executable name for the GAppInfo. +Gets the executable name for the GAppInfo.

get_icon ()

Gets the GIcon for the GAppInfo. +Gets the GIcon for the GAppInfo.

launch ()

Launches an application specified by the GAppInfo. +Launches an application specified by the GAppInfo.

supports_uris ()

Indicates whether the application specified supports launching URIs. +Indicates whether the application specified supports launching URIs.

supports_files ()

Indicates whether the application specified accepts filename arguments. +Indicates whether the application specified accepts filename arguments.

launch_uris ()

Launches an application with a list of URIs. +Launches an application with a list of URIs.

should_show ()

Returns whether an application should be shown (e.g. when getting a list of installed applications). +Returns whether an application should be shown (e.g. when getting a list of installed applications). FreeDesktop.Org Startup Notification Specification.

set_as_default_for_type ()

Sets an application as default for a given content type. +Sets an application as default for a given content type.

set_as_default_for_extension ()

Sets an application as default for a given file extension. +Sets an application as default for a given file extension.

add_supports_type ()

Adds to the GAppInfo information about supported file types. +Adds to the GAppInfo information about supported file types.

can_remove_supports_type ()

Checks for support for removing supported file types from a GAppInfo. +Checks for support for removing supported file types from a GAppInfo.

remove_supports_type ()

Removes a supported application type from a GAppInfo. +Removes a supported application type from a GAppInfo.

can_delete ()

Checks if a GAppInfo can be deleted. Since 2.20 +Checks if a GAppInfo can be deleted. Since 2.20

do_delete ()

Deletes a GAppInfo. Since 2.20 +Deletes a GAppInfo. Since 2.20

get_commandline ()

Gets the commandline for the GAppInfo. Since 2.20 +Gets the commandline for the GAppInfo. Since 2.20

get_display_name ()

Gets the display name for the GAppInfo. Since 2.24 +Gets the display name for the GAppInfo. Since 2.24
@@ -451,33 +426,34 @@ on the same screen as the launching window.


g_app_info_create_from_commandline ()

-
GAppInfo *          g_app_info_create_from_commandline  (const char *commandline,
-                                                         const char *application_name,
-                                                         GAppInfoCreateFlags flags,
-                                                         GError **error);
+
GAppInfo *          g_app_info_create_from_commandline  (const char *commandline,
+                                                         const char *application_name,
+                                                         GAppInfoCreateFlags flags,
+                                                         GError **error);

-Creates a new GAppInfo from the given information.

+Creates a new GAppInfo from the given information. +

- - - - @@ -491,15 +467,16 @@ Creates a new

g_app_info_dup ()

-
GAppInfo *          g_app_info_dup                      (GAppInfo *appinfo);
+
GAppInfo *          g_app_info_dup                      (GAppInfo *appinfo);

-Creates a duplicate of a GAppInfo.

+Creates a duplicate of a GAppInfo. +

commandline :

the commandline to use +the commandline to use

application_name :

the application name, or NULL to use commandline +the application name, or NULL to use commandline

flags :

flags that can specify details of the created GAppInfo +flags that can specify details of the created GAppInfo

error :

a GError location to store the error occuring, NULL to ignore. +a GError location to store the error occuring, NULL to ignore.
- @@ -513,26 +490,27 @@ Creates a duplicate of a <

g_app_info_equal ()

-
gboolean            g_app_info_equal                    (GAppInfo *appinfo1,
-                                                         GAppInfo *appinfo2);
+
gboolean            g_app_info_equal                    (GAppInfo *appinfo1,
+                                                         GAppInfo *appinfo2);

-Checks if two GAppInfos are equal.

+Checks if two GAppInfos are equal. +

appinfo :

a GAppInfo. +a GAppInfo.
- - - @@ -541,7 +519,7 @@ Checks if two

g_app_info_get_id ()

-
const char *        g_app_info_get_id                   (GAppInfo *appinfo);
+
const char *        g_app_info_get_id                   (GAppInfo *appinfo);

Gets the ID of an application. An id is a string that identifies the application. The exact format of the id is @@ -549,14 +527,15 @@ platform dependent. For instance, on Unix this is the desktop file id from the xdg menu specification.

-Note that the returned ID may be NULL, depending on how -the appinfo has been constructed.

+Note that the returned ID may be NULL, depending on how +the appinfo has been constructed. +

appinfo1 :

the first GAppInfo. +the first GAppInfo.

appinfo2 :

the second GAppInfo. +the second GAppInfo.

Returns :

TRUE if appinfo1 is equal to appinfo2. FALSE otherwise. + TRUE if appinfo1 is equal to appinfo2. FALSE otherwise.
- @@ -570,15 +549,16 @@ the appinfo has been constructed.


g_app_info_get_name ()

-
const char *        g_app_info_get_name                 (GAppInfo *appinfo);
+
const char *        g_app_info_get_name                 (GAppInfo *appinfo);

-Gets the installed name of the application.

+Gets the installed name of the application. +

appinfo :

a GAppInfo. +a GAppInfo.
- @@ -592,16 +572,17 @@ Gets the installed name of the application.


g_app_info_get_display_name ()

-
const char *        g_app_info_get_display_name         (GAppInfo *appinfo);
+
const char *        g_app_info_get_display_name         (GAppInfo *appinfo);

Gets the display name of the application. The display name is often more -descriptive to the user than the name itself.

+descriptive to the user than the name itself. +

appinfo :

a GAppInfo. +a GAppInfo.
- @@ -618,21 +599,22 @@ no display name is available.

g_app_info_get_description ()

-
const char *        g_app_info_get_description          (GAppInfo *appinfo);
+
const char *        g_app_info_get_description          (GAppInfo *appinfo);

-Gets a human-readable description of an installed application.

+Gets a human-readable description of an installed application. +

appinfo :

a GAppInfo. +a GAppInfo.
- @@ -641,15 +623,16 @@ application appinfo, or

g_app_info_get_executable ()

-
const char *        g_app_info_get_executable           (GAppInfo *appinfo);
+
const char *        g_app_info_get_executable           (GAppInfo *appinfo);

-Gets the executable's name for the installed application.

+Gets the executable's name for the installed application. +

appinfo :

a GAppInfo. +a GAppInfo.

Returns :

a string containing a description of the -application appinfo, or NULL if none. +application appinfo, or NULL if none.
- @@ -664,22 +647,23 @@ binaries name

g_app_info_get_commandline ()

-
const char *        g_app_info_get_commandline          (GAppInfo *appinfo);
+
const char *        g_app_info_get_commandline          (GAppInfo *appinfo);

Gets the commandline with which the application will be -started.

+started. +

appinfo :

a GAppInfo +a GAppInfo
- @@ -690,15 +674,16 @@ started.


g_app_info_get_icon ()

-
GIcon *             g_app_info_get_icon                 (GAppInfo *appinfo);
+
GIcon *             g_app_info_get_icon                 (GAppInfo *appinfo);

-Gets the icon for the application.

+Gets the icon for the application. +

appinfo :

a GAppInfo +a GAppInfo

Returns :

a string containing the appinfo's commandline, - or NULL if this information is not available + or NULL if this information is not available
- @@ -712,10 +697,10 @@ Gets the icon for the application.


g_app_info_launch ()

-
gboolean            g_app_info_launch                   (GAppInfo *appinfo,
-                                                         GList *files,
-                                                         GAppLaunchContext *launch_context,
-                                                         GError **error);
+
gboolean            g_app_info_launch                   (GAppInfo *appinfo,
+                                                         GList *files,
+                                                         GAppLaunchContext *launch_context,
+                                                         GError **error);

Launches the application. Passes files to the launched application as arguments, using the optional launch_context to get information @@ -723,7 +708,7 @@ about the details of the launcher (like what screen it is on). On error, error will be set accordingly.

-To lauch the application without arguments pass a NULL files list. +To lauch the application without arguments pass a NULL files list.

Note that even if the launch is successful the application launched @@ -734,33 +719,34 @@ no way to detect this. Some URIs can be changed when passed through a GFile (for instance unsupported uris with strange formats like mailto:), so if you have a textual uri you want to pass in as argument, consider using -g_app_info_launch_uris() instead.

+g_app_info_launch_uris() instead. +

appinfo :

a GAppInfo. +a GAppInfo.
- - - - - @@ -769,20 +755,21 @@ a textual uri you want to pass in as argument, consider using

g_app_info_supports_files ()

-
gboolean            g_app_info_supports_files           (GAppInfo *appinfo);
+
gboolean            g_app_info_supports_files           (GAppInfo *appinfo);

-Checks if the application accepts files as arguments.

+Checks if the application accepts files as arguments. +

appinfo :

a GAppInfo +a GAppInfo

files :

a GList of GFile objects +a GList of GFile objects

launch_context :

a GAppLaunchContext or NULL +a GAppLaunchContext or NULL

error :

a GError +a GError

Returns :

TRUE on successful launch, FALSE otherwise. + TRUE on successful launch, FALSE otherwise.
- - @@ -791,20 +778,21 @@ Checks if the application accepts files as arguments.


g_app_info_supports_uris ()

-
gboolean            g_app_info_supports_uris            (GAppInfo *appinfo);
+
gboolean            g_app_info_supports_uris            (GAppInfo *appinfo);

-Checks if the application supports reading files and directories from URIs.

+Checks if the application supports reading files and directories from URIs. +

appinfo :

a GAppInfo. +a GAppInfo.

Returns :

TRUE if the appinfo supports files. + TRUE if the appinfo supports files.
- - @@ -813,10 +801,10 @@ Checks if the application supports reading files and directories from URIs.


g_app_info_launch_uris ()

-
gboolean            g_app_info_launch_uris              (GAppInfo *appinfo,
-                                                         GList *uris,
-                                                         GAppLaunchContext *launch_context,
-                                                         GError **error);
+
gboolean            g_app_info_launch_uris              (GAppInfo *appinfo,
+                                                         GList *uris,
+                                                         GAppLaunchContext *launch_context,
+                                                         GError **error);

Launches the application. Passes uris to the launched application as arguments, using the optional launch_context to get information @@ -824,38 +812,39 @@ about the details of the launcher (like what screen it is on). On error, error will be set accordingly.

-To lauch the application without arguments pass a NULL uris list. +To lauch the application without arguments pass a NULL uris list.

Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is -no way to detect this.

+no way to detect this. +

appinfo :

a GAppInfo. +a GAppInfo.

Returns :

TRUE if the appinfo supports URIs. + TRUE if the appinfo supports URIs.
- - - - - @@ -864,21 +853,22 @@ no way to detect this.


g_app_info_should_show ()

-
gboolean            g_app_info_should_show              (GAppInfo *appinfo);
+
gboolean            g_app_info_should_show              (GAppInfo *appinfo);

Checks if the application info should be shown in menus that -list available applications.

+list available applications. +

appinfo :

a GAppInfo +a GAppInfo

uris :

a GList containing URIs to launch. +a GList containing URIs to launch.

launch_context :

a GAppLaunchContext or NULL +a GAppLaunchContext or NULL

error :

a GError +a GError

Returns :

TRUE on successful launch, FALSE otherwise. + TRUE on successful launch, FALSE otherwise.
- - @@ -887,21 +877,22 @@ list available applications.


g_app_info_can_delete ()

-
gboolean            g_app_info_can_delete               (GAppInfo *appinfo);
+
gboolean            g_app_info_can_delete               (GAppInfo *appinfo);

Obtains the information whether the GAppInfo can be deleted. -See g_app_info_delete().

+See g_app_info_delete(). +

appinfo :

a GAppInfo. +a GAppInfo.

Returns :

TRUE if the appinfo should be shown, FALSE otherwise. + TRUE if the appinfo should be shown, FALSE otherwise.
- - @@ -912,25 +903,26 @@ See

g_app_info_delete ()

-
gboolean            g_app_info_delete                   (GAppInfo *appinfo);
+
gboolean            g_app_info_delete                   (GAppInfo *appinfo);

Tries to delete a GAppInfo.

On some platforms, there may be a difference between user-defined GAppInfos which can be deleted, and system-wide ones which -cannot. See g_app_info_can_delete().

+cannot. See g_app_info_can_delete(). +

appinfo :

a GAppInfo +a GAppInfo

Returns :

TRUE if appinfo can be deleted + TRUE if appinfo can be deleted
- - @@ -941,17 +933,18 @@ cannot. See

g_app_info_reset_type_associations ()

-
void                g_app_info_reset_type_associations  (const char *content_type);
+
void                g_app_info_reset_type_associations  (const char *content_type);

Removes all changes to the type associations done by g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), -g_app_info_add_supports_type() or g_app_info_remove_supports_type().

+g_app_info_add_supports_type() or g_app_info_remove_supports_type(). +

appinfo :

a GAppInfo +a GAppInfo

Returns :

TRUE if appinfo has been deleted + TRUE if appinfo has been deleted
-

content_type :

a content type +a content type
@@ -960,32 +953,33 @@ Removes all changes to the type associations done by

g_app_info_set_as_default_for_type ()

-
gboolean            g_app_info_set_as_default_for_type  (GAppInfo *appinfo,
-                                                         const char *content_type,
-                                                         GError **error);
+
gboolean            g_app_info_set_as_default_for_type  (GAppInfo *appinfo,
+                                                         const char *content_type,
+                                                         GError **error);

-Sets the application as the default handler for a given type.

+Sets the application as the default handler for a given type. +

- - - - @@ -994,33 +988,34 @@ Sets the application as the default handler for a given type.


g_app_info_set_as_default_for_extension ()

-
gboolean            g_app_info_set_as_default_for_extension
-                                                        (GAppInfo *appinfo,
-                                                         const char *extension,
-                                                         GError **error);
+
gboolean            g_app_info_set_as_default_for_extension
+                                                        (GAppInfo *appinfo,
+                                                         const char *extension,
+                                                         GError **error);

-Sets the application as the default handler for the given file extension.

+Sets the application as the default handler for the given file extension. +

appinfo :

a GAppInfo. +a GAppInfo.

content_type :

the content type. +the content type.

error :

a GError. +a GError.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - - @@ -1029,33 +1024,34 @@ Sets the application as the default handler for the given file extension.


g_app_info_add_supports_type ()

-
gboolean            g_app_info_add_supports_type        (GAppInfo *appinfo,
-                                                         const char *content_type,
-                                                         GError **error);
+
gboolean            g_app_info_add_supports_type        (GAppInfo *appinfo,
+                                                         const char *content_type,
+                                                         GError **error);

Adds a content type to the application information to indicate the -application is capable of opening files with the given content type.

+application is capable of opening files with the given content type. +

appinfo :

a GAppInfo. +a GAppInfo.

extension :

a string containing the file extension (without the dot). +a string containing the file extension (without the dot).

error :

a GError. +a GError.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - - @@ -1064,21 +1060,22 @@ application is capable of opening files with the given content type.


g_app_info_can_remove_supports_type ()

-
gboolean            g_app_info_can_remove_supports_type (GAppInfo *appinfo);
+
gboolean            g_app_info_can_remove_supports_type (GAppInfo *appinfo);

-Checks if a supported content type can be removed from an application.

+Checks if a supported content type can be removed from an application. +

appinfo :

a GAppInfo. +a GAppInfo.

content_type :

a string. +a string.

error :

a GError. +a GError.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - @@ -1087,32 +1084,33 @@ Checks if a supported content type can be removed from an application.


g_app_info_remove_supports_type ()

-
gboolean            g_app_info_remove_supports_type     (GAppInfo *appinfo,
-                                                         const char *content_type,
-                                                         GError **error);
+
gboolean            g_app_info_remove_supports_type     (GAppInfo *appinfo,
+                                                         const char *content_type,
+                                                         GError **error);

-Removes a supported type from an application, if possible.

+Removes a supported type from an application, if possible. +

appinfo :

a GAppInfo. +a GAppInfo.

Returns :

TRUE if it is possible to remove supported - content types from a given appinfo, FALSE if not. + TRUE if it is possible to remove supported + content types from a given appinfo, FALSE if not.
- - - - @@ -1121,7 +1119,7 @@ Removes a supported type from an application, if possible.


g_app_info_get_all ()

-
GList *             g_app_info_get_all                  (void);
+
GList *             g_app_info_get_all                  (void);

Gets a list of all of the applications currently registered on this system. @@ -1132,12 +1130,13 @@ For desktop files, this includes applications that have display by means of OnlyShowIn or NotShowIn. See g_app_info_should_show(). The returned list does not include applications which have -the Hidden key set.

+the Hidden key set. +

appinfo :

a GAppInfo. +a GAppInfo.

content_type :

a string. +a string.

error :

a GError. +a GError.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
-

Returns :

a newly allocated GList of references to GAppInfos. + a newly allocated GList of references to GAppInfos.
@@ -1145,21 +1144,22 @@ the Hidden key set.


g_app_info_get_all_for_type ()

-
GList *             g_app_info_get_all_for_type         (const char *content_type);
+
GList *             g_app_info_get_all_for_type         (const char *content_type);

-Gets a list of all GAppInfos for a given content type.

+Gets a list of all GAppInfos for a given content type. +

- - @@ -1168,27 +1168,28 @@ Gets a list of all

g_app_info_get_default_for_type ()

-
GAppInfo *          g_app_info_get_default_for_type     (const char *content_type,
-                                                         gboolean must_support_uris);
+
GAppInfo *          g_app_info_get_default_for_type     (const char *content_type,
+                                                         gboolean must_support_uris);

-Gets the GAppInfo that corresponds to a given content type.

+Gets the GAppInfo that corresponds to a given content type. +

content_type :

the content type to find a GAppInfo for +the content type to find a GAppInfo for

Returns :

GList of GAppInfos for given content_type - or NULL on error. + GList of GAppInfos for given content_type + or NULL on error.
- - - @@ -1198,23 +1199,24 @@ Gets the

g_app_info_get_default_for_uri_scheme ()

GAppInfo *          g_app_info_get_default_for_uri_scheme
-                                                        (const char *uri_scheme);
+ (const char *uri_scheme);

Gets the default application for launching applications using this URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", -"ftp" or "sip".

+"ftp" or "sip". +

content_type :

the content type to find a GAppInfo for +the content type to find a GAppInfo for

must_support_uris :

if TRUE, the GAppInfo is expected to +if TRUE, the GAppInfo is expected to support URIs

Returns :

GAppInfo for given content_type or NULL on error. + GAppInfo for given content_type or NULL on error.
- - @@ -1223,35 +1225,36 @@ of the URI, up to but not including the ':', e.g. "http",

g_app_info_launch_default_for_uri ()

-
gboolean            g_app_info_launch_default_for_uri   (const char *uri,
-                                                         GAppLaunchContext *launch_context,
-                                                         GError **error);
+
gboolean            g_app_info_launch_default_for_uri   (const char *uri,
+                                                         GAppLaunchContext *launch_context,
+                                                         GError **error);

Utility function that launches the default application registered to handle the specified uri. Synchronous I/O is done on the uri to detect the type of the file if -required.

+required. +

uri_scheme :

a string containing a URI scheme. +a string containing a URI scheme.

Returns :

GAppInfo for given uri_scheme or NULL on error. + GAppInfo for given uri_scheme or NULL on error.
- - - - @@ -1260,29 +1263,30 @@ required.


g_app_launch_context_get_display ()

-
char *              g_app_launch_context_get_display    (GAppLaunchContext *context,
-                                                         GAppInfo *info,
-                                                         GList *files);
+
char *              g_app_launch_context_get_display    (GAppLaunchContext *context,
+                                                         GAppInfo *info,
+                                                         GList *files);

Gets the display string for the display. This is used to ensure new applications are started on the same display as the launching -application.

+application. +

uri :

the uri to show +the uri to show

launch_context :

an optional GAppLaunchContext. +an optional GAppLaunchContext.

error :

a GError. +a GError.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - @@ -1297,37 +1301,38 @@ application.

g_app_launch_context_get_startup_notify_id ()

char *              g_app_launch_context_get_startup_notify_id
-                                                        (GAppLaunchContext *context,
-                                                         GAppInfo *info,
-                                                         GList *files);
+ (GAppLaunchContext *context, + GAppInfo *info, + GList *files);

Initiates startup notification for the application and returns the DESKTOP_STARTUP_ID for the launched operation, if supported.

Startup notification IDs are defined in the -FreeDesktop.Org Startup Notifications standard.

+FreeDesktop.Org Startup Notifications standard. +

context :

a GAppLaunchContext +a GAppLaunchContext

info :

a GAppInfo +a GAppInfo

files :

a GList of GFile objects +a GList of GFile objects
- - - - @@ -1337,22 +1342,23 @@ FreeDesktop.Org Startup Notifications standard.


g_app_launch_context_launch_failed ()

-
void                g_app_launch_context_launch_failed  (GAppLaunchContext *context,
-                                                         const char *startup_notify_id);
+
void                g_app_launch_context_launch_failed  (GAppLaunchContext *context,
+                                                         const char *startup_notify_id);

Called when an application has failed to launch, so that it can cancel -the application startup notification started in g_app_launch_context_get_startup_notify_id().

+the application startup notification started in g_app_launch_context_get_startup_notify_id(). +

context :

a GAppLaunchContext +a GAppLaunchContext

info :

a GAppInfo +a GAppInfo

files :

a GList of of GFile objects +a GList of of GFile objects

Returns :

a startup notification ID for the application, or NULL if + a startup notification ID for the application, or NULL if not supported.
- - @@ -1361,10 +1367,11 @@ the application startup notification started in

g_app_launch_context_new ()

-
GAppLaunchContext * g_app_launch_context_new            (void);
+
GAppLaunchContext * g_app_launch_context_new            (void);

Creates a new application launch context. This is not normally used, -instead you instantiate a subclass of this, such as GdkAppLaunchContext.

+instead you instantiate a subclass of this, such as GdkAppLaunchContext. +

context :

a GAppLaunchContext. +a GAppLaunchContext.

startup_notify_id :

the startup notification id that was returned by g_app_launch_context_get_startup_notify_id(). +the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().
@@ -1378,6 +1385,6 @@ instead you instantiate a subclass of this, such as
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GAsyncInitable.html b/docs/reference/gio/html/GAsyncInitable.html index 3b02f3c..4c2770a 100644 --- a/docs/reference/gio/html/GAsyncInitable.html +++ b/docs/reference/gio/html/GAsyncInitable.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -76,38 +46,38 @@ GAsyncInitable; GAsyncInitableIface; -voidg_async_initable_init_async (GAsyncInitable *initable, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_async_initable_init_finish (GAsyncInitable *initable, - GAsyncResult *res, - GError **error); -voidg_async_initable_new_async (GType object_type, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data, - const gchar *first_property_name, - ...); -GObject * g_async_initable_new_finish (GAsyncInitable *initable, - GAsyncResult *res, - GError **error); -voidg_async_initable_new_valist_async (GType object_type, - const gchar *first_property_name, - va_list var_args, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -voidg_async_initable_newv_async (GType object_type, - guint n_parameters, - GParameter *parameters, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); +voidg_async_initable_init_async (GAsyncInitable *initable, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_async_initable_init_finish (GAsyncInitable *initable, + GAsyncResult *res, + GError **error); +voidg_async_initable_new_async (GType object_type, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data, + const gchar *first_property_name, + ...); +GObject * g_async_initable_new_finish (GAsyncInitable *initable, + GAsyncResult *res, + GError **error); +voidg_async_initable_new_valist_async (GType object_type, + const gchar *first_property_name, + va_list var_args, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +voidg_async_initable_newv_async (GType object_type, + guint n_parameters, + GParameter *parameters, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);
@@ -121,7 +91,7 @@

Prerequisites

GAsyncInitable requires - GObject.

+ GObject.

Description

@@ -138,8 +108,9 @@ Users of objects implementing this are not intended to use the interface method directly; instead it will be used automatically in various ways. For C applications you generally just call g_async_initable_new_async() directly, or indirectly via a foo_thing_new_async() wrapper. This will call -g_async_initable_init_async() under the cover, calling back with NULL and -a set GError on failure.

+g_async_initable_init_async() under the cover, calling back with NULL and +a set GError on failure. +

Details

@@ -147,7 +118,8 @@ a set

GAsyncInitable

typedef struct _GAsyncInitable GAsyncInitable;

-Interface for asynchronously initializable objects.

+Interface for asynchronously initializable objects. +

Since 2.22


@@ -170,23 +142,24 @@ Interface for asynchronously initializable objects.

Provides an interface for asynchronous initializing object such that -initialization may fail.

+initialization may fail. +

- - + - - @@ -196,11 +169,11 @@ initialization may fail.


g_async_initable_init_async ()

-
void                g_async_initable_init_async         (GAsyncInitable *initable,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_async_initable_init_async         (GAsyncInitable *initable,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Starts asynchronous initialization of the object implementing the interface. This must be done before any real use of the object after @@ -214,9 +187,9 @@ initialization.

Implementations may also support cancellation. If cancellable is not -NULL, then initialization can be cancelled by triggering the cancellable +NULL, then initialization can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error -G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL, and +G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL, and the object doesn't support cancellable initialization, the error G_IO_ERROR_NOT_SUPPORTED will be returned.

@@ -237,34 +210,35 @@ For classes that also support the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the GAsyncInitable interface without overriding -any interface methods.

+any interface methods. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

init_async ()

Starts initialization of the object. +Starts initialization of the object.

init_finish ()

Finishes initialization of the object. +Finishes initialization of the object.
- - - - - @@ -274,35 +248,36 @@ any interface methods.


g_async_initable_init_finish ()

-
gboolean            g_async_initable_init_finish        (GAsyncInitable *initable,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
gboolean            g_async_initable_init_finish        (GAsyncInitable *initable,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes asynchronous initialization and returns the result. -See g_async_initable_init_async().

+See g_async_initable_init_async(). +

initable :

a GAsyncInitable. +a GAsyncInitable.

io_priority :

the I/O priority +the I/O priority of the operation.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -313,61 +288,62 @@ will return

g_async_initable_new_async ()

-
void                g_async_initable_new_async          (GType object_type,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         const gchar *first_property_name,
-                                                         ...);
+
void                g_async_initable_new_async          (GType object_type,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data,
+                                                         const gchar *first_property_name,
+                                                         ...);

Helper function for constructing GAsyncInitiable object. This is -similar to g_object_new() but also initializes the object asynchronously. +similar to g_object_new() but also initializes the object asynchronously.

When the initialization is finished, callback will be called. You can then call g_async_initable_new_finish() to get the new object and check -for any errors.

+for any errors. +

initable :

a GAsyncInitable. +a GAsyncInitable.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if successful. If an error has occurred, this function -will return FALSE and set error appropriately if present. + TRUE if successful. If an error has occurred, this function +will return FALSE and set error appropriately if present.
- - - - - - - @@ -377,35 +353,36 @@ for any errors.


g_async_initable_new_finish ()

-
GObject *           g_async_initable_new_finish         (GAsyncInitable *initable,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GObject *           g_async_initable_new_finish         (GAsyncInitable *initable,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes the async construction for the various g_async_initable_new calls, -returning the created object or NULL on error.

+returning the created object or NULL on error. +

object_type :

a GType supporting GAsyncInitable. +a GType supporting GAsyncInitable.

io_priority :

the I/O priority +the I/O priority of the operation.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the initialization is +a GAsyncReadyCallback to call when the initialization is finished

user_data :

the data to pass to callback function +the data to pass to callback function

first_property_name :

the name of the first property, or NULL if no +the name of the first property, or NULL if no properties

... :

the value of the first property, followed by other property - value pairs, and ended by NULL. +the value of the first property, followed by other property + value pairs, and ended by NULL.
- - - - @@ -416,61 +393,62 @@ returning the created object or

g_async_initable_new_valist_async ()

-
void                g_async_initable_new_valist_async   (GType object_type,
-                                                         const gchar *first_property_name,
-                                                         va_list var_args,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_async_initable_new_valist_async   (GType object_type,
+                                                         const gchar *first_property_name,
+                                                         va_list var_args,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Helper function for constructing GAsyncInitiable object. This is -similar to g_object_new_valist() but also initializes the object +similar to g_object_new_valist() but also initializes the object asynchronously.

When the initialization is finished, callback will be called. You can then call g_async_initable_new_finish() to get the new object and check -for any errors.

+for any errors. +

initable :

the GAsyncInitable from the callback +the GAsyncInitable from the callback

res :

the GAsyncResult.from the callback +the GAsyncResult.from the callback

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a newly created GObject, or NULL on error. Free with - g_object_unref(). + a newly created GObject, or NULL on error. Free with + g_object_unref().
- - - - - - - @@ -480,59 +458,60 @@ the value, and other property value pairs, and ended by

g_async_initable_newv_async ()

-
void                g_async_initable_newv_async         (GType object_type,
-                                                         guint n_parameters,
-                                                         GParameter *parameters,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_async_initable_newv_async         (GType object_type,
+                                                         guint n_parameters,
+                                                         GParameter *parameters,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Helper function for constructing GAsyncInitiable object. This is -similar to g_object_newv() but also initializes the object asynchronously. +similar to g_object_newv() but also initializes the object asynchronously.

When the initialization is finished, callback will be called. You can then call g_async_initable_new_finish() to get the new object and check -for any errors.

+for any errors. +

object_type :

a GType supporting GAsyncInitable. +a GType supporting GAsyncInitable.

first_property_name :

the name of the first property, followed by -the value, and other property value pairs, and ended by NULL. +the name of the first property, followed by +the value, and other property value pairs, and ended by NULL.

var_args :

The var args list generated from first_property_name. +The var args list generated from first_property_name.

io_priority :

the I/O priority +the I/O priority of the operation.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the initialization is +a GAsyncReadyCallback to call when the initialization is finished

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - - - - @@ -547,6 +526,6 @@ for any errors.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GAsyncResult.html b/docs/reference/gio/html/GAsyncResult.html index 8167ca4..bc923b0 100644 --- a/docs/reference/gio/html/GAsyncResult.html +++ b/docs/reference/gio/html/GAsyncResult.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

object_type :

a GType supporting GAsyncInitable. +a GType supporting GAsyncInitable.

n_parameters :

the number of parameters in parameters +the number of parameters in parameters

parameters :

the parameters to use to construct the object +the parameters to use to construct the object

io_priority :

the I/O priority +the I/O priority of the operation.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the initialization is +a GAsyncReadyCallback to call when the initialization is finished

user_data :

the data to pass to callback function +the data to pass to callback function
@@ -78,11 +48,11 @@ GAsyncResult; GAsyncResultIface; -void (*GAsyncReadyCallback) (GObject *source_object, - GAsyncResult *res, - gpointer user_data); -gpointerg_async_result_get_user_data (GAsyncResult *res); -GObject * g_async_result_get_source_object (GAsyncResult *res); +void (*GAsyncReadyCallback) (GObject *source_object, + GAsyncResult *res, + gpointer user_data); +gpointerg_async_result_get_user_data (GAsyncResult *res); +GObject * g_async_result_get_source_object (GAsyncResult *res);
@@ -96,7 +66,7 @@

Prerequisites

GAsyncResult requires - GObject.

+ GObject.

Known Implementations

@@ -136,46 +106,91 @@ later; however, the "_finish()" function may be ca

Example of a typical asynchronous operation flow:

-
-void _theoretical_frobnitz_async (Theoretical         *t,
-                                  GCancellable        *c,
-                                  GAsyncReadyCallback *cb,
-                                  gpointer             u);
+
+
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
void _theoretical_frobnitz_async (Theoretical         *t,
+                                  GCancellable        *c,
+                                  GAsyncReadyCallback *cb,
+                                  gpointer             u);
 
-gboolean _theoretical_frobnitz_finish (Theoretical   *t,
-                                       GAsyncResult  *res,
-                                       GError       **e);
+gboolean _theoretical_frobnitz_finish (Theoretical   *t,
+                                       GAsyncResult  *res,
+                                       GError       **e);
 
-static void
-frobnitz_result_func (GObject      *source_object,
-		 GAsyncResult *res,
-		 gpointer      user_data)
-{
-  gboolean success = FALSE;
+static void
+frobnitz_result_func (GObject      *source_object,
+         GAsyncResult *res,
+         gpointer      user_data)
+{
+  gboolean success = FALSE;
 
-  success = _theoretical_frobnitz_finish (source_object, res, NULL);
+  success = _theoretical_frobnitz_finish (source_object, res, NULL);
 
-  if (success)
-    g_printf ("Hurray!\n");
-  else
-    g_printf ("Uh oh!\n");
+  if (success)
+    g_printf ("Hurray!\n");
+  else
+    g_printf ("Uh oh!\n");
 
-  /* ... */
+  /* ... */
 
-}
+}
 
-int main (int argc, void *argv[])
-{
-   /* ... */
+int main (int argc, void *argv[])
+{
+   /* ... */
 
-   _theoretical_frobnitz_async (theoretical_data,
-                                NULL,
-                                frobnitz_result_func,
-                                NULL);
+   _theoretical_frobnitz_async (theoretical_data,
+                                NULL,
+                                frobnitz_result_func,
+                                NULL);
+
+   /* ... */
+}
+
- /* ... */ -} -

@@ -185,10 +200,11 @@ the result is a GThread has been initialized, but +These are run in a separate thread, if GThread has been initialized, but otherwise they are sent to the Main Event Loop and processed in an idle function. So, if you truly need asynchronous operations, make sure to -initialize GThread.

+initialize GThread. +


@@ -212,23 +229,24 @@ usually passed directly to a asynchronous _finish()

-Interface definition for GAsyncResult.

+Interface definition for GAsyncResult. +

- - + - - @@ -237,28 +255,29 @@ Interface definition for

GAsyncReadyCallback ()

-
void                (*GAsyncReadyCallback)              (GObject *source_object,
-                                                         GAsyncResult *res,
-                                                         gpointer user_data);
+
void                (*GAsyncReadyCallback)              (GObject *source_object,
+                                                         GAsyncResult *res,
+                                                         gpointer user_data);

Type definition for a function that will be called back when an asynchronous -operation within GIO has been completed.

+operation within GIO has been completed. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

get_user_data ()

Gets the user data passed to the callback. +Gets the user data passed to the callback.

get_source_object ()

Gets the source object that issued the asynchronous operation. +Gets the source object that issued the asynchronous operation.
- - - @@ -267,15 +286,16 @@ operation within GIO has been completed.


g_async_result_get_user_data ()

-
gpointer            g_async_result_get_user_data        (GAsyncResult *res);
+
gpointer            g_async_result_get_user_data        (GAsyncResult *res);

-Gets the user data from a GAsyncResult.

+Gets the user data from a GAsyncResult. +

source_object :

the object the asynchronous operation was started with. +the object the asynchronous operation was started with.

res :

a GAsyncResult. +a GAsyncResult.

user_data :

user data passed to the callback. +user data passed to the callback.
- @@ -289,21 +309,22 @@ Gets the user data from a

g_async_result_get_source_object ()

-
GObject *           g_async_result_get_source_object    (GAsyncResult *res);
+
GObject *           g_async_result_get_source_object    (GAsyncResult *res);

-Gets the source object from a GAsyncResult.

+Gets the source object from a GAsyncResult. +

res :

a GAsyncResult. +a GAsyncResult.
- @@ -317,6 +338,6 @@ Gets the source object from a
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GBufferedInputStream.html b/docs/reference/gio/html/GBufferedInputStream.html index a2365bf..fbce634 100644 --- a/docs/reference/gio/html/GBufferedInputStream.html +++ b/docs/reference/gio/html/GBufferedInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

res :

a GAsyncResult +a GAsyncResult

Returns :

a new reference to the source object for the res, - or NULL if there is none. + or NULL if there is none.
@@ -75,44 +45,44 @@ #include <gio/gio.h> GBufferedInputStream; -GInputStream* g_buffered_input_stream_new (GInputStream *base_stream); -GInputStream* g_buffered_input_stream_new_sized (GInputStream *base_stream, - gsize size); -gsizeg_buffered_input_stream_get_buffer_size - (GBufferedInputStream *stream); +GInputStream* g_buffered_input_stream_new (GInputStream *base_stream); +GInputStream* g_buffered_input_stream_new_sized (GInputStream *base_stream, + gsize size); +gsizeg_buffered_input_stream_get_buffer_size + (GBufferedInputStream *stream); voidg_buffered_input_stream_set_buffer_size - (GBufferedInputStream *stream, - gsize size); -gsizeg_buffered_input_stream_get_available - (GBufferedInputStream *stream); -const void* g_buffered_input_stream_peek_buffer (GBufferedInputStream *stream, - gsize *count); -gsizeg_buffered_input_stream_peek (GBufferedInputStream *stream, - void *buffer, - gsize offset, - gsize count); -gssizeg_buffered_input_stream_fill (GBufferedInputStream *stream, - gssize count, - GCancellable *cancellable, - GError **error); -voidg_buffered_input_stream_fill_async (GBufferedInputStream *stream, - gssize count, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gssizeg_buffered_input_stream_fill_finish (GBufferedInputStream *stream, - GAsyncResult *result, - GError **error); -intg_buffered_input_stream_read_byte (GBufferedInputStream *stream, - GCancellable *cancellable, - GError **error); + (GBufferedInputStream *stream, + gsize size); +gsizeg_buffered_input_stream_get_available + (GBufferedInputStream *stream); +const void* g_buffered_input_stream_peek_buffer (GBufferedInputStream *stream, + gsize *count); +gsizeg_buffered_input_stream_peek (GBufferedInputStream *stream, + void *buffer, + gsize offset, + gsize count); +gssizeg_buffered_input_stream_fill (GBufferedInputStream *stream, + gssize count, + GCancellable *cancellable, + GError **error); +voidg_buffered_input_stream_fill_async (GBufferedInputStream *stream, + gssize count, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gssizeg_buffered_input_stream_fill_finish (GBufferedInputStream *stream, + GAsyncResult *result, + GError **error); +intg_buffered_input_stream_read_byte (GBufferedInputStream *stream, + GCancellable *cancellable, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFilterInputStream
                +----GBufferedInputStream
@@ -122,7 +92,7 @@ const void*         
 

Properties

-  "buffer-size"              guint                 : Read / Write / Construct
+  "buffer-size"              guint                 : Read / Write / Construct
 
@@ -144,7 +114,8 @@ To get the size of a buffer within a buffered input stream, use g_buffered_input_stream_get_buffer_size(). To change the size of a buffered input stream's buffer, use g_buffered_input_stream_set_buffer_size(). Note that the buffer's size -cannot be reduced below the size of the data within the buffer.

+cannot be reduced below the size of the data within the buffer. +

Details

@@ -152,21 +123,23 @@ cannot be reduced below the size of the data within the buffer.

GBufferedInputStream

typedef struct _GBufferedInputStream GBufferedInputStream;

-Implements GFilterInputStream with a sized input buffer.

+Implements GFilterInputStream with a sized input buffer. +


g_buffered_input_stream_new ()

-
GInputStream*       g_buffered_input_stream_new         (GInputStream *base_stream);
+
GInputStream*       g_buffered_input_stream_new         (GInputStream *base_stream);

Creates a new GInputStream from the given base_stream, with -a buffer set to the default size (4 kilobytes).

+a buffer set to the default size (4 kilobytes). +

- @@ -180,22 +153,23 @@ a buffer set to the default size (4 kilobytes).


g_buffered_input_stream_new_sized ()

-
GInputStream*       g_buffered_input_stream_new_sized   (GInputStream *base_stream,
-                                                         gsize size);
+
GInputStream*       g_buffered_input_stream_new_sized   (GInputStream *base_stream,
+                                                         gsize size);

Creates a new GBufferedInputStream from the given base_stream, -with a buffer set to size.

+with a buffer set to size. +

base_stream :

a GInputStream. +a GInputStream.
- - @@ -209,16 +183,18 @@ with a buffer set to size.


g_buffered_input_stream_get_buffer_size ()

-
gsize               g_buffered_input_stream_get_buffer_size
-                                                        (GBufferedInputStream *stream);
+
gsize               g_buffered_input_stream_get_buffer_size
+                                                        (GBufferedInputStream *stream);

-Gets the size of the input buffer.

+Gets the size of the input buffer. +

base_stream :

a GInputStream. +a GInputStream.

size :

a gsize. +a gsize.
- @@ -233,23 +209,25 @@ Gets the size of the input buffer.

g_buffered_input_stream_set_buffer_size ()

void                g_buffered_input_stream_set_buffer_size
-                                                        (GBufferedInputStream *stream,
-                                                         gsize size);
+ (GBufferedInputStream *stream, + gsize size);

Sets the size of the internal buffer of stream to size, or to the size of the contents of the buffer. The buffer can never be resized -smaller than its current contents.

+smaller than its current contents. +

stream :

GBufferedInputStream. + +GBufferedInputStream.
- - @@ -258,16 +236,18 @@ smaller than its current contents.


g_buffered_input_stream_get_available ()

-
gsize               g_buffered_input_stream_get_available
-                                                        (GBufferedInputStream *stream);
+
gsize               g_buffered_input_stream_get_available
+                                                        (GBufferedInputStream *stream);

-Gets the size of the available data within the stream.

+Gets the size of the available data within the stream. +

stream :

GBufferedInputStream. + +GBufferedInputStream.

size :

a gsize. +a gsize.
- @@ -281,23 +261,24 @@ Gets the size of the available data within the stream.


g_buffered_input_stream_peek_buffer ()

-
const void*         g_buffered_input_stream_peek_buffer (GBufferedInputStream *stream,
-                                                         gsize *count);
+
const void*         g_buffered_input_stream_peek_buffer (GBufferedInputStream *stream,
+                                                         gsize *count);

Returns the buffer with the currently available bytes. The returned buffer must not be modified and will become invalid when reading from -the stream or filling the buffer.

+the stream or filling the buffer. +

stream :

GBufferedInputStream. + +GBufferedInputStream.
- - @@ -311,39 +292,40 @@ the stream or filling the buffer.


g_buffered_input_stream_peek ()

-
gsize               g_buffered_input_stream_peek        (GBufferedInputStream *stream,
-                                                         void *buffer,
-                                                         gsize offset,
-                                                         gsize count);
+
gsize               g_buffered_input_stream_peek        (GBufferedInputStream *stream,
+                                                         void *buffer,
+                                                         gsize offset,
+                                                         gsize count);

Peeks in the buffer, copying data of size count into buffer, -offset offset bytes.

+offset offset bytes. +

stream :

a GBufferedInputStream. +a GBufferedInputStream.

count :

a gsize to get the number of bytes available in the buffer. +a gsize to get the number of bytes available in the buffer.
- - - - - @@ -352,17 +334,17 @@ offset offset bytes.


g_buffered_input_stream_fill ()

-
gssize              g_buffered_input_stream_fill        (GBufferedInputStream *stream,
-                                                         gssize count,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_buffered_input_stream_fill        (GBufferedInputStream *stream,
+                                                         gssize count,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to read count bytes from the stream into the buffer. Will block during this read.

If count is zero, returns zero and does nothing. A value of count -larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error. +larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

On success, the number of bytes read into the buffer is returned. @@ -375,7 +357,7 @@ If count is -1 then the attempted read s bytes that are required to fill the buffer.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the @@ -386,28 +368,30 @@ On error -1 is returned and error is set

For the asynchronous, non-blocking, version of this function, see -g_buffered_input_stream_fill_async().

+g_buffered_input_stream_fill_async(). +

stream :

a GBufferedInputStream. +a GBufferedInputStream.

buffer :

a pointer to an allocated chunk of memory. +a pointer to an allocated chunk of memory.

offset :

a gsize. +a gsize.

count :

a gsize. +a gsize.

Returns :

a gsize of the number of bytes peeked, or -1 on error. + a gsize of the number of bytes peeked, or -1 on error.
- - - - @@ -422,12 +406,12 @@ For the asynchronous, non-blocking, version of this function, see

g_buffered_input_stream_fill_async ()

-
void                g_buffered_input_stream_fill_async  (GBufferedInputStream *stream,
-                                                         gssize count,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_buffered_input_stream_fill_async  (GBufferedInputStream *stream,
+                                                         gssize count,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Reads data into stream's buffer asynchronously, up to count size. io_priority can be used to prioritize reads. For the synchronous @@ -435,39 +419,41 @@ version of this function, see count is -1 then the attempted read size is equal to the number -of bytes that are required to fill the buffer.

+of bytes that are required to fill the buffer. +

stream :

GBufferedInputStream. + +GBufferedInputStream.

count :

the number of bytes that will be read from the stream. +the number of bytes that will be read from the stream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore. +location to store the error occuring, or NULL to ignore.
- - - - - - @@ -476,32 +462,33 @@ of bytes that are required to fill the buffer.


g_buffered_input_stream_fill_finish ()

-
gssize              g_buffered_input_stream_fill_finish (GBufferedInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gssize              g_buffered_input_stream_fill_finish (GBufferedInputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes an asynchronous read.

+Finishes an asynchronous read. +

stream :

GBufferedInputStream. + +GBufferedInputStream.

count :

the number of bytes that will be read from the stream. +the number of bytes that will be read from the stream.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object +optional GCancellable object

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

a gpointer. +a gpointer.
- - - - @@ -510,9 +497,9 @@ Finishes an asynchronous read.


g_buffered_input_stream_read_byte ()

-
int                 g_buffered_input_stream_read_byte   (GBufferedInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
int                 g_buffered_input_stream_read_byte   (GBufferedInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to read a single byte from the stream or the buffer. Will block during this read. @@ -522,30 +509,32 @@ On success, the byte read from the stream is returned. On end of stream -1 is returned but it's not an exceptional error and error is not set.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error.

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

stream :

a GBufferedInputStream. +a GBufferedInputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError. +a GError.

Returns :

a gssize of the read stream, or -1 on an error. + a gssize of the read stream, or -1 on an error.
- - - @@ -561,7 +550,7 @@ On error -1 is returned and error is set

Property Details

The "buffer-size" property

-
  "buffer-size"              guint                 : Read / Write / Construct
+
  "buffer-size"              guint                 : Read / Write / Construct

The size of the backend buffer.

Allowed values: >= 1

Default value: 4096

@@ -574,6 +563,6 @@ On error -1 is returned and error is set
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GBufferedOutputStream.html b/docs/reference/gio/html/GBufferedOutputStream.html index bc5aeb3..212341d 100644 --- a/docs/reference/gio/html/GBufferedOutputStream.html +++ b/docs/reference/gio/html/GBufferedOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

GBufferedInputStream. + +GBufferedInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore. +location to store the error occuring, or NULL to ignore.
@@ -75,25 +45,25 @@ #include <gio/gio.h> GBufferedOutputStream; -GOutputStream* g_buffered_output_stream_new (GOutputStream *base_stream); -GOutputStream* g_buffered_output_stream_new_sized (GOutputStream *base_stream, - gsize size); -gsizeg_buffered_output_stream_get_buffer_size - (GBufferedOutputStream *stream); +GOutputStream* g_buffered_output_stream_new (GOutputStream *base_stream); +GOutputStream* g_buffered_output_stream_new_sized (GOutputStream *base_stream, + gsize size); +gsizeg_buffered_output_stream_get_buffer_size + (GBufferedOutputStream *stream); voidg_buffered_output_stream_set_buffer_size - (GBufferedOutputStream *stream, - gsize size); -gbooleang_buffered_output_stream_get_auto_grow - (GBufferedOutputStream *stream); + (GBufferedOutputStream *stream, + gsize size); +gbooleang_buffered_output_stream_get_auto_grow + (GBufferedOutputStream *stream); voidg_buffered_output_stream_set_auto_grow - (GBufferedOutputStream *stream, - gboolean auto_grow); + (GBufferedOutputStream *stream, + gboolean auto_grow);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFilterOutputStream
                +----GBufferedOutputStream
@@ -102,8 +72,8 @@
 

Properties

-  "auto-grow"                gboolean              : Read / Write
-  "buffer-size"              guint                 : Read / Write / Construct
+  "auto-grow"                gboolean              : Read / Write
+  "buffer-size"              guint                 : Read / Write / Construct
 
@@ -125,7 +95,8 @@ To get the size of a buffer within a buffered input stream, use g_buffered_output_stream_get_buffer_size(). To change the size of a buffered output stream's buffer, use g_buffered_output_stream_set_buffer_size(). Note that the buffer's -size cannot be reduced below the size of the data within the buffer.

+size cannot be reduced below the size of the data within the buffer. +

Details

@@ -133,7 +104,8 @@ size cannot be reduced below the size of the data within the buffer.

GBufferedOutputStream

typedef struct _GBufferedOutputStream GBufferedOutputStream;

-An implementation of GFilterOutputStream with a sized buffer.

+An implementation of GFilterOutputStream with a sized buffer. +

@@ -142,15 +114,16 @@ An implementation of

g_buffered_output_stream_new ()

-
GOutputStream*      g_buffered_output_stream_new        (GOutputStream *base_stream);
+
GOutputStream*      g_buffered_output_stream_new        (GOutputStream *base_stream);

-Creates a new buffered output stream for a base stream.

+Creates a new buffered output stream for a base stream. +

- @@ -164,21 +137,22 @@ Creates a new buffered output stream for a base stream.


g_buffered_output_stream_new_sized ()

-
GOutputStream*      g_buffered_output_stream_new_sized  (GOutputStream *base_stream,
-                                                         gsize size);
+
GOutputStream*      g_buffered_output_stream_new_sized  (GOutputStream *base_stream,
+                                                         gsize size);

-Creates a new buffered output stream with a given buffer size.

+Creates a new buffered output stream with a given buffer size. +

base_stream :

a GOutputStream. +a GOutputStream.
- - @@ -192,16 +166,17 @@ Creates a new buffered output stream with a given buffer size.


g_buffered_output_stream_get_buffer_size ()

-
gsize               g_buffered_output_stream_get_buffer_size
-                                                        (GBufferedOutputStream *stream);
+
gsize               g_buffered_output_stream_get_buffer_size
+                                                        (GBufferedOutputStream *stream);

-Gets the size of the buffer in the stream.

+Gets the size of the buffer in the stream. +

base_stream :

a GOutputStream. +a GOutputStream.

size :

a gsize. +a gsize.
- @@ -216,21 +191,22 @@ Gets the size of the buffer in the stream

g_buffered_output_stream_set_buffer_size ()

void                g_buffered_output_stream_set_buffer_size
-                                                        (GBufferedOutputStream *stream,
-                                                         gsize size);
+ (GBufferedOutputStream *stream, + gsize size);

-Sets the size of the internal buffer to size.

+Sets the size of the internal buffer to size. +

stream :

a GBufferedOutputStream. +a GBufferedOutputStream.
- - @@ -239,22 +215,23 @@ Sets the size of the internal buffer to size<

g_buffered_output_stream_get_auto_grow ()

-
gboolean            g_buffered_output_stream_get_auto_grow
-                                                        (GBufferedOutputStream *stream);
+
gboolean            g_buffered_output_stream_get_auto_grow
+                                                        (GBufferedOutputStream *stream);

-Checks if the buffer automatically grows as data is added.

+Checks if the buffer automatically grows as data is added. +

stream :

a GBufferedOutputStream. +a GBufferedOutputStream.

size :

a gsize. +a gsize.
- - @@ -264,24 +241,25 @@ Checks if the buffer automatically grows as data is added.

g_buffered_output_stream_set_auto_grow ()

void                g_buffered_output_stream_set_auto_grow
-                                                        (GBufferedOutputStream *stream,
-                                                         gboolean auto_grow);
+ (GBufferedOutputStream *stream, + gboolean auto_grow);

Sets whether or not the stream's buffer should automatically grow. If auto_grow is true, then each write will just make the buffer larger, and you must manually flush the buffer to actually write out -the data to the underlying stream.

+the data to the underlying stream. +

stream :

a GBufferedOutputStream. +a GBufferedOutputStream.

Returns :

TRUE if the stream's buffer automatically grows, -FALSE otherwise. + TRUE if the stream's buffer automatically grows, +FALSE otherwise.
- - @@ -292,14 +270,14 @@ the data to the underlying stream.

Property Details

The "auto-grow" property

-
  "auto-grow"                gboolean              : Read / Write
+
  "auto-grow"                gboolean              : Read / Write

Whether the buffer should automatically grow.

Default value: FALSE


The "buffer-size" property

-
  "buffer-size"              guint                 : Read / Write / Construct
+
  "buffer-size"              guint                 : Read / Write / Construct

The size of the backend buffer.

Allowed values: >= 1

Default value: 4096

@@ -312,6 +290,6 @@ the data to the underlying stream.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GCancellable.html b/docs/reference/gio/html/GCancellable.html index ab86983..8e21d8c 100644 --- a/docs/reference/gio/html/GCancellable.html +++ b/docs/reference/gio/html/GCancellable.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GBufferedOutputStream. +a GBufferedOutputStream.

auto_grow :

a gboolean. +a gboolean.
@@ -75,32 +45,32 @@ #include <gio/gio.h> GCancellable; -GCancellable * g_cancellable_new (void); -gboolean g_cancellable_is_cancelled (GCancellable *cancellable); -gboolean g_cancellable_set_error_if_cancelled - (GCancellable *cancellable, - GError **error); -int g_cancellable_get_fd (GCancellable *cancellable); -gboolean g_cancellable_make_pollfd (GCancellable *cancellable, - GPollFD *pollfd); -void g_cancellable_release_fd (GCancellable *cancellable); -GCancellable * g_cancellable_get_current (void); -void g_cancellable_pop_current (GCancellable *cancellable); -void g_cancellable_push_current (GCancellable *cancellable); -void g_cancellable_reset (GCancellable *cancellable); -gulong g_cancellable_connect (GCancellable *cancellable, - GCallback callback, - gpointer data, - GDestroyNotify data_destroy_func); -void g_cancellable_disconnect (GCancellable *cancellable, - gulong handler_id); -void g_cancellable_cancel (GCancellable *cancellable); +GCancellable * g_cancellable_new (void); +gboolean g_cancellable_is_cancelled (GCancellable *cancellable); +gboolean g_cancellable_set_error_if_cancelled + (GCancellable *cancellable, + GError **error); +int g_cancellable_get_fd (GCancellable *cancellable); +gboolean g_cancellable_make_pollfd (GCancellable *cancellable, + GPollFD *pollfd); +void g_cancellable_release_fd (GCancellable *cancellable); +GCancellable * g_cancellable_get_current (void); +void g_cancellable_pop_current (GCancellable *cancellable); +void g_cancellable_push_current (GCancellable *cancellable); +void g_cancellable_reset (GCancellable *cancellable); +gulong g_cancellable_connect (GCancellable *cancellable, + GCallback callback, + gpointer data, + GDestroyNotify data_destroy_func); +void g_cancellable_disconnect (GCancellable *cancellable, + gulong handler_id); +void g_cancellable_cancel (GCancellable *cancellable);

Object Hierarchy

-  GObject
+  GObject
    +----GCancellable
 
@@ -115,7 +85,8 @@

GCancellable is a thread-safe operation cancellation stack used throughout GIO to allow for cancellation of synchronous and -asynchronous operations.

+asynchronous operations. +

Details

@@ -123,12 +94,13 @@ asynchronous operations.

GCancellable

typedef struct _GCancellable GCancellable;

-Allows actions to be cancelled.

+Allows actions to be cancelled. +


g_cancellable_new ()

-
GCancellable *      g_cancellable_new                   (void);
+
GCancellable *      g_cancellable_new                   (void);

Creates a new GCancellable object.

@@ -139,7 +111,8 @@ and pass it to the operations.

One GCancellable can be used in multiple consecutive -operations, but not in multiple concurrent operations.

+operations, but not in multiple concurrent operations. +

@@ -152,21 +125,22 @@ operations, but not in multiple concurrent operations.


g_cancellable_is_cancelled ()

-
gboolean            g_cancellable_is_cancelled          (GCancellable *cancellable);
+
gboolean            g_cancellable_is_cancelled          (GCancellable *cancellable);

-Checks if a cancellable job has been cancelled.

+Checks if a cancellable job has been cancelled. +

- - @@ -175,28 +149,30 @@ FALSE if called with

g_cancellable_set_error_if_cancelled ()

-
gboolean            g_cancellable_set_error_if_cancelled
-                                                        (GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_cancellable_set_error_if_cancelled
+                                                        (GCancellable *cancellable,
+                                                         GError **error);

If the cancellable is cancelled, sets the error to notify -that the operation was cancelled.

+that the operation was cancelled. +

cancellable :

a GCancellable or NULL. +a GCancellable or NULL.

Returns :

TRUE if cancellable is cancelled, -FALSE if called with NULL or if item is not cancelled. + TRUE if cancellable is cancelled, +FALSE if called with NULL or if item is not cancelled.
- - - @@ -205,7 +181,7 @@ that the operation was cancelled.


g_cancellable_get_fd ()

-
int                 g_cancellable_get_fd                (GCancellable *cancellable);
+
int                 g_cancellable_get_fd                (GCancellable *cancellable);

Gets the file descriptor for a cancellable job. This can be used to implement cancellable operations on Unix systems. The returned fd will @@ -222,13 +198,14 @@ After a successful return from this function, you should use the returned file descriptor.

-See also g_cancellable_make_pollfd().

+See also g_cancellable_make_pollfd(). +

cancellable :

a GCancellable object. +a GCancellable object.

error :

GError to append error state to. + +GError to append error state to.

Returns :

TRUE if cancellable was cancelled, FALSE if it was not. + TRUE if cancellable was cancelled, FALSE if it was not.
- @@ -243,21 +220,21 @@ is not supported, or on errors.

g_cancellable_make_pollfd ()

-
gboolean            g_cancellable_make_pollfd           (GCancellable *cancellable,
-                                                         GPollFD *pollfd);
+
gboolean            g_cancellable_make_pollfd           (GCancellable *cancellable,
+                                                         GPollFD *pollfd);

-Creates a GPollFD corresponding to cancellable; this can be passed -to g_poll() and used to poll for cancellation. This is useful both +Creates a GPollFD corresponding to cancellable; this can be passed +to g_poll() and used to poll for cancellation. This is useful both for unix systems without a native poll and for portability to windows.

-When this function returns TRUE, you should use +When this function returns TRUE, you should use g_cancellable_release_fd() to free up resources allocated for the -pollfd. After a FALSE return, do not call g_cancellable_release_fd(). +pollfd. After a FALSE return, do not call g_cancellable_release_fd().

-If this function returns FALSE, either no cancellable was given or +If this function returns FALSE, either no cancellable was given or resource limits prevent this function from allocating the necessary structures for polling. (On Linux, you will likely have reached the maximum number of file descriptors.) The suggested way to handle @@ -266,23 +243,24 @@ these cases is to ignore the cancellable

You are not supposed to read from the fd yourself, just check for readable status. Reading to unset the readable status is done -with g_cancellable_reset().

+with g_cancellable_reset(). +

cancellable :

a GCancellable. +a GCancellable.
- - - @@ -294,7 +272,7 @@ with

g_cancellable_release_fd ()

-
void                g_cancellable_release_fd            (GCancellable *cancellable);
+
void                g_cancellable_release_fd            (GCancellable *cancellable);

Releases a resources previously allocated by g_cancellable_get_fd() or g_cancellable_make_pollfd(). @@ -305,12 +283,13 @@ is not strictly required, the resources will be automatically freed when the cancellable is finalized. However, the cancellable will block scarce file descriptors until it is finalized if this function is not called. This can cause the application to run out of file -descriptors when many GCancellables are used at the same time.

+descriptors when many GCancellables are used at the same time. +

cancellable :

a GCancellable or NULL +a GCancellable or NULL

pollfd :

a pointer to a GPollFD +a pointer to a GPollFD

Returns :

TRUE if pollfd was successfully initialized, FALSE on + TRUE if pollfd was successfully initialized, FALSE on failure to prepare the cancellable.
-

cancellable :

a GCancellable +a GCancellable
@@ -319,14 +298,15 @@ descriptors when many GCancellabl

g_cancellable_get_current ()

-
GCancellable *      g_cancellable_get_current           (void);
+
GCancellable *      g_cancellable_get_current           (void);

-Gets the top cancellable from the stack.

+Gets the top cancellable from the stack. +

- @@ -335,15 +315,16 @@ if the stack is empty.

g_cancellable_pop_current ()

-
void                g_cancellable_pop_current           (GCancellable *cancellable);
+
void                g_cancellable_pop_current           (GCancellable *cancellable);

Pops cancellable off the cancellable stack (verifying that cancellable -is on the top of the stack).

+is on the top of the stack). +

Returns :

a GCancellable from the top of the stack, or NULL + a GCancellable from the top of the stack, or NULL if the stack is empty.
-

cancellable :

a GCancellable object +a GCancellable object
@@ -351,7 +332,7 @@ is on the top of the stack).


g_cancellable_push_current ()

-
void                g_cancellable_push_current          (GCancellable *cancellable);
+
void                g_cancellable_push_current          (GCancellable *cancellable);

Pushes cancellable onto the cancellable stack. The current cancllable can then be recieved using g_cancellable_get_current(). @@ -362,12 +343,13 @@ code that does not allow you to pass down the cancellable object.

This is typically called automatically by e.g. GFile operations, -so you rarely have to call this yourself.

+so you rarely have to call this yourself. +

-

cancellable :

a GCancellable object +a GCancellable object
@@ -375,14 +357,15 @@ so you rarely have to call this yourself.


g_cancellable_reset ()

-
void                g_cancellable_reset                 (GCancellable *cancellable);
+
void                g_cancellable_reset                 (GCancellable *cancellable);

-Resets cancellable to its uncancelled state.

+Resets cancellable to its uncancelled state. +

-

cancellable :

a GCancellable object. +a GCancellable object.
@@ -390,10 +373,10 @@ Resets cancellable to its uncancelled st

g_cancellable_connect ()

-
gulong              g_cancellable_connect               (GCancellable *cancellable,
-                                                         GCallback callback,
-                                                         gpointer data,
-                                                         GDestroyNotify data_destroy_func);
+
gulong              g_cancellable_connect               (GCancellable *cancellable,
+                                                         GCallback callback,
+                                                         gpointer data,
+                                                         GDestroyNotify data_destroy_func);

Convenience function to connect to the "cancelled" signal. Also handles the race condition that may happen @@ -410,28 +393,29 @@ disconnected, or immediately if the cancellable is already cancelled.

-See "cancelled" for details on how to use this.

+See "cancelled" for details on how to use this. +

- - - - @@ -448,11 +432,11 @@ See "cancelled" signal handler will therefore result in a @@ -465,19 +449,20 @@ signal handler is removed. See cancellable is NULL or handler_id is 0 this function does -nothing.

+If cancellable is NULL or handler_id is 0 this function does +nothing. +

cancellable :

A GCancellable. +A GCancellable.

callback :

The GCallback to connect. +The GCallback to connect.

data :

Data to pass to callback. +Data to pass to callback.

data_destroy_func :

Free function for data or NULL. +Free function for data or NULL.
- - @@ -487,7 +472,7 @@ nothing.


g_cancellable_cancel ()

-
void                g_cancellable_cancel                (GCancellable *cancellable);
+
void                g_cancellable_cancel                (GCancellable *cancellable);

Will set cancellable to cancelled, and will emit the "cancelled" signal. (However, see the warning about @@ -504,12 +489,13 @@ The convention within gio is that cancelling an asynchronous operation causes it to complete asynchronously. That is, if you cancel the operation from the same thread in which it is running, then the operation's GAsyncReadyCallback will not be invoked until -the application returns to the main loop.

+the application returns to the main loop. +

cancellable :

A GCancellable or NULL. +A GCancellable or NULL.

handler_id :

Handler id of the handler to be disconnected, or 0. +Handler id of the handler to be disconnected, or 0.
-

cancellable :

a GCancellable object. +a GCancellable object.
@@ -520,7 +506,7 @@ the application returns to the main loop.

The "cancelled" signal

void                user_function                      (GCancellable *cancellable,
-                                                        gpointer      user_data)        : Run Last
+ gpointer user_data) : Run Last

Emitted when the operation has been cancelled.

@@ -535,7 +521,7 @@ Note that disconnecting from this signal (or any signal) in a multi-threaded program is prone to race conditions. For instance it is possible that a signal handler may be invoked even after a call to -g_signal_handler_disconnect() for that handler has already +g_signal_handler_disconnect() for that handler has already returned.

@@ -554,40 +540,68 @@ like this.

An example of how to us this:

-
-    /* Make sure we don't do any unnecessary work if already cancelled */
-    if (g_cancellable_set_error_if_cancelled (cancellable))
-      return;
-    /* Set up all the data needed to be able to
-     * handle cancellation of the operation */
-    my_data = my_data_new (...);
+
+ + + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
/* Make sure we don't do any unnecessary work if already cancelled */
+if (g_cancellable_set_error_if_cancelled (cancellable))
+  return;
+/* Set up all the data needed to be able to
+ * handle cancellation of the operation */
+my_data = my_data_new (...);
+
+id = 0;
+if (cancellable)
+  id = g_cancellable_connect (cancellable,
+                  G_CALLBACK (cancelled_handler)
+                  data, NULL);
 
-    id = 0;
-    if (cancellable)
-      id = g_cancellable_connect (cancellable,
-    			      G_CALLBACK (cancelled_handler)
-    			      data, NULL);
+/* cancellable operation here... */
 
-    /* cancellable operation here... */
+g_cancellable_disconnect (cancellable, id);
 
-    g_cancellable_disconnect (cancellable, id);
+/* cancelled_handler is never called after this, it
+ * is now safe to free the data */
+my_data_free (my_data);
+
- /* cancelled_handler is never called after this, it - * is now safe to free the data */ - my_data_free (my_data); -

Note that the cancelled signal is emitted in the thread that the user cancelled from, which may be the main thread. So, the -cancellable signal should not do something that can block.

+cancellable signal should not do something that can block. +

- @@ -601,6 +615,6 @@ cancellable signal should not do something that can block.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GCharsetConverter.html b/docs/reference/gio/html/GCharsetConverter.html index f6058e0..2d40a11 100644 --- a/docs/reference/gio/html/GCharsetConverter.html +++ b/docs/reference/gio/html/GCharsetConverter.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

cancellable :

a GCancellable. +a GCancellable.
@@ -77,22 +47,22 @@ #include <gio/gio.h> GCharsetConverter; -GCharsetConverter * g_charset_converter_new (const gchar *to_charset, - const gchar *from_charset, - GError **error); +GCharsetConverter * g_charset_converter_new (const gchar *to_charset, + const gchar *from_charset, + GError **error); voidg_charset_converter_set_use_fallback - (GCharsetConverter *converter, - gboolean use_fallback); -gbooleang_charset_converter_get_use_fallback - (GCharsetConverter *converter); -guintg_charset_converter_get_num_fallbacks - (GCharsetConverter *converter); + (GCharsetConverter *converter, + gboolean use_fallback); +gbooleang_charset_converter_get_use_fallback + (GCharsetConverter *converter); +guintg_charset_converter_get_num_fallbacks + (GCharsetConverter *converter);

Object Hierarchy

-  GObject
+  GObject
    +----GCharsetConverter
 
@@ -105,16 +75,17 @@ GCharsetConverter implements

Properties

-  "from-charset"             gchar*                : Read / Write / Construct Only
-  "to-charset"               gchar*                : Read / Write / Construct Only
-  "use-fallback"             gboolean              : Read / Write / Construct
+  "from-charset"             gchar*                : Read / Write / Construct Only
+  "to-charset"               gchar*                : Read / Write / Construct Only
+  "use-fallback"             gboolean              : Read / Write / Construct
 

Description

GCharsetConverter is an implementation of GConverter based on -GIConv.

+GIConv. +

Details

@@ -122,37 +93,40 @@ GIConv.

GCharsetConverter

typedef struct _GCharsetConverter GCharsetConverter;

-Conversions between character sets.

+Conversions between character sets. +


g_charset_converter_new ()

-
GCharsetConverter * g_charset_converter_new             (const gchar *to_charset,
-                                                         const gchar *from_charset,
-                                                         GError **error);
+
GCharsetConverter * g_charset_converter_new             (const gchar *to_charset,
+                                                         const gchar *from_charset,
+                                                         GError **error);

-Creates a new GCharsetConverter.

+Creates a new GCharsetConverter. +

- - - - @@ -164,21 +138,23 @@ Creates a new

g_charset_converter_set_use_fallback ()

void                g_charset_converter_set_use_fallback
-                                                        (GCharsetConverter *converter,
-                                                         gboolean use_fallback);
+ (GCharsetConverter *converter, + gboolean use_fallback);

-Sets the "use-fallback" property.

+Sets the "use-fallback" property. +

to_charset :

destination charset +destination charset

from_charset :

source charset +source charset

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a new GCharsetConverter or NULL on error. + a new GCharsetConverter or NULL on error.
- - @@ -188,21 +164,22 @@ Sets the

g_charset_converter_get_use_fallback ()

-
gboolean            g_charset_converter_get_use_fallback
-                                                        (GCharsetConverter *converter);
+
gboolean            g_charset_converter_get_use_fallback
+                                                        (GCharsetConverter *converter);

-Gets the "use-fallback" property.

+Gets the "use-fallback" property. +

converter :

a GCharsetConverter +a GCharsetConverter

use_fallback :

TRUE to use fallbacks + +TRUE to use fallbacks
- - @@ -213,16 +190,17 @@ Gets the

g_charset_converter_get_num_fallbacks ()

-
guint               g_charset_converter_get_num_fallbacks
-                                                        (GCharsetConverter *converter);
+
guint               g_charset_converter_get_num_fallbacks
+                                                        (GCharsetConverter *converter);

-Gets the number of fallbacks that converter has applied so far.

+Gets the number of fallbacks that converter has applied so far. +

converter :

a GCharsetConverter +a GCharsetConverter

Returns :

TRUE if fallbacks are used by converter + TRUE if fallbacks are used by converter
- @@ -240,21 +218,21 @@ Gets the number of fallbacks that converter

Property Details

The "from-charset" property

-
  "from-charset"             gchar*                : Read / Write / Construct Only
+
  "from-charset"             gchar*                : Read / Write / Construct Only

The character encoding to convert from.

Default value: NULL


The "to-charset" property

-
  "to-charset"               gchar*                : Read / Write / Construct Only
+
  "to-charset"               gchar*                : Read / Write / Construct Only

The character encoding to convert to.

Default value: NULL


The "use-fallback" property

-
  "use-fallback"             gboolean              : Read / Write / Construct
+
  "use-fallback"             gboolean              : Read / Write / Construct

Use fallback (of form \<hexval>) for invalid bytes.

Default value: FALSE

@@ -262,6 +240,6 @@ Gets the number of fallbacks that converter + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GConverter.html b/docs/reference/gio/html/GConverter.html index 3f381d8..8395f87 100644 --- a/docs/reference/gio/html/GConverter.html +++ b/docs/reference/gio/html/GConverter.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

converter :

a GCharsetConverter +a GCharsetConverter
@@ -79,16 +49,16 @@ GConverter; GConverterIface; enum GConverterResult; -GConverterResult g_converter_convert (GConverter *converter, - const void *inbuf, - gsize inbuf_size, - void *outbuf, - gsize outbuf_size, - GConverterFlags flags, - gsize *bytes_read, - gsize *bytes_written, - GError **error); -void g_converter_reset (GConverter *converter); +GConverterResult g_converter_convert (GConverter *converter, + const void *inbuf, + gsize inbuf_size, + void *outbuf, + gsize outbuf_size, + GConverterFlags flags, + gsize *bytes_read, + gsize *bytes_written, + GError **error); +void g_converter_reset (GConverter *converter);
@@ -102,13 +72,13 @@ enum

Prerequisites

GConverter requires - GObject.

+ GObject.

Known Implementations

GConverter is implemented by - GZlibCompressor, GCharsetConverter and GZlibDecompressor.

+ GCharsetConverter, GZlibCompressor and GZlibDecompressor.

Description

@@ -120,7 +90,8 @@ stateful and may fail at any place.

Some example conversions are: character set conversion, compression, decompression and regular expression -replace.

+replace. +

Details

@@ -128,7 +99,8 @@ replace.

GConverter

typedef struct _GConverter GConverter;

-Seek object for streaming operations.

+Seek object for streaming operations. +

Since 2.24


@@ -154,23 +126,24 @@ Seek object for streaming operations.

Provides an interface for converting data from one type to another type. The conversion can be stateful -and may fail at any place.

+and may fail at any place. +

- - + - - @@ -188,28 +161,29 @@ and may fail at any place.

} GConverterResult;

-Results returned from g_converter_convert().

+Results returned from g_converter_convert(). +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

convert ()

Converts data. +Converts data.

reset ()

Reverts the internal state of the converter to its initial state. +Reverts the internal state of the converter to its initial state.
- - - - @@ -219,15 +193,15 @@ Results returned from

g_converter_convert ()

-
GConverterResult    g_converter_convert                 (GConverter *converter,
-                                                         const void *inbuf,
-                                                         gsize inbuf_size,
-                                                         void *outbuf,
-                                                         gsize outbuf_size,
-                                                         GConverterFlags flags,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
+
GConverterResult    g_converter_convert                 (GConverter *converter,
+                                                         const void *inbuf,
+                                                         gsize inbuf_size,
+                                                         void *outbuf,
+                                                         gsize outbuf_size,
+                                                         GConverterFlags flags,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);

This is the main operation used when converting data. It is to be called multiple times in a loop, and each time it will do some work, i.e. @@ -322,53 +296,54 @@ treat this as the end of input and do the match. Flushing is not always possible (like if a charset converter flushes at a partial multibyte sequence). Converters are supposed to try to produce as much output as possible and then return an error -(typically G_IO_ERROR_PARTIAL_INPUT).

+(typically G_IO_ERROR_PARTIAL_INPUT). +

G_CONVERTER_ERROR

There was an error during conversion. +There was an error during conversion.

G_CONVERTER_CONVERTED

Some data was consumed or produced +Some data was consumed or produced

G_CONVERTER_FINISHED

The conversion is finished +The conversion is finished

G_CONVERTER_FLUSHED

Flushing is finished +Flushing is finished
- - - - - - - - - @@ -384,16 +359,17 @@ to produce as much output as possible and then return an error

g_converter_reset ()

-
void                g_converter_reset                   (GConverter *converter);
+
void                g_converter_reset                   (GConverter *converter);

Resets all internal state in the converter, making it behave as if it was just created. If the converter has any internal -state that would produce output then that output is lost.

+state that would produce output then that output is lost. +

converter :

a GConverter. +a GConverter.

inbuf :

the buffer containing the data to convert. +the buffer containing the data to convert.

inbuf_size :

the number of bytes in inbuf +the number of bytes in inbuf

outbuf :

a buffer to write converted data in. +a buffer to write converted data in.

outbuf_size :

the number of bytes in outbuf, must be at least one +the number of bytes in outbuf, must be at least one

flags :

a GConvertFlags controlling the conversion details +a GConvertFlags controlling the conversion details

bytes_read :

will be set to the number of bytes read from inbuf on success +will be set to the number of bytes read from inbuf on success

bytes_written :

will be set to the number of bytes written to outbuf on success +will be set to the number of bytes written to outbuf on success

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore
-

converter :

a GConverter. +a GConverter.
@@ -407,6 +383,6 @@ state that would produce output then that output is lost.

+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/GDataInputStream.html b/docs/reference/gio/html/GDataInputStream.html index b2462ed..3625f33 100644 --- a/docs/reference/gio/html/GDataInputStream.html +++ b/docs/reference/gio/html/GDataInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -77,74 +47,74 @@ GDataInputStream; enum GDataStreamByteOrder; enum GDataStreamNewlineType; -GDataInputStream * g_data_input_stream_new (GInputStream *base_stream); -voidg_data_input_stream_set_byte_order (GDataInputStream *stream, - GDataStreamByteOrder order); +GDataInputStream * g_data_input_stream_new (GInputStream *base_stream); +voidg_data_input_stream_set_byte_order (GDataInputStream *stream, + GDataStreamByteOrder order); GDataStreamByteOrderg_data_input_stream_get_byte_order - (GDataInputStream *stream); + (GDataInputStream *stream); voidg_data_input_stream_set_newline_type - (GDataInputStream *stream, - GDataStreamNewlineType type); + (GDataInputStream *stream, + GDataStreamNewlineType type); GDataStreamNewlineTypeg_data_input_stream_get_newline_type - (GDataInputStream *stream); -gucharg_data_input_stream_read_byte (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -gint16g_data_input_stream_read_int16 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -guint16g_data_input_stream_read_uint16 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -gint32g_data_input_stream_read_int32 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -guint32g_data_input_stream_read_uint32 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -gint64g_data_input_stream_read_int64 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -guint64g_data_input_stream_read_uint64 (GDataInputStream *stream, - GCancellable *cancellable, - GError **error); -char * g_data_input_stream_read_line (GDataInputStream *stream, - gsize *length, - GCancellable *cancellable, - GError **error); -voidg_data_input_stream_read_line_async (GDataInputStream *stream, - gint io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GDataInputStream *stream); +gucharg_data_input_stream_read_byte (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +gint16g_data_input_stream_read_int16 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +guint16g_data_input_stream_read_uint16 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +gint32g_data_input_stream_read_int32 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +guint32g_data_input_stream_read_uint32 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +gint64g_data_input_stream_read_int64 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +guint64g_data_input_stream_read_uint64 (GDataInputStream *stream, + GCancellable *cancellable, + GError **error); +char * g_data_input_stream_read_line (GDataInputStream *stream, + gsize *length, + GCancellable *cancellable, + GError **error); +voidg_data_input_stream_read_line_async (GDataInputStream *stream, + gint io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); char * g_data_input_stream_read_line_finish - (GDataInputStream *stream, - GAsyncResult *result, - gsize *length, - GError **error); -char * g_data_input_stream_read_until (GDataInputStream *stream, - const gchar *stop_chars, - gsize *length, - GCancellable *cancellable, - GError **error); + (GDataInputStream *stream, + GAsyncResult *result, + gsize *length, + GError **error); +char * g_data_input_stream_read_until (GDataInputStream *stream, + const gchar *stop_chars, + gsize *length, + GCancellable *cancellable, + GError **error); voidg_data_input_stream_read_until_async - (GDataInputStream *stream, - const gchar *stop_chars, - gint io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GDataInputStream *stream, + const gchar *stop_chars, + gint io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); char * g_data_input_stream_read_until_finish - (GDataInputStream *stream, - GAsyncResult *result, - gsize *length, - GError **error); + (GDataInputStream *stream, + GAsyncResult *result, + gsize *length, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFilterInputStream
                +----GBufferedInputStream
@@ -162,7 +132,8 @@ enum                

Description

Data input stream implements GInputStream and includes functions for -reading structured data directly from a binary input stream.

+reading structured data directly from a binary input stream. +

Details

@@ -171,7 +142,8 @@ reading structured data directly from a binary input stream.

typedef struct _GDataInputStream GDataInputStream;

An implementation of GBufferedInputStream that allows for high-level -data manipulation of arbitrary data (including binary operations).

+data manipulation of arbitrary data (including binary operations). +

@@ -188,23 +160,24 @@ data manipulation of arbitrary data (including binary operations).

GDataStreamByteOrder is used to ensure proper endianness of streaming data sources -across various machine architectures.

+across various machine architectures. +

- - - @@ -221,28 +194,29 @@ across various machine architectures.

} GDataStreamNewlineType;

-GDataStreamNewlineType is used when checking for or setting the line endings for a given file.

+GDataStreamNewlineType is used when checking for or setting the line endings for a given file. +

G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN

Selects Big Endian byte order. +Selects Big Endian byte order.

G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN

Selects Little Endian byte order. +Selects Little Endian byte order.

G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN

Selects endianness based on host machine's architecture. +Selects endianness based on host machine's architecture.
- - - - @@ -251,15 +225,16 @@ across various machine architectures.


g_data_input_stream_new ()

-
GDataInputStream *  g_data_input_stream_new             (GInputStream *base_stream);
+
GDataInputStream *  g_data_input_stream_new             (GInputStream *base_stream);

-Creates a new data input stream for the base_stream.

+Creates a new data input stream for the base_stream. +

G_DATA_STREAM_NEWLINE_TYPE_LF

Selects "LF" line endings, common on most modern UNIX platforms. +Selects "LF" line endings, common on most modern UNIX platforms.

G_DATA_STREAM_NEWLINE_TYPE_CR

Selects "CR" line endings. +Selects "CR" line endings.

G_DATA_STREAM_NEWLINE_TYPE_CR_LF

Selects "CR, LF" line ending, common on Microsoft Windows. +Selects "CR, LF" line ending, common on Microsoft Windows.

G_DATA_STREAM_NEWLINE_TYPE_ANY

Automatically try to handle any line ending type. +Automatically try to handle any line ending type.
- @@ -273,22 +248,23 @@ Creates a new data input stream for the base_stream<

g_data_input_stream_set_byte_order ()

-
void                g_data_input_stream_set_byte_order  (GDataInputStream *stream,
-                                                         GDataStreamByteOrder order);
+
void                g_data_input_stream_set_byte_order  (GDataInputStream *stream,
+                                                         GDataStreamByteOrder order);

This function sets the byte order for the given stream. All subsequent -reads from the stream will be read in the given order.

+reads from the stream will be read in the given order. +

base_stream :

a GInputStream. +a GInputStream.
- - @@ -298,15 +274,16 @@ reads from the stream will be read in th

g_data_input_stream_get_byte_order ()

GDataStreamByteOrder  g_data_input_stream_get_byte_order
-                                                        (GDataInputStream *stream);
+ (GDataInputStream *stream);

-Gets the byte order for the data input stream.

+Gets the byte order for the data input stream. +

stream :

a given GDataInputStream. +a given GDataInputStream.

order :

a GDataStreamByteOrder to set. +a GDataStreamByteOrder to set.
- @@ -321,26 +298,27 @@ Gets the byte order for the data input stream.

g_data_input_stream_set_newline_type ()

void                g_data_input_stream_set_newline_type
-                                                        (GDataInputStream *stream,
-                                                         GDataStreamNewlineType type);
+ (GDataInputStream *stream, + GDataStreamNewlineType type);

Sets the newline type for the stream.

Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read chunk ends in "CR" we must read an additional byte to know if this is "CR" or -"CR LF", and this might block if there is no more data availible.

+"CR LF", and this might block if there is no more data availible. +

stream :

a given GDataInputStream. +a given GDataInputStream.
- - @@ -350,15 +328,16 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or

g_data_input_stream_get_newline_type ()

GDataStreamNewlineType  g_data_input_stream_get_newline_type
-                                                        (GDataInputStream *stream);
+ (GDataInputStream *stream);

-Gets the current newline type for the stream.

+Gets the current newline type for the stream. +

stream :

a GDataInputStream. +a GDataInputStream.

type :

the type of new line return as GDataStreamNewlineType. +the type of new line return as GDataStreamNewlineType.
- @@ -372,27 +351,29 @@ Gets the current newline type for the stream<

g_data_input_stream_read_byte ()

-
guchar              g_data_input_stream_read_byte       (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
guchar              g_data_input_stream_read_byte       (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Reads an unsigned 8-bit/1-byte value from stream.

+Reads an unsigned 8-bit/1-byte value from stream. +

stream :

a given GDataInputStream. +a given GDataInputStream.
- - - @@ -407,31 +388,33 @@ if an error occurred.

g_data_input_stream_read_int16 ()

-
gint16              g_data_input_stream_read_int16      (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gint16              g_data_input_stream_read_int16      (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads a 16-bit/2-byte value from stream.

In order to get the correct byte order for this read operation, -see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().

+see g_data_stream_get_byte_order() and g_data_stream_set_byte_order(). +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -446,31 +429,33 @@ an error occurred.

g_data_input_stream_read_uint16 ()

-
guint16             g_data_input_stream_read_uint16     (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
guint16             g_data_input_stream_read_uint16     (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads an unsigned 16-bit/2-byte value from stream.

In order to get the correct byte order for this read operation, -see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().

+see g_data_stream_get_byte_order() and g_data_stream_set_byte_order(). +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -485,9 +470,9 @@ an error occurred.

g_data_input_stream_read_int32 ()

-
gint32              g_data_input_stream_read_int32      (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gint32              g_data_input_stream_read_int32      (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads a signed 32-bit/4-byte value from stream.

@@ -496,25 +481,27 @@ In order to get the correct byte order for this read operation, see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -529,9 +516,9 @@ an error occurred.

g_data_input_stream_read_uint32 ()

-
guint32             g_data_input_stream_read_uint32     (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
guint32             g_data_input_stream_read_uint32     (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads an unsigned 32-bit/4-byte value from stream.

@@ -540,25 +527,27 @@ In order to get the correct byte order for this read operation, see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -573,9 +562,9 @@ an error occurred.

g_data_input_stream_read_int64 ()

-
gint64              g_data_input_stream_read_int64      (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gint64              g_data_input_stream_read_int64      (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads a 64-bit/8-byte value from stream.

@@ -584,25 +573,27 @@ In order to get the correct byte order for this read operation, see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -617,9 +608,9 @@ an error occurred.

g_data_input_stream_read_uint64 ()

-
guint64             g_data_input_stream_read_uint64     (GDataInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
guint64             g_data_input_stream_read_uint64     (GDataInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads an unsigned 64-bit/8-byte value from stream.

@@ -628,25 +619,27 @@ In order to get the correct byte order for this read operation, see g_data_stream_get_byte_order().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - @@ -661,46 +654,48 @@ an error occurred.

g_data_input_stream_read_line ()

-
char *              g_data_input_stream_read_line       (GDataInputStream *stream,
-                                                         gsize *length,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
char *              g_data_input_stream_read_line       (GDataInputStream *stream,
+                                                         gsize *length,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads a line from the data input stream.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a given GDataInputStream. +a given GDataInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.
- - - - @@ -709,11 +704,11 @@ was cancelled, the error

g_data_input_stream_read_line_async ()

-
void                g_data_input_stream_read_line_async (GDataInputStream *stream,
-                                                         gint io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_data_input_stream_read_line_async (GDataInputStream *stream,
+                                                         gint io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

The asynchronous version of g_data_input_stream_read_line(). It is an error to have two outstanding calls to this function. @@ -721,34 +716,35 @@ an error to have two outstanding calls to this function.

When the operation is finished, callback will be called. You can then call g_data_input_stream_read_line_finish() to get -the result of the operation.

+the result of the operation. +

stream :

a given GDataInputStream. +a given GDataInputStream.

length :

a gsize to get the length of the data read in. +a gsize to get the length of the data read in.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.

Returns :

a string with the line that was read in (without the newlines). - Set length to a gsize to get the length of the read line. - On an error, it will return NULL and error will be set. If there's no - content to read, it will still return NULL, but error won't be set. + Set length to a gsize to get the length of the read line. + On an error, it will return NULL and error will be set. If there's no + content to read, it will still return NULL, but error won't be set.
- - - - - @@ -759,42 +755,44 @@ the result of the operation.

g_data_input_stream_read_line_finish ()

char *              g_data_input_stream_read_line_finish
-                                                        (GDataInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         gsize *length,
-                                                         GError **error);
+ (GDataInputStream *stream, + GAsyncResult *result, + gsize *length, + GError **error);

Finish an asynchronous call started by -g_data_input_stream_read_line_async().

+g_data_input_stream_read_line_async(). +

stream :

a given GDataInputStream. +a given GDataInputStream.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied. +callback to call when the request is satisfied.

user_data :

the data to pass to callback function. +the data to pass to callback function.
- - - - @@ -805,51 +803,53 @@ Finish an asynchronous call started by

g_data_input_stream_read_until ()

-
char *              g_data_input_stream_read_until      (GDataInputStream *stream,
-                                                         const gchar *stop_chars,
-                                                         gsize *length,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
char *              g_data_input_stream_read_until      (GDataInputStream *stream,
+                                                         const gchar *stop_chars,
+                                                         gsize *length,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Reads a string from the data input stream, up to the first occurrence of any of the stop characters.

Note that, in contrast to g_data_input_stream_read_until_async(), -this function consumes the stop character that it finds.

+this function consumes the stop character that it finds. +

stream :

a given GDataInputStream. +a given GDataInputStream.

result :

the GAsyncResult that was provided to the callback. +the GAsyncResult that was provided to the callback.

length :

a gsize to get the length of the data read in. +a gsize to get the length of the data read in.

error :

GError for error reporting. + +GError for error reporting.

Returns :

a string with the line that was read in (without the newlines). - Set length to a gsize to get the length of the read line. - On an error, it will return NULL and error will be set. If there's no - content to read, it will still return NULL, but error won't be set. + Set length to a gsize to get the length of the read line. + On an error, it will return NULL and error will be set. If there's no + content to read, it will still return NULL, but error won't be set.
- - - - - @@ -859,12 +859,12 @@ this function consumes the stop character that it finds.

g_data_input_stream_read_until_async ()

void                g_data_input_stream_read_until_async
-                                                        (GDataInputStream *stream,
-                                                         const gchar *stop_chars,
-                                                         gint io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GDataInputStream *stream, + const gchar *stop_chars, + gint io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

The asynchronous version of g_data_input_stream_read_until(). It is an error to have two outstanding calls to this function. @@ -877,39 +877,40 @@ must read it for yourself.

When the operation is finished, callback will be called. You can then call g_data_input_stream_read_until_finish() to get -the result of the operation.

+the result of the operation. +

stream :

a given GDataInputStream. +a given GDataInputStream.

stop_chars :

characters to terminate the read. +characters to terminate the read.

length :

a gsize to get the length of the data read in. +a gsize to get the length of the data read in.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.

Returns :

a string with the data that was read before encountering - any of the stop characters. Set length to a gsize to get the length - of the string. This function will return NULL on an error. + any of the stop characters. Set length to a gsize to get the length + of the string. This function will return NULL on an error.
- - - - - - @@ -920,41 +921,43 @@ the result of the operation.

g_data_input_stream_read_until_finish ()

char *              g_data_input_stream_read_until_finish
-                                                        (GDataInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         gsize *length,
-                                                         GError **error);
+ (GDataInputStream *stream, + GAsyncResult *result, + gsize *length, + GError **error);

Finish an asynchronous call started by -g_data_input_stream_read_until_async().

+g_data_input_stream_read_until_async(). +

stream :

a given GDataInputStream. +a given GDataInputStream.

stop_chars :

characters to terminate the read. +characters to terminate the read.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied. +callback to call when the request is satisfied.

user_data :

the data to pass to callback function. +the data to pass to callback function.
- - - - @@ -985,6 +988,6 @@ Finish an asynchronous call started by + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GDataOutputStream.html b/docs/reference/gio/html/GDataOutputStream.html index 52ea6c6..3821784 100644 --- a/docs/reference/gio/html/GDataOutputStream.html +++ b/docs/reference/gio/html/GDataOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a given GDataInputStream. +a given GDataInputStream.

result :

the GAsyncResult that was provided to the callback. +the GAsyncResult that was provided to the callback.

length :

a gsize to get the length of the data read in. +a gsize to get the length of the data read in.

error :

GError for error reporting. + +GError for error reporting.

Returns :

a string with the data that was read before encountering - any of the stop characters. Set length to a gsize to get the length - of the string. This function will return NULL on an error. + any of the stop characters. Set length to a gsize to get the length + of the string. This function will return NULL on an error.
@@ -75,49 +45,49 @@ #include <gio/gio.h> GDataOutputStream; -GDataOutputStream * g_data_output_stream_new (GOutputStream *base_stream); -void g_data_output_stream_set_byte_order (GDataOutputStream *stream, - GDataStreamByteOrder order); +GDataOutputStream * g_data_output_stream_new (GOutputStream *base_stream); +void g_data_output_stream_set_byte_order (GDataOutputStream *stream, + GDataStreamByteOrder order); GDataStreamByteOrder g_data_output_stream_get_byte_order - (GDataOutputStream *stream); -gboolean g_data_output_stream_put_byte (GDataOutputStream *stream, - guchar data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_int16 (GDataOutputStream *stream, - gint16 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_uint16 (GDataOutputStream *stream, - guint16 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_int32 (GDataOutputStream *stream, - gint32 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_uint32 (GDataOutputStream *stream, - guint32 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_int64 (GDataOutputStream *stream, - gint64 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_uint64 (GDataOutputStream *stream, - guint64 data, - GCancellable *cancellable, - GError **error); -gboolean g_data_output_stream_put_string (GDataOutputStream *stream, - const char *str, - GCancellable *cancellable, - GError **error); + (GDataOutputStream *stream); +gboolean g_data_output_stream_put_byte (GDataOutputStream *stream, + guchar data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_int16 (GDataOutputStream *stream, + gint16 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_uint16 (GDataOutputStream *stream, + guint16 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_int32 (GDataOutputStream *stream, + gint32 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_uint32 (GDataOutputStream *stream, + guint32 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_int64 (GDataOutputStream *stream, + gint64 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_uint64 (GDataOutputStream *stream, + guint64 data, + GCancellable *cancellable, + GError **error); +gboolean g_data_output_stream_put_string (GDataOutputStream *stream, + const char *str, + GCancellable *cancellable, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFilterOutputStream
                +----GDataOutputStream
@@ -133,7 +103,8 @@
 

Description

Data output stream implements GOutputStream and includes functions for -writing data directly to an output stream.

+writing data directly to an output stream. +

Details

@@ -142,7 +113,8 @@ writing data directly to an output stream.

typedef struct _GDataOutputStream GDataOutputStream;

An implementation of GBufferedOutputStream that allows for high-level -data manipulation of arbitrary data (including binary operations).

+data manipulation of arbitrary data (including binary operations). +

@@ -151,15 +123,16 @@ data manipulation of arbitrary data (including binary operations).


g_data_output_stream_new ()

-
GDataOutputStream * g_data_output_stream_new            (GOutputStream *base_stream);
+
GDataOutputStream * g_data_output_stream_new            (GOutputStream *base_stream);

-Creates a new data output stream for base_stream.

+Creates a new data output stream for base_stream. +

- @@ -173,21 +146,22 @@ Creates a new data output stream for base_stream

g_data_output_stream_set_byte_order ()

-
void                g_data_output_stream_set_byte_order (GDataOutputStream *stream,
-                                                         GDataStreamByteOrder order);
+
void                g_data_output_stream_set_byte_order (GDataOutputStream *stream,
+                                                         GDataStreamByteOrder order);

-Sets the byte order of the data output stream to order.

+Sets the byte order of the data output stream to order. +

base_stream :

a GOutputStream. +a GOutputStream.
- - @@ -197,15 +171,16 @@ Sets the byte order of the data output stream to ord

g_data_output_stream_get_byte_order ()

GDataStreamByteOrder  g_data_output_stream_get_byte_order
-                                                        (GDataOutputStream *stream);
+ (GDataOutputStream *stream);

-Gets the byte order for the stream.

+Gets the byte order for the stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

order :

a GDataStreamByteOrder. +a GDataStreamByteOrder.
- @@ -219,38 +194,39 @@ Gets the byte order for the stream.


g_data_output_stream_put_byte ()

-
gboolean            g_data_output_stream_put_byte       (GDataOutputStream *stream,
-                                                         guchar data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_byte       (GDataOutputStream *stream,
+                                                         guchar data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts a byte into the output stream.

+Puts a byte into the output stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.
- - - - - @@ -259,38 +235,39 @@ Puts a byte into the output stream.


g_data_output_stream_put_int16 ()

-
gboolean            g_data_output_stream_put_int16      (GDataOutputStream *stream,
-                                                         gint16 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_int16      (GDataOutputStream *stream,
+                                                         gint16 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts a signed 16-bit integer into the output stream.

+Puts a signed 16-bit integer into the output stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a guchar. +a guchar.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -299,38 +276,39 @@ Puts a signed 16-bit integer into the output stream.


g_data_output_stream_put_uint16 ()

-
gboolean            g_data_output_stream_put_uint16     (GDataOutputStream *stream,
-                                                         guint16 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_uint16     (GDataOutputStream *stream,
+                                                         guint16 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts an unsigned 16-bit integer into the output stream.

+Puts an unsigned 16-bit integer into the output stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a gint16. +a gint16.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -339,38 +317,39 @@ Puts an unsigned 16-bit integer into the output stream.


g_data_output_stream_put_int32 ()

-
gboolean            g_data_output_stream_put_int32      (GDataOutputStream *stream,
-                                                         gint32 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_int32      (GDataOutputStream *stream,
+                                                         gint32 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts a signed 32-bit integer into the output stream.

+Puts a signed 32-bit integer into the output stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a guint16. +a guint16.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -379,38 +358,39 @@ Puts a signed 32-bit integer into the output stream.


g_data_output_stream_put_uint32 ()

-
gboolean            g_data_output_stream_put_uint32     (GDataOutputStream *stream,
-                                                         guint32 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_uint32     (GDataOutputStream *stream,
+                                                         guint32 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts an unsigned 32-bit integer into the stream.

+Puts an unsigned 32-bit integer into the stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a gint32. +a gint32.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -419,38 +399,39 @@ Puts an unsigned 32-bit integer into the stream.


g_data_output_stream_put_int64 ()

-
gboolean            g_data_output_stream_put_int64      (GDataOutputStream *stream,
-                                                         gint64 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_int64      (GDataOutputStream *stream,
+                                                         gint64 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts a signed 64-bit integer into the stream.

+Puts a signed 64-bit integer into the stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a guint32. +a guint32.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -459,38 +440,39 @@ Puts a signed 64-bit integer into the stream.


g_data_output_stream_put_uint64 ()

-
gboolean            g_data_output_stream_put_uint64     (GDataOutputStream *stream,
-                                                         guint64 data,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_uint64     (GDataOutputStream *stream,
+                                                         guint64 data,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts an unsigned 64-bit integer into the stream.

+Puts an unsigned 64-bit integer into the stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a gint64. +a gint64.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -499,38 +481,39 @@ Puts an unsigned 64-bit integer into the stream.


g_data_output_stream_put_string ()

-
gboolean            g_data_output_stream_put_string     (GDataOutputStream *stream,
-                                                         const char *str,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_data_output_stream_put_string     (GDataOutputStream *stream,
+                                                         const char *str,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Puts a string into the output stream.

+Puts a string into the output stream. +

stream :

a GDataOutputStream. +a GDataOutputStream.

data :

a guint64. +a guint64.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if data was successfully added to the stream. + TRUE if data was successfully added to the stream.
- - - - - @@ -544,7 +527,8 @@ Puts a string into the output stream.

  "byte-order"               GDataStreamByteOrder  : Read / Write

Determines the byte ordering that is used when writing -multi-byte entities (such as integers) to the stream.

+multi-byte entities (such as integers) to the stream. +

Default value: G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN

@@ -555,6 +539,6 @@ multi-byte entities (such as integers) to the stream.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GDrive.html b/docs/reference/gio/html/GDrive.html index 3e8b8f6..4ffc5ff 100644 --- a/docs/reference/gio/html/GDrive.html +++ b/docs/reference/gio/html/GDrive.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GDataOutputStream. +a GDataOutputStream.

str :

a string. +a string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if string was successfully added to the stream. + TRUE if string was successfully added to the stream.
@@ -80,64 +50,64 @@ GDriveIface; enum GDriveStartFlags; enum GDriveStartStopType; -char * g_drive_get_name (GDrive *drive); -GIcon * g_drive_get_icon (GDrive *drive); -gboolean g_drive_has_volumes (GDrive *drive); -GList * g_drive_get_volumes (GDrive *drive); -gboolean g_drive_can_eject (GDrive *drive); -GDriveStartStopType g_drive_get_start_stop_type (GDrive *drive); -gboolean g_drive_can_start (GDrive *drive); -gboolean g_drive_can_start_degraded (GDrive *drive); -gboolean g_drive_can_stop (GDrive *drive); -gboolean g_drive_can_poll_for_media (GDrive *drive); -void g_drive_poll_for_media (GDrive *drive, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_drive_poll_for_media_finish (GDrive *drive, - GAsyncResult *result, - GError **error); -gboolean g_drive_has_media (GDrive *drive); -gboolean g_drive_is_media_check_automatic (GDrive *drive); -gboolean g_drive_is_media_removable (GDrive *drive); -void g_drive_eject (GDrive *drive, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_drive_eject_finish (GDrive *drive, - GAsyncResult *result, - GError **error); -void g_drive_eject_with_operation (GDrive *drive, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_drive_eject_with_operation_finish (GDrive *drive, - GAsyncResult *result, - GError **error); -void g_drive_start (GDrive *drive, - GDriveStartFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_drive_start_finish (GDrive *drive, - GAsyncResult *result, - GError **error); -void g_drive_stop (GDrive *drive, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_drive_stop_finish (GDrive *drive, - GAsyncResult *result, - GError **error); -char ** g_drive_enumerate_identifiers (GDrive *drive); -char * g_drive_get_identifier (GDrive *drive, - const char *kind); +char * g_drive_get_name (GDrive *drive); +GIcon * g_drive_get_icon (GDrive *drive); +gboolean g_drive_has_volumes (GDrive *drive); +GList * g_drive_get_volumes (GDrive *drive); +gboolean g_drive_can_eject (GDrive *drive); +GDriveStartStopType g_drive_get_start_stop_type (GDrive *drive); +gboolean g_drive_can_start (GDrive *drive); +gboolean g_drive_can_start_degraded (GDrive *drive); +gboolean g_drive_can_stop (GDrive *drive); +gboolean g_drive_can_poll_for_media (GDrive *drive); +void g_drive_poll_for_media (GDrive *drive, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_drive_poll_for_media_finish (GDrive *drive, + GAsyncResult *result, + GError **error); +gboolean g_drive_has_media (GDrive *drive); +gboolean g_drive_is_media_check_automatic (GDrive *drive); +gboolean g_drive_is_media_removable (GDrive *drive); +void g_drive_eject (GDrive *drive, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_drive_eject_finish (GDrive *drive, + GAsyncResult *result, + GError **error); +void g_drive_eject_with_operation (GDrive *drive, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_drive_eject_with_operation_finish (GDrive *drive, + GAsyncResult *result, + GError **error); +void g_drive_start (GDrive *drive, + GDriveStartFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_drive_start_finish (GDrive *drive, + GAsyncResult *result, + GError **error); +void g_drive_stop (GDrive *drive, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_drive_stop_finish (GDrive *drive, + GAsyncResult *result, + GError **error); +char ** g_drive_enumerate_identifiers (GDrive *drive); +char * g_drive_get_identifier (GDrive *drive, + const char *kind);
@@ -151,7 +121,7 @@ enum

Prerequisites

GDrive requires - GObject.

+ GObject.

Signals

@@ -194,7 +164,8 @@ file manager, use

For porting from GnomeVFS note that there is no equivalent of -GDrive in that API.

+GDrive in that API. +

Details

@@ -202,7 +173,8 @@ For porting from GnomeVFS note that there is no equivalent of

GDrive

typedef struct _GDrive GDrive;

-Opaque drive object.

+Opaque drive object. +


@@ -284,160 +256,161 @@ Opaque drive object.

} GDriveIface;

-Interface for creating GDrive implementations.

+Interface for creating GDrive implementations. +

- - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -451,12 +424,13 @@ Interface for creating

-Flags used when starting a drive.

+Flags used when starting a drive. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

changed ()

Signal emitted when the drive is changed. +Signal emitted when the drive is changed.

disconnected ()

The removed signal that is emitted when the GDrive have been disconnected. If the recipient is holding references to the object they should release them so the object can be finalized. +The removed signal that is emitted when the GDrive have been disconnected. If the recipient is holding references to the object they should release them so the object can be finalized.

eject_button ()

Signal emitted when the physical eject button (if any) of a drive have been pressed. +Signal emitted when the physical eject button (if any) of a drive have been pressed.

get_name ()

Returns the name for the given GDrive. +Returns the name for the given GDrive.

get_icon ()

Returns a GIcon for the given GDrive. +Returns a GIcon for the given GDrive.

has_volumes ()

Returns TRUE if the GDrive has mountable volumes. +Returns TRUE if the GDrive has mountable volumes.

get_volumes ()

Returns a list GList of GVolume for the GDrive. +Returns a list GList of GVolume for the GDrive.

is_media_removable ()

Returns TRUE if the GDrive supports removal and insertion of media. +Returns TRUE if the GDrive supports removal and insertion of media.

has_media ()

Returns TRUE if the GDrive has media inserted. +Returns TRUE if the GDrive has media inserted.

is_media_check_automatic ()

Returns TRUE if the GDrive is capabable of automatically detecting media changes. +Returns TRUE if the GDrive is capabable of automatically detecting media changes.

can_eject ()

Returns TRUE if the GDrive can eject media. +Returns TRUE if the GDrive can eject media.

can_poll_for_media ()

Returns TRUE if the GDrive is capable of manually polling for media change. +Returns TRUE if the GDrive is capable of manually polling for media change.

eject ()

Ejects a GDrive. +Ejects a GDrive.

eject_finish ()

Finishes an eject operation. +Finishes an eject operation.

poll_for_media ()

Poll for media insertion/removal on a GDrive. +Poll for media insertion/removal on a GDrive.

poll_for_media_finish ()

Finishes a media poll operation. +Finishes a media poll operation.

get_identifier ()

Returns the identifier of the given kind, or NULL if +Returns the identifier of the given kind, or NULL if the GDrive doesn't have one.

enumerate_identifiers ()

Returns an array strings listing the kinds +Returns an array strings listing the kinds of identifiers which the GDrive has.

get_start_stop_type ()

Gets a GDriveStartStopType with details about starting/stopping the drive. Since 2.22. +Gets a GDriveStartStopType with details about starting/stopping the drive. Since 2.22.

can_start ()

Returns TRUE if a GDrive can be started. Since 2.22. +Returns TRUE if a GDrive can be started. Since 2.22.

can_start_degraded ()

Returns TRUE if a GDrive can be started degraded. Since 2.22. +Returns TRUE if a GDrive can be started degraded. Since 2.22.

start ()

Starts a GDrive. Since 2.22. +Starts a GDrive. Since 2.22.

start_finish ()

Finishes a start operation. Since 2.22. +Finishes a start operation. Since 2.22.

can_stop ()

Returns TRUE if a GDrive can be stopped. Since 2.22. +Returns TRUE if a GDrive can be stopped. Since 2.22.

stop ()

Stops a GDrive. Since 2.22. +Stops a GDrive. Since 2.22.

stop_finish ()

Finishes a stop operation. Since 2.22. +Finishes a stop operation. Since 2.22.

stop_button ()

Signal emitted when the physical stop button (if any) of a drive have been pressed. Since 2.22. +Signal emitted when the physical stop button (if any) of a drive have been pressed. Since 2.22.

eject_with_operation ()

Starts ejecting a GDrive using a GMountOperation. Since 2.22. +Starts ejecting a GDrive using a GMountOperation. Since 2.22.

eject_with_operation_finish ()

Finishes an eject operation using a GMountOperation. Since 2.22. +Finishes an eject operation using a GMountOperation. Since 2.22.
-

G_DRIVE_START_NONE

No flags set. +No flags set.
@@ -474,39 +448,40 @@ Flags used when starting a drive.

} GDriveStartStopType;

-Enumeration describing how a drive can be started/stopped.

+Enumeration describing how a drive can be started/stopped. +

- - - - - @@ -518,15 +493,16 @@ Enumeration describing how a drive can be started/stopped.


g_drive_get_name ()

-
char *              g_drive_get_name                    (GDrive *drive);
+
char *              g_drive_get_name                    (GDrive *drive);

-Gets the name of drive.

+Gets the name of drive. +

G_DRIVE_START_STOP_TYPE_UNKNOWN

Unknown or drive doesn't support +Unknown or drive doesn't support start/stop.

G_DRIVE_START_STOP_TYPE_SHUTDOWN

The stop method will physically +The stop method will physically shut down the drive and e.g. power down the port the drive is attached to.

G_DRIVE_START_STOP_TYPE_NETWORK

The start/stop methods are used +The start/stop methods are used for connecting/disconnect to the drive over the network.

G_DRIVE_START_STOP_TYPE_MULTIDISK

The start/stop methods will +The start/stop methods will assemble/disassemble a virtual drive from several physical drives.

G_DRIVE_START_STOP_TYPE_PASSWORD

The start/stop methods will +The start/stop methods will unlock/lock the disk (for example using the ATA “SECURITY UNLOCK DEVICE” command)
- @@ -541,21 +517,22 @@ Gets the name of drive.


g_drive_get_icon ()

-
GIcon *             g_drive_get_icon                    (GDrive *drive);
+
GIcon *             g_drive_get_icon                    (GDrive *drive);

-Gets the icon for drive.

+Gets the icon for drive. +

drive :

a GDrive. +a GDrive.
- @@ -564,20 +541,21 @@ Gets the icon for drive.


g_drive_has_volumes ()

-
gboolean            g_drive_has_volumes                 (GDrive *drive);
+
gboolean            g_drive_has_volumes                 (GDrive *drive);

-Check if drive has any mountable volumes.

+Check if drive has any mountable volumes. +

drive :

a GDrive. +a GDrive.

Returns :

GIcon for the drive. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - @@ -586,24 +564,25 @@ Check if drive has any mountable volumes

g_drive_get_volumes ()

-
GList *             g_drive_get_volumes                 (GDrive *drive);
+
GList *             g_drive_get_volumes                 (GDrive *drive);

Get a list of mountable volumes for drive.

-The returned list should be freed with g_list_free(), after -its elements have been unreffed with g_object_unref().

+The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive contains volumes, FALSE otherwise. + TRUE if the drive contains volumes, FALSE otherwise.
- - @@ -612,20 +591,21 @@ its elements have been unreffed with

g_drive_can_eject ()

-
gboolean            g_drive_can_eject                   (GDrive *drive);
+
gboolean            g_drive_can_eject                   (GDrive *drive);

-Checks if a drive can be ejected.

+Checks if a drive can be ejected. +

drive :

a GDrive. +a GDrive.

Returns :

GList containing any GVolume objects on the given drive. + GList containing any GVolume objects on the given drive.
- - @@ -634,15 +614,16 @@ Checks if a drive can be ejected.


g_drive_get_start_stop_type ()

-
GDriveStartStopType  g_drive_get_start_stop_type        (GDrive *drive);
+
GDriveStartStopType  g_drive_get_start_stop_type        (GDrive *drive);

-Gets a hint about how a drive can be started/stopped.

+Gets a hint about how a drive can be started/stopped. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive can be ejected, FALSE otherwise. + TRUE if the drive can be ejected, FALSE otherwise.
- @@ -658,20 +639,21 @@ Gets a hint about how a drive can be started/stopped.


g_drive_can_start ()

-
gboolean            g_drive_can_start                   (GDrive *drive);
+
gboolean            g_drive_can_start                   (GDrive *drive);

-Checks if a drive can be started.

+Checks if a drive can be started. +

drive :

a GDrive. +a GDrive.
- - @@ -682,20 +664,21 @@ Checks if a drive can be started.


g_drive_can_start_degraded ()

-
gboolean            g_drive_can_start_degraded          (GDrive *drive);
+
gboolean            g_drive_can_start_degraded          (GDrive *drive);

-Checks if a drive can be started degraded.

+Checks if a drive can be started degraded. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive can be started, FALSE otherwise. + TRUE if the drive can be started, FALSE otherwise.
- - @@ -706,20 +689,21 @@ Checks if a drive can be started degraded.


g_drive_can_stop ()

-
gboolean            g_drive_can_stop                    (GDrive *drive);
+
gboolean            g_drive_can_stop                    (GDrive *drive);

-Checks if a drive can be stopped.

+Checks if a drive can be stopped. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive can be started degraded, FALSE otherwise. + TRUE if the drive can be started degraded, FALSE otherwise.
- - @@ -730,21 +714,22 @@ Checks if a drive can be stopped.


g_drive_can_poll_for_media ()

-
gboolean            g_drive_can_poll_for_media          (GDrive *drive);
+
gboolean            g_drive_can_poll_for_media          (GDrive *drive);

-Checks if a drive can be polled for media changes.

+Checks if a drive can be polled for media changes. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive can be stopped, FALSE otherwise. + TRUE if the drive can be stopped, FALSE otherwise.
- - @@ -753,38 +738,39 @@ Checks if a drive can be polled for media changes.


g_drive_poll_for_media ()

-
void                g_drive_poll_for_media              (GDrive *drive,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_drive_poll_for_media              (GDrive *drive,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously polls drive to see if media has been inserted or removed.

When the operation is finished, callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the -result of the operation.

+result of the operation. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive can be polled for media changes, - FALSE otherwise. + TRUE if the drive can be polled for media changes, + FALSE otherwise.
- - - - @@ -793,33 +779,34 @@ result of the operation.


g_drive_poll_for_media_finish ()

-
gboolean            g_drive_poll_for_media_finish       (GDrive *drive,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_drive_poll_for_media_finish       (GDrive *drive,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes an operation started with g_drive_poll_for_media() on a drive.

+Finishes an operation started with g_drive_poll_for_media() on a drive. +

drive :

a GDrive. +a GDrive.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data to pass to callback +user data to pass to callback
- - - - @@ -828,22 +815,23 @@ Finishes an operation started with

g_drive_has_media ()

-
gboolean            g_drive_has_media                   (GDrive *drive);
+
gboolean            g_drive_has_media                   (GDrive *drive);

Checks if the drive has media. Note that the OS may not be polling the drive for media changes; see g_drive_is_media_check_automatic() -for more details.

+for more details. +

drive :

a GDrive. +a GDrive.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the drive has been poll_for_mediaed successfully, - FALSE otherwise. + TRUE if the drive has been poll_for_mediaed successfully, + FALSE otherwise.
- - @@ -852,21 +840,22 @@ for more details.


g_drive_is_media_check_automatic ()

-
gboolean            g_drive_is_media_check_automatic    (GDrive *drive);
+
gboolean            g_drive_is_media_check_automatic    (GDrive *drive);

-Checks if drive is capabable of automatically detecting media changes.

+Checks if drive is capabable of automatically detecting media changes. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if drive has media, FALSE otherwise. + TRUE if drive has media, FALSE otherwise.
- - @@ -875,20 +864,21 @@ Checks if drive is capabable of automati

g_drive_is_media_removable ()

-
gboolean            g_drive_is_media_removable          (GDrive *drive);
+
gboolean            g_drive_is_media_removable          (GDrive *drive);

-Checks if the drive supports removable media.

+Checks if the drive supports removable media. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if the drive is capabable of automatically detecting - media changes, FALSE otherwise. + TRUE if the drive is capabable of automatically detecting + media changes, FALSE otherwise.
- - @@ -897,11 +887,11 @@ Checks if the drive supports removable m

g_drive_eject ()

-
void                g_drive_eject                       (GDrive *drive,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_drive_eject                       (GDrive *drive,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_drive_eject has been deprecated since version 2.22 and should not be used in newly-written code. Use g_drive_eject_with_operation() instead.

@@ -912,33 +902,34 @@ Asynchronously ejects a drive.

When the operation is finished, callback will be called. You can then call g_drive_eject_finish() to obtain the -result of the operation.

+result of the operation. +

drive :

a GDrive. +a GDrive.

Returns :

TRUE if drive supports removable media, FALSE otherwise. + TRUE if drive supports removable media, FALSE otherwise.
- - - - - @@ -947,37 +938,38 @@ result of the operation.


g_drive_eject_finish ()

-
gboolean            g_drive_eject_finish                (GDrive *drive,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_drive_eject_finish                (GDrive *drive,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_drive_eject_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_drive_eject_with_operation_finish() instead.

-Finishes ejecting a drive.

+Finishes ejecting a drive. +

drive :

a GDrive. +a GDrive.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data to pass to callback +user data to pass to callback
- - - - @@ -987,47 +979,48 @@ Finishes ejecting a drive.


g_drive_eject_with_operation ()

-
void                g_drive_eject_with_operation        (GDrive *drive,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_drive_eject_with_operation        (GDrive *drive,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the drive -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

drive :

a GDrive. +a GDrive.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the drive has been ejected successfully, - FALSE otherwise. + TRUE if the drive has been ejected successfully, + FALSE otherwise.
- - - - - - @@ -1037,34 +1030,35 @@ and

g_drive_eject_with_operation_finish ()

-
gboolean            g_drive_eject_with_operation_finish (GDrive *drive,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_drive_eject_with_operation_finish (GDrive *drive,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes ejecting a drive. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

drive :

a GDrive. +a GDrive.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -1075,50 +1069,51 @@ Finishes ejecting a drive. If any errors occurred during the operation,

g_drive_start ()

-
void                g_drive_start                       (GDrive *drive,
-                                                         GDriveStartFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_drive_start                       (GDrive *drive,
+                                                         GDriveStartFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously starts a drive.

When the operation is finished, callback will be called. You can then call g_drive_start_finish() to obtain the -result of the operation.

+result of the operation. +

drive :

a GDrive. +a GDrive.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the drive was successfully ejected. FALSE otherwise. + TRUE if the drive was successfully ejected. FALSE otherwise.
- - - - - - @@ -1128,33 +1123,34 @@ result of the operation.


g_drive_start_finish ()

-
gboolean            g_drive_start_finish                (GDrive *drive,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_drive_start_finish                (GDrive *drive,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes starting a drive.

+Finishes starting a drive. +

drive :

a GDrive. +a GDrive.

flags :

flags affecting the start operation. +flags affecting the start operation.

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data to pass to callback +user data to pass to callback
- - - - @@ -1165,50 +1161,51 @@ Finishes starting a drive.


g_drive_stop ()

-
void                g_drive_stop                        (GDrive *drive,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_drive_stop                        (GDrive *drive,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously stops a drive.

When the operation is finished, callback will be called. You can then call g_drive_stop_finish() to obtain the -result of the operation.

+result of the operation. +

drive :

a GDrive. +a GDrive.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the drive has been started successfully, - FALSE otherwise. + TRUE if the drive has been started successfully, + FALSE otherwise.
- - - - - - @@ -1218,33 +1215,34 @@ result of the operation.


g_drive_stop_finish ()

-
gboolean            g_drive_stop_finish                 (GDrive *drive,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_drive_stop_finish                 (GDrive *drive,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes stopping a drive.

+Finishes stopping a drive. +

drive :

a GDrive. +a GDrive.

flags :

flags affecting the unmount if required for stopping. +flags affecting the unmount if required for stopping.

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data to pass to callback +user data to pass to callback
- - - - @@ -1255,23 +1253,24 @@ Finishes stopping a drive.


g_drive_enumerate_identifiers ()

-
char **             g_drive_enumerate_identifiers       (GDrive *drive);
+
char **             g_drive_enumerate_identifiers       (GDrive *drive);

Gets the kinds of identifiers that drive has. Use g_drive_get_identifer() to obtain the identifiers -themselves.

+themselves. +

drive :

a GDrive. +a GDrive.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the drive has been stopped successfully, - FALSE otherwise. + TRUE if the drive has been stopped successfully, + FALSE otherwise.
- - @@ -1280,27 +1279,28 @@ themselves.


g_drive_get_identifier ()

-
char *              g_drive_get_identifier              (GDrive *drive,
-                                                         const char *kind);
+
char *              g_drive_get_identifier              (GDrive *drive,
+                                                         const char *kind);

-Gets the identifier of the given kind for drive.

+Gets the identifier of the given kind for drive. +

drive :

a GDrive +a GDrive

Returns :

a NULL-terminated array of strings containing - kinds of identifiers. Use g_strfreev() to free. + a NULL-terminated array of strings containing + kinds of identifiers. Use g_strfreev() to free.
- - @@ -1313,15 +1313,16 @@ Gets the identifier of the given kind for drive

The "changed" signal

void                user_function                      (GDrive  *drive,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the drive's state has changed.

+Emitted when the drive's state has changed. +

drive :

a GDrive +a GDrive

kind :

the kind of identifier to return +the kind of identifier to return

Returns :

a newly allocated string containing the - requested identfier, or NULL if the GDrive + requested identfier, or NULL if the GDrive doesn't have this kind of identifier.
- @@ -1335,18 +1336,19 @@ Emitted when the drive's state has changed.

The "disconnected" signal

void                user_function                      (GDrive  *drive,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

This signal is emitted when the GDrive have been disconnected. If the recipient is holding references to the object they should release them so the object can be -finalized.

+finalized. +

drive :

a GDrive. +a GDrive.
- @@ -1360,16 +1362,17 @@ finalized.

The "eject-button" signal

void                user_function                      (GDrive  *drive,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

Emitted when the physical eject button (if any) of a drive has -been pressed.

+been pressed. +

drive :

a GDrive. +a GDrive.
- @@ -1383,16 +1386,17 @@ been pressed.

The "stop-button" signal

void                user_function                      (GDrive  *drive,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

Emitted when the physical stop button (if any) of a drive has -been pressed.

+been pressed. +

drive :

a GDrive. +a GDrive.
- @@ -1407,6 +1411,6 @@ been pressed.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GEmblem.html b/docs/reference/gio/html/GEmblem.html index e9a40c0..63061f4 100644 --- a/docs/reference/gio/html/GEmblem.html +++ b/docs/reference/gio/html/GEmblem.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

drive :

a GDrive. +a GDrive.
@@ -78,17 +48,17 @@ GEmblem; enum GEmblemOrigin; -GEmblem * g_emblem_new (GIcon *icon); -GEmblem * g_emblem_new_with_origin (GIcon *icon, - GEmblemOrigin origin); -GIcon * g_emblem_get_icon (GEmblem *emblem); -GEmblemOrigin g_emblem_get_origin (GEmblem *emblem); +GEmblem * g_emblem_new (GIcon *icon); +GEmblem * g_emblem_new_with_origin (GIcon *icon, + GEmblemOrigin origin); +GIcon * g_emblem_get_icon (GEmblem *emblem); +GEmblemOrigin g_emblem_get_origin (GEmblem *emblem);

Object Hierarchy

-  GObject
+  GObject
    +----GEmblem
 
@@ -101,7 +71,7 @@ GEmblem implements

Properties

-  "icon"                     GObject*              : Read / Write / Construct Only
+  "icon"                     GObject*              : Read / Write / Construct Only
   "origin"                   GEmblemOrigin         : Read / Write / Construct Only
 
@@ -114,7 +84,8 @@ It can than be added to a

Details

@@ -122,7 +93,8 @@ supported. More may be added in the future.

GEmblem

typedef struct _GEmblem GEmblem;

-An object for Emblems

+An object for Emblems +


@@ -136,28 +108,29 @@ An object for Emblems

GEmblemOrigin is used to add information about the origin of the emblem -to GEmblem.

+to GEmblem. +

- - - - @@ -167,15 +140,16 @@ to GEmble

g_emblem_new ()

-
GEmblem *           g_emblem_new                        (GIcon *icon);
+
GEmblem *           g_emblem_new                        (GIcon *icon);

-Creates a new emblem for icon.

+Creates a new emblem for icon. +

G_EMBLEM_ORIGIN_UNKNOWN

Emblem of unknown origin +Emblem of unknown origin

G_EMBLEM_ORIGIN_DEVICE

Emblem adds device-specific information +Emblem adds device-specific information

G_EMBLEM_ORIGIN_LIVEMETADATA

Emblem depicts live metadata, such as "readonly" +Emblem depicts live metadata, such as "readonly"

G_EMBLEM_ORIGIN_TAG

Emblem comes from a user-defined tag, e.g. set by nautilus (in the future) +Emblem comes from a user-defined tag, e.g. set by nautilus (in the future)
- @@ -191,21 +165,22 @@ Creates a new emblem for icon.


g_emblem_new_with_origin ()

-
GEmblem *           g_emblem_new_with_origin            (GIcon *icon,
-                                                         GEmblemOrigin origin);
+
GEmblem *           g_emblem_new_with_origin            (GIcon *icon,
+                                                         GEmblemOrigin origin);

-Creates a new emblem for icon.

+Creates a new emblem for icon. +

icon :

a GIcon containing the icon. +a GIcon containing the icon.
- - @@ -221,15 +196,16 @@ Creates a new emblem for icon.


g_emblem_get_icon ()

-
GIcon *             g_emblem_get_icon                   (GEmblem *emblem);
+
GIcon *             g_emblem_get_icon                   (GEmblem *emblem);

-Gives back the icon from emblem.

+Gives back the icon from emblem. +

icon :

a GIcon containing the icon. +a GIcon containing the icon.

origin :

a GEmblemOrigin enum defining the emblem's origin +a GEmblemOrigin enum defining the emblem's origin
- @@ -246,15 +222,16 @@ Gives back the icon from emblem.


g_emblem_get_origin ()

-
GEmblemOrigin       g_emblem_get_origin                 (GEmblem *emblem);
+
GEmblemOrigin       g_emblem_get_origin                 (GEmblem *emblem);

-Gets the origin of the emblem.

+Gets the origin of the emblem. +

emblem :

a GEmblem from which the icon should be extracted. +a GEmblem from which the icon should be extracted.
- @@ -272,7 +249,7 @@ Gets the origin of the emblem.

Property Details

The "icon" property

-
  "icon"                     GObject*              : Read / Write / Construct Only
+
  "icon"                     GObject*              : Read / Write / Construct Only

The actual icon of the emblem.


@@ -290,6 +267,6 @@ Gets the origin of the emblem.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GEmblemedIcon.html b/docs/reference/gio/html/GEmblemedIcon.html index 85c3794..5389177 100644 --- a/docs/reference/gio/html/GEmblemedIcon.html +++ b/docs/reference/gio/html/GEmblemedIcon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

emblem :

a GEmblem +a GEmblem
@@ -75,18 +45,18 @@ #include <gio/gio.h> GEmblemedIcon; -GIcon * g_emblemed_icon_new (GIcon *icon, - GEmblem *emblem); -GIcon * g_emblemed_icon_get_icon (GEmblemedIcon *emblemed); -GList * g_emblemed_icon_get_emblems (GEmblemedIcon *emblemed); -void g_emblemed_icon_add_emblem (GEmblemedIcon *emblemed, - GEmblem *emblem); +GIcon * g_emblemed_icon_new (GIcon *icon, + GEmblem *emblem); +GIcon * g_emblemed_icon_get_icon (GEmblemedIcon *emblemed); +GList * g_emblemed_icon_get_emblems (GEmblemedIcon *emblemed); +void g_emblemed_icon_add_emblem (GEmblemedIcon *emblemed, + GEmblem *emblem);

Object Hierarchy

-  GObject
+  GObject
    +----GEmblemedIcon
 
@@ -105,7 +75,8 @@ icon is ensured via GEmblemedIcon allows no control over the position -of the emblems. See also GEmblem for more information.

+of the emblems. See also GEmblem for more information. +

Details

@@ -113,26 +84,28 @@ of the emblems. See also

GEmblemedIcon

typedef struct _GEmblemedIcon GEmblemedIcon;

-An implementation of GIcon for icons with emblems.

+An implementation of GIcon for icons with emblems. +


g_emblemed_icon_new ()

-
GIcon *             g_emblemed_icon_new                 (GIcon *icon,
-                                                         GEmblem *emblem);
+
GIcon *             g_emblemed_icon_new                 (GIcon *icon,
+                                                         GEmblem *emblem);

-Creates a new emblemed icon for icon with the emblem emblem.

+Creates a new emblemed icon for icon with the emblem emblem. +

- - @@ -148,15 +121,16 @@ Creates a new emblemed icon for icon wit

g_emblemed_icon_get_icon ()

-
GIcon *             g_emblemed_icon_get_icon            (GEmblemedIcon *emblemed);
+
GIcon *             g_emblemed_icon_get_icon            (GEmblemedIcon *emblemed);

-Gets the main icon for emblemed.

+Gets the main icon for emblemed. +

icon :

a GIcon +a GIcon

emblem :

a GEmblem +a GEmblem
- @@ -172,20 +146,21 @@ Gets the main icon for emblemed.


g_emblemed_icon_get_emblems ()

-
GList *             g_emblemed_icon_get_emblems         (GEmblemedIcon *emblemed);
+
GList *             g_emblemed_icon_get_emblems         (GEmblemedIcon *emblemed);

-Gets the list of emblems for the icon.

+Gets the list of emblems for the icon. +

emblemed :

a GEmblemedIcon +a GEmblemedIcon
- - @@ -196,21 +171,22 @@ Gets the list of emblems for the icon.

g_emblemed_icon_add_emblem ()

-
void                g_emblemed_icon_add_emblem          (GEmblemedIcon *emblemed,
-                                                         GEmblem *emblem);
+
void                g_emblemed_icon_add_emblem          (GEmblemedIcon *emblemed,
+                                                         GEmblem *emblem);

-Adds emblem to the GList of GEmblem s.

+Adds emblem to the GList of GEmblem s. +

emblemed :

a GEmblemedIcon +a GEmblemedIcon

Returns :

a GList of GEmblem s that is owned by emblemed + a GList of GEmblem s that is owned by emblemed
- - @@ -225,6 +201,6 @@ Adds emblem to the
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFile.html b/docs/reference/gio/html/GFile.html index d3f18eb..52c5063 100644 --- a/docs/reference/gio/html/GFile.html +++ b/docs/reference/gio/html/GFile.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

emblemed :

a GEmblemedIcon +a GEmblemedIcon

emblem :

a GEmblem +a GEmblem
@@ -81,470 +51,470 @@ enum GFileCopyFlags; enum GFileMonitorFlags; enum GFilesystemPreviewType; -void (*GFileProgressCallback) (goffset current_num_bytes, - goffset total_num_bytes, - gpointer user_data); -gboolean (*GFileReadMoreCallback) (const char *file_contents, - goffset file_size, - gpointer callback_data); -GFile * g_file_new_for_path (const char *path); -GFile * g_file_new_for_uri (const char *uri); -GFile * g_file_new_for_commandline_arg (const char *arg); -GFile * g_file_parse_name (const char *parse_name); -GFile * g_file_dup (GFile *file); -guint g_file_hash (gconstpointer file); -gboolean g_file_equal (GFile *file1, - GFile *file2); -char * g_file_get_basename (GFile *file); -char * g_file_get_path (GFile *file); -char * g_file_get_uri (GFile *file); -char * g_file_get_parse_name (GFile *file); -GFile * g_file_get_parent (GFile *file); -gboolean g_file_has_parent (GFile *file, - GFile *parent); -GFile * g_file_get_child (GFile *file, - const char *name); -GFile * g_file_get_child_for_display_name (GFile *file, - const char *display_name, - GError **error); -gboolean g_file_has_prefix (GFile *file, - GFile *prefix); -char * g_file_get_relative_path (GFile *parent, - GFile *descendant); -GFile * g_file_resolve_relative_path (GFile *file, - const char *relative_path); -gboolean g_file_is_native (GFile *file); -gboolean g_file_has_uri_scheme (GFile *file, - const char *uri_scheme); -char * g_file_get_uri_scheme (GFile *file); -GFileInputStream * g_file_read (GFile *file, - GCancellable *cancellable, - GError **error); -void g_file_read_async (GFile *file, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileInputStream * g_file_read_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFileOutputStream * g_file_append_to (GFile *file, - GFileCreateFlags flags, - GCancellable *cancellable, - GError **error); -GFileOutputStream * g_file_create (GFile *file, - GFileCreateFlags flags, - GCancellable *cancellable, - GError **error); -GFileOutputStream * g_file_replace (GFile *file, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_append_to_async (GFile *file, - GFileCreateFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileOutputStream * g_file_append_to_finish (GFile *file, - GAsyncResult *res, - GError **error); -void g_file_create_async (GFile *file, - GFileCreateFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileOutputStream * g_file_create_finish (GFile *file, - GAsyncResult *res, - GError **error); -void g_file_replace_async (GFile *file, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileOutputStream * g_file_replace_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFileInfo * g_file_query_info (GFile *file, - const char *attributes, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_query_info_async (GFile *file, - const char *attributes, - GFileQueryInfoFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileInfo * g_file_query_info_finish (GFile *file, - GAsyncResult *res, - GError **error); -gboolean g_file_query_exists (GFile *file, - GCancellable *cancellable); -GFileType g_file_query_file_type (GFile *file, - GFileQueryInfoFlags flags, - GCancellable *cancellable); -GFileInfo * g_file_query_filesystem_info (GFile *file, - const char *attributes, - GCancellable *cancellable, - GError **error); -void g_file_query_filesystem_info_async (GFile *file, - const char *attributes, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileInfo * g_file_query_filesystem_info_finish (GFile *file, - GAsyncResult *res, - GError **error); -GAppInfo * g_file_query_default_handler (GFile *file, - GCancellable *cancellable, - GError **error); -GMount * g_file_find_enclosing_mount (GFile *file, - GCancellable *cancellable, - GError **error); -void g_file_find_enclosing_mount_async (GFile *file, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GMount * g_file_find_enclosing_mount_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFileEnumerator * g_file_enumerate_children (GFile *file, - const char *attributes, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_enumerate_children_async (GFile *file, - const char *attributes, - GFileQueryInfoFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileEnumerator * g_file_enumerate_children_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFile * g_file_set_display_name (GFile *file, - const char *display_name, - GCancellable *cancellable, - GError **error); -void g_file_set_display_name_async (GFile *file, - const char *display_name, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFile * g_file_set_display_name_finish (GFile *file, - GAsyncResult *res, - GError **error); -gboolean g_file_delete (GFile *file, - GCancellable *cancellable, - GError **error); -gboolean g_file_trash (GFile *file, - GCancellable *cancellable, - GError **error); -gboolean g_file_copy (GFile *source, - GFile *destination, - GFileCopyFlags flags, - GCancellable *cancellable, - GFileProgressCallback progress_callback, - gpointer progress_callback_data, - GError **error); -void g_file_copy_async (GFile *source, - GFile *destination, - GFileCopyFlags flags, - int io_priority, - GCancellable *cancellable, - GFileProgressCallback progress_callback, - gpointer progress_callback_data, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_copy_finish (GFile *file, - GAsyncResult *res, - GError **error); -gboolean g_file_move (GFile *source, - GFile *destination, - GFileCopyFlags flags, - GCancellable *cancellable, - GFileProgressCallback progress_callback, - gpointer progress_callback_data, - GError **error); -gboolean g_file_make_directory (GFile *file, - GCancellable *cancellable, - GError **error); -gboolean g_file_make_directory_with_parents (GFile *file, - GCancellable *cancellable, - GError **error); -gboolean g_file_make_symbolic_link (GFile *file, - const char *symlink_value, - GCancellable *cancellable, - GError **error); +void (*GFileProgressCallback) (goffset current_num_bytes, + goffset total_num_bytes, + gpointer user_data); +gboolean (*GFileReadMoreCallback) (const char *file_contents, + goffset file_size, + gpointer callback_data); +GFile * g_file_new_for_path (const char *path); +GFile * g_file_new_for_uri (const char *uri); +GFile * g_file_new_for_commandline_arg (const char *arg); +GFile * g_file_parse_name (const char *parse_name); +GFile * g_file_dup (GFile *file); +guint g_file_hash (gconstpointer file); +gboolean g_file_equal (GFile *file1, + GFile *file2); +char * g_file_get_basename (GFile *file); +char * g_file_get_path (GFile *file); +char * g_file_get_uri (GFile *file); +char * g_file_get_parse_name (GFile *file); +GFile * g_file_get_parent (GFile *file); +gboolean g_file_has_parent (GFile *file, + GFile *parent); +GFile * g_file_get_child (GFile *file, + const char *name); +GFile * g_file_get_child_for_display_name (GFile *file, + const char *display_name, + GError **error); +gboolean g_file_has_prefix (GFile *file, + GFile *prefix); +char * g_file_get_relative_path (GFile *parent, + GFile *descendant); +GFile * g_file_resolve_relative_path (GFile *file, + const char *relative_path); +gboolean g_file_is_native (GFile *file); +gboolean g_file_has_uri_scheme (GFile *file, + const char *uri_scheme); +char * g_file_get_uri_scheme (GFile *file); +GFileInputStream * g_file_read (GFile *file, + GCancellable *cancellable, + GError **error); +void g_file_read_async (GFile *file, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileInputStream * g_file_read_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFileOutputStream * g_file_append_to (GFile *file, + GFileCreateFlags flags, + GCancellable *cancellable, + GError **error); +GFileOutputStream * g_file_create (GFile *file, + GFileCreateFlags flags, + GCancellable *cancellable, + GError **error); +GFileOutputStream * g_file_replace (GFile *file, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_append_to_async (GFile *file, + GFileCreateFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileOutputStream * g_file_append_to_finish (GFile *file, + GAsyncResult *res, + GError **error); +void g_file_create_async (GFile *file, + GFileCreateFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileOutputStream * g_file_create_finish (GFile *file, + GAsyncResult *res, + GError **error); +void g_file_replace_async (GFile *file, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileOutputStream * g_file_replace_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFileInfo * g_file_query_info (GFile *file, + const char *attributes, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_query_info_async (GFile *file, + const char *attributes, + GFileQueryInfoFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileInfo * g_file_query_info_finish (GFile *file, + GAsyncResult *res, + GError **error); +gboolean g_file_query_exists (GFile *file, + GCancellable *cancellable); +GFileType g_file_query_file_type (GFile *file, + GFileQueryInfoFlags flags, + GCancellable *cancellable); +GFileInfo * g_file_query_filesystem_info (GFile *file, + const char *attributes, + GCancellable *cancellable, + GError **error); +void g_file_query_filesystem_info_async (GFile *file, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileInfo * g_file_query_filesystem_info_finish (GFile *file, + GAsyncResult *res, + GError **error); +GAppInfo * g_file_query_default_handler (GFile *file, + GCancellable *cancellable, + GError **error); +GMount * g_file_find_enclosing_mount (GFile *file, + GCancellable *cancellable, + GError **error); +void g_file_find_enclosing_mount_async (GFile *file, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GMount * g_file_find_enclosing_mount_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFileEnumerator * g_file_enumerate_children (GFile *file, + const char *attributes, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_enumerate_children_async (GFile *file, + const char *attributes, + GFileQueryInfoFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileEnumerator * g_file_enumerate_children_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFile * g_file_set_display_name (GFile *file, + const char *display_name, + GCancellable *cancellable, + GError **error); +void g_file_set_display_name_async (GFile *file, + const char *display_name, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFile * g_file_set_display_name_finish (GFile *file, + GAsyncResult *res, + GError **error); +gboolean g_file_delete (GFile *file, + GCancellable *cancellable, + GError **error); +gboolean g_file_trash (GFile *file, + GCancellable *cancellable, + GError **error); +gboolean g_file_copy (GFile *source, + GFile *destination, + GFileCopyFlags flags, + GCancellable *cancellable, + GFileProgressCallback progress_callback, + gpointer progress_callback_data, + GError **error); +void g_file_copy_async (GFile *source, + GFile *destination, + GFileCopyFlags flags, + int io_priority, + GCancellable *cancellable, + GFileProgressCallback progress_callback, + gpointer progress_callback_data, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_copy_finish (GFile *file, + GAsyncResult *res, + GError **error); +gboolean g_file_move (GFile *source, + GFile *destination, + GFileCopyFlags flags, + GCancellable *cancellable, + GFileProgressCallback progress_callback, + gpointer progress_callback_data, + GError **error); +gboolean g_file_make_directory (GFile *file, + GCancellable *cancellable, + GError **error); +gboolean g_file_make_directory_with_parents (GFile *file, + GCancellable *cancellable, + GError **error); +gboolean g_file_make_symbolic_link (GFile *file, + const char *symlink_value, + GCancellable *cancellable, + GError **error); GFileAttributeInfoList * g_file_query_settable_attributes - (GFile *file, - GCancellable *cancellable, - GError **error); + (GFile *file, + GCancellable *cancellable, + GError **error); GFileAttributeInfoList * g_file_query_writable_namespaces - (GFile *file, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute (GFile *file, - const char *attribute, - GFileAttributeType type, - gpointer value_p, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attributes_from_info (GFile *file, - GFileInfo *info, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_set_attributes_async (GFile *file, - GFileInfo *info, - GFileQueryInfoFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_set_attributes_finish (GFile *file, - GAsyncResult *result, - GFileInfo **info, - GError **error); -gboolean g_file_set_attribute_string (GFile *file, - const char *attribute, - const char *value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute_byte_string (GFile *file, - const char *attribute, - const char *value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute_uint32 (GFile *file, - const char *attribute, - guint32 value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute_int32 (GFile *file, - const char *attribute, - gint32 value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute_uint64 (GFile *file, - const char *attribute, - guint64 value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_set_attribute_int64 (GFile *file, - const char *attribute, - gint64 value, - GFileQueryInfoFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_mount_mountable (GFile *file, - GMountMountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFile * g_file_mount_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_unmount_mountable (GFile *file, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_unmount_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); + (GFile *file, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute (GFile *file, + const char *attribute, + GFileAttributeType type, + gpointer value_p, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attributes_from_info (GFile *file, + GFileInfo *info, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_set_attributes_async (GFile *file, + GFileInfo *info, + GFileQueryInfoFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_set_attributes_finish (GFile *file, + GAsyncResult *result, + GFileInfo **info, + GError **error); +gboolean g_file_set_attribute_string (GFile *file, + const char *attribute, + const char *value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute_byte_string (GFile *file, + const char *attribute, + const char *value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute_uint32 (GFile *file, + const char *attribute, + guint32 value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute_int32 (GFile *file, + const char *attribute, + gint32 value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute_uint64 (GFile *file, + const char *attribute, + guint64 value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_set_attribute_int64 (GFile *file, + const char *attribute, + gint64 value, + GFileQueryInfoFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_mount_mountable (GFile *file, + GMountMountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFile * g_file_mount_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_unmount_mountable (GFile *file, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_unmount_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); void g_file_unmount_mountable_with_operation - (GFile *file, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_unmount_mountable_with_operation_finish - (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_eject_mountable (GFile *file, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_eject_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); + (GFile *file, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_unmount_mountable_with_operation_finish + (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_eject_mountable (GFile *file, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_eject_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); void g_file_eject_mountable_with_operation - (GFile *file, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_eject_mountable_with_operation_finish - (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_start_mountable (GFile *file, - GDriveStartFlags flags, - GMountOperation *start_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_start_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_stop_mountable (GFile *file, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_stop_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_poll_mountable (GFile *file, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_poll_mountable_finish (GFile *file, - GAsyncResult *result, - GError **error); -void g_file_mount_enclosing_volume (GFile *location, - GMountMountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_mount_enclosing_volume_finish - (GFile *location, - GAsyncResult *result, - GError **error); -GFileMonitor* g_file_monitor_directory (GFile *file, - GFileMonitorFlags flags, - GCancellable *cancellable, - GError **error); -GFileMonitor* g_file_monitor_file (GFile *file, - GFileMonitorFlags flags, - GCancellable *cancellable, - GError **error); -GFileMonitor* g_file_monitor (GFile *file, - GFileMonitorFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_file_load_contents (GFile *file, - GCancellable *cancellable, - char **contents, - gsize *length, - char **etag_out, - GError **error); -void g_file_load_contents_async (GFile *file, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_load_contents_finish (GFile *file, - GAsyncResult *res, - char **contents, - gsize *length, - char **etag_out, - GError **error); -void g_file_load_partial_contents_async (GFile *file, - GCancellable *cancellable, - GFileReadMoreCallback read_more_callback, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_load_partial_contents_finish (GFile *file, - GAsyncResult *res, - char **contents, - gsize *length, - char **etag_out, - GError **error); -gboolean g_file_replace_contents (GFile *file, - const char *contents, - gsize length, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - char **new_etag, - GCancellable *cancellable, - GError **error); -void g_file_replace_contents_async (GFile *file, - const char *contents, - gsize length, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_replace_contents_finish (GFile *file, - GAsyncResult *res, - char **new_etag, - GError **error); -gboolean g_file_copy_attributes (GFile *source, - GFile *destination, - GFileCopyFlags flags, - GCancellable *cancellable, - GError **error); -GFileIOStream * g_file_create_readwrite (GFile *file, - GFileCreateFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_create_readwrite_async (GFile *file, - GFileCreateFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileIOStream * g_file_create_readwrite_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFileIOStream * g_file_open_readwrite (GFile *file, - GCancellable *cancellable, - GError **error); -void g_file_open_readwrite_async (GFile *file, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileIOStream * g_file_open_readwrite_finish (GFile *file, - GAsyncResult *res, - GError **error); -GFileIOStream * g_file_replace_readwrite (GFile *file, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - GCancellable *cancellable, - GError **error); -void g_file_replace_readwrite_async (GFile *file, - const char *etag, - gboolean make_backup, - GFileCreateFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileIOStream * g_file_replace_readwrite_finish (GFile *file, - GAsyncResult *res, - GError **error); -gboolean g_file_supports_thread_contexts (GFile *file); + (GFile *file, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_eject_mountable_with_operation_finish + (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_start_mountable (GFile *file, + GDriveStartFlags flags, + GMountOperation *start_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_start_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_stop_mountable (GFile *file, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_stop_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_poll_mountable (GFile *file, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_poll_mountable_finish (GFile *file, + GAsyncResult *result, + GError **error); +void g_file_mount_enclosing_volume (GFile *location, + GMountMountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_mount_enclosing_volume_finish + (GFile *location, + GAsyncResult *result, + GError **error); +GFileMonitor* g_file_monitor_directory (GFile *file, + GFileMonitorFlags flags, + GCancellable *cancellable, + GError **error); +GFileMonitor* g_file_monitor_file (GFile *file, + GFileMonitorFlags flags, + GCancellable *cancellable, + GError **error); +GFileMonitor* g_file_monitor (GFile *file, + GFileMonitorFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_file_load_contents (GFile *file, + GCancellable *cancellable, + char **contents, + gsize *length, + char **etag_out, + GError **error); +void g_file_load_contents_async (GFile *file, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_load_contents_finish (GFile *file, + GAsyncResult *res, + char **contents, + gsize *length, + char **etag_out, + GError **error); +void g_file_load_partial_contents_async (GFile *file, + GCancellable *cancellable, + GFileReadMoreCallback read_more_callback, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_load_partial_contents_finish (GFile *file, + GAsyncResult *res, + char **contents, + gsize *length, + char **etag_out, + GError **error); +gboolean g_file_replace_contents (GFile *file, + const char *contents, + gsize length, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + char **new_etag, + GCancellable *cancellable, + GError **error); +void g_file_replace_contents_async (GFile *file, + const char *contents, + gsize length, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_replace_contents_finish (GFile *file, + GAsyncResult *res, + char **new_etag, + GError **error); +gboolean g_file_copy_attributes (GFile *source, + GFile *destination, + GFileCopyFlags flags, + GCancellable *cancellable, + GError **error); +GFileIOStream * g_file_create_readwrite (GFile *file, + GFileCreateFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_create_readwrite_async (GFile *file, + GFileCreateFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileIOStream * g_file_create_readwrite_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFileIOStream * g_file_open_readwrite (GFile *file, + GCancellable *cancellable, + GError **error); +void g_file_open_readwrite_async (GFile *file, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileIOStream * g_file_open_readwrite_finish (GFile *file, + GAsyncResult *res, + GError **error); +GFileIOStream * g_file_replace_readwrite (GFile *file, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + GCancellable *cancellable, + GError **error); +void g_file_replace_readwrite_async (GFile *file, + const char *etag, + gboolean make_backup, + GFileCreateFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileIOStream * g_file_replace_readwrite_finish (GFile *file, + GAsyncResult *res, + GError **error); +gboolean g_file_supports_thread_contexts (GFile *file);
@@ -558,7 +528,7 @@ enum

Prerequisites

GFile requires - GObject.

+ GObject.

Description

@@ -641,6 +611,8 @@ been modified from the version on the file system. See the HTTP 1.1 specification for HTTP Etag headers, which are a very similar concept.

+

+

Details

@@ -650,7 +622,8 @@ for HTTP Etag headers, which are a very similar concept.

A handle to an object implementing the GFileIface interface. Generally stores a location within the file system. Handles do not -necessarily represent files or directories that currently exist.

+necessarily represent files or directories that currently exist. +


@@ -1045,513 +1018,514 @@ necessarily represent files or directories that currently exist.

} GFileIface;

-An interface for writing VFS file handles.

+An interface for writing VFS file handles. +

- - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - @@ -1566,18 +1540,19 @@ An interface for writing VFS file handles.

} GFileQueryInfoFlags;

-Flags used when querying a GFileInfo.

+Flags used when querying a GFileInfo. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

dup ()

Duplicates a GFile. +Duplicates a GFile.

hash ()

Creates a hash of a GFile. +Creates a hash of a GFile.

equal ()

Checks equality of two given GFiles. +Checks equality of two given GFiles.

is_native ()

Checks to see if a file is native to the system. +Checks to see if a file is native to the system.

has_uri_scheme ()

Checks to see if a GFile has a given URI scheme. +Checks to see if a GFile has a given URI scheme.

get_uri_scheme ()

Gets the URI scheme for a GFile. +Gets the URI scheme for a GFile.

get_basename ()

Gets the basename for a given GFile. +Gets the basename for a given GFile.

get_path ()

Gets the current path within a GFile. +Gets the current path within a GFile.

get_uri ()

Gets a URI for the path within a GFile. +Gets a URI for the path within a GFile.

get_parse_name ()

Gets the parsed name for the GFile. +Gets the parsed name for the GFile.

get_parent ()

Gets the parent directory for the GFile. +Gets the parent directory for the GFile.

prefix_matches ()

Checks whether a GFile contains a specified file. +Checks whether a GFile contains a specified file.

get_relative_path ()

Gets the path for a GFile relative to a given path. +Gets the path for a GFile relative to a given path.

resolve_relative_path ()

Resolves a relative path for a GFile to an absolute path. +Resolves a relative path for a GFile to an absolute path.

get_child_for_display_name ()

Gets the child GFile for a given display name. +Gets the child GFile for a given display name.

enumerate_children ()

Gets a GFileEnumerator with the children of a GFile. +Gets a GFileEnumerator with the children of a GFile.

enumerate_children_async ()

Asynchronously gets a GFileEnumerator with the children of a GFile. +Asynchronously gets a GFileEnumerator with the children of a GFile.

enumerate_children_finish ()

Finishes asynchronously enumerating the children. +Finishes asynchronously enumerating the children.

query_info ()

Gets the GFileInfo for a GFile. +Gets the GFileInfo for a GFile.

query_info_async ()

Asynchronously gets the GFileInfo for a GFile. +Asynchronously gets the GFileInfo for a GFile.

query_info_finish ()

Finishes an asynchronous query info operation. +Finishes an asynchronous query info operation.

query_filesystem_info ()

Gets a GFileInfo for the file system GFile is on. +Gets a GFileInfo for the file system GFile is on.

query_filesystem_info_async ()

Asynchronously gets a GFileInfo for the file system GFile is on. +Asynchronously gets a GFileInfo for the file system GFile is on.

query_filesystem_info_finish ()

Finishes asynchronously getting the file system info. +Finishes asynchronously getting the file system info.

find_enclosing_mount ()

Gets a GMount for the GFile. +Gets a GMount for the GFile.

find_enclosing_mount_async ()

Asynchronously gets the GMount for a GFile. +Asynchronously gets the GMount for a GFile.

find_enclosing_mount_finish ()

Finishes asynchronously getting the volume. +Finishes asynchronously getting the volume.

set_display_name ()

Sets the display name for a GFile. +Sets the display name for a GFile.

set_display_name_async ()

Asynchronously sets a GFile's display name. +Asynchronously sets a GFile's display name.

set_display_name_finish ()

Finishes asynchronously setting a GFile's display name. +Finishes asynchronously setting a GFile's display name.

query_settable_attributes ()

Returns a list of GFileAttributes that can be set. +Returns a list of GFileAttributes that can be set.

_query_settable_attributes_async ()

Asynchronously gets a list of GFileAttributes that can be set. +Asynchronously gets a list of GFileAttributes that can be set.

_query_settable_attributes_finish ()

Finishes asynchronously querying settable attributes. +Finishes asynchronously querying settable attributes.

query_writable_namespaces ()

Returns a list of GFileAttribute namespaces that are writable. +Returns a list of GFileAttribute namespaces that are writable.

_query_writable_namespaces_async ()

Asynchronously gets a list of GFileAttribute namespaces that are writable. +Asynchronously gets a list of GFileAttribute namespaces that are writable.

_query_writable_namespaces_finish ()

Finishes asynchronously querying the writable namespaces. +Finishes asynchronously querying the writable namespaces.

set_attribute ()

Sets a GFileAttribute. +Sets a GFileAttribute.

set_attributes_from_info ()

Sets a GFileAttribute with information from a GFileInfo. +Sets a GFileAttribute with information from a GFileInfo.

set_attributes_async ()

Asynchronously sets a file's attributes. +Asynchronously sets a file's attributes.

set_attributes_finish ()

Finishes setting a file's attributes asynchronously. +Finishes setting a file's attributes asynchronously.

read_fn ()

Reads a file asynchronously. +Reads a file asynchronously.

read_async ()

Asynchronously reads a file. +Asynchronously reads a file.

read_finish ()

Finishes asynchronously reading a file. +Finishes asynchronously reading a file.

append_to ()

Writes to the end of a file. +Writes to the end of a file.

append_to_async ()

Asynchronously writes to the end of a file. +Asynchronously writes to the end of a file.

append_to_finish ()

Finishes an asynchronous file append operation. +Finishes an asynchronous file append operation.

create ()

Creates a new file. +Creates a new file.

create_async ()

Asynchronously creates a file. +Asynchronously creates a file.

create_finish ()

Finishes asynchronously creating a file. +Finishes asynchronously creating a file.

replace ()

Replaces the contents of a file. +Replaces the contents of a file.

replace_async ()

Asynchronously replaces the contents of a file. +Asynchronously replaces the contents of a file.

replace_finish ()

Finishes asynchronously replacing a file. +Finishes asynchronously replacing a file.

delete_file ()

Deletes a file. +Deletes a file.

_delete_file_async ()

Asynchronously deletes a file. +Asynchronously deletes a file.

_delete_file_finish ()

Finishes an asynchronous delete. +Finishes an asynchronous delete.

trash ()

Sends a GFile to the Trash location. +Sends a GFile to the Trash location.

_trash_async ()

Asynchronously sends a GFile to the Trash location. +Asynchronously sends a GFile to the Trash location.

_trash_finish ()

Finishes an asynchronous file trashing operation. +Finishes an asynchronous file trashing operation.

make_directory ()

Makes a directory. +Makes a directory.

_make_directory_async ()

Asynchronously makes a directory. +Asynchronously makes a directory.

_make_directory_finish ()

Finishes making a directory asynchronously. +Finishes making a directory asynchronously.

make_symbolic_link ()

Makes a symbolic link. +Makes a symbolic link.

_make_symbolic_link_async ()

Asynchronously makes a symbolic link +Asynchronously makes a symbolic link

_make_symbolic_link_finish ()

Finishes making a symbolic link asynchronously. +Finishes making a symbolic link asynchronously.

copy ()

Copies a file. +Copies a file.

copy_async ()

Asynchronously copies a file. +Asynchronously copies a file.

copy_finish ()

Finishes an asynchronous copy operation. +Finishes an asynchronous copy operation.

move ()

Moves a file. +Moves a file.

_move_async ()

Asynchronously moves a file. +Asynchronously moves a file.

_move_finish ()

Finishes an asynchronous move operation. +Finishes an asynchronous move operation.

mount_mountable ()

Mounts a mountable object. +Mounts a mountable object.

mount_mountable_finish ()

Finishes a mounting operation. +Finishes a mounting operation.

unmount_mountable ()

Unmounts a mountable object. +Unmounts a mountable object.

unmount_mountable_finish ()

Finishes an unmount operation. +Finishes an unmount operation.

eject_mountable ()

Ejects a mountable. +Ejects a mountable.

eject_mountable_finish ()

Finishes an eject operation. +Finishes an eject operation.

mount_enclosing_volume ()

Mounts a specified location. +Mounts a specified location.

mount_enclosing_volume_finish ()

Finishes mounting a specified location. +Finishes mounting a specified location.

monitor_dir ()

Creates a GFileMonitor for the location. +Creates a GFileMonitor for the location.

monitor_file ()

Creates a GFileMonitor for the location. +Creates a GFileMonitor for the location.

open_readwrite ()

Open file read/write. Since 2.22. +Open file read/write. Since 2.22.

open_readwrite_async ()

Asynchronously opens file read/write. Since 2.22. +Asynchronously opens file read/write. Since 2.22.

open_readwrite_finish ()

Finishes an asynchronous open read/write. Since 2.22. +Finishes an asynchronous open read/write. Since 2.22.

create_readwrite ()

Creates file read/write. Since 2.22. +Creates file read/write. Since 2.22.

create_readwrite_async ()

Asynchronously creates file read/write. Since 2.22. +Asynchronously creates file read/write. Since 2.22.

create_readwrite_finish ()

Finishes an asynchronous creates read/write. Since 2.22. +Finishes an asynchronous creates read/write. Since 2.22.

replace_readwrite ()

Replaces file read/write. Since 2.22. +Replaces file read/write. Since 2.22.

replace_readwrite_async ()

Asynchronously replaces file read/write. Since 2.22. +Asynchronously replaces file read/write. Since 2.22.

replace_readwrite_finish ()

Finishes an asynchronous replace read/write. Since 2.22. +Finishes an asynchronous replace read/write. Since 2.22.

start_mountable ()

Starts a mountable object. Since 2.22. +Starts a mountable object. Since 2.22.

start_mountable_finish ()

Finishes an start operation. Since 2.22. +Finishes an start operation. Since 2.22.

stop_mountable ()

Stops a mountable. Since 2.22. +Stops a mountable. Since 2.22.

stop_mountable_finish ()

Finishes an stop operation. Since 2.22. +Finishes an stop operation. Since 2.22.

gboolean supports_thread_contexts;

a boolean that indicates whether the GFile implementation supports thread-default contexts. Since 2.22. +

gboolean supports_thread_contexts;

a boolean that indicates whether the GFile implementation supports thread-default contexts. Since 2.22.

unmount_mountable_with_operation ()

Unmounts a mountable object using a GMountOperation. Since 2.22. +Unmounts a mountable object using a GMountOperation. Since 2.22.

unmount_mountable_with_operation_finish ()

Finishes an unmount operation using a GMountOperation. Since 2.22. +Finishes an unmount operation using a GMountOperation. Since 2.22.

eject_mountable_with_operation ()

Ejects a mountable object using a GMountOperation. Since 2.22. +Ejects a mountable object using a GMountOperation. Since 2.22.

eject_mountable_with_operation_finish ()

Finishes an eject operation using a GMountOperation. Since 2.22. +Finishes an eject operation using a GMountOperation. Since 2.22.

poll_mountable ()

Polls a mountable object for media changes. Since 2.22. +Polls a mountable object for media changes. Since 2.22.

poll_mountable_finish ()

Finishes an poll operation for media changes. Since 2.22. +Finishes an poll operation for media changes. Since 2.22.
- - @@ -1593,24 +1568,25 @@ Flags used when querying a

G_FILE_QUERY_INFO_NONE

No flags set. +No flags set.

G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS

Don't follow symlinks. +Don't follow symlinks.
- - -

G_FILE_CREATE_NONE

No flags set. +No flags set.

G_FILE_CREATE_PRIVATE

Create a file that can only be +Create a file that can only be accessed by the current user.

G_FILE_CREATE_REPLACE_DESTINATION

Replace the destination +Replace the destination as if it didn't exist before. Don't try to keep any old permissions, replace instead of following links. This is generally useful if you're doing a "copy over" @@ -1637,43 +1613,44 @@ Flags used when an operation may create a file.

} GFileCopyFlags;

-Flags used when copying or moving files.

+Flags used when copying or moving files. +

- - - - - - - @@ -1689,23 +1666,24 @@ Flags used when copying or moving files.

} GFileMonitorFlags;

-Flags used to set what a GFileMonitor will watch for.

+Flags used to set what a GFileMonitor will watch for. +

G_FILE_COPY_NONE

No flags set. +No flags set.

G_FILE_COPY_OVERWRITE

Overwrite any existing files +Overwrite any existing files

G_FILE_COPY_BACKUP

Make a backup of any existing files. +Make a backup of any existing files.

G_FILE_COPY_NOFOLLOW_SYMLINKS

Don't follow symlinks. +Don't follow symlinks.

G_FILE_COPY_ALL_METADATA

Copy all file metadata instead of just default set used for copy (see GFileInfo). +Copy all file metadata instead of just default set used for copy (see GFileInfo).

G_FILE_COPY_NO_FALLBACK_FOR_MOVE

Don't use copy and delete fallback if native move not supported. +Don't use copy and delete fallback if native move not supported.

G_FILE_COPY_TARGET_DEFAULT_PERMS

Leaves target file with default perms, instead of setting the source file perms. +Leaves target file with default perms, instead of setting the source file perms.
- - -

G_FILE_MONITOR_NONE

No flags set. +No flags set.

G_FILE_MONITOR_WATCH_MOUNTS

Watch for mount events. +Watch for mount events.

G_FILE_MONITOR_SEND_MOVED

Pair DELETED and CREATED events caused +Pair DELETED and CREATED events caused by file renames (moves) and send a single G_FILE_MONITOR_EVENT_MOVED event instead (NB: not supported on all backends; the default behaviour -without specifying this flag- is to send single DELETED @@ -1727,23 +1705,24 @@ Flags used to set what a G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.

+G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW. +

- - - @@ -1752,29 +1731,30 @@ previewed in a file manager. Returned as the value of the key

GFileProgressCallback ()

-
void                (*GFileProgressCallback)            (goffset current_num_bytes,
-                                                         goffset total_num_bytes,
-                                                         gpointer user_data);
+
void                (*GFileProgressCallback)            (goffset current_num_bytes,
+                                                         goffset total_num_bytes,
+                                                         gpointer user_data);

When doing file operations that may take a while, such as moving a file or copying a file, a progress callback is used to pass how -far along that operation is to the application.

+far along that operation is to the application. +

G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS

Only preview files if user has explicitly requested it. +Only preview files if user has explicitly requested it.

G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL

Preview files if user has requested preview of "local" files. +Preview files if user has requested preview of "local" files.

G_FILESYSTEM_PREVIEW_TYPE_NEVER

Never preview files. +Never preview files.
- - - @@ -1783,35 +1763,36 @@ far along that operation is to the application.


GFileReadMoreCallback ()

-
gboolean            (*GFileReadMoreCallback)            (const char *file_contents,
-                                                         goffset file_size,
-                                                         gpointer callback_data);
+
gboolean            (*GFileReadMoreCallback)            (const char *file_contents,
+                                                         goffset file_size,
+                                                         gpointer callback_data);

When loading the partial contents of a file with g_file_load_partial_contents_async(), it may become necessary to determine if any more data from the file should be loaded. -A GFileReadMoreCallback function facilitates this by returning TRUE if more data -should be read, or FALSE otherwise.

+A GFileReadMoreCallback function facilitates this by returning TRUE if more data +should be read, or FALSE otherwise. +

current_num_bytes :

the current number of bytes in the operation. +the current number of bytes in the operation.

total_num_bytes :

the total number of bytes in the operation. +the total number of bytes in the operation.

user_data :

user data passed to the callback. +user data passed to the callback.
- - - - @@ -1820,17 +1801,18 @@ should be read, or

g_file_new_for_path ()

-
GFile *             g_file_new_for_path                 (const char *path);
+
GFile *             g_file_new_for_path                 (const char *path);

Constructs a GFile for a given path. This operation never fails, but the returned object might not support any I/O -operation if path is malformed.

+operation if path is malformed. +

file_contents :

the data as currently read. +the data as currently read.

file_size :

the size of the data currently read. +the size of the data currently read.

callback_data :

data passed to the callback. +data passed to the callback.

Returns :

TRUE if more data should be read back. FALSE otherwise. + TRUE if more data should be read back. FALSE otherwise.
- @@ -1844,18 +1826,19 @@ operation if path is malformed.


g_file_new_for_uri ()

-
GFile *             g_file_new_for_uri                  (const char *uri);
+
GFile *             g_file_new_for_uri                  (const char *uri);

Constructs a GFile for a given URI. This operation never fails, but the returned object might not support any I/O operation if uri is malformed or if the uri type is -not supported.

+not supported. +

path :

a string containing a relative or absolute path. +a string containing a relative or absolute path.
- @@ -1869,19 +1852,20 @@ not supported.


g_file_new_for_commandline_arg ()

-
GFile *             g_file_new_for_commandline_arg      (const char *arg);
+
GFile *             g_file_new_for_commandline_arg      (const char *arg);

Creates a GFile with the given argument from the command line. The value of arg can be either a URI, an absolute path or a relative path resolved relative to the current working directory. This operation never fails, but the returned object might not support any -I/O operation if arg points to a malformed path.

+I/O operation if arg points to a malformed path. +

uri :

a string containing a URI. +a string containing a URI.
- @@ -1895,17 +1879,18 @@ I/O operation if arg points to a malform

g_file_parse_name ()

-
GFile *             g_file_parse_name                   (const char *parse_name);
+
GFile *             g_file_parse_name                   (const char *parse_name);

Constructs a GFile with the given parse_name (i.e. something given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O -operation if the parse_name cannot be parsed.

+operation if the parse_name cannot be parsed. +

arg :

a command line string. +a command line string.
- @@ -1919,20 +1904,21 @@ operation if the parse_name cannot be pa

g_file_dup ()

-
GFile *             g_file_dup                          (GFile *file);
+
GFile *             g_file_dup                          (GFile *file);

Duplicates a GFile handle. This operation does not duplicate the actual file or directory represented by the GFile; see g_file_copy() if attempting to copy a file.

-This call does no blocking i/o.

+This call does no blocking i/o. +

parse_name :

a file name or path to be parsed. +a file name or path to be parsed.
- @@ -1946,18 +1932,20 @@ This call does no blocking i/o.


g_file_hash ()

-
guint               g_file_hash                         (gconstpointer file);
+
guint               g_file_hash                         (gconstpointer file);

Creates a hash value for a GFile.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.
- @@ -1965,7 +1953,7 @@ This call does no blocking i/o.

@@ -1974,8 +1962,8 @@ This call does no blocking i/o.


g_file_equal ()

-
gboolean            g_file_equal                        (GFile *file1,
-                                                         GFile *file2);
+
gboolean            g_file_equal                        (GFile *file1,
+                                                         GFile *file2);

Checks equality of two given GFiles. Note that two GFiles that differ can still refer to the same @@ -1983,24 +1971,25 @@ file on the filesystem due to various forms of filename aliasing.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

gconstpointer to a GFile. + +gconstpointer to a GFile.
0 if file is not a valid GFile, otherwise an integer that can be used as hash value for the GFile. This function is intended for easily hashing a GFile to - add to a GHashTable or similar data structure. + add to a GHashTable or similar data structure.
- - - @@ -2009,7 +1998,7 @@ This call does no blocking i/o.


g_file_get_basename ()

-
char *              g_file_get_basename                 (GFile *file);
+
char *              g_file_get_basename                 (GFile *file);

Gets the base name (the last component of the path) for a given GFile.

@@ -2026,20 +2015,21 @@ can get by requesting the g_file_query_info().

-This call does no blocking i/o.

+This call does no blocking i/o. +

file1 :

the first GFile. +the first GFile.

file2 :

the second GFile. +the second GFile.

Returns :

TRUE if file1 and file2 are equal. - FALSE if either is not a GFile. + TRUE if file1 and file2 are equal. + FALSE if either is not a GFile.
- - @@ -2048,25 +2038,26 @@ This call does no blocking i/o.


g_file_get_path ()

-
char *              g_file_get_path                     (GFile *file);
+
char *              g_file_get_path                     (GFile *file);

Gets the local pathname for GFile, if one exists.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

Returns :

string containing the GFile's base name, or NULL + string containing the GFile's base name, or NULL if given GFile is invalid. The returned string should be - freed with g_free() when no longer needed. + freed with g_free() when no longer needed.
- - @@ -2075,24 +2066,25 @@ This call does no blocking i/o.


g_file_get_uri ()

-
char *              g_file_get_uri                      (GFile *file);
+
char *              g_file_get_uri                      (GFile *file);

Gets the URI for the file.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

Returns :

string containing the GFile's path, or NULL if + string containing the GFile's path, or NULL if no such path exists. The returned string should be - freed with g_free() when no longer needed. + freed with g_free() when no longer needed.
- @@ -2101,7 +2093,7 @@ This call does no blocking i/o.


g_file_get_parse_name ()

-
char *              g_file_get_parse_name               (GFile *file);
+
char *              g_file_get_parse_name               (GFile *file);

Gets the parse name of the file. A parse name is a UTF-8 string that describes the @@ -2119,19 +2111,20 @@ to UTF8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF8 characters unescaped).

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

Returns :

a string containing the GFile's URI. - The returned string should be freed with g_free() when no longer needed. + The returned string should be freed with g_free() when no longer needed.
- @@ -2140,27 +2133,28 @@ This call does no blocking i/o.


g_file_get_parent ()

-
GFile *             g_file_get_parent                   (GFile *file);
+
GFile *             g_file_get_parent                   (GFile *file);

Gets the parent directory for the file. If the file represents the root directory of the -file system, then NULL will be returned. +file system, then NULL will be returned.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

Returns :

a string containing the GFile's parse name. The returned - string should be freed with g_free() when no longer needed. + string should be freed with g_free() when no longer needed.
- @@ -2169,32 +2163,33 @@ This call does no blocking i/o.


g_file_has_parent ()

-
gboolean            g_file_has_parent                   (GFile *file,
-                                                         GFile *parent);
+
gboolean            g_file_has_parent                   (GFile *file,
+                                                         GFile *parent);

Checks if file has a parent, and optionally, if it is parent.

-If parent is NULL then this function returns TRUE if file has any -parent at all. If parent is non-NULL then TRUE is only returned -if file is a child of parent.

+If parent is NULL then this function returns TRUE if file has any +parent at all. If parent is non-NULL then TRUE is only returned +if file is a child of parent. +

file :

input GFile. +input GFile.

Returns :

a GFile structure to the parent of the given - GFile or NULL if there is no parent. - Free the returned object with g_object_unref(). + GFile or NULL if there is no parent. + Free the returned object with g_object_unref().
- - - @@ -2205,8 +2200,8 @@ if file is a child of

g_file_get_child ()

-
GFile *             g_file_get_child                    (GFile *file,
-                                                         const char *name);
+
GFile *             g_file_get_child                    (GFile *file,
+                                                         const char *name);

Gets a child of file with basename equal to name.

@@ -2216,24 +2211,25 @@ you can still have a

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile +input GFile

parent :

the parent to check for, or NULL +the parent to check for, or NULL

Returns :

TRUE if file is a child of parent (or any parent in the - case that parent is NULL). + TRUE if file is a child of parent (or any parent in the + case that parent is NULL).
- - @@ -2242,41 +2238,43 @@ This call does no blocking i/o.


g_file_get_child_for_display_name ()

-
GFile *             g_file_get_child_for_display_name   (GFile *file,
-                                                         const char *display_name,
-                                                         GError **error);
+
GFile *             g_file_get_child_for_display_name   (GFile *file,
+                                                         const char *display_name,
+                                                         GError **error);

Gets the child of file for a given display_name (i.e. a UTF8 -version of the name). If this function fails, it returns NULL and error will be +version of the name). If this function fails, it returns NULL and error will be set. This is very useful when constructing a GFile for a new file and the user entered the filename in the user interface, for instance when you select a directory and type a filename in the file selector.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

name :

string containing the child's basename. +string containing the child's basename.

Returns :

a GFile to a child specified by name. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - - @@ -2285,8 +2283,8 @@ This call does no blocking i/o.


g_file_has_prefix ()

-
gboolean            g_file_has_prefix                   (GFile *file,
-                                                         GFile *prefix);
+
gboolean            g_file_has_prefix                   (GFile *file,
+                                                         GFile *prefix);

Checks whether file has the prefix specified by prefix. In other word, if the names of inital elements of files pathname match prefix. @@ -2295,26 +2293,27 @@ considered a prefix of /foobar, only of /foo/bar.

This call does no i/o, as it works purely on names. As such it can -sometimes return FALSE even if file is inside a prefix (from a +sometimes return FALSE even if file is inside a prefix (from a filesystem point of view), because the prefix of file is an alias -of prefix.

+of prefix. +

file :

input GFile. +input GFile.

display_name :

string to a possible child. +string to a possible child.

error :

GError. + +GError.

Returns :

a GFile to the specified child, or - NULL if the display name couldn't be converted. - Free the returned object with g_object_unref(). + NULL if the display name couldn't be converted. + Free the returned object with g_object_unref().
- - - @@ -2323,31 +2322,32 @@ of prefix.


g_file_get_relative_path ()

-
char *              g_file_get_relative_path            (GFile *parent,
-                                                         GFile *descendant);
+
char *              g_file_get_relative_path            (GFile *parent,
+                                                         GFile *descendant);

Gets the path for descendant relative to parent.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

prefix :

input GFile. +input GFile.

Returns :

TRUE if the files's parent, grandparent, etc is prefix. - FALSE otherwise. + TRUE if the files's parent, grandparent, etc is prefix. + FALSE otherwise.
- - @@ -2356,31 +2356,32 @@ This call does no blocking i/o.


g_file_resolve_relative_path ()

-
GFile *             g_file_resolve_relative_path        (GFile *file,
-                                                         const char *relative_path);
+
GFile *             g_file_resolve_relative_path        (GFile *file,
+                                                         const char *relative_path);

Resolves a relative path for file to an absolute path.

-This call does no blocking i/o.

+This call does no blocking i/o. +

parent :

input GFile. +input GFile.

descendant :

input GFile. +input GFile.

Returns :

string with the relative path from descendant - to parent, or NULL if descendant doesn't have parent as prefix. - The returned string should be freed with g_free() when no longer needed. + to parent, or NULL if descendant doesn't have parent as prefix. + The returned string should be freed with g_free() when no longer needed.
- - - @@ -2389,7 +2390,7 @@ This call does no blocking i/o.


g_file_is_native ()

-
gboolean            g_file_is_native                    (GFile *file);
+
gboolean            g_file_is_native                    (GFile *file);

Checks to see if a file is native to the platform.

@@ -2401,22 +2402,23 @@ as it might be on a locally mounted remote filesystem.

On some systems non-native files may be available using the native filesystem via a userspace filesystem (FUSE), in -these cases this call will return FALSE, but g_file_get_path() +these cases this call will return FALSE, but g_file_get_path() will still return a native path.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

relative_path :

a given relative path string. +a given relative path string.

Returns :

GFile to the resolved path. NULL if relative_path - is NULL or if file is invalid. - Free the returned object with g_object_unref(). + GFile to the resolved path. NULL if relative_path + is NULL or if file is invalid. + Free the returned object with g_object_unref().
- - @@ -2425,30 +2427,31 @@ This call does no blocking i/o.


g_file_has_uri_scheme ()

-
gboolean            g_file_has_uri_scheme               (GFile *file,
-                                                         const char *uri_scheme);
+
gboolean            g_file_has_uri_scheme               (GFile *file,
+                                                         const char *uri_scheme);

Checks to see if a GFile has a given URI scheme.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

Returns :

TRUE if file is native. + TRUE if file is native.
- - - @@ -2458,7 +2461,7 @@ This call does no blocking i/o.


g_file_get_uri_scheme ()

-
char *              g_file_get_uri_scheme               (GFile *file);
+
char *              g_file_get_uri_scheme               (GFile *file);

Gets the URI scheme for a GFile. RFC 3986 decodes the scheme as: @@ -2470,19 +2473,20 @@ URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] Common schemes include "file", "http", "ftp", etc.

-This call does no blocking i/o.

+This call does no blocking i/o. +

file :

input GFile. +input GFile.

uri_scheme :

a string containing a URI scheme. +a string containing a URI scheme.

Returns :

TRUE if GFile's backend supports the - given URI scheme, FALSE if URI scheme is NULL, + TRUE if GFile's backend supports the + given URI scheme, FALSE if URI scheme is NULL, not supported, or GFile is invalid.
- @@ -2492,44 +2496,46 @@ This call does no blocking i/o.


g_file_read ()

-
GFileInputStream *  g_file_read                         (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInputStream *  g_file_read                         (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Opens a file for reading. The result is a GFileInputStream that can be used to read the contents of the file.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. -Other errors are possible too, and depend on what kind of filesystem the file is on.

+Other errors are possible too, and depend on what kind of filesystem the file is on. +

file :

input GFile. +input GFile.

Returns :

a string containing the URI scheme for the given - GFile. The returned string should be freed with g_free() + GFile. The returned string should be freed with g_free() when no longer needed.
- - - - @@ -2538,11 +2544,11 @@ Other errors are possible too, and depend on what kind of filesystem the file is

g_file_read_async ()

-
void                g_file_read_async                   (GFile *file,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_read_async                   (GFile *file,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously opens file for reading.

@@ -2552,34 +2558,35 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_read_finish() to get the result of the operation.

+g_file_read_finish() to get the result of the operation. +

file :

GFile to read. + +GFile to read.

cancellable :

a GCancellable +a GCancellable

error :

a GError, or NULL +a GError, or NULL

Returns :

GFileInputStream or NULL on error. - Free the returned object with g_object_unref(). + GFileInputStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -2588,34 +2595,35 @@ When the operation is finished, callback

g_file_read_finish ()

-
GFileInputStream *  g_file_read_finish                  (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileInputStream *  g_file_read_finish                  (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file read operation started with -g_file_read_async().

+g_file_read_async(). +

file :

input GFile +input GFile

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -2624,10 +2632,10 @@ Finishes an asynchronous file read operation started with

g_file_append_to ()

-
GFileOutputStream * g_file_append_to                    (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileOutputStream * g_file_append_to                    (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Gets an output stream for appending data to the file. If the file doesn't already exist it is created. @@ -2639,7 +2647,7 @@ will be made readable only to the current user, to the level that is supported on the target filesystem.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

@@ -2648,34 +2656,35 @@ Some file systems don't allow all file names, and may return an G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of -filesystem the file is on.

+filesystem the file is on. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileInputStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileInputStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -2684,10 +2693,10 @@ filesystem the file is on.


g_file_create ()

-
GFileOutputStream * g_file_create                       (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileOutputStream * g_file_create                       (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Creates a new file and returns an output stream for writing to it. The file must not already exist. @@ -2699,7 +2708,7 @@ will be made readable only to the current user, to the level that is supported on the target filesystem.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

@@ -2710,35 +2719,36 @@ Some file systems don't allow all file names, and may return an G_IO_ERROR_INVALID_FILENAME error, and if the name is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of -filesystem the file is on.

+filesystem the file is on. +

file :

input GFile. +input GFile.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileOutputStream, or NULL on error. - Free the returned object with g_object_unref(). + a GFileOutputStream, or NULL on error. + Free the returned object with g_object_unref().
- - - - @@ -2747,12 +2757,12 @@ filesystem the file is on.


g_file_replace ()

-
GFileOutputStream * g_file_replace                      (GFile *file,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileOutputStream * g_file_replace                      (GFile *file,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. If the file doesn't exist, @@ -2772,12 +2782,12 @@ will be made readable only to the current user, to the level that is supported on the target filesystem.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

-If you pass in a non-NULL etag value, then this value is +If you pass in a non-NULL etag value, then this value is compared to the current entity tag of the file, and if they differ an G_IO_ERROR_WRONG_ETAG error is returned. This generally means that the file has been changed since you last read it. You can get @@ -2787,10 +2797,10 @@ a new file you can use make_backup is TRUE, this function will attempt to make a backup +If make_backup is TRUE, this function will attempt to make a backup of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP error will be returned. If you want to replace anyway, try again with -make_backup set to FALSE. +make_backup set to FALSE.

If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned, @@ -2800,45 +2810,47 @@ Some file systems don't allow all file names, and may return an G_IO_ERROR_INVALID_FILENAME error, and if the name is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of -filesystem the file is on.

+filesystem the file is on. +

file :

input GFile. +input GFile.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileOutputStream for the newly created file, or - NULL on error. - Free the returned object with g_object_unref(). + NULL on error. + Free the returned object with g_object_unref().
- - - - - - - @@ -2847,12 +2859,12 @@ filesystem the file is on.


g_file_append_to_async ()

-
void                g_file_append_to_async              (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_append_to_async              (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously opens file for appending.

@@ -2862,39 +2874,40 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_append_to_finish() to get the result of the operation.

+g_file_append_to_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

etag :

an optional entity tag for the - current GFile, or NULL to ignore. +an optional entity tag for the + current GFile, or NULL to ignore.

make_backup :

TRUE if a backup should be created. + +TRUE if a backup should be created.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileOutputStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileOutputStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - - @@ -2903,34 +2916,36 @@ When the operation is finished, callback

g_file_append_to_finish ()

-
GFileOutputStream * g_file_append_to_finish             (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileOutputStream * g_file_append_to_finish             (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file append operation started with -g_file_append_to_async().

+g_file_append_to_async(). +

file :

input GFile. +input GFile.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -2939,12 +2954,12 @@ Finishes an asynchronous file append operation started with

g_file_create_async ()

-
void                g_file_create_async                 (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_create_async                 (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously creates a new file and returns an output stream for writing to it. The file must not already exist. @@ -2955,39 +2970,40 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_create_finish() to get the result of the operation.

+g_file_create_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

res :

GAsyncResult + +GAsyncResult

error :

a GError, or NULL +a GError, or NULL

Returns :

a valid GFileOutputStream or NULL on error. - Free the returned object with g_object_unref(). + a valid GFileOutputStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - - @@ -2996,34 +3012,35 @@ When the operation is finished, callback

g_file_create_finish ()

-
GFileOutputStream * g_file_create_finish                (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileOutputStream * g_file_create_finish                (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file create operation started with -g_file_create_async().

+g_file_create_async(). +

file :

input GFile. +input GFile.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3032,14 +3049,14 @@ Finishes an asynchronous file create operation started with

g_file_replace_async ()

-
void                g_file_replace_async                (GFile *file,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_replace_async                (GFile *file,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first. @@ -3050,50 +3067,52 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_replace_finish() to get the result of the operation.

+g_file_replace_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileOutputStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileOutputStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - - - - @@ -3102,34 +3121,35 @@ When the operation is finished, callback

g_file_replace_finish ()

-
GFileOutputStream * g_file_replace_finish               (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileOutputStream * g_file_replace_finish               (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file replace operation started with -g_file_replace_async().

+g_file_replace_async(). +

file :

input GFile. +input GFile.

etag :

an entity tag for the +an entity tag for the current GFile, or NULL to ignore.

make_backup :

TRUE if a backup should be created. + +TRUE if a backup should be created.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3138,11 +3158,11 @@ Finishes an asynchronous file replace operation started with

g_file_query_info ()

-
GFileInfo *         g_file_query_info                   (GFile *file,
-                                                         const char *attributes,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_query_info                   (GFile *file,
+                                                         const char *attributes,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Gets the requested information about specified file. The result is a GFileInfo object that contains key-value attributes (such as @@ -3158,7 +3178,7 @@ namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

@@ -3172,39 +3192,40 @@ will be returned.

If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. -Other errors are possible too, and depend on what kind of filesystem the file is on.

+Other errors are possible too, and depend on what kind of filesystem the file is on. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileOutputStream, or NULL on error. - Free the returned object with g_object_unref(). + a GFileOutputStream, or NULL on error. + Free the returned object with g_object_unref().
- - - - - - @@ -3213,13 +3234,13 @@ Other errors are possible too, and depend on what kind of filesystem the file is

g_file_query_info_async ()

-
void                g_file_query_info_async             (GFile *file,
-                                                         const char *attributes,
-                                                         GFileQueryInfoFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_query_info_async             (GFile *file,
+                                                         const char *attributes,
+                                                         GFileQueryInfoFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously gets the requested information about specified file. The result is a GFileInfo object that contains key-value attributes (such as type or size @@ -3231,44 +3252,45 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_query_info_finish() to get the result of the operation.

+g_file_query_info_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

flags :

a set of GFileQueryInfoFlags. +a set of GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError. +a GError.

Returns :

a GFileInfo for the given file, or NULL on error. - Free the returned object with g_object_unref(). + a GFileInfo for the given file, or NULL on error. + Free the returned object with g_object_unref().
- - - - - - - @@ -3277,34 +3299,35 @@ When the operation is finished, callback

g_file_query_info_finish ()

-
GFileInfo *         g_file_query_info_finish            (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileInfo *         g_file_query_info_finish            (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file info query. -See g_file_query_info_async().

+See g_file_query_info_async(). +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

flags :

a set of GFileQueryInfoFlags. +a set of GFileQueryInfoFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3313,8 +3336,8 @@ See

g_file_query_exists ()

-
gboolean            g_file_query_exists                 (GFile *file,
-                                                         GCancellable *cancellable);
+
gboolean            g_file_query_exists                 (GFile *file,
+                                                         GCancellable *cancellable);

Utility function to check if a particular file exists. This is implemented using g_file_query_info() and as such does blocking I/O. @@ -3340,23 +3363,24 @@ However, in many cases an existence check is useful in a user interface, for instance to make a menu item sensitive/insensitive, so that you don't have to fool users that something is possible and then just show and error dialog. If you do this, you should make sure to also handle the -errors that can happen due to races when you execute the operation.

+errors that can happen due to races when you execute the operation. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError. +a GError.

Returns :

GFileInfo for given file or NULL on error. - Free the returned object with g_object_unref(). + GFileInfo for given file or NULL on error. + Free the returned object with g_object_unref().
- - - @@ -3365,32 +3389,33 @@ errors that can happen due to races when you execute the operation.


g_file_query_file_type ()

-
GFileType           g_file_query_file_type              (GFile *file,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable);
+
GFileType           g_file_query_file_type              (GFile *file,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable);

Utility function to inspect the GFileType of a file. This is implemented using g_file_query_info() and as such does blocking I/O.

The primary use case of this method is to check if a file is a regular file, -directory, or symlink.

+directory, or symlink. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

Returns :

TRUE if the file exists (and can be detected without error), FALSE otherwise (or if cancelled). + TRUE if the file exists (and can be detected without error), FALSE otherwise (or if cancelled).
- - - @@ -3407,10 +3432,10 @@ directory, or symlink.


g_file_query_filesystem_info ()

-
GFileInfo *         g_file_query_filesystem_info        (GFile *file,
-                                                         const char *attributes,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_query_filesystem_info        (GFile *file,
+                                                         const char *attributes,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Similar to g_file_query_info(), but obtains information about the filesystem the file is on, rather than the file itself. @@ -3429,40 +3454,41 @@ Common attributes of interest are G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. -Other errors are possible too, and depend on what kind of filesystem the file is on.

+Other errors are possible too, and depend on what kind of filesystem the file is on. +

file :

input GFile. +input GFile.

flags :

a set of GFileQueryInfoFlags passed to g_file_query_info(). +a set of GFileQueryInfoFlags passed to g_file_query_info().

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.
- - - - - @@ -3471,12 +3497,12 @@ Other errors are possible too, and depend on what kind of filesystem the file is

g_file_query_filesystem_info_async ()

-
void                g_file_query_filesystem_info_async  (GFile *file,
-                                                         const char *attributes,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_query_filesystem_info_async  (GFile *file,
+                                                         const char *attributes,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously gets the requested information about the filesystem that the specified file is on. The result is a GFileInfo object @@ -3490,39 +3516,40 @@ synchronous version of this call.

When the operation is finished, callback will be called. You can then call g_file_query_info_finish() to get the result of the -operation.

+operation. +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError. +a GError.

Returns :

a GFileInfo or NULL if there was an error. - Free the returned object with g_object_unref(). + a GFileInfo or NULL if there was an error. + Free the returned object with g_object_unref().
- - - - - - @@ -3531,34 +3558,35 @@ operation.


g_file_query_filesystem_info_finish ()

-
GFileInfo *         g_file_query_filesystem_info_finish (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileInfo *         g_file_query_filesystem_info_finish (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous filesystem info query. See -g_file_query_filesystem_info_async().

+g_file_query_filesystem_info_async(). +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3567,39 +3595,40 @@ Finishes an asynchronous filesystem info query. See

g_file_query_default_handler ()

-
GAppInfo *          g_file_query_default_handler        (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GAppInfo *          g_file_query_default_handler        (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Returns the GAppInfo that is registered as the default application to handle the file specified by file.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError. +a GError.

Returns :

GFileInfo for given file or NULL on error. - Free the returned object with g_object_unref(). + GFileInfo for given file or NULL on error. + Free the returned object with g_object_unref().
- - - - @@ -3608,43 +3637,44 @@ When you are done with it, release it with

g_file_find_enclosing_mount ()

-
GMount *            g_file_find_enclosing_mount         (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GMount *            g_file_find_enclosing_mount         (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Gets a GMount for the GFile.

If the GFileIface for file does not have a mount (e.g. possibly a -remote share), error will be set to G_IO_ERROR_NOT_FOUND and NULL +remote share), error will be set to G_IO_ERROR_NOT_FOUND and NULL will be returned.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

a GFile to open. +a GFile to open.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GAppInfo if the handle was found, NULL if there were errors. -When you are done with it, release it with g_object_unref() + a GAppInfo if the handle was found, NULL if there were errors. +When you are done with it, release it with g_object_unref()
- - - - @@ -3653,11 +3683,11 @@ was cancelled, the error

g_file_find_enclosing_mount_async ()

-
void                g_file_find_enclosing_mount_async   (GFile *file,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_find_enclosing_mount_async   (GFile *file,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously gets the mount for the file.

@@ -3667,34 +3697,35 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_find_enclosing_mount_finish() to get the result of the operation.

+g_file_find_enclosing_mount_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError. +a GError.

Returns :

a GMount where the file is located or NULL on error. - Free the returned object with g_object_unref(). + a GMount where the file is located or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -3703,34 +3734,35 @@ When the operation is finished, callback

g_file_find_enclosing_mount_finish ()

-
GMount *            g_file_find_enclosing_mount_finish  (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GMount *            g_file_find_enclosing_mount_finish  (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous find mount request. -See g_file_find_enclosing_mount_async().

+See g_file_find_enclosing_mount_async(). +

file :

a GFile +a GFile

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3739,11 +3771,11 @@ See

g_file_enumerate_children ()

-
GFileEnumerator *   g_file_enumerate_children           (GFile *file,
-                                                         const char *attributes,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileEnumerator *   g_file_enumerate_children           (GFile *file,
+                                                         const char *attributes,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Gets the requested information about the files in a directory. The result is a GFileEnumerator object that will give out GFileInfo objects for @@ -3759,46 +3791,48 @@ namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned. -Other errors are possible too.

+Other errors are possible too. +

file :

a GFile +a GFile

res :

a GAsyncResult +a GAsyncResult

error :

a GError +a GError

Returns :

GMount for given file or NULL on error. - Free the returned object with g_object_unref(). + GMount for given file or NULL on error. + Free the returned object with g_object_unref().
- - - - - - @@ -3807,13 +3841,13 @@ Other errors are possible too.


g_file_enumerate_children_async ()

-
void                g_file_enumerate_children_async     (GFile *file,
-                                                         const char *attributes,
-                                                         GFileQueryInfoFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_enumerate_children_async     (GFile *file,
+                                                         const char *attributes,
+                                                         GFileQueryInfoFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously gets the requested information about the files in a directory. The result is a GFileEnumerator object that will give out GFileInfo objects for @@ -3825,44 +3859,45 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_enumerate_children_finish() to get the result of the operation.

+g_file_enumerate_children_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

flags :

a set of GFileQueryInfoFlags. +a set of GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting. + +GError for error reporting.

Returns :

A GFileEnumerator if successful, NULL on error. - Free the returned object with g_object_unref(). + A GFileEnumerator if successful, NULL on error. + Free the returned object with g_object_unref().
- - - - - - - @@ -3871,34 +3906,35 @@ When the operation is finished, callback

g_file_enumerate_children_finish ()

-
GFileEnumerator *   g_file_enumerate_children_finish    (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileEnumerator *   g_file_enumerate_children_finish    (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an async enumerate children operation. -See g_file_enumerate_children_async().

+See g_file_enumerate_children_async(). +

file :

input GFile. +input GFile.

attributes :

an attribute query string. +an attribute query string.

flags :

a set of GFileQueryInfoFlags. +a set of GFileQueryInfoFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -3907,10 +3943,10 @@ See

g_file_set_display_name ()

-
GFile *             g_file_set_display_name             (GFile *file,
-                                                         const char *display_name,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFile *             g_file_set_display_name             (GFile *file,
+                                                         const char *display_name,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Renames file to the specified display name.

@@ -3927,37 +3963,38 @@ widget, and then the result after editing should be passed to

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError. +a GError.

Returns :

a GFileEnumerator or NULL if an error occurred. - Free the returned object with g_object_unref(). + a GFileEnumerator or NULL if an error occurred. + Free the returned object with g_object_unref().
- - - - - @@ -3966,12 +4003,12 @@ was cancelled, the error

g_file_set_display_name_async ()

-
void                g_file_set_display_name_async       (GFile *file,
-                                                         const char *display_name,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_set_display_name_async       (GFile *file,
+                                                         const char *display_name,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously sets the display name for a given GFile.

@@ -3981,39 +4018,40 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_set_display_name_finish() to get the result of the operation.

+g_file_set_display_name_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

display_name :

a string. +a string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFile specifying what file was renamed to, or NULL + a GFile specifying what file was renamed to, or NULL if there was an error. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - - - - - @@ -4022,34 +4060,35 @@ When the operation is finished, callback

g_file_set_display_name_finish ()

-
GFile *             g_file_set_display_name_finish      (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFile *             g_file_set_display_name_finish      (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes setting a display name started with -g_file_set_display_name_async().

+g_file_set_display_name_async(). +

file :

input GFile. +input GFile.

display_name :

a string. +a string.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -4058,38 +4097,39 @@ Finishes setting a display name started with

g_file_delete ()

-
gboolean            g_file_delete                       (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_delete                       (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Deletes a file. If the file is a directory, it will only be deleted if it is empty.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFile or NULL on error. - Free the returned object with g_object_unref(). + a GFile or NULL on error. + Free the returned object with g_object_unref().
- - - - @@ -4098,9 +4138,9 @@ was cancelled, the error

g_file_trash ()

-
gboolean            g_file_trash                        (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_trash                        (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sends file to the "Trashcan", if possible. This is similar to deleting it, but the user can recover it before emptying the trashcan. @@ -4108,30 +4148,32 @@ Not all file systems support trashing, so this call can return the G_IO_ERROR_NOT_SUPPORTED error.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the file was deleted. FALSE otherwise. + TRUE if the file was deleted. FALSE otherwise.
- - - - @@ -4140,13 +4182,13 @@ was cancelled, the error

g_file_copy ()

-
gboolean            g_file_copy                         (GFile *source,
-                                                         GFile *destination,
-                                                         GFileCopyFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GFileProgressCallback progress_callback,
-                                                         gpointer progress_callback_data,
-                                                         GError **error);
+
gboolean            g_file_copy                         (GFile *source,
+                                                         GFile *destination,
+                                                         GFileCopyFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GFileProgressCallback progress_callback,
+                                                         gpointer progress_callback_data,
+                                                         GError **error);

Copies the file source to the location specified by destination. Can not handle recursive copies of directories. @@ -4161,12 +4203,12 @@ will be copied as symlinks, otherwise the target of the source symlink will be copied.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

-If progress_callback is not NULL, then the operation can be monitored by +If progress_callback is not NULL, then the operation can be monitored by setting this to a GFileProgressCallback function. progress_callback_data will be passed to this function. It is guaranteed that this callback will be called after all data has been transferred with the total number of bytes @@ -4192,48 +4234,50 @@ is returned.

If you are interested in copying the GFile object itself (not the on-disk -file), see g_file_dup().

+file), see g_file_dup(). +

file :

GFile to send to trash. + +GFile to send to trash.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE on successful trash, FALSE otherwise. + TRUE on successful trash, FALSE otherwise.
- - - - - - - - @@ -4242,74 +4286,75 @@ file), see

g_file_copy_async ()

-
void                g_file_copy_async                   (GFile *source,
-                                                         GFile *destination,
-                                                         GFileCopyFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GFileProgressCallback progress_callback,
-                                                         gpointer progress_callback_data,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_copy_async                   (GFile *source,
+                                                         GFile *destination,
+                                                         GFileCopyFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GFileProgressCallback progress_callback,
+                                                         gpointer progress_callback_data,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Copies the file source to the location specified by destination asynchronously. For details of the behaviour, see g_file_copy().

-If progress_callback is not NULL, then that function that will be called +If progress_callback is not NULL, then that function that will be called just like in g_file_copy(), however the callback will run in the main loop, not in the thread that is doing the I/O operation.

When the operation is finished, callback will be called. You can then call -g_file_copy_finish() to get the result of the operation.

+g_file_copy_finish() to get the result of the operation. +

source :

input GFile. +input GFile.

destination :

destination GFile +destination GFile

flags :

set of GFileCopyFlags +set of GFileCopyFlags

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

progress_callback :

function to callback with progress information +function to callback with progress information

progress_callback_data :

user data to pass to progress_callback +user data to pass to progress_callback

error :

GError to set on error, or NULL + +GError to set on error, or NULL

Returns :

TRUE on success, FALSE otherwise. + TRUE on success, FALSE otherwise.
- - - - - - - - - @@ -4318,33 +4363,34 @@ When the operation is finished, callback

g_file_copy_finish ()

-
gboolean            g_file_copy_finish                  (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
gboolean            g_file_copy_finish                  (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes copying the file started with -g_file_copy_async().

+g_file_copy_async(). +

source :

input GFile. +input GFile.

destination :

destination GFile +destination GFile

flags :

set of GFileCopyFlags +set of GFileCopyFlags

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

progress_callback :

function to callback with progress information +function to callback with progress information

progress_callback_data :

user data to pass to progress_callback +user data to pass to progress_callback

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -4353,13 +4399,13 @@ Finishes copying the file started with

g_file_move ()

-
gboolean            g_file_move                         (GFile *source,
-                                                         GFile *destination,
-                                                         GFileCopyFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GFileProgressCallback progress_callback,
-                                                         gpointer progress_callback_data,
-                                                         GError **error);
+
gboolean            g_file_move                         (GFile *source,
+                                                         GFile *destination,
+                                                         GFileCopyFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GFileProgressCallback progress_callback,
+                                                         gpointer progress_callback_data,
+                                                         GError **error);

Tries to move the file or directory source to the location specified by destination. If native move operations are supported then this is used, otherwise a copy + delete @@ -4376,12 +4422,12 @@ will be copied as symlinks, otherwise the target of the source symlink will be copied.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

-If progress_callback is not NULL, then the operation can be monitored by +If progress_callback is not NULL, then the operation can be monitored by setting this to a GFileProgressCallback function. progress_callback_data will be passed to this function. It is guaranteed that this callback will be called after all data has been transferred with the total number of bytes @@ -4403,48 +4449,53 @@ G_IO_ERROR_WOULD_MERGE error is returned.

If the source is a directory and the target does not exist, or G_FILE_COPY_OVERWRITE is specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error -may be returned (if the native move operation isn't available).

+may be returned (if the native move operation isn't available). +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a TRUE on success, FALSE on error. + a TRUE on success, FALSE on error.
- - - - - - - - @@ -4453,9 +4504,9 @@ may be returned (if the native move operation isn't available).


g_file_make_directory ()

-
gboolean            g_file_make_directory               (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_make_directory               (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Creates a directory. Note that this will only create a child directory of the immediate parent directory of the path or URI given by the GFile. To @@ -4470,30 +4521,31 @@ For a local G (current) ownership and permissions of the current process.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

source :

GFile pointing to the source location. + +GFile pointing to the source location.

destination :

GFile pointing to the destination location. + +GFile pointing to the destination location.

flags :

set of GFileCopyFlags. +set of GFileCopyFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

progress_callback :

GFileProgressCallback function for updates. + +GFileProgressCallback function for updates.

progress_callback_data :

gpointer to user data for the callback function. +gpointer to user data for the callback function.

error :

GError for returning error conditions, or NULL + +GError for returning error conditions, or NULL

Returns :

TRUE on successful move, FALSE otherwise. + TRUE on successful move, FALSE otherwise.
- - - - @@ -4502,9 +4554,9 @@ was cancelled, the error

g_file_make_directory_with_parents ()

-
gboolean            g_file_make_directory_with_parents  (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_make_directory_with_parents  (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Creates a directory and any parent directories that may not exist similar to 'mkdir -p'. If the file system does not support creating directories, this @@ -4515,30 +4567,31 @@ For a local G (current) ownership and permissions of the current process.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE on successful creation, FALSE otherwise. + TRUE on successful creation, FALSE otherwise.
- - - - @@ -4550,43 +4603,44 @@ otherwise.

g_file_make_symbolic_link ()

-
gboolean            g_file_make_symbolic_link           (GFile *file,
-                                                         const char *symlink_value,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_make_symbolic_link           (GFile *file,
+                                                         const char *symlink_value,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Creates a symbolic link.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if all directories have been successfully created, FALSE + TRUE if all directories have been successfully created, FALSE otherwise.
- - - - - @@ -4596,9 +4650,9 @@ was cancelled, the error

g_file_query_settable_attributes ()

GFileAttributeInfoList * g_file_query_settable_attributes
-                                                        (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+ (GFile *file, + GCancellable *cancellable, + GError **error);

Obtain the list of settable attributes for the file.

@@ -4609,25 +4663,26 @@ succeed though, you might get an access failure, or some specific file may not support a specific attribute.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

symlink_value :

a string with the value of the new symlink. +a string with the value of the new symlink.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError. +a GError.

Returns :

TRUE on the creation of a new symlink, FALSE otherwise. + TRUE on the creation of a new symlink, FALSE otherwise.
- - - @@ -4643,34 +4698,35 @@ When you are done with it, release it with

g_file_query_writable_namespaces ()

GFileAttributeInfoList * g_file_query_writable_namespaces
-                                                        (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+ (GFile *file, + GCancellable *cancellable, + GError **error);

Obtain the list of attribute namespaces where new attributes can be created by a user. An example of this is extended attributes (in the "xattr" namespace).

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL
- - - @@ -4685,61 +4741,62 @@ When you are done with it, release it with

g_file_set_attribute ()

-
gboolean            g_file_set_attribute                (GFile *file,
-                                                         const char *attribute,
-                                                         GFileAttributeType type,
-                                                         gpointer value_p,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute                (GFile *file,
+                                                         const char *attribute,
+                                                         GFileAttributeType type,
+                                                         gpointer value_p,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets an attribute in the file with attribute name attribute to value.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL
- - - - - - - - @@ -4748,11 +4805,11 @@ was cancelled, the error

g_file_set_attributes_from_info ()

-
gboolean            g_file_set_attributes_from_info     (GFile *file,
-                                                         GFileInfo *info,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attributes_from_info     (GFile *file,
+                                                         GFileInfo *info,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to set all attributes in the GFileInfo on the target values, not stopping on the first error. @@ -4765,40 +4822,42 @@ the "status" field in the attribute value to further errors.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

type :

The type of the attribute +The type of the attribute

value_p :

a pointer to the value (or the pointer itself if the type is a pointer type) +a pointer to the value (or the pointer itself if the type is a pointer type)

flags :

a set of GFileQueryInfoFlags. +a set of GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was set, FALSE otherwise. + TRUE if the attribute was set, FALSE otherwise.
- - - - - - @@ -4807,13 +4866,13 @@ was cancelled, the error

g_file_set_attributes_async ()

-
void                g_file_set_attributes_async         (GFile *file,
-                                                         GFileInfo *info,
-                                                         GFileQueryInfoFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_set_attributes_async         (GFile *file,
+                                                         GFileInfo *info,
+                                                         GFileQueryInfoFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously sets the attributes of file with info.

@@ -4823,44 +4882,45 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_set_attributes_finish() to get the result of the operation.

+g_file_set_attributes_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

info :

a GFileInfo. +a GFileInfo.

flags :

GFileQueryInfoFlags + +GFileQueryInfoFlags

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if there was any error, FALSE otherwise. + TRUE if there was any error, FALSE otherwise.
- - - - - - - @@ -4869,38 +4929,39 @@ When the operation is finished, callback

g_file_set_attributes_finish ()

-
gboolean            g_file_set_attributes_finish        (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GFileInfo **info,
-                                                         GError **error);
+
gboolean            g_file_set_attributes_finish        (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GFileInfo **info,
+                                                         GError **error);

-Finishes setting an attribute started in g_file_set_attributes_async().

+Finishes setting an attribute started in g_file_set_attributes_async(). +

file :

input GFile. +input GFile.

info :

a GFileInfo. +a GFileInfo.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

a gpointer. +a gpointer.
- - - - - @@ -4909,56 +4970,58 @@ Finishes setting an attribute started in

g_file_set_attribute_string ()

-
gboolean            g_file_set_attribute_string         (GFile *file,
-                                                         const char *attribute,
-                                                         const char *value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_string         (GFile *file,
+                                                         const char *attribute,
+                                                         const char *value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_STRING to value. If attribute is of a different type, this operation will fail.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

info :

a GFileInfo. +a GFileInfo.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attributes were set correctly, FALSE otherwise. + TRUE if the attributes were set correctly, FALSE otherwise.
- - - - - - - @@ -4967,58 +5030,59 @@ was cancelled, the error

g_file_set_attribute_byte_string ()

-
gboolean            g_file_set_attribute_byte_string    (GFile *file,
-                                                         const char *attribute,
-                                                         const char *value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_byte_string    (GFile *file,
+                                                         const char *attribute,
+                                                         const char *value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to value. If attribute is of a different type, this operation will fail, -returning FALSE. +returning FALSE.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a string containing the attribute's value. +a string containing the attribute's value.

flags :

GFileQueryInfoFlags. + +GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set, FALSE otherwise. + TRUE if the attribute was successfully set, FALSE otherwise.
- - - - - - - @@ -5027,57 +5091,58 @@ in the file,

g_file_set_attribute_uint32 ()

-
gboolean            g_file_set_attribute_uint32         (GFile *file,
-                                                         const char *attribute,
-                                                         guint32 value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_uint32         (GFile *file,
+                                                         const char *attribute,
+                                                         guint32 value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_UINT32 to value. If attribute is of a different type, this operation will fail.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a string containing the attribute's new value. +a string containing the attribute's new value.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set to value -in the file, FALSE otherwise. + TRUE if the attribute was successfully set to value +in the file, FALSE otherwise.
- - - - - - - @@ -5086,57 +5151,58 @@ in the file,

g_file_set_attribute_int32 ()

-
gboolean            g_file_set_attribute_int32          (GFile *file,
-                                                         const char *attribute,
-                                                         gint32 value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_int32          (GFile *file,
+                                                         const char *attribute,
+                                                         gint32 value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_INT32 to value. If attribute is of a different type, this operation will fail.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a guint32 containing the attribute's new value. +a guint32 containing the attribute's new value.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set to value -in the file, FALSE otherwise. + TRUE if the attribute was successfully set to value +in the file, FALSE otherwise.
- - - - - - - @@ -5145,57 +5211,58 @@ in the file,

g_file_set_attribute_uint64 ()

-
gboolean            g_file_set_attribute_uint64         (GFile *file,
-                                                         const char *attribute,
-                                                         guint64 value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_uint64         (GFile *file,
+                                                         const char *attribute,
+                                                         guint64 value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_UINT64 to value. If attribute is of a different type, this operation will fail.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a gint32 containing the attribute's new value. +a gint32 containing the attribute's new value.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set to value -in the file, FALSE otherwise. + TRUE if the attribute was successfully set to value +in the file, FALSE otherwise.
- - - - - - - @@ -5204,56 +5271,57 @@ in the file,

g_file_set_attribute_int64 ()

-
gboolean            g_file_set_attribute_int64          (GFile *file,
-                                                         const char *attribute,
-                                                         gint64 value,
-                                                         GFileQueryInfoFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_set_attribute_int64          (GFile *file,
+                                                         const char *attribute,
+                                                         gint64 value,
+                                                         GFileQueryInfoFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Sets attribute of type G_FILE_ATTRIBUTE_TYPE_INT64 to value. If attribute is of a different type, this operation will fail.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a guint64 containing the attribute's new value. +a guint64 containing the attribute's new value.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set to value -in the file, FALSE otherwise. + TRUE if the attribute was successfully set to value +in the file, FALSE otherwise.
- - - - - - - @@ -5262,56 +5330,57 @@ was cancelled, the error

g_file_mount_mountable ()

-
void                g_file_mount_mountable              (GFile *file,
-                                                         GMountMountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_mount_mountable              (GFile *file,
+                                                         GMountMountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Mounts a file of type G_FILE_TYPE_MOUNTABLE. Using mount_operation, you can request callbacks when, for instance, passwords are needed during authentication.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_mount_mountable_finish() to get the result of the operation.

+g_file_mount_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

attribute :

a string containing the attribute's name. +a string containing the attribute's name.

value :

a guint64 containing the attribute's new value. +a guint64 containing the attribute's new value.

flags :

a GFileQueryInfoFlags. +a GFileQueryInfoFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the attribute was successfully set, FALSE otherwise. + TRUE if the attribute was successfully set, FALSE otherwise.
- - - - - - @@ -5320,37 +5389,38 @@ When the operation is finished, callback

g_file_mount_mountable_finish ()

-
GFile *             g_file_mount_mountable_finish       (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GFile *             g_file_mount_mountable_finish       (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes a mount operation. See g_file_mount_mountable() for details.

Finish an asynchronous mount operation that was started -with g_file_mount_mountable().

+with g_file_mount_mountable(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation, or NULL to avoid user interaction. +a GMountOperation, or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5359,11 +5429,11 @@ with

g_file_unmount_mountable ()

-
void                g_file_unmount_mountable            (GFile *file,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_unmount_mountable            (GFile *file,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_file_unmount_mountable has been deprecated since version 2.22 and should not be used in newly-written code. Use g_file_unmount_mountable_with_operation() instead.

@@ -5372,39 +5442,40 @@ with cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_unmount_mountable_finish() to get the result of the operation.

+g_file_unmount_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFile or NULL on error. - Free the returned object with g_object_unref(). + a GFile or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -5413,9 +5484,9 @@ When the operation is finished, callback

g_file_unmount_mountable_finish ()

-
gboolean            g_file_unmount_mountable_finish     (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_unmount_mountable_finish     (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_file_unmount_mountable_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_file_unmount_mountable_with_operation_finish() instead.

@@ -5425,28 +5496,29 @@ Finishes an unmount operation, see g_file_unmount_mountable().

+with g_file_unmount_mountable(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5458,54 +5530,55 @@ otherwise.

g_file_unmount_mountable_with_operation ()

void                g_file_unmount_mountable_with_operation
-                                                        (GFile *file,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GFile *file, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Unmounts a file of type G_FILE_TYPE_MOUNTABLE.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_unmount_mountable_finish() to get the result of the operation.

+g_file_unmount_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the operation finished successfully. FALSE + TRUE if the operation finished successfully. FALSE otherwise.
- - - - - - @@ -5515,37 +5588,38 @@ When the operation is finished, callback

g_file_unmount_mountable_with_operation_finish ()

-
gboolean            g_file_unmount_mountable_with_operation_finish
-                                                        (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_unmount_mountable_with_operation_finish
+                                                        (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.

Finish an asynchronous unmount operation that was started -with g_file_unmount_mountable_with_operation().

+with g_file_unmount_mountable_with_operation(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation, or NULL to avoid user interaction. +a GMountOperation, or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5557,11 +5631,11 @@ otherwise.

g_file_eject_mountable ()

-
void                g_file_eject_mountable              (GFile *file,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_eject_mountable              (GFile *file,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_file_eject_mountable has been deprecated since version 2.22 and should not be used in newly-written code. Use g_file_eject_mountable_with_operation() instead.

@@ -5573,35 +5647,36 @@ When this operation has completed, callbackg_file_eject_mountable_finish().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the operation finished successfully. FALSE + TRUE if the operation finished successfully. FALSE otherwise.
- - - - - @@ -5610,37 +5685,38 @@ was cancelled, the error

g_file_eject_mountable_finish ()

-
gboolean            g_file_eject_mountable_finish       (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_eject_mountable_finish       (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_file_eject_mountable_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_file_eject_mountable_with_operation_finish() instead.

Finishes an asynchronous eject operation started by -g_file_eject_mountable().

+g_file_eject_mountable(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5652,12 +5728,12 @@ otherwise.

g_file_eject_mountable_with_operation ()

void                g_file_eject_mountable_with_operation
-                                                        (GFile *file,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GFile *file, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Starts an asynchronous eject on a mountable. When this operation has completed, callback will be called with @@ -5665,40 +5741,41 @@ When this operation has completed, callbackg_file_eject_mountable_with_operation_finish().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the file was ejected successfully. FALSE + TRUE if the file was ejected successfully. FALSE otherwise.
- - - - - - @@ -5708,34 +5785,35 @@ was cancelled, the error

g_file_eject_mountable_with_operation_finish ()

-
gboolean            g_file_eject_mountable_with_operation_finish
-                                                        (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_eject_mountable_with_operation_finish
+                                                        (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes an asynchronous eject operation started by -g_file_eject_mountable_with_operation().

+g_file_eject_mountable_with_operation(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation, or NULL to avoid user interaction. +a GMountOperation, or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5747,56 +5825,57 @@ otherwise.

g_file_start_mountable ()

-
void                g_file_start_mountable              (GFile *file,
-                                                         GDriveStartFlags flags,
-                                                         GMountOperation *start_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_start_mountable              (GFile *file,
+                                                         GDriveStartFlags flags,
+                                                         GMountOperation *start_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Starts a file of type G_FILE_TYPE_MOUNTABLE. Using start_operation, you can request callbacks when, for instance, passwords are needed during authentication.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_mount_mountable_finish() to get the result of the operation.

+g_file_mount_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the file was ejected successfully. FALSE + TRUE if the file was ejected successfully. FALSE otherwise.
- - - - - - @@ -5806,36 +5885,37 @@ When the operation is finished, callback

g_file_start_mountable_finish ()

-
gboolean            g_file_start_mountable_finish       (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_start_mountable_finish       (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes a start operation. See g_file_start_mountable() for details.

Finish an asynchronous start operation that was started -with g_file_start_mountable().

+with g_file_start_mountable(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

start_operation :

a GMountOperation, or NULL to avoid user interaction. +a GMountOperation, or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5847,54 +5927,55 @@ otherwise.

g_file_stop_mountable ()

-
void                g_file_stop_mountable               (GFile *file,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_stop_mountable               (GFile *file,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Stops a file of type G_FILE_TYPE_MOUNTABLE.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_stop_mountable_finish() to get the result of the operation.

+g_file_stop_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the operation finished successfully. FALSE + TRUE if the operation finished successfully. FALSE otherwise.
- - - - - - @@ -5904,36 +5985,37 @@ When the operation is finished, callback

g_file_stop_mountable_finish ()

-
gboolean            g_file_stop_mountable_finish        (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_stop_mountable_finish        (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes an stop operation, see g_file_stop_mountable() for details.

Finish an asynchronous stop operation that was started -with g_file_stop_mountable().

+with g_file_stop_mountable(). +

file :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation, or NULL to avoid user interaction. +a GMountOperation, or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -5945,42 +6027,43 @@ otherwise.

g_file_poll_mountable ()

-
void                g_file_poll_mountable               (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_poll_mountable               (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Polls a file of type G_FILE_TYPE_MOUNTABLE.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

When the operation is finished, callback will be called. You can then call -g_file_mount_mountable_finish() to get the result of the operation.

+g_file_mount_mountable_finish() to get the result of the operation. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the operation finished successfully. FALSE + TRUE if the operation finished successfully. FALSE otherwise.
- - - - @@ -5990,36 +6073,37 @@ When the operation is finished, callback

g_file_poll_mountable_finish ()

-
gboolean            g_file_poll_mountable_finish        (GFile *file,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_poll_mountable_finish        (GFile *file,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes a poll operation. See g_file_poll_mountable() for details.

Finish an asynchronous poll operation that was polled -with g_file_poll_mountable().

+with g_file_poll_mountable(). +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -6031,12 +6115,12 @@ otherwise.

g_file_mount_enclosing_volume ()

-
void                g_file_mount_enclosing_volume       (GFile *location,
-                                                         GMountMountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_mount_enclosing_volume       (GFile *location,
+                                                         GMountMountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Starts a mount_operation, mounting the volume that contains the file location.

@@ -6046,40 +6130,41 @@ When this operation has completed, callbackg_file_mount_enclosing_volume_finish().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the operation finished successfully. FALSE + TRUE if the operation finished successfully. FALSE otherwise.
- - - - - - @@ -6088,34 +6173,35 @@ was cancelled, the error

g_file_mount_enclosing_volume_finish ()

-
gboolean            g_file_mount_enclosing_volume_finish
-                                                        (GFile *location,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_mount_enclosing_volume_finish
+                                                        (GFile *location,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes a mount operation started by g_file_mount_enclosing_volume().

+Finishes a mount operation started by g_file_mount_enclosing_volume(). +

location :

input GFile. +input GFile.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied, or NULL. +a GAsyncReadyCallback to call when the request is satisfied, or NULL.

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -6125,45 +6211,46 @@ appropriately if present.

g_file_monitor_directory ()

-
GFileMonitor*       g_file_monitor_directory            (GFile *file,
-                                                         GFileMonitorFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileMonitor*       g_file_monitor_directory            (GFile *file,
+                                                         GFileMonitorFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Obtains a directory monitor for the given file. This may fail if directory monitoring is not supported.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

location :

input GFile. +input GFile.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if successful. If an error -has occurred, this function will return FALSE and set error + TRUE if successful. If an error +has occurred, this function will return FALSE and set error appropriately if present.
- - - - - @@ -6172,45 +6259,46 @@ was cancelled, the error

g_file_monitor_file ()

-
GFileMonitor*       g_file_monitor_file                 (GFile *file,
-                                                         GFileMonitorFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileMonitor*       g_file_monitor_file                 (GFile *file,
+                                                         GFileMonitorFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Obtains a file monitor for the given file. If no file notification mechanism exists, then regular polling of the file is used.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

flags :

a set of GFileMonitorFlags. +a set of GFileMonitorFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL. +a GError, or NULL.

Returns :

a GFileMonitor for the given file, or NULL on error. - Free the returned object with g_object_unref(). + a GFileMonitor for the given file, or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -6219,45 +6307,46 @@ was cancelled, the error

g_file_monitor ()

-
GFileMonitor*       g_file_monitor                      (GFile *file,
-                                                         GFileMonitorFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileMonitor*       g_file_monitor                      (GFile *file,
+                                                         GFileMonitorFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Obtains a file or directory monitor for the given file, depending on the type of the file.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

flags :

a set of GFileMonitorFlags. +a set of GFileMonitorFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL. +a GError, or NULL.

Returns :

a GFileMonitor for the given file, or NULL on error. - Free the returned object with g_object_unref(). + a GFileMonitor for the given file, or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -6268,61 +6357,62 @@ was cancelled, the error

g_file_load_contents ()

-
gboolean            g_file_load_contents                (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         char **contents,
-                                                         gsize *length,
-                                                         char **etag_out,
-                                                         GError **error);
+
gboolean            g_file_load_contents                (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         char **contents,
+                                                         gsize *length,
+                                                         char **etag_out,
+                                                         GError **error);

Loads the content of the file into memory. The data is always zero-terminated, but this is not included in the resultant length. -The returned content should be freed with g_free() when no longer +The returned content should be freed with g_free() when no longer needed.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile +input GFile

flags :

a set of GFileMonitorFlags +a set of GFileMonitorFlags

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileMonitor for the given file, or NULL on error. - Free the returned object with g_object_unref(). + a GFileMonitor for the given file, or NULL on error. + Free the returned object with g_object_unref().
- - - - - - - @@ -6331,10 +6421,10 @@ was cancelled, the error

g_file_load_contents_async ()

-
void                g_file_load_contents_async          (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_load_contents_async          (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Starts an asynchronous load of the file's contents.

@@ -6349,30 +6439,31 @@ with user data. To finish the operation, the callback.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

contents :

a location to place the contents of the file. +a location to place the contents of the file.

length :

a location to place the length of the contents of the file, - or NULL if the length is not needed +a location to place the length of the contents of the file, + or NULL if the length is not needed

etag_out :

a location to place the current entity tag for the file, - or NULL if the entity tag is not needed +a location to place the current entity tag for the file, + or NULL if the entity tag is not needed

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the file's contents were successfully loaded. -FALSE if there were errors. + TRUE if the file's contents were successfully loaded. +FALSE if there were errors.
- - - - @@ -6381,56 +6472,57 @@ was cancelled, the error

g_file_load_contents_finish ()

-
gboolean            g_file_load_contents_finish         (GFile *file,
-                                                         GAsyncResult *res,
-                                                         char **contents,
-                                                         gsize *length,
-                                                         char **etag_out,
-                                                         GError **error);
+
gboolean            g_file_load_contents_finish         (GFile *file,
+                                                         GAsyncResult *res,
+                                                         char **contents,
+                                                         gsize *length,
+                                                         char **etag_out,
+                                                         GError **error);

Finishes an asynchronous load of the file's contents. The contents are placed in contents, and length is set to the size of the contents string. The content should be freed with -g_free() when no longer needed. If etag_out is present, it will be -set to the new entity tag for the file.

+g_free() when no longer needed. If etag_out is present, it will be +set to the new entity tag for the file. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - - - - @@ -6440,11 +6532,11 @@ present, it will be set appropriately.

g_file_load_partial_contents_async ()

-
void                g_file_load_partial_contents_async  (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GFileReadMoreCallback read_more_callback,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_load_partial_contents_async  (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GFileReadMoreCallback read_more_callback,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Reads the partial contents of a file. A GFileReadMoreCallback should be used to stop reading from the file when appropriate, else this function @@ -6456,35 +6548,36 @@ Users of this function should be aware that user_dat both the read_more_callback and the callback.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

contents :

a location to place the contents of the file. +a location to place the contents of the file.

length :

a location to place the length of the contents of the file, - or NULL if the length is not needed +a location to place the length of the contents of the file, + or NULL if the length is not needed

etag_out :

a location to place the current entity tag for the file, - or NULL if the entity tag is not needed +a location to place the current entity tag for the file, + or NULL if the entity tag is not needed

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the load was successful. If FALSE and error is + TRUE if the load was successful. If FALSE and error is present, it will be set appropriately.
- - - - - @@ -6493,56 +6586,57 @@ was cancelled, the error

g_file_load_partial_contents_finish ()

-
gboolean            g_file_load_partial_contents_finish (GFile *file,
-                                                         GAsyncResult *res,
-                                                         char **contents,
-                                                         gsize *length,
-                                                         char **etag_out,
-                                                         GError **error);
+
gboolean            g_file_load_partial_contents_finish (GFile *file,
+                                                         GAsyncResult *res,
+                                                         char **contents,
+                                                         gsize *length,
+                                                         char **etag_out,
+                                                         GError **error);

Finishes an asynchronous partial load operation that was started with g_file_load_partial_contents_async(). The data is always zero-terminated, but this is not included in the resultant length. -The returned content should be freed with g_free() when no longer -needed.

+The returned content should be freed with g_free() when no longer +needed. +

file :

input GFile. +input GFile.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

read_more_callback :

a GFileReadMoreCallback to receive partial data and to specify whether further data should be read. +a GFileReadMoreCallback to receive partial data and to specify whether further data should be read.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to the callback functions. +the data to pass to the callback functions.
- - - - - - - @@ -6552,87 +6646,89 @@ present, it will be set appropriately.

g_file_replace_contents ()

-
gboolean            g_file_replace_contents             (GFile *file,
-                                                         const char *contents,
-                                                         gsize length,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         char **new_etag,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_replace_contents             (GFile *file,
+                                                         const char *contents,
+                                                         gsize length,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         char **new_etag,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Replaces the contents of file with contents of length bytes. -If etag is specified (not NULL) any existing file must have that etag, or +If etag is specified (not NULL) any existing file must have that etag, or the error G_IO_ERROR_WRONG_ETAG will be returned.

-If make_backup is TRUE, this function will attempt to make a backup of file. +If make_backup is TRUE, this function will attempt to make a backup of file.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

The returned new_etag can be used to verify that the file hasn't changed the -next time it is saved over.

+next time it is saved over. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

contents :

a location to place the contents of the file. +a location to place the contents of the file.

length :

a location to place the length of the contents of the file, - or NULL if the length is not needed +a location to place the length of the contents of the file, + or NULL if the length is not needed

etag_out :

a location to place the current entity tag for the file, - or NULL if the entity tag is not needed +a location to place the current entity tag for the file, + or NULL if the entity tag is not needed

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if the load was successful. If FALSE and error is + TRUE if the load was successful. If FALSE and error is present, it will be set appropriately.
- - - - - - - - - - @@ -6642,15 +6738,15 @@ appropriately if present.

g_file_replace_contents_async ()

-
void                g_file_replace_contents_async       (GFile *file,
-                                                         const char *contents,
-                                                         gsize length,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_replace_contents_async       (GFile *file,
+                                                         const char *contents,
+                                                         gsize length,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Starts an asynchronous replacement of file with the given contents of length bytes. etag will replace the document's @@ -6662,59 +6758,61 @@ When this operation has completed, callbackg_file_replace_contents_finish().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

-If make_backup is TRUE, this function will attempt to -make a backup of file.

+If make_backup is TRUE, this function will attempt to +make a backup of file. +

file :

input GFile. +input GFile.

contents :

a string containing the new contents for file. +a string containing the new contents for file.

length :

the length of contents in bytes. +the length of contents in bytes.

etag :

the old entity tag - for the document, or NULL +the old entity tag + for the document, or NULL

make_backup :

TRUE if a backup should be created. + +TRUE if a backup should be created.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

new_etag :

a location to a new entity tag - for the document. This should be freed with g_free() when no longer - needed, or NULL +a location to a new entity tag + for the document. This should be freed with g_free() when no longer + needed, or NULL

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE if successful. If an error -has occurred, this function will return FALSE and set error + TRUE if successful. If an error +has occurred, this function will return FALSE and set error appropriately if present.
- - - - - - - - - @@ -6723,42 +6821,43 @@ make a backup of file.


g_file_replace_contents_finish ()

-
gboolean            g_file_replace_contents_finish      (GFile *file,
-                                                         GAsyncResult *res,
-                                                         char **new_etag,
-                                                         GError **error);
+
gboolean            g_file_replace_contents_finish      (GFile *file,
+                                                         GAsyncResult *res,
+                                                         char **new_etag,
+                                                         GError **error);

Finishes an asynchronous replace of the given file. See g_file_replace_contents_async(). Sets new_etag to the new entity -tag for the document, if present.

+tag for the document, if present. +

file :

input GFile. +input GFile.

contents :

string of contents to replace the file with. +string of contents to replace the file with.

length :

the length of contents in bytes. +the length of contents in bytes.

etag :

a new entity tag for the file, or NULL +a new entity tag for the file, or NULL

make_backup :

TRUE if a backup should be created. + +TRUE if a backup should be created.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - - @@ -6767,11 +6866,11 @@ tag for the document, if present.


g_file_copy_attributes ()

-
gboolean            g_file_copy_attributes              (GFile *source,
-                                                         GFile *destination,
-                                                         GFileCopyFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_copy_attributes              (GFile *source,
+                                                         GFile *destination,
+                                                         GFileCopyFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Copies the file attributes from source to destination.

@@ -6781,38 +6880,39 @@ those that are copies in a normal file copy operation (which for instance does not include e.g. owner). However if G_FILE_COPY_ALL_METADATA is specified in flags, then all the metadata that is possible to copy is copied. This -is useful when implementing move by copy + delete source.

+is useful when implementing move by copy + delete source. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

new_etag :

a location of a new entity tag - for the document. This should be freed with g_free() when it is no - longer needed, or NULL +a location of a new entity tag + for the document. This should be freed with g_free() when it is no + longer needed, or NULL

error :

a GError, or NULL +a GError, or NULL

Returns :

TRUE on success, FALSE on failure. + TRUE on success, FALSE on failure.
- - - - - - @@ -6821,10 +6921,10 @@ is useful when implementing move by copy + delete source.


g_file_create_readwrite ()

-
GFileIOStream *     g_file_create_readwrite             (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileIOStream *     g_file_create_readwrite             (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Creates a new file and returns a stream for reading and writing to it. The file must not already exist. @@ -6836,7 +6936,7 @@ will be made readable only to the current user, to the level that is supported on the target filesystem.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

@@ -6850,34 +6950,35 @@ are possible too, and depend on what kind of filesystem the file is on.

Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, -rather than just opening for reading or writing.

+rather than just opening for reading or writing. +

source :

a GFile with attributes. +a GFile with attributes.

destination :

a GFile to copy attributes to. +a GFile to copy attributes to.

flags :

a set of GFileCopyFlags. +a set of GFileCopyFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

TRUE if the attributes were copied successfully, FALSE otherwise. + TRUE if the attributes were copied successfully, FALSE otherwise.
- - - - - @@ -6888,12 +6989,12 @@ rather than just opening for reading or writing.


g_file_create_readwrite_async ()

-
void                g_file_create_readwrite_async       (GFile *file,
-                                                         GFileCreateFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_create_readwrite_async       (GFile *file,
+                                                         GFileCreateFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously creates a new file and returns a stream for reading and writing to it. The file must not already exist. @@ -6904,39 +7005,40 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then -call g_file_create_readwrite_finish() to get the result of the operation.

+call g_file_create_readwrite_finish() to get the result of the operation. +

file :

a GFile +a GFile

flags :

a set of GFileCreateFlags +a set of GFileCreateFlags

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GFileIOStream for the newly created file, or NULL on error. - Free the returned object with g_object_unref(). + a GFileIOStream for the newly created file, or NULL on error. + Free the returned object with g_object_unref().
- - - - - - @@ -6946,34 +7048,35 @@ call

g_file_create_readwrite_finish ()

-
GFileIOStream *     g_file_create_readwrite_finish      (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileIOStream *     g_file_create_readwrite_finish      (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file create operation started with -g_file_create_readwrite_async().

+g_file_create_readwrite_async(). +

file :

input GFile +input GFile

flags :

a set of GFileCreateFlags +a set of GFileCreateFlags

io_priority :

the I/O priority +the I/O priority of the request

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -6984,15 +7087,15 @@ Finishes an asynchronous file create operation started with

g_file_open_readwrite ()

-
GFileIOStream *     g_file_open_readwrite               (GFile *file,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileIOStream *     g_file_open_readwrite               (GFile *file,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Opens an existing file for reading and writing. The result is a GFileIOStream that can be used to read and write the contents of the file.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

@@ -7002,29 +7105,31 @@ If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than -just opening for reading or writing.

+just opening for reading or writing. +

file :

input GFile +input GFile

res :

a GAsyncResult +a GAsyncResult

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileIOStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileIOStream or NULL on error. + Free the returned object with g_object_unref().
- - - - @@ -7035,11 +7140,11 @@ just opening for reading or writing.


g_file_open_readwrite_async ()

-
void                g_file_open_readwrite_async         (GFile *file,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_open_readwrite_async         (GFile *file,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously opens file for reading and writing.

@@ -7049,34 +7154,35 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then call -g_file_open_readwrite_finish() to get the result of the operation.

+g_file_open_readwrite_finish() to get the result of the operation. +

file :

GFile to open + +GFile to open

cancellable :

a GCancellable +a GCancellable

error :

a GError, or NULL +a GError, or NULL

Returns :

GFileIOStream or NULL on error. - Free the returned object with g_object_unref(). + GFileIOStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -7086,34 +7192,35 @@ When the operation is finished, callback

g_file_open_readwrite_finish ()

-
GFileIOStream *     g_file_open_readwrite_finish        (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileIOStream *     g_file_open_readwrite_finish        (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file read operation started with -g_file_open_readwrite_async().

+g_file_open_readwrite_async(). +

file :

input GFile. +input GFile.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -7124,12 +7231,12 @@ Finishes an asynchronous file read operation started with

g_file_replace_readwrite ()

-
GFileIOStream *     g_file_replace_readwrite            (GFile *file,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileIOStream *     g_file_replace_readwrite            (GFile *file,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Returns an output stream for overwriting the file in readwrite mode, possibly creating a backup copy of the file first. If the file doesn't @@ -7142,45 +7249,47 @@ thing but returns an output stream only.

Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, -rather than just opening for reading or writing.

+rather than just opening for reading or writing. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileIOStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileIOStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - - - @@ -7191,14 +7300,14 @@ rather than just opening for reading or writing.


g_file_replace_readwrite_async ()

-
void                g_file_replace_readwrite_async      (GFile *file,
-                                                         const char *etag,
-                                                         gboolean make_backup,
-                                                         GFileCreateFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_replace_readwrite_async      (GFile *file,
+                                                         const char *etag,
+                                                         gboolean make_backup,
+                                                         GFileCreateFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously overwrites the file in read-write mode, replacing the contents, possibly creating a backup copy of the file first. @@ -7209,50 +7318,52 @@ the synchronous version of this call.

When the operation is finished, callback will be called. You can then -call g_file_replace_readwrite_finish() to get the result of the operation.

+call g_file_replace_readwrite_finish() to get the result of the operation. +

file :

a GFile +a GFile

etag :

an optional entity tag for the - current GFile, or NULL to ignore +an optional entity tag for the + current GFile, or NULL to ignore

make_backup :

TRUE if a backup should be created + +TRUE if a backup should be created

flags :

a set of GFileCreateFlags +a set of GFileCreateFlags

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GFileIOStream or NULL on error. - Free the returned object with g_object_unref(). + a GFileIOStream or NULL on error. + Free the returned object with g_object_unref().
- - - - - - - - @@ -7262,34 +7373,35 @@ call

g_file_replace_readwrite_finish ()

-
GFileIOStream *     g_file_replace_readwrite_finish     (GFile *file,
-                                                         GAsyncResult *res,
-                                                         GError **error);
+
GFileIOStream *     g_file_replace_readwrite_finish     (GFile *file,
+                                                         GAsyncResult *res,
+                                                         GError **error);

Finishes an asynchronous file replace operation started with -g_file_replace_readwrite_async().

+g_file_replace_readwrite_async(). +

file :

input GFile. +input GFile.

etag :

an entity tag for the +an entity tag for the current GFile, or NULL to ignore.

make_backup :

TRUE if a backup should be created. + +TRUE if a backup should be created.

flags :

a set of GFileCreateFlags. +a set of GFileCreateFlags.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -7300,18 +7412,19 @@ Finishes an asynchronous file replace operation started with

g_file_supports_thread_contexts ()

-
gboolean            g_file_supports_thread_contexts     (GFile *file);
+
gboolean            g_file_supports_thread_contexts     (GFile *file);

Checks if file supports thread-default -contexts. If this returns FALSE, you cannot perform +contexts. If this returns FALSE, you cannot perform asynchronous operations on file in a thread that has a -thread-default context.

+thread-default context. +

file :

input GFile. +input GFile.

res :

a GAsyncResult. +a GAsyncResult.

error :

a GError, or NULL +a GError, or NULL

Returns :

a GFileIOStream, or NULL on error. - Free the returned object with g_object_unref(). + a GFileIOStream, or NULL on error. + Free the returned object with g_object_unref().
- @@ -7332,6 +7445,6 @@ thread-default context.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileDescriptorBased.html b/docs/reference/gio/html/GFileDescriptorBased.html index 1332aa5..704b758 100644 --- a/docs/reference/gio/html/GFileDescriptorBased.html +++ b/docs/reference/gio/html/GFileDescriptorBased.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

file :

a GFile. +a GFile.
@@ -75,7 +45,7 @@ #include <gio/gio.h> GFileDescriptorBased; -int g_file_descriptor_based_get_fd (GFileDescriptorBased *fd_based); +int g_file_descriptor_based_get_fd (GFileDescriptorBased *fd_based);
@@ -89,13 +59,14 @@

Prerequisites

GFileDescriptorBased requires - GObject.

+ GObject.

Description

GFileDescriptorBased is implemented by streams (implementations of -GInputStream or GOutputStream) that are based on file descriptors.

+GInputStream or GOutputStream) that are based on file descriptors. +

Details

@@ -103,20 +74,22 @@ GFileDescriptorBased requires

GFileDescriptorBased

typedef struct _GFileDescriptorBased GFileDescriptorBased;

-An interface for file descriptor based io objects.

+An interface for file descriptor based io objects. +


g_file_descriptor_based_get_fd ()

-
int                 g_file_descriptor_based_get_fd      (GFileDescriptorBased *fd_based);
+
int                 g_file_descriptor_based_get_fd      (GFileDescriptorBased *fd_based);

-Gets the underlying file descriptor.

+Gets the underlying file descriptor. +

- @@ -137,6 +110,6 @@ Gets the underlying file descriptor.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileEnumerator.html b/docs/reference/gio/html/GFileEnumerator.html index 58476c8..4bd320f 100644 --- a/docs/reference/gio/html/GFileEnumerator.html +++ b/docs/reference/gio/html/GFileEnumerator.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

fd_based :

a GFileDescriptorBased. +a GFileDescriptorBased.
@@ -75,40 +45,40 @@ #include <gio/gio.h> GFileEnumerator; -GFileInfo * g_file_enumerator_next_file (GFileEnumerator *enumerator, - GCancellable *cancellable, - GError **error); -gboolean g_file_enumerator_close (GFileEnumerator *enumerator, - GCancellable *cancellable, - GError **error); -void g_file_enumerator_next_files_async (GFileEnumerator *enumerator, - int num_files, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GList * g_file_enumerator_next_files_finish (GFileEnumerator *enumerator, - GAsyncResult *result, - GError **error); -void g_file_enumerator_close_async (GFileEnumerator *enumerator, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_file_enumerator_close_finish (GFileEnumerator *enumerator, - GAsyncResult *result, - GError **error); -gboolean g_file_enumerator_is_closed (GFileEnumerator *enumerator); -gboolean g_file_enumerator_has_pending (GFileEnumerator *enumerator); -void g_file_enumerator_set_pending (GFileEnumerator *enumerator, - gboolean pending); -GFile * g_file_enumerator_get_container (GFileEnumerator *enumerator); +GFileInfo * g_file_enumerator_next_file (GFileEnumerator *enumerator, + GCancellable *cancellable, + GError **error); +gboolean g_file_enumerator_close (GFileEnumerator *enumerator, + GCancellable *cancellable, + GError **error); +void g_file_enumerator_next_files_async (GFileEnumerator *enumerator, + int num_files, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GList * g_file_enumerator_next_files_finish (GFileEnumerator *enumerator, + GAsyncResult *result, + GError **error); +void g_file_enumerator_close_async (GFileEnumerator *enumerator, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_file_enumerator_close_finish (GFileEnumerator *enumerator, + GAsyncResult *result, + GError **error); +gboolean g_file_enumerator_is_closed (GFileEnumerator *enumerator); +gboolean g_file_enumerator_has_pending (GFileEnumerator *enumerator); +void g_file_enumerator_set_pending (GFileEnumerator *enumerator, + gboolean pending); +GFile * g_file_enumerator_get_container (GFileEnumerator *enumerator);

Object Hierarchy

-  GObject
+  GObject
    +----GFileEnumerator
 
@@ -137,7 +107,8 @@ synchronous will only return the next file in the enumerator. To close a GFileEnumerator, use g_file_enumerator_close(), or its asynchronous version, g_file_enumerator_close_async(). Once a GFileEnumerator is closed, no further actions may be performed -on it, and it should be freed with g_object_unref().

+on it, and it should be freed with g_object_unref(). +

Details

@@ -145,7 +116,8 @@ on it, and it should be freed with

GFileEnumerator

typedef struct _GFileEnumerator GFileEnumerator;

-A per matched file iterator.

+A per matched file iterator. +

@@ -154,9 +126,9 @@ A per matched file iterator.


g_file_enumerator_next_file ()

-
GFileInfo *         g_file_enumerator_next_file         (GFileEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_enumerator_next_file         (GFileEnumerator *enumerator,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Returns information for the next file in the enumerated object. Will block until the information is available. The GFileInfo @@ -164,31 +136,32 @@ returned from this function will contain attributes that match the attribute string that was passed when the GFileEnumerator was created.

-On error, returns NULL and sets error to the error. If the -enumerator is at the end, NULL will be returned and error will -be unset.

+On error, returns NULL and sets error to the error. If the +enumerator is at the end, NULL will be returned and error will +be unset. +

- - - - @@ -197,9 +170,9 @@ be unset.


g_file_enumerator_close ()

-
gboolean            g_file_enumerator_close             (GFileEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_file_enumerator_close             (GFileEnumerator *enumerator,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Releases all resources used by this enumerator, making the enumerator return G_IO_ERROR_CLOSED on all calls. @@ -207,28 +180,29 @@ enumerator return

enumerator :

a GFileEnumerator. +a GFileEnumerator.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

A GFileInfo or NULL on error or end of enumerator. - Free the returned object with g_object_unref() when no longer needed. + A GFileInfo or NULL on error or end of enumerator. + Free the returned object with g_object_unref() when no longer needed.
- - - - @@ -237,12 +211,12 @@ sure resources are released as early as possible.


g_file_enumerator_next_files_async ()

-
void                g_file_enumerator_next_files_async  (GFileEnumerator *enumerator,
-                                                         int num_files,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_enumerator_next_files_async  (GFileEnumerator *enumerator,
+                                                         int num_files,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Request information for a number of files from the enumerator asynchronously. When all i/o for the operation is finished the callback will be called with @@ -262,39 +236,40 @@ result in Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default -priority is G_PRIORITY_DEFAULT.

+priority is G_PRIORITY_DEFAULT. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success or FALSE on error. + TRUE on success or FALSE on error.
- - - - - - @@ -303,34 +278,35 @@ priority is

g_file_enumerator_next_files_finish ()

-
GList *             g_file_enumerator_next_files_finish (GFileEnumerator *enumerator,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GList *             g_file_enumerator_next_files_finish (GFileEnumerator *enumerator,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes the asynchronous operation started with g_file_enumerator_next_files_async().

+Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

num_files :

the number of file info objects to request +the number of file info objects to request

io_priority :

the io priority +the io priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -340,46 +316,47 @@ ignore.

g_file_enumerator_close_async ()

-
void                g_file_enumerator_close_async       (GFileEnumerator *enumerator,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_enumerator_close_async       (GFileEnumerator *enumerator,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously closes the file enumerator.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned in -g_file_enumerator_close_finish().

+g_file_enumerator_close_finish(). +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GList of GFileInfos. You must free the list with - g_list_free() and unref the infos with g_object_unref() when you're + a GList of GFileInfos. You must free the list with + g_list_free() and unref the infos with g_object_unref() when you're done with them.
- - - - - @@ -388,43 +365,44 @@ was cancelled, the error

g_file_enumerator_close_finish ()

-
gboolean            g_file_enumerator_close_finish      (GFileEnumerator *enumerator,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_file_enumerator_close_finish      (GFileEnumerator *enumerator,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes closing a file enumerator, started from g_file_enumerator_close_async().

If the file enumerator was already closed when g_file_enumerator_close_async() was called, then this function will report G_IO_ERROR_CLOSED in error, and -return FALSE. If the file enumerator had pending operation when the close +return FALSE. If the file enumerator had pending operation when the close operation was started, then this function will report G_IO_ERROR_PENDING, and -return FALSE. If cancellable was not NULL, then the operation may have been +return FALSE. If cancellable was not NULL, then the operation may have been cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be set, and FALSE will be -returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be set, and FALSE will be +returned. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -433,20 +411,21 @@ ignore.

g_file_enumerator_is_closed ()

-
gboolean            g_file_enumerator_is_closed         (GFileEnumerator *enumerator);
+
gboolean            g_file_enumerator_is_closed         (GFileEnumerator *enumerator);

-Checks if the file enumerator has been closed.

+Checks if the file enumerator has been closed. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the close operation has finished successfully. + TRUE if the close operation has finished successfully.
- - @@ -455,20 +434,21 @@ Checks if the file enumerator has been closed.


g_file_enumerator_has_pending ()

-
gboolean            g_file_enumerator_has_pending       (GFileEnumerator *enumerator);
+
gboolean            g_file_enumerator_has_pending       (GFileEnumerator *enumerator);

-Checks if the file enumerator has pending operations.

+Checks if the file enumerator has pending operations. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

Returns :

TRUE if the enumerator is closed. + TRUE if the enumerator is closed.
- - @@ -477,21 +457,22 @@ Checks if the file enumerator has pending operations.


g_file_enumerator_set_pending ()

-
void                g_file_enumerator_set_pending       (GFileEnumerator *enumerator,
-                                                         gboolean pending);
+
void                g_file_enumerator_set_pending       (GFileEnumerator *enumerator,
+                                                         gboolean pending);

-Sets the file enumerator as having pending operations.

+Sets the file enumerator as having pending operations. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

Returns :

TRUE if the enumerator has pending operations. + TRUE if the enumerator has pending operations.
- - @@ -500,15 +481,16 @@ Sets the file enumerator as having pending operations.


g_file_enumerator_get_container ()

-
GFile *             g_file_enumerator_get_container     (GFileEnumerator *enumerator);
+
GFile *             g_file_enumerator_get_container     (GFileEnumerator *enumerator);

-Get the GFile container which is being enumerated.

+Get the GFile container which is being enumerated. +

enumerator :

a GFileEnumerator. +a GFileEnumerator.

pending :

a boolean value. +a boolean value.
- @@ -533,6 +515,6 @@ Get the GFile + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileIOStream.html b/docs/reference/gio/html/GFileIOStream.html index e266d8c..77e78a9 100644 --- a/docs/reference/gio/html/GFileIOStream.html +++ b/docs/reference/gio/html/GFileIOStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

enumerator :

a GFileEnumerator +a GFileEnumerator
@@ -75,26 +45,26 @@ #include <gio/gio.h> GFileIOStream; -char * g_file_io_stream_get_etag (GFileIOStream *stream); -GFileInfo * g_file_io_stream_query_info (GFileIOStream *stream, - const char *attributes, - GCancellable *cancellable, - GError **error); -void g_file_io_stream_query_info_async (GFileIOStream *stream, - const char *attributes, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GFileInfo * g_file_io_stream_query_info_finish (GFileIOStream *stream, - GAsyncResult *result, - GError **error); +char * g_file_io_stream_get_etag (GFileIOStream *stream); +GFileInfo * g_file_io_stream_query_info (GFileIOStream *stream, + const char *attributes, + GCancellable *cancellable, + GError **error); +void g_file_io_stream_query_info_async (GFileIOStream *stream, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GFileInfo * g_file_io_stream_query_info_finish (GFileIOStream *stream, + GAsyncResult *result, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GIOStream
          +----GFileIOStream
 
@@ -131,7 +101,8 @@ stream, use GFileIOStream operations and the implementation of GSeekable just call into the same operations -on the output stream.

+on the output stream. +

Details

@@ -143,22 +114,24 @@ A subclass of GIOStream for opened files. This adds a few file-specific operations and seeking and truncating.

-GFileIOStream implements GSeekable.

+GFileIOStream implements GSeekable. +


g_file_io_stream_get_etag ()

-
char *              g_file_io_stream_get_etag           (GFileIOStream *stream);
+
char *              g_file_io_stream_get_etag           (GFileIOStream *stream);

Gets the entity tag for the file when it has been written. This must be called after the stream has been written -and closed, as the etag can change while writing.

+and closed, as the etag can change while writing. +

- @@ -174,10 +147,10 @@ and closed, as the etag can change while writing.


g_file_io_stream_query_info ()

-
GFileInfo *         g_file_io_stream_query_info         (GFileIOStream *stream,
-                                                         const char *attributes,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_io_stream_query_info         (GFileIOStream *stream,
+                                                         const char *attributes,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Queries a file io stream for the given attributes. This function blocks while querying the stream. For the asynchronous @@ -191,39 +164,40 @@ Can fail if the stream was already closed (with erro G_IO_ERROR_CLOSED), the stream has pending operations (with error being set to G_IO_ERROR_PENDING), or if querying info is not supported for the stream's interface (with error being set to G_IO_ERROR_NOT_SUPPORTED). I -all cases of failure, NULL will be returned. +all cases of failure, NULL will be returned.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be set, and NULL will -be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be set, and NULL will +be returned. +

stream :

a GFileIOStream. +a GFileIOStream.
- - - - - @@ -234,12 +208,12 @@ be returned.


g_file_io_stream_query_info_async ()

-
void                g_file_io_stream_query_info_async   (GFileIOStream *stream,
-                                                         const char *attributes,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_file_io_stream_query_info_async   (GFileIOStream *stream,
+                                                         const char *attributes,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Asynchronously queries the stream for a GFileInfo. When completed, callback will be called with a GAsyncResult which can be used to @@ -247,39 +221,40 @@ finish the operation with g_file_io_stream_query_info().

+g_file_io_stream_query_info(). +

stream :

a GFileIOStream. +a GFileIOStream.

attributes :

a file attribute query string. +a file attribute query string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

a GFileInfo for the stream, or NULL on error. + a GFileInfo for the stream, or NULL on error.
- - - - - - @@ -289,28 +264,29 @@ For the synchronous version of this function, see

g_file_io_stream_query_info_finish ()

-
GFileInfo *         g_file_io_stream_query_info_finish  (GFileIOStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GFileInfo *         g_file_io_stream_query_info_finish  (GFileIOStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finalizes the asynchronous query started -by g_file_io_stream_query_info_async().

+by g_file_io_stream_query_info_async(). +

stream :

a GFileIOStream. +a GFileIOStream.

attributes :

a file attribute query string. +a file attribute query string.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - @@ -331,6 +307,6 @@ by + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileIcon.html b/docs/reference/gio/html/GFileIcon.html index 1a27370..fffc386 100644 --- a/docs/reference/gio/html/GFileIcon.html +++ b/docs/reference/gio/html/GFileIcon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GFileIOStream. +a GFileIOStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.
@@ -77,14 +47,14 @@ #include <gio/gio.h> GFileIcon; -GIcon * g_file_icon_new (GFile *file); -GFile * g_file_icon_get_file (GFileIcon *icon); +GIcon * g_file_icon_new (GFile *file); +GFile * g_file_icon_get_file (GFileIcon *icon);

Object Hierarchy

-  GObject
+  GObject
    +----GFileIcon
 
@@ -104,7 +74,8 @@ GFileIcon implements

Description

GFileIcon specifies an icon by pointing to an image file -to be used as icon.

+to be used as icon. +

Details

@@ -112,25 +83,27 @@ to be used as icon.

GFileIcon

typedef struct _GFileIcon GFileIcon;

-Gets an icon for a GFile. Implements GLoadableIcon.

+Gets an icon for a GFile. Implements GLoadableIcon. +


g_file_icon_new ()

-
GIcon *             g_file_icon_new                     (GFile *file);
+
GIcon *             g_file_icon_new                     (GFile *file);

-Creates a new icon for a file.

+Creates a new icon for a file. +

- - @@ -139,20 +112,21 @@ Creates a new icon for a file.


g_file_icon_get_file ()

-
GFile *             g_file_icon_get_file                (GFileIcon *icon);
+
GFile *             g_file_icon_get_file                (GFileIcon *icon);

-Gets the GFile associated with the given icon.

+Gets the GFile associated with the given icon. +

file :

a GFile. +a GFile.

Returns :

a GIcon for the given file, or NULL on error. + a GIcon for the given file, or NULL on error.
- - @@ -165,7 +139,8 @@ Gets the GFil

The "file" property

  "file"                     GFile*                : Read / Write / Construct Only

-The file containing the icon.

+The file containing the icon. +

@@ -175,6 +150,6 @@ The file containing the icon.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileInfo.html b/docs/reference/gio/html/GFileInfo.html index 08673a6..f35d008 100644 --- a/docs/reference/gio/html/GFileInfo.html +++ b/docs/reference/gio/html/GFileInfo.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

icon :

a GIcon. +a GIcon.

Returns :

a GFile, or NULL. + a GFile, or NULL.
@@ -148,145 +118,145 @@ enum G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT #define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW #define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION -GFileInfo * g_file_info_new (void); -GFileInfo * g_file_info_dup (GFileInfo *other); -void g_file_info_copy_into (GFileInfo *src_info, - GFileInfo *dest_info); -gboolean g_file_info_has_attribute (GFileInfo *info, - const char *attribute); -gboolean g_file_info_has_namespace (GFileInfo *info, - const char *name_space); -char ** g_file_info_list_attributes (GFileInfo *info, - const char *name_space); -GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info, - const char *attribute); -void g_file_info_remove_attribute (GFileInfo *info, - const char *attribute); -char * g_file_info_get_attribute_as_string (GFileInfo *info, - const char *attribute); -gboolean g_file_info_get_attribute_data (GFileInfo *info, - const char *attribute, - GFileAttributeType *type, - gpointer *value_pp, - GFileAttributeStatus *status); -GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info, - const char *attribute); -const char * g_file_info_get_attribute_string (GFileInfo *info, - const char *attribute); -char ** g_file_info_get_attribute_stringv (GFileInfo *info, - const char *attribute); +GFileInfo * g_file_info_new (void); +GFileInfo * g_file_info_dup (GFileInfo *other); +void g_file_info_copy_into (GFileInfo *src_info, + GFileInfo *dest_info); +gboolean g_file_info_has_attribute (GFileInfo *info, + const char *attribute); +gboolean g_file_info_has_namespace (GFileInfo *info, + const char *name_space); +char ** g_file_info_list_attributes (GFileInfo *info, + const char *name_space); +GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info, + const char *attribute); +void g_file_info_remove_attribute (GFileInfo *info, + const char *attribute); +char * g_file_info_get_attribute_as_string (GFileInfo *info, + const char *attribute); +gboolean g_file_info_get_attribute_data (GFileInfo *info, + const char *attribute, + GFileAttributeType *type, + gpointer *value_pp, + GFileAttributeStatus *status); +GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info, + const char *attribute); +const char * g_file_info_get_attribute_string (GFileInfo *info, + const char *attribute); +char ** g_file_info_get_attribute_stringv (GFileInfo *info, + const char *attribute); const char * g_file_info_get_attribute_byte_string - (GFileInfo *info, - const char *attribute); -gboolean g_file_info_get_attribute_boolean (GFileInfo *info, - const char *attribute); -guint32 g_file_info_get_attribute_uint32 (GFileInfo *info, - const char *attribute); -gint32 g_file_info_get_attribute_int32 (GFileInfo *info, - const char *attribute); -guint64 g_file_info_get_attribute_uint64 (GFileInfo *info, - const char *attribute); -gint64 g_file_info_get_attribute_int64 (GFileInfo *info, - const char *attribute); -GObject * g_file_info_get_attribute_object (GFileInfo *info, - const char *attribute); -void g_file_info_set_attribute (GFileInfo *info, - const char *attribute, - GFileAttributeType type, - gpointer value_p); -gboolean g_file_info_set_attribute_status (GFileInfo *info, - const char *attribute, - GFileAttributeStatus status); -void g_file_info_set_attribute_string (GFileInfo *info, - const char *attribute, - const char *attr_value); -void g_file_info_set_attribute_stringv (GFileInfo *info, - const char *attribute, - char **attr_value); + (GFileInfo *info, + const char *attribute); +gboolean g_file_info_get_attribute_boolean (GFileInfo *info, + const char *attribute); +guint32 g_file_info_get_attribute_uint32 (GFileInfo *info, + const char *attribute); +gint32 g_file_info_get_attribute_int32 (GFileInfo *info, + const char *attribute); +guint64 g_file_info_get_attribute_uint64 (GFileInfo *info, + const char *attribute); +gint64 g_file_info_get_attribute_int64 (GFileInfo *info, + const char *attribute); +GObject * g_file_info_get_attribute_object (GFileInfo *info, + const char *attribute); +void g_file_info_set_attribute (GFileInfo *info, + const char *attribute, + GFileAttributeType type, + gpointer value_p); +gboolean g_file_info_set_attribute_status (GFileInfo *info, + const char *attribute, + GFileAttributeStatus status); +void g_file_info_set_attribute_string (GFileInfo *info, + const char *attribute, + const char *attr_value); +void g_file_info_set_attribute_stringv (GFileInfo *info, + const char *attribute, + char **attr_value); void g_file_info_set_attribute_byte_string - (GFileInfo *info, - const char *attribute, - const char *attr_value); -void g_file_info_set_attribute_boolean (GFileInfo *info, - const char *attribute, - gboolean attr_value); -void g_file_info_set_attribute_uint32 (GFileInfo *info, - const char *attribute, - guint32 attr_value); -void g_file_info_set_attribute_int32 (GFileInfo *info, - const char *attribute, - gint32 attr_value); -void g_file_info_set_attribute_uint64 (GFileInfo *info, - const char *attribute, - guint64 attr_value); -void g_file_info_set_attribute_int64 (GFileInfo *info, - const char *attribute, - gint64 attr_value); -void g_file_info_set_attribute_object (GFileInfo *info, - const char *attribute, - GObject *attr_value); -void g_file_info_clear_status (GFileInfo *info); -GFileType g_file_info_get_file_type (GFileInfo *info); -gboolean g_file_info_get_is_hidden (GFileInfo *info); -gboolean g_file_info_get_is_backup (GFileInfo *info); -gboolean g_file_info_get_is_symlink (GFileInfo *info); -const char * g_file_info_get_name (GFileInfo *info); -const char * g_file_info_get_display_name (GFileInfo *info); -const char * g_file_info_get_edit_name (GFileInfo *info); -GIcon * g_file_info_get_icon (GFileInfo *info); -const char * g_file_info_get_content_type (GFileInfo *info); -goffset g_file_info_get_size (GFileInfo *info); -void g_file_info_get_modification_time (GFileInfo *info, - GTimeVal *result); -const char * g_file_info_get_symlink_target (GFileInfo *info); -const char * g_file_info_get_etag (GFileInfo *info); -gint32 g_file_info_get_sort_order (GFileInfo *info); -void g_file_info_set_attribute_mask (GFileInfo *info, - GFileAttributeMatcher *mask); -void g_file_info_unset_attribute_mask (GFileInfo *info); -void g_file_info_set_file_type (GFileInfo *info, - GFileType type); -void g_file_info_set_is_hidden (GFileInfo *info, - gboolean is_hidden); -void g_file_info_set_is_symlink (GFileInfo *info, - gboolean is_symlink); -void g_file_info_set_name (GFileInfo *info, - const char *name); -void g_file_info_set_display_name (GFileInfo *info, - const char *display_name); -void g_file_info_set_edit_name (GFileInfo *info, - const char *edit_name); -void g_file_info_set_icon (GFileInfo *info, - GIcon *icon); -void g_file_info_set_content_type (GFileInfo *info, - const char *content_type); -void g_file_info_set_size (GFileInfo *info, - goffset size); -void g_file_info_set_modification_time (GFileInfo *info, - GTimeVal *mtime); -void g_file_info_set_symlink_target (GFileInfo *info, - const char *symlink_target); -void g_file_info_set_sort_order (GFileInfo *info, - gint32 sort_order); -GFileAttributeMatcher * g_file_attribute_matcher_new (const char *attributes); -GFileAttributeMatcher * g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher); -void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher); -gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher, - const char *attribute); -gboolean g_file_attribute_matcher_matches_only - (GFileAttributeMatcher *matcher, - const char *attribute); -gboolean g_file_attribute_matcher_enumerate_namespace - (GFileAttributeMatcher *matcher, - const char *ns); + (GFileInfo *info, + const char *attribute, + const char *attr_value); +void g_file_info_set_attribute_boolean (GFileInfo *info, + const char *attribute, + gboolean attr_value); +void g_file_info_set_attribute_uint32 (GFileInfo *info, + const char *attribute, + guint32 attr_value); +void g_file_info_set_attribute_int32 (GFileInfo *info, + const char *attribute, + gint32 attr_value); +void g_file_info_set_attribute_uint64 (GFileInfo *info, + const char *attribute, + guint64 attr_value); +void g_file_info_set_attribute_int64 (GFileInfo *info, + const char *attribute, + gint64 attr_value); +void g_file_info_set_attribute_object (GFileInfo *info, + const char *attribute, + GObject *attr_value); +void g_file_info_clear_status (GFileInfo *info); +GFileType g_file_info_get_file_type (GFileInfo *info); +gboolean g_file_info_get_is_hidden (GFileInfo *info); +gboolean g_file_info_get_is_backup (GFileInfo *info); +gboolean g_file_info_get_is_symlink (GFileInfo *info); +const char * g_file_info_get_name (GFileInfo *info); +const char * g_file_info_get_display_name (GFileInfo *info); +const char * g_file_info_get_edit_name (GFileInfo *info); +GIcon * g_file_info_get_icon (GFileInfo *info); +const char * g_file_info_get_content_type (GFileInfo *info); +goffset g_file_info_get_size (GFileInfo *info); +void g_file_info_get_modification_time (GFileInfo *info, + GTimeVal *result); +const char * g_file_info_get_symlink_target (GFileInfo *info); +const char * g_file_info_get_etag (GFileInfo *info); +gint32 g_file_info_get_sort_order (GFileInfo *info); +void g_file_info_set_attribute_mask (GFileInfo *info, + GFileAttributeMatcher *mask); +void g_file_info_unset_attribute_mask (GFileInfo *info); +void g_file_info_set_file_type (GFileInfo *info, + GFileType type); +void g_file_info_set_is_hidden (GFileInfo *info, + gboolean is_hidden); +void g_file_info_set_is_symlink (GFileInfo *info, + gboolean is_symlink); +void g_file_info_set_name (GFileInfo *info, + const char *name); +void g_file_info_set_display_name (GFileInfo *info, + const char *display_name); +void g_file_info_set_edit_name (GFileInfo *info, + const char *edit_name); +void g_file_info_set_icon (GFileInfo *info, + GIcon *icon); +void g_file_info_set_content_type (GFileInfo *info, + const char *content_type); +void g_file_info_set_size (GFileInfo *info, + goffset size); +void g_file_info_set_modification_time (GFileInfo *info, + GTimeVal *mtime); +void g_file_info_set_symlink_target (GFileInfo *info, + const char *symlink_target); +void g_file_info_set_sort_order (GFileInfo *info, + gint32 sort_order); +GFileAttributeMatcher * g_file_attribute_matcher_new (const char *attributes); +GFileAttributeMatcher * g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher); +void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher); +gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher, + const char *attribute); +gboolean g_file_attribute_matcher_matches_only + (GFileAttributeMatcher *matcher, + const char *attribute); +gboolean g_file_attribute_matcher_enumerate_namespace + (GFileAttributeMatcher *matcher, + const char *ns); const char * g_file_attribute_matcher_enumerate_next - (GFileAttributeMatcher *matcher); + (GFileAttributeMatcher *matcher);

Object Hierarchy

-  GObject
+  GObject
    +----GFileInfo
 
@@ -321,7 +291,8 @@ of a particular file at runtime.

GFileAttributeMatcher allows for searching through a GFileInfo for -attributes.

+attributes. +

Details

@@ -329,7 +300,8 @@ attributes.

GFileAttributeMatcher

typedef struct _GFileAttributeMatcher GFileAttributeMatcher;

-Determines if a string matches a file attribute.

+Determines if a string matches a file attribute. +


@@ -345,45 +317,46 @@ Determines if a string matches a file attribute.

} GFileType;

-Indicates the file's on-disk type.

+Indicates the file's on-disk type. +

- - - - - - - @@ -394,7 +367,8 @@ Indicates the file's on-disk type.

GFileInfo

typedef struct _GFileInfo GFileInfo;

-Stores information about a file system object referenced by a GFile.

+Stores information about a file system object referenced by a GFile. +


@@ -404,7 +378,8 @@ Stores information about a file system object referenced by a A key in the "standard" namespace for storing file types. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32. -The value for this key should contain a GFileType.

+The value for this key should contain a GFileType. +


@@ -413,7 +388,8 @@ The value for this key should contain a GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +



@@ -433,7 +410,8 @@ Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +



@@ -455,7 +434,8 @@ The name is the on-disk filename which may not be in any known encoding, and can thus not be generally displayed as is. Use G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the name in a user interface. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. +


@@ -466,7 +446,8 @@ Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -481,7 +462,8 @@ might contain information you don't want in the new filename (such as "(invalid unicode)" if the filename was in an invalid encoding).

-Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -497,7 +479,8 @@ might have a different encoding. If the filename is not a valid string in the encoding selected for the filesystem it is in then the copy name will not be set.

-Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -507,7 +490,8 @@ Corresponding A key in the "standard" namespace for getting the icon for the file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_OBJECT. -The value for this key should contain a GIcon.

+The value for this key should contain a GIcon. +


@@ -517,7 +501,8 @@ The value for this key should contain a A key in the "standard" namespace for getting the content type of the file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. -The value for this key should contain a valid content type.

+The value for this key should contain a valid content type. +


@@ -529,7 +514,8 @@ A key in the "standard" namespace for getting the fast content type. The fast content type isn't as reliable as the regular one, as it only uses the filename to guess it, but it is faster to calculate than the regular content type. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +



@@ -550,7 +537,8 @@ A key in the "standard" namespace for getting the amount of disk space that is consumed by the file (in bytes). This will generally be larger than the file size (due to block size overhead) but can occasionally be smaller (for example, for sparse files). -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64. +

Since 2.20


@@ -561,7 +549,8 @@ Corresponding A key in the "standard" namespace for getting the symlink target, if the file is a symlink. Corresponding GFileAttributeType is -G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.

+G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. +


@@ -571,7 +560,8 @@ is a symlink. Corresponding G_FILE_TYPE_SHORTCUT or G_FILE_TYPE_MOUNTABLE files. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -584,7 +574,8 @@ Corresponding +was zero. +



@@ -605,7 +597,8 @@ entity tag. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during listing files, to avoid recursive -directory scanning.

+directory scanning. +


@@ -617,7 +610,8 @@ A key in the "id" namespace for getting the file system identifier. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during drag and drop to see if the source and target are on the same filesystem (default to move) or not (default -to copy).

+to copy). +


@@ -627,7 +621,8 @@ to copy).

A key in the "access" namespace for getting read privileges. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to read the file.

+This attribute will be TRUE if the user is able to read the file. +


@@ -637,7 +632,8 @@ This attribute will be GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to write to the file.

+This attribute will be TRUE if the user is able to write to the file. +


@@ -647,7 +643,8 @@ This attribute will be GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to execute the file.

+This attribute will be TRUE if the user is able to execute the file. +


@@ -657,7 +654,8 @@ This attribute will be GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to delete the file.

+This attribute will be TRUE if the user is able to delete the file. +


@@ -667,8 +665,9 @@ This attribute will be GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to move the file to -the trash.

+This attribute will be TRUE if the user is able to move the file to +the trash. +


@@ -678,7 +677,8 @@ the trash.

A key in the "access" namespace for checking renaming privileges. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. -This attribute will be TRUE if the user is able to rename the file.

+This attribute will be TRUE if the user is able to rename the file. +


@@ -687,7 +687,8 @@ This attribute will be GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +






@@ -733,7 +738,8 @@ Corresponding

A key in the "mountable" namespace for getting the HAL UDI for the mountable -file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -742,7 +748,8 @@ file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +

Since 2.22


@@ -753,7 +760,8 @@ Corresponding A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is automatically polled for media. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +

Since 2.22


@@ -763,7 +771,8 @@ Corresponding

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +

Since 2.22


@@ -774,7 +783,8 @@ Corresponding A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started degraded. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +

Since 2.22


@@ -784,7 +794,8 @@ Corresponding

A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +

Since 2.22


@@ -794,7 +805,8 @@ Corresponding

A key in the "mountable" namespace for getting the GDriveStartStopType. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32. +

Since 2.22


@@ -806,7 +818,8 @@ Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the -file was modified.

+file was modified. +


@@ -817,7 +830,8 @@ file was modified.

A key in the "time" namespace for getting the miliseconds of the time the file was last modified. This should be used in conjunction with G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding GFileAttributeType is -G_FILE_ATTRIBUTE_TYPE_UINT32.

+G_FILE_ATTRIBUTE_TYPE_UINT32. +


@@ -828,7 +842,8 @@ the file was last modified. This should be used in conjunction with A key in the "time" namespace for getting the time the file was last accessed. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the -file was last accessed.

+file was last accessed. +


@@ -839,7 +854,8 @@ file was last accessed.

A key in the "time" namespace for getting the microseconds of the time the file was last accessed. This should be used in conjunction with G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding GFileAttributeType is -G_FILE_ATTRIBUTE_TYPE_UINT32.

+G_FILE_ATTRIBUTE_TYPE_UINT32. +





@@ -898,7 +918,8 @@ the file was created. This should be used in conjunction with A key in the "unix" namespace for getting the device id of the device the file is located on (see stat() documentation). This attribute is only available for UNIX file systems. Corresponding GFileAttributeType is -G_FILE_ATTRIBUTE_TYPE_UINT32.

+G_FILE_ATTRIBUTE_TYPE_UINT32. +


@@ -908,7 +929,8 @@ available for UNIX file systems. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64.

+GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT64. +


@@ -919,7 +941,8 @@ This attribute is only available for UNIX file systems. Corresponding A key in the "unix" namespace for getting the mode of the file (e.g. whether the file is a regular file, symlink, etc). See lstat() documentation. This attribute is only available for UNIX file systems. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32. +



@@ -940,7 +964,8 @@ for UNIX file systems. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32. +






@@ -990,9 +1019,10 @@ Corresponding

A key in the "unix" namespace for checking if the file represents a -UNIX mount point. This attribute is TRUE if the file is a UNIX mount +UNIX mount point. This attribute is TRUE if the file is a UNIX mount point. This attribute is only available for UNIX file systems. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +


@@ -1001,9 +1031,10 @@ Corresponding

A key in the "dos" namespace for checking if the file's archive flag -is set. This attribute is TRUE if the archive flag is set. This attribute +is set. This attribute is TRUE if the archive flag is set. This attribute is only available for DOS file systems. Corresponding GFileAttributeType -is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +


@@ -1012,9 +1043,10 @@ is TRUE if the backup flag is set. This attribute +is set. This attribute is TRUE if the backup flag is set. This attribute is only available for DOS file systems. Corresponding GFileAttributeType -is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +



@@ -1034,7 +1067,8 @@ file's owner. Corresponding GFileAttributeType is -G_FILE_ATTRIBUTE_TYPE_STRING.

+G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -1043,7 +1077,8 @@ user that owns the file. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +



@@ -1062,8 +1098,9 @@ image. Corresponding TRUE if thumbnailing failed. Corresponding -GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+This attribute is TRUE if thumbnailing failed. Corresponding +GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +


@@ -1075,7 +1112,8 @@ A key in the "preview" namespace for getting a GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_OBJECT. The value -for this key should contain a GIcon.

+for this key should contain a GIcon. +

Since 2.20


@@ -1086,7 +1124,8 @@ for this key should contain a A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, used in g_file_query_filesystem_info(). Corresponding GFileAttributeType -is G_FILE_ATTRIBUTE_TYPE_UINT64.

+is G_FILE_ATTRIBUTE_TYPE_UINT64. +



@@ -1105,7 +1145,8 @@ file system. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


@@ -1114,8 +1155,9 @@ Corresponding

A key in the "filesystem" namespace for checking if the file system -is read only. Is set to TRUE if the file system is read only. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN.

+is read only. Is set to TRUE if the file system is read only. +Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_BOOLEAN. +



@@ -1136,7 +1179,8 @@ GVFS backend in use. Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only -available if GLib has been built with SELinux support.

+available if GLib has been built with SELinux support. +


@@ -1146,7 +1190,8 @@ available if GLib has been built with SELinux support.

A key in the "trash" namespace. When requested against "trash:///" returns the number of (toplevel) items in the trash folder. -Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_UINT32. +


@@ -1157,7 +1202,8 @@ Corresponding GFilesystemPreviewType.

+GFilesystemPreviewType. +


@@ -1173,14 +1219,16 @@ for a file in the trash. This is useful for instance as the window title when displaying a directory or for a bookmarks menu.

-Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING.

+Corresponding GFileAttributeType is G_FILE_ATTRIBUTE_TYPE_STRING. +


g_file_info_new ()

-
GFileInfo *         g_file_info_new                     (void);
+
GFileInfo *         g_file_info_new                     (void);

-Creates a new file info structure.

+Creates a new file info structure. +

G_FILE_TYPE_UNKNOWN

File's type is unknown. +File's type is unknown.

G_FILE_TYPE_REGULAR

File handle represents a regular file. +File handle represents a regular file.

G_FILE_TYPE_DIRECTORY

File handle represents a directory. +File handle represents a directory.

G_FILE_TYPE_SYMBOLIC_LINK

File handle represents a symbolic link +File handle represents a symbolic link (Unix systems).

G_FILE_TYPE_SPECIAL

File is a "special" file, such as a socket, fifo, +File is a "special" file, such as a socket, fifo, block device, or character device.

G_FILE_TYPE_SHORTCUT

File is a shortcut (Windows systems). +File is a shortcut (Windows systems).

G_FILE_TYPE_MOUNTABLE

File is a mountable location. +File is a mountable location.
@@ -1193,15 +1241,16 @@ Creates a new file info structure.


g_file_info_dup ()

-
GFileInfo *         g_file_info_dup                     (GFileInfo *other);
+
GFileInfo *         g_file_info_dup                     (GFileInfo *other);

-Duplicates a file info structure.

+Duplicates a file info structure. +

- @@ -1215,21 +1264,22 @@ Duplicates a file info structure.


g_file_info_copy_into ()

-
void                g_file_info_copy_into               (GFileInfo *src_info,
-                                                         GFileInfo *dest_info);
+
void                g_file_info_copy_into               (GFileInfo *src_info,
+                                                         GFileInfo *dest_info);

-Copies all of the GFileAttributes from src_info to dest_info.

+Copies all of the GFileAttributes from src_info to dest_info. +

other :

a GFileInfo. +a GFileInfo.
- - @@ -1238,27 +1288,28 @@ Copies all of the GFileAttributes from

g_file_info_has_attribute ()

-
gboolean            g_file_info_has_attribute           (GFileInfo *info,
-                                                         const char *attribute);
+
gboolean            g_file_info_has_attribute           (GFileInfo *info,
+                                                         const char *attribute);

-Checks if a file info structure has an attribute named attribute.

+Checks if a file info structure has an attribute named attribute. +

src_info :

source to copy attributes from. +source to copy attributes from.

dest_info :

destination to copy attributes to. +destination to copy attributes to.
- - - @@ -1267,28 +1318,29 @@ Checks if a file info structure has an attribute named

g_file_info_has_namespace ()

-
gboolean            g_file_info_has_namespace           (GFileInfo *info,
-                                                         const char *name_space);
+
gboolean            g_file_info_has_namespace           (GFileInfo *info,
+                                                         const char *name_space);

Checks if a file info structure has an attribute in the -specified name_space.

+specified name_space. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

TRUE if Ginfo has an attribute named attribute, - FALSE otherwise. + TRUE if Ginfo has an attribute named attribute, + FALSE otherwise.
- - - @@ -1299,28 +1351,29 @@ specified name_space.


g_file_info_list_attributes ()

-
char **             g_file_info_list_attributes         (GFileInfo *info,
-                                                         const char *name_space);
+
char **             g_file_info_list_attributes         (GFileInfo *info,
+                                                         const char *name_space);

-Lists the file info structure's attributes.

+Lists the file info structure's attributes. +

info :

a GFileInfo. +a GFileInfo.

name_space :

a file attribute namespace. +a file attribute namespace.

Returns :

TRUE if Ginfo has an attribute in name_space, - FALSE otherwise. + TRUE if Ginfo has an attribute in name_space, + FALSE otherwise.
- - @@ -1329,21 +1382,22 @@ possible attribute types for the given name_space

g_file_info_get_attribute_type ()

-
GFileAttributeType  g_file_info_get_attribute_type      (GFileInfo *info,
-                                                         const char *attribute);
+
GFileAttributeType  g_file_info_get_attribute_type      (GFileInfo *info,
+                                                         const char *attribute);

-Gets the attribute type for an attribute key.

+Gets the attribute type for an attribute key. +

info :

a GFileInfo. +a GFileInfo.

name_space :

a file attribute key's namespace. +a file attribute key's namespace.

Returns :

a null-terminated array of strings of all of the possible attribute types for the given name_space, or -NULL on error. +NULL on error.
- - @@ -1358,21 +1412,22 @@ Gets the attribute type for an attribute key.


g_file_info_remove_attribute ()

-
void                g_file_info_remove_attribute        (GFileInfo *info,
-                                                         const char *attribute);
+
void                g_file_info_remove_attribute        (GFileInfo *info,
+                                                         const char *attribute);

-Removes all cases of attribute from info if it exists.

+Removes all cases of attribute from info if it exists. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1381,29 +1436,30 @@ Removes all cases of attribute from

g_file_info_get_attribute_as_string ()

-
char *              g_file_info_get_attribute_as_string (GFileInfo *info,
-                                                         const char *attribute);
+
char *              g_file_info_get_attribute_as_string (GFileInfo *info,
+                                                         const char *attribute);

Gets the value of a attribute, formated as a string. This escapes things as needed to make the string valid -utf8.

+utf8. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1412,45 +1468,46 @@ utf8.


g_file_info_get_attribute_data ()

-
gboolean            g_file_info_get_attribute_data      (GFileInfo *info,
-                                                         const char *attribute,
-                                                         GFileAttributeType *type,
-                                                         gpointer *value_pp,
-                                                         GFileAttributeStatus *status);
+
gboolean            g_file_info_get_attribute_data      (GFileInfo *info,
+                                                         const char *attribute,
+                                                         GFileAttributeType *type,
+                                                         gpointer *value_pp,
+                                                         GFileAttributeStatus *status);

-Gets the attribute type, value and status for an attribute key.

+Gets the attribute type, value and status for an attribute key. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

a UTF-8 string associated with the given attribute. - When you're done with the string it must be freed with g_free(). + When you're done with the string it must be freed with g_free().
- - - - - - @@ -1459,21 +1516,22 @@ Gets the attribute type, value and status for an attribute key.


g_file_info_get_attribute_status ()

-
GFileAttributeStatus  g_file_info_get_attribute_status  (GFileInfo *info,
-                                                         const char *attribute);
+
GFileAttributeStatus  g_file_info_get_attribute_status  (GFileInfo *info,
+                                                         const char *attribute);

-Gets the attribute status for an attribute key.

+Gets the attribute status for an attribute key. +

info :

a GFileInfo +a GFileInfo

attribute :

a file attribute key +a file attribute key

type :

return location for the attribute type, or NULL +return location for the attribute type, or NULL

value_pp :

return location for the attribute value, or NULL +return location for the attribute value, or NULL

status :

return location for the attribute status, or NULL +return location for the attribute status, or NULL

Returns :

TRUE if info has an attribute named attribute, - FALSE otherwise. + TRUE if info has an attribute named attribute, + FALSE otherwise.
- - @@ -1489,28 +1547,29 @@ Gets the attribute status for an attribute key.


g_file_info_get_attribute_string ()

-
const char *        g_file_info_get_attribute_string    (GFileInfo *info,
-                                                         const char *attribute);
+
const char *        g_file_info_get_attribute_string    (GFileInfo *info,
+                                                         const char *attribute);

Gets the value of a string attribute. If the attribute does -not contain a string, NULL will be returned.

+not contain a string, NULL will be returned. +

info :

a GFileInfo +a GFileInfo

attribute :

a file attribute key +a file attribute key
- - @@ -1519,28 +1578,29 @@ not contain a string,

g_file_info_get_attribute_stringv ()

-
char **             g_file_info_get_attribute_stringv   (GFileInfo *info,
-                                                         const char *attribute);
+
char **             g_file_info_get_attribute_stringv   (GFileInfo *info,
+                                                         const char *attribute);

Gets the value of a stringv attribute. If the attribute does -not contain a stringv, NULL will be returned.

+not contain a stringv, NULL will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

the contents of the attribute value as a string, or -NULL otherwise. +NULL otherwise.
- - @@ -1552,28 +1612,29 @@ not contain a stringv,

g_file_info_get_attribute_byte_string ()

const char *        g_file_info_get_attribute_byte_string
-                                                        (GFileInfo *info,
-                                                         const char *attribute);
+ (GFileInfo *info, + const char *attribute);

Gets the value of a byte string attribute. If the attribute does -not contain a byte string, NULL will be returned.

+not contain a byte string, NULL will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

the contents of the attribute value as a stringv, or -NULL otherwise. Do not free. +NULL otherwise. Do not free.
- - @@ -1582,22 +1643,23 @@ not contain a byte string,

g_file_info_get_attribute_boolean ()

-
gboolean            g_file_info_get_attribute_boolean   (GFileInfo *info,
-                                                         const char *attribute);
+
gboolean            g_file_info_get_attribute_boolean   (GFileInfo *info,
+                                                         const char *attribute);

Gets the value of a boolean attribute. If the attribute does not -contain a boolean value, FALSE will be returned.

+contain a boolean value, FALSE will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

the contents of the attribute value as a byte string, or -NULL otherwise. +NULL otherwise.
- - @@ -1611,23 +1673,24 @@ contain a boolean value,

g_file_info_get_attribute_uint32 ()

-
guint32             g_file_info_get_attribute_uint32    (GFileInfo *info,
-                                                         const char *attribute);
+
guint32             g_file_info_get_attribute_uint32    (GFileInfo *info,
+                                                         const char *attribute);

Gets an unsigned 32-bit integer contained within the attribute. If the attribute does not contain an unsigned 32-bit integer, or is invalid, -0 will be returned.

+0 will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1641,23 +1704,24 @@ attribute does not contain an unsigned 32-bit integer, or is invalid,

g_file_info_get_attribute_int32 ()

-
gint32              g_file_info_get_attribute_int32     (GFileInfo *info,
-                                                         const char *attribute);
+
gint32              g_file_info_get_attribute_int32     (GFileInfo *info,
+                                                         const char *attribute);

Gets a signed 32-bit integer contained within the attribute. If the attribute does not contain a signed 32-bit integer, or is invalid, -0 will be returned.

+0 will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1671,23 +1735,24 @@ attribute does not contain a signed 32-bit integer, or is invalid,

g_file_info_get_attribute_uint64 ()

-
guint64             g_file_info_get_attribute_uint64    (GFileInfo *info,
-                                                         const char *attribute);
+
guint64             g_file_info_get_attribute_uint64    (GFileInfo *info,
+                                                         const char *attribute);

Gets a unsigned 64-bit integer contained within the attribute. If the attribute does not contain an unsigned 64-bit integer, or is invalid, -0 will be returned.

+0 will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1701,23 +1766,24 @@ attribute does not contain an unsigned 64-bit integer, or is invalid,

g_file_info_get_attribute_int64 ()

-
gint64              g_file_info_get_attribute_int64     (GFileInfo *info,
-                                                         const char *attribute);
+
gint64              g_file_info_get_attribute_int64     (GFileInfo *info,
+                                                         const char *attribute);

Gets a signed 64-bit integer contained within the attribute. If the attribute does not contain an signed 64-bit integer, or is invalid, -0 will be returned.

+0 will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - @@ -1731,28 +1797,29 @@ attribute does not contain an signed 64-bit integer, or is invalid,

g_file_info_get_attribute_object ()

-
GObject *           g_file_info_get_attribute_object    (GFileInfo *info,
-                                                         const char *attribute);
+
GObject *           g_file_info_get_attribute_object    (GFileInfo *info,
+                                                         const char *attribute);

-Gets the value of a GObject attribute. If the attribute does -not contain a GObject, NULL will be returned.

+Gets the value of a GObject attribute. If the attribute does +not contain a GObject, NULL will be returned. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.
- - - @@ -1761,33 +1828,34 @@ not contain a

g_file_info_set_attribute ()

-
void                g_file_info_set_attribute           (GFileInfo *info,
-                                                         const char *attribute,
-                                                         GFileAttributeType type,
-                                                         gpointer value_p);
+
void                g_file_info_set_attribute           (GFileInfo *info,
+                                                         const char *attribute,
+                                                         GFileAttributeType type,
+                                                         gpointer value_p);

-Sets the attribute to contain the given value, if possible.

+Sets the attribute to contain the given value, if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

Returns :

a GObject associated with the given attribute, or -NULL otherwise. + a GObject associated with the given attribute, or +NULL otherwise.
- - - - @@ -1796,38 +1864,39 @@ Sets the attribute to contain the given

g_file_info_set_attribute_status ()

-
gboolean            g_file_info_set_attribute_status    (GFileInfo *info,
-                                                         const char *attribute,
-                                                         GFileAttributeStatus status);
+
gboolean            g_file_info_set_attribute_status    (GFileInfo *info,
+                                                         const char *attribute,
+                                                         GFileAttributeStatus status);

Sets the attribute status for an attribute key. This is only needed by external code that implement g_file_set_attributes_from_info() or similar functions.

-The attribute must exist in info for this to work. Otherwise FALSE -is returned and info is unchanged.

+The attribute must exist in info for this to work. Otherwise FALSE +is returned and info is unchanged. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

type :

a GFileAttributeType +a GFileAttributeType

value_p :

pointer to the value +pointer to the value
- - - - @@ -1838,28 +1907,29 @@ is returned and info is unchanged.


g_file_info_set_attribute_string ()

-
void                g_file_info_set_attribute_string    (GFileInfo *info,
-                                                         const char *attribute,
-                                                         const char *attr_value);
+
void                g_file_info_set_attribute_string    (GFileInfo *info,
+                                                         const char *attribute,
+                                                         const char *attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo +a GFileInfo

attribute :

a file attribute key +a file attribute key

status :

a GFileAttributeStatus +a GFileAttributeStatus

Returns :

TRUE if the status was changed, FALSE if the key was not set. + TRUE if the status was changed, FALSE if the key was not set.
- - - @@ -1868,31 +1938,32 @@ if possible.


g_file_info_set_attribute_stringv ()

-
void                g_file_info_set_attribute_stringv   (GFileInfo *info,
-                                                         const char *attribute,
-                                                         char **attr_value);
+
void                g_file_info_set_attribute_stringv   (GFileInfo *info,
+                                                         const char *attribute,
+                                                         char **attr_value);

Sets the attribute to contain the given attr_value, if possible.

-Sinze: 2.22

+Sinze: 2.22 +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a string. +a string.
- - - @@ -1902,28 +1973,29 @@ Sinze: 2.22

g_file_info_set_attribute_byte_string ()

void                g_file_info_set_attribute_byte_string
-                                                        (GFileInfo *info,
-                                                         const char *attribute,
-                                                         const char *attr_value);
+ (GFileInfo *info, + const char *attribute, + const char *attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a NULL terminated string array +a NULL terminated string array
- - - @@ -1932,28 +2004,29 @@ if possible.


g_file_info_set_attribute_boolean ()

-
void                g_file_info_set_attribute_boolean   (GFileInfo *info,
-                                                         const char *attribute,
-                                                         gboolean attr_value);
+
void                g_file_info_set_attribute_boolean   (GFileInfo *info,
+                                                         const char *attribute,
+                                                         gboolean attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a byte string. +a byte string.
- - - @@ -1962,28 +2035,29 @@ if possible.


g_file_info_set_attribute_uint32 ()

-
void                g_file_info_set_attribute_uint32    (GFileInfo *info,
-                                                         const char *attribute,
-                                                         guint32 attr_value);
+
void                g_file_info_set_attribute_uint32    (GFileInfo *info,
+                                                         const char *attribute,
+                                                         guint32 attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a boolean value. +a boolean value.
- - - @@ -1992,28 +2066,29 @@ if possible.


g_file_info_set_attribute_int32 ()

-
void                g_file_info_set_attribute_int32     (GFileInfo *info,
-                                                         const char *attribute,
-                                                         gint32 attr_value);
+
void                g_file_info_set_attribute_int32     (GFileInfo *info,
+                                                         const char *attribute,
+                                                         gint32 attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

an unsigned 32-bit integer. +an unsigned 32-bit integer.
- - - @@ -2022,28 +2097,29 @@ if possible.


g_file_info_set_attribute_uint64 ()

-
void                g_file_info_set_attribute_uint64    (GFileInfo *info,
-                                                         const char *attribute,
-                                                         guint64 attr_value);
+
void                g_file_info_set_attribute_uint64    (GFileInfo *info,
+                                                         const char *attribute,
+                                                         guint64 attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a signed 32-bit integer +a signed 32-bit integer
- - - @@ -2052,28 +2128,29 @@ if possible.


g_file_info_set_attribute_int64 ()

-
void                g_file_info_set_attribute_int64     (GFileInfo *info,
-                                                         const char *attribute,
-                                                         gint64 attr_value);
+
void                g_file_info_set_attribute_int64     (GFileInfo *info,
+                                                         const char *attribute,
+                                                         gint64 attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

an unsigned 64-bit integer. +an unsigned 64-bit integer.
- - - @@ -2082,28 +2159,29 @@ if possible.


g_file_info_set_attribute_object ()

-
void                g_file_info_set_attribute_object    (GFileInfo *info,
-                                                         const char *attribute,
-                                                         GObject *attr_value);
+
void                g_file_info_set_attribute_object    (GFileInfo *info,
+                                                         const char *attribute,
+                                                         GObject *attr_value);

Sets the attribute to contain the given attr_value, -if possible.

+if possible. +

info :

a GFileInfo. +a GFileInfo.

attribute :

attribute name to set. +attribute name to set.

attr_value :

int64 value to set attribute to. +int64 value to set attribute to.
- - - @@ -2112,14 +2190,15 @@ if possible.


g_file_info_clear_status ()

-
void                g_file_info_clear_status            (GFileInfo *info);
+
void                g_file_info_clear_status            (GFileInfo *info);

-Clears the status information from info.

+Clears the status information from info. +

info :

a GFileInfo. +a GFileInfo.

attribute :

a file attribute key. +a file attribute key.

attr_value :

a GObject. +a GObject.
-

info :

a GFileInfo. +a GFileInfo.
@@ -2127,16 +2206,17 @@ Clears the status information from info.

g_file_info_get_file_type ()

-
GFileType           g_file_info_get_file_type           (GFileInfo *info);
+
GFileType           g_file_info_get_file_type           (GFileInfo *info);

Gets a file's type (whether it is a regular file, symlink, etc). -This is different from the file's content type, see g_file_info_get_content_type().

+This is different from the file's content type, see g_file_info_get_content_type(). +

- @@ -2150,20 +2230,21 @@ This is different from the file's content type, see

g_file_info_get_is_hidden ()

-
gboolean            g_file_info_get_is_hidden           (GFileInfo *info);
+
gboolean            g_file_info_get_is_hidden           (GFileInfo *info);

-Checks if a file is hidden.

+Checks if a file is hidden. +

info :

a GFileInfo. +a GFileInfo.
- - @@ -2172,20 +2253,21 @@ Checks if a file is hidden.


g_file_info_get_is_backup ()

-
gboolean            g_file_info_get_is_backup           (GFileInfo *info);
+
gboolean            g_file_info_get_is_backup           (GFileInfo *info);

-Checks if a file is a backup file.

+Checks if a file is a backup file. +

info :

a GFileInfo. +a GFileInfo.

Returns :

TRUE if the file is a hidden file, FALSE otherwise. + TRUE if the file is a hidden file, FALSE otherwise.
- - @@ -2194,20 +2276,21 @@ Checks if a file is a backup file.


g_file_info_get_is_symlink ()

-
gboolean            g_file_info_get_is_symlink          (GFileInfo *info);
+
gboolean            g_file_info_get_is_symlink          (GFileInfo *info);

-Checks if a file is a symlink.

+Checks if a file is a symlink. +

info :

a GFileInfo. +a GFileInfo.

Returns :

TRUE if file is a backup file, FALSE otherwise. + TRUE if file is a backup file, FALSE otherwise.
- - @@ -2216,15 +2299,16 @@ Checks if a file is a symlink.


g_file_info_get_name ()

-
const char *        g_file_info_get_name                (GFileInfo *info);
+
const char *        g_file_info_get_name                (GFileInfo *info);

-Gets the name for a file.

+Gets the name for a file. +

info :

a GFileInfo. +a GFileInfo.

Returns :

TRUE if the given info is a symlink. + TRUE if the given info is a symlink.
- @@ -2238,15 +2322,16 @@ Gets the name for a file.


g_file_info_get_display_name ()

-
const char *        g_file_info_get_display_name        (GFileInfo *info);
+
const char *        g_file_info_get_display_name        (GFileInfo *info);

-Gets a display name for a file.

+Gets a display name for a file. +

info :

a GFileInfo. +a GFileInfo.
- @@ -2260,15 +2345,16 @@ Gets a display name for a file.


g_file_info_get_edit_name ()

-
const char *        g_file_info_get_edit_name           (GFileInfo *info);
+
const char *        g_file_info_get_edit_name           (GFileInfo *info);

-Gets the edit name for a file.

+Gets the edit name for a file. +

info :

a GFileInfo. +a GFileInfo.
- @@ -2282,15 +2368,16 @@ Gets the edit name for a file.


g_file_info_get_icon ()

-
GIcon *             g_file_info_get_icon                (GFileInfo *info);
+
GIcon *             g_file_info_get_icon                (GFileInfo *info);

-Gets the icon for a file.

+Gets the icon for a file. +

info :

a GFileInfo. +a GFileInfo.
- @@ -2304,15 +2391,16 @@ Gets the icon for a file.


g_file_info_get_content_type ()

-
const char *        g_file_info_get_content_type        (GFileInfo *info);
+
const char *        g_file_info_get_content_type        (GFileInfo *info);

-Gets the file's content type.

+Gets the file's content type. +

info :

a GFileInfo. +a GFileInfo.
- @@ -2326,20 +2414,21 @@ Gets the file's content type.


g_file_info_get_size ()

-
goffset             g_file_info_get_size                (GFileInfo *info);
+
goffset             g_file_info_get_size                (GFileInfo *info);

-Gets the file's size.

+Gets the file's size. +

info :

a GFileInfo. +a GFileInfo.
- - @@ -2348,22 +2437,23 @@ Gets the file's size.


g_file_info_get_modification_time ()

-
void                g_file_info_get_modification_time   (GFileInfo *info,
-                                                         GTimeVal *result);
+
void                g_file_info_get_modification_time   (GFileInfo *info,
+                                                         GTimeVal *result);

Gets the modification time of the current info and sets it -in result.

+in result. +

info :

a GFileInfo. +a GFileInfo.

Returns :

a goffset containing the file's size. + a goffset containing the file's size.
- - @@ -2372,15 +2462,16 @@ in result.


g_file_info_get_symlink_target ()

-
const char *        g_file_info_get_symlink_target      (GFileInfo *info);
+
const char *        g_file_info_get_symlink_target      (GFileInfo *info);

-Gets the symlink target for a given GFileInfo.

+Gets the symlink target for a given GFileInfo. +

info :

a GFileInfo. +a GFileInfo.

result :

a GTimeVal. +a GTimeVal.
- @@ -2394,16 +2485,17 @@ Gets the symlink target for a given

g_file_info_get_etag ()

-
const char *        g_file_info_get_etag                (GFileInfo *info);
+
const char *        g_file_info_get_etag                (GFileInfo *info);

Gets the entity tag for a given -GFileInfo. See G_FILE_ATTRIBUTE_ETAG_VALUE.

+GFileInfo. See G_FILE_ATTRIBUTE_ETAG_VALUE. +

info :

a GFileInfo. +a GFileInfo.
- @@ -2417,21 +2509,22 @@ Gets the entity tag for a given

g_file_info_get_sort_order ()

-
gint32              g_file_info_get_sort_order          (GFileInfo *info);
+
gint32              g_file_info_get_sort_order          (GFileInfo *info);

Gets the value of the sort_order attribute from the GFileInfo. -See G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.

+See G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. +

info :

a GFileInfo. +a GFileInfo.
- - @@ -2440,21 +2533,22 @@ See

g_file_info_set_attribute_mask ()

-
void                g_file_info_set_attribute_mask      (GFileInfo *info,
-                                                         GFileAttributeMatcher *mask);
+
void                g_file_info_set_attribute_mask      (GFileInfo *info,
+                                                         GFileAttributeMatcher *mask);

-Sets mask on info to match specific attribute types.

+Sets mask on info to match specific attribute types. +

info :

a GFileInfo. +a GFileInfo.

Returns :

a gint32 containing the value of the "standard::sort_order" attribute. + a gint32 containing the value of the "standard::sort_order" attribute.
- - @@ -2463,15 +2557,17 @@ Sets mask on

g_file_info_unset_attribute_mask ()

-
void                g_file_info_unset_attribute_mask    (GFileInfo *info);
+
void                g_file_info_unset_attribute_mask    (GFileInfo *info);

Unsets a mask set by g_file_info_set_attribute_mask(), if one -is set.

+is set. +

info :

a GFileInfo. +a GFileInfo.

mask :

a GFileAttributeMatcher. +a GFileAttributeMatcher.
-

info :

GFileInfo. + +GFileInfo.
@@ -2479,22 +2575,23 @@ is set.


g_file_info_set_file_type ()

-
void                g_file_info_set_file_type           (GFileInfo *info,
-                                                         GFileType type);
+
void                g_file_info_set_file_type           (GFileInfo *info,
+                                                         GFileType type);

Sets the file type in a GFileInfo to type. -See G_FILE_ATTRIBUTE_STANDARD_TYPE.

+See G_FILE_ATTRIBUTE_STANDARD_TYPE. +

- - @@ -2503,22 +2600,23 @@ See

g_file_info_set_is_hidden ()

-
void                g_file_info_set_is_hidden           (GFileInfo *info,
-                                                         gboolean is_hidden);
+
void                g_file_info_set_is_hidden           (GFileInfo *info,
+                                                         gboolean is_hidden);

Sets the "is_hidden" attribute in a GFileInfo according to is_symlink. -See G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.

+See G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. +

info :

a GFileInfo. +a GFileInfo.

type :

a GFileType. +a GFileType.
- - @@ -2527,22 +2625,23 @@ See

g_file_info_set_is_symlink ()

-
void                g_file_info_set_is_symlink          (GFileInfo *info,
-                                                         gboolean is_symlink);
+
void                g_file_info_set_is_symlink          (GFileInfo *info,
+                                                         gboolean is_symlink);

Sets the "is_symlink" attribute in a GFileInfo according to is_symlink. -See G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.

+See G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. +

info :

a GFileInfo. +a GFileInfo.

is_hidden :

a gboolean. +a gboolean.
- - @@ -2551,22 +2650,23 @@ See

g_file_info_set_name ()

-
void                g_file_info_set_name                (GFileInfo *info,
-                                                         const char *name);
+
void                g_file_info_set_name                (GFileInfo *info,
+                                                         const char *name);

Sets the name attribute for the current GFileInfo. -See G_FILE_ATTRIBUTE_STANDARD_NAME.

+See G_FILE_ATTRIBUTE_STANDARD_NAME. +

info :

a GFileInfo. +a GFileInfo.

is_symlink :

a gboolean. +a gboolean.
- - @@ -2575,22 +2675,23 @@ See

g_file_info_set_display_name ()

-
void                g_file_info_set_display_name        (GFileInfo *info,
-                                                         const char *display_name);
+
void                g_file_info_set_display_name        (GFileInfo *info,
+                                                         const char *display_name);

Sets the display name for the current GFileInfo. -See G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.

+See G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. +

info :

a GFileInfo. +a GFileInfo.

name :

a string containing a name. +a string containing a name.
- - @@ -2599,22 +2700,23 @@ See

g_file_info_set_edit_name ()

-
void                g_file_info_set_edit_name           (GFileInfo *info,
-                                                         const char *edit_name);
+
void                g_file_info_set_edit_name           (GFileInfo *info,
+                                                         const char *edit_name);

Sets the edit name for the current file. -See G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.

+See G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. +

info :

a GFileInfo. +a GFileInfo.

display_name :

a string containing a display name. +a string containing a display name.
- - @@ -2623,22 +2725,23 @@ See

g_file_info_set_icon ()

-
void                g_file_info_set_icon                (GFileInfo *info,
-                                                         GIcon *icon);
+
void                g_file_info_set_icon                (GFileInfo *info,
+                                                         GIcon *icon);

Sets the icon for a given GFileInfo. -See G_FILE_ATTRIBUTE_STANDARD_ICON.

+See G_FILE_ATTRIBUTE_STANDARD_ICON. +

info :

a GFileInfo. +a GFileInfo.

edit_name :

a string containing an edit name. +a string containing an edit name.
- - @@ -2647,22 +2750,23 @@ See

g_file_info_set_content_type ()

-
void                g_file_info_set_content_type        (GFileInfo *info,
-                                                         const char *content_type);
+
void                g_file_info_set_content_type        (GFileInfo *info,
+                                                         const char *content_type);

Sets the content type attribute for a given GFileInfo. -See G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.

+See G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. +

info :

a GFileInfo. +a GFileInfo.

icon :

a GIcon. +a GIcon.
- - @@ -2671,22 +2775,23 @@ See

g_file_info_set_size ()

-
void                g_file_info_set_size                (GFileInfo *info,
-                                                         goffset size);
+
void                g_file_info_set_size                (GFileInfo *info,
+                                                         goffset size);

Sets the G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info -to the given size.

+to the given size. +

info :

a GFileInfo. +a GFileInfo.

content_type :

a content type. See GContentType. +a content type. See GContentType.
- - @@ -2695,22 +2800,23 @@ to the given size.


g_file_info_set_modification_time ()

-
void                g_file_info_set_modification_time   (GFileInfo *info,
-                                                         GTimeVal *mtime);
+
void                g_file_info_set_modification_time   (GFileInfo *info,
+                                                         GTimeVal *mtime);

Sets the G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file -info to the given time value.

+info to the given time value. +

info :

a GFileInfo. +a GFileInfo.

size :

a goffset containing the file's size. +a goffset containing the file's size.
- - @@ -2719,22 +2825,23 @@ info to the given time value.


g_file_info_set_symlink_target ()

-
void                g_file_info_set_symlink_target      (GFileInfo *info,
-                                                         const char *symlink_target);
+
void                g_file_info_set_symlink_target      (GFileInfo *info,
+                                                         const char *symlink_target);

Sets the G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info -to the given symlink target.

+to the given symlink target. +

info :

a GFileInfo. +a GFileInfo.

mtime :

a GTimeVal. +a GTimeVal.
- - @@ -2743,22 +2850,23 @@ to the given symlink target.


g_file_info_set_sort_order ()

-
void                g_file_info_set_sort_order          (GFileInfo *info,
-                                                         gint32 sort_order);
+
void                g_file_info_set_sort_order          (GFileInfo *info,
+                                                         gint32 sort_order);

Sets the sort order attribute in the file info structure. See -G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.

+G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. +

info :

a GFileInfo. +a GFileInfo.

symlink_target :

a static string containing a path to a symlink target. +a static string containing a path to a symlink target.
- - @@ -2767,7 +2875,7 @@ Sets the sort order attribute in the file info structure. See

g_file_attribute_matcher_new ()

-
GFileAttributeMatcher * g_file_attribute_matcher_new    (const char *attributes);
+
GFileAttributeMatcher * g_file_attribute_matcher_new    (const char *attributes);

Creates a new file attribute matcher, which matches attributes against a given string. GFileAttributeMatchers are reference @@ -2786,7 +2894,7 @@ The wildcard "*" may be used to match all keys and namespaces, or Examples of strings to use:

-

Table 3. File Attribute Matcher strings and results

+

Table 3. File Attribute Matcher strings and results

info :

a GFileInfo. +a GFileInfo.

sort_order :

a sort order integer. +a sort order integer.
@@ -2813,13 +2921,14 @@ all keys in the unix namespace.
-


+


+

- @@ -2833,15 +2942,16 @@ all keys in the unix namespace.

g_file_attribute_matcher_ref ()

-
GFileAttributeMatcher * g_file_attribute_matcher_ref    (GFileAttributeMatcher *matcher);
+
GFileAttributeMatcher * g_file_attribute_matcher_ref    (GFileAttributeMatcher *matcher);

-References a file attribute matcher.

+References a file attribute matcher. +

attributes :

an attribute string to match. +an attribute string to match.
- @@ -2855,15 +2965,16 @@ References a file attribute matcher.


g_file_attribute_matcher_unref ()

-
void                g_file_attribute_matcher_unref      (GFileAttributeMatcher *matcher);
+
void                g_file_attribute_matcher_unref      (GFileAttributeMatcher *matcher);

Unreferences matcher. If the reference count falls below 1, -the matcher is automatically freed.

+the matcher is automatically freed. +

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.
-

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.
@@ -2871,28 +2982,29 @@ the matcher is automatically freed.


g_file_attribute_matcher_matches ()

-
gboolean            g_file_attribute_matcher_matches    (GFileAttributeMatcher *matcher,
-                                                         const char *attribute);
+
gboolean            g_file_attribute_matcher_matches    (GFileAttributeMatcher *matcher,
+                                                         const char *attribute);

Checks if an attribute will be matched by an attribute matcher. If the matcher was created with the "*" matching string, this function -will always return TRUE.

+will always return TRUE. +

- - - @@ -2901,28 +3013,29 @@ will always return

g_file_attribute_matcher_matches_only ()

-
gboolean            g_file_attribute_matcher_matches_only
-                                                        (GFileAttributeMatcher *matcher,
-                                                         const char *attribute);
+
gboolean            g_file_attribute_matcher_matches_only
+                                                        (GFileAttributeMatcher *matcher,
+                                                         const char *attribute);

Checks if a attribute matcher only matches a given attribute. Always -returns FALSE if "*" was used when creating the matcher.

+returns FALSE if "*" was used when creating the matcher. +

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.

attribute :

a file attribute key. +a file attribute key.

Returns :

TRUE if attribute matches matcher. FALSE otherwise. + TRUE if attribute matches matcher. FALSE otherwise.
- - - @@ -2931,34 +3044,35 @@ returns

g_file_attribute_matcher_enumerate_namespace ()

-
gboolean            g_file_attribute_matcher_enumerate_namespace
-                                                        (GFileAttributeMatcher *matcher,
-                                                         const char *ns);
+
gboolean            g_file_attribute_matcher_enumerate_namespace
+                                                        (GFileAttributeMatcher *matcher,
+                                                         const char *ns);

Checks if the matcher will match all of the keys in a given namespace. -This will always return TRUE if a wildcard character is in use (e.g. if +This will always return TRUE if a wildcard character is in use (e.g. if matcher was created with "standard::*" and ns is "standard", or if matcher was created using "*" and namespace is anything.)

-TODO: this is awkwardly worded.

+TODO: this is awkwardly worded. +

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.

attribute :

a file attribute key. +a file attribute key.

Returns :

TRUE if the matcher only matches attribute. FALSE otherwise. + TRUE if the matcher only matches attribute. FALSE otherwise.
- - - @@ -2968,20 +3082,21 @@ in the given ns,

g_file_attribute_matcher_enumerate_next ()

const char *        g_file_attribute_matcher_enumerate_next
-                                                        (GFileAttributeMatcher *matcher);
+ (GFileAttributeMatcher *matcher);

-Gets the next matched attribute from a GFileAttributeMatcher.

+Gets the next matched attribute from a GFileAttributeMatcher. +

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.

ns :

a string containing a file attribute namespace. +a string containing a file attribute namespace.

Returns :

TRUE if the matcher matches all of the entries -in the given ns, FALSE otherwise. + TRUE if the matcher matches all of the entries +in the given ns, FALSE otherwise.
- - @@ -2996,6 +3111,6 @@ no more attribute exist. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileInputStream.html b/docs/reference/gio/html/GFileInputStream.html index 384480e..fbc16d3 100644 --- a/docs/reference/gio/html/GFileInputStream.html +++ b/docs/reference/gio/html/GFileInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

matcher :

a GFileAttributeMatcher. +a GFileAttributeMatcher.

Returns :

a string containing the next attribute or NULL if + a string containing the next attribute or NULL if no more attribute exist.
@@ -75,27 +45,27 @@ #include <gio/gio.h> GFileInputStream; -GFileInfo * g_file_input_stream_query_info (GFileInputStream *stream, - const char *attributes, - GCancellable *cancellable, - GError **error); +GFileInfo * g_file_input_stream_query_info (GFileInputStream *stream, + const char *attributes, + GCancellable *cancellable, + GError **error); voidg_file_input_stream_query_info_async - (GFileInputStream *stream, - const char *attributes, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GFileInputStream *stream, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); GFileInfo * g_file_input_stream_query_info_finish - (GFileInputStream *stream, - GAsyncResult *result, - GError **error); + (GFileInputStream *stream, + GAsyncResult *result, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFileInputStream
 
@@ -118,7 +88,8 @@ stream to jump to arbitrary positions in the file, provided the filesystem of the file allows it. To find the position of a file input stream, use g_seekable_tell(). To find out if a file input stream supports seeking, use g_seekable_stream_can_seek(). -To position a file input stream, use g_seekable_seek().

+To position a file input stream, use g_seekable_seek(). +

Details

@@ -130,48 +101,50 @@ A subclass of GInputStream for opened files. This adds a few file-specific operations and seeking.

-GFileInputStream implements GSeekable.

+GFileInputStream implements GSeekable. +


g_file_input_stream_query_info ()

-
GFileInfo *         g_file_input_stream_query_info      (GFileInputStream *stream,
-                                                         const char *attributes,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_input_stream_query_info      (GFileInputStream *stream,
+                                                         const char *attributes,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Queries a file input stream the given attributes. This function blocks while querying the stream. For the asynchronous (non-blocking) version of this function, see g_file_input_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and -any other operations on the stream will fail with G_IO_ERROR_PENDING.

+any other operations on the stream will fail with G_IO_ERROR_PENDING. +

- - - - - @@ -181,12 +154,12 @@ ignore.

g_file_input_stream_query_info_async ()

void                g_file_input_stream_query_info_async
-                                                        (GFileInputStream *stream,
-                                                         const char *attributes,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GFileInputStream *stream, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Queries the stream information asynchronously. When the operation is finished callback will be called. @@ -198,41 +171,42 @@ For the synchronous version of this function, see g_file_input_stream_query_info().

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be set

+was cancelled, the error G_IO_ERROR_CANCELLED will be set +

stream :

a GFileInputStream. +a GFileInputStream.

attributes :

a file attribute query string. +a file attribute query string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GFileInfo, or NULL on error. + a GFileInfo, or NULL on error.
- - - - - - @@ -242,28 +216,29 @@ was cancelled, the error

g_file_input_stream_query_info_finish ()

GFileInfo *         g_file_input_stream_query_info_finish
-                                                        (GFileInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+ (GFileInputStream *stream, + GAsyncResult *result, + GError **error);

-Finishes an asynchronous info query operation.

+Finishes an asynchronous info query operation. +

stream :

a GFileInputStream. +a GFileInputStream.

attributes :

a file attribute query string. +a file attribute query string.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - @@ -282,6 +257,6 @@ Finishes an asynchronous info query operation.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileMonitor.html b/docs/reference/gio/html/GFileMonitor.html index df9ad1c..0a4efa3 100644 --- a/docs/reference/gio/html/GFileMonitor.html +++ b/docs/reference/gio/html/GFileMonitor.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GFileInputStream. +a GFileInputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, - or NULL to ignore. +a GError location to store the error occuring, + or NULL to ignore.
@@ -78,28 +48,28 @@ enum GFileMonitorEvent; GFileMonitor; -gbooleang_file_monitor_cancel (GFileMonitor *monitor); -gbooleang_file_monitor_is_cancelled (GFileMonitor *monitor); -voidg_file_monitor_set_rate_limit (GFileMonitor *monitor, - int limit_msecs); -voidg_file_monitor_emit_event (GFileMonitor *monitor, - GFile *child, - GFile *other_file, - GFileMonitorEvent event_type); +gbooleang_file_monitor_cancel (GFileMonitor *monitor); +gbooleang_file_monitor_is_cancelled (GFileMonitor *monitor); +voidg_file_monitor_set_rate_limit (GFileMonitor *monitor, + int limit_msecs); +voidg_file_monitor_emit_event (GFileMonitor *monitor, + GFile *child, + GFile *other_file, + GFileMonitorEvent event_type);

Object Hierarchy

-  GObject
+  GObject
    +----GFileMonitor
 

Properties

-  "cancelled"                gboolean              : Read
-  "rate-limit"               gint                  : Read / Write
+  "cancelled"                gboolean              : Read
+  "rate-limit"               gint                  : Read / Write
 
@@ -125,7 +95,8 @@ signal will be emitted in the

Details

@@ -143,48 +114,49 @@ context is still running).

} GFileMonitorEvent;

-Specifies what type of event a monitor event is.

+Specifies what type of event a monitor event is. +

- - - - - - - - @@ -195,25 +167,27 @@ Specifies what type of event a monitor event is.

GFileMonitor

typedef struct _GFileMonitor GFileMonitor;

-Watches for changes to a file.

+Watches for changes to a file. +


g_file_monitor_cancel ()

-
gboolean            g_file_monitor_cancel               (GFileMonitor *monitor);
+
gboolean            g_file_monitor_cancel               (GFileMonitor *monitor);

-Cancels a file monitor.

+Cancels a file monitor. +

G_FILE_MONITOR_EVENT_CHANGED

a file changed. +a file changed.

G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT

a hint that this was probably the last change in a set of changes. +a hint that this was probably the last change in a set of changes.

G_FILE_MONITOR_EVENT_DELETED

a file was deleted. +a file was deleted.

G_FILE_MONITOR_EVENT_CREATED

a file was created. +a file was created.

G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED

a file attribute was changed. +a file attribute was changed.

G_FILE_MONITOR_EVENT_PRE_UNMOUNT

the file location will soon be unmounted. +the file location will soon be unmounted.

G_FILE_MONITOR_EVENT_UNMOUNTED

the file location was unmounted. +the file location was unmounted.

G_FILE_MONITOR_EVENT_MOVED

the file was moved. +the file was moved.
- - @@ -222,20 +196,21 @@ Cancels a file monitor.


g_file_monitor_is_cancelled ()

-
gboolean            g_file_monitor_is_cancelled         (GFileMonitor *monitor);
+
gboolean            g_file_monitor_is_cancelled         (GFileMonitor *monitor);

-Returns whether the monitor is canceled.

+Returns whether the monitor is canceled. +

monitor :

a GFileMonitor. +a GFileMonitor.

Returns :

TRUE if monitor was cancelled. + TRUE if monitor was cancelled.
- - @@ -244,22 +219,23 @@ Returns whether the monitor is canceled.


g_file_monitor_set_rate_limit ()

-
void                g_file_monitor_set_rate_limit       (GFileMonitor *monitor,
-                                                         int limit_msecs);
+
void                g_file_monitor_set_rate_limit       (GFileMonitor *monitor,
+                                                         int limit_msecs);

Sets the rate limit to which the monitor will report -consecutive change events to the same file.

+consecutive change events to the same file. +

monitor :

a GFileMonitor +a GFileMonitor

Returns :

TRUE if monitor is canceled. FALSE otherwise. + TRUE if monitor is canceled. FALSE otherwise.
- - @@ -269,10 +245,10 @@ poll for changes.

g_file_monitor_emit_event ()

-
void                g_file_monitor_emit_event           (GFileMonitor *monitor,
-                                                         GFile *child,
-                                                         GFile *other_file,
-                                                         GFileMonitorEvent event_type);
+
void                g_file_monitor_emit_event           (GFileMonitor *monitor,
+                                                         GFile *child,
+                                                         GFile *other_file,
+                                                         GFileMonitorEvent event_type);

Emits the "changed" signal if a change has taken place. Should be called from file monitor @@ -280,28 +256,29 @@ implementations only.

The signal will be emitted from an idle handler (in the thread-default main -context).

+context). +

monitor :

a GFileMonitor. +a GFileMonitor.

limit_msecs :

a integer with the limit in milliseconds to +a integer with the limit in milliseconds to poll for changes.
- - - - @@ -312,14 +289,14 @@ context).

Property Details

The "cancelled" property

-
  "cancelled"                gboolean              : Read
+
  "cancelled"                gboolean              : Read

Whether the monitor has been cancelled.

Default value: FALSE


The "rate-limit" property

-
  "rate-limit"               gint                  : Read / Write
+
  "rate-limit"               gint                  : Read / Write

The limit of the monitor to watch for changes, in milliseconds.

Allowed values: >= 0

Default value: 800

@@ -333,30 +310,31 @@ context).

GFile *file, GFile *other_file, GFileMonitorEvent event_type, - gpointer user_data) : Run Last + gpointer user_data) : Run Last

-Emitted when a file has been changed.

+Emitted when a file has been changed. +

monitor :

a GFileMonitor. +a GFileMonitor.

child :

a GFile. +a GFile.

other_file :

a GFile. +a GFile.

event_type :

a set of GFileMonitorEvent flags. +a set of GFileMonitorEvent flags.
- - - - @@ -370,6 +348,6 @@ Emitted when a file has been changed.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFileOutputStream.html b/docs/reference/gio/html/GFileOutputStream.html index 3d9d185..ffc732c 100644 --- a/docs/reference/gio/html/GFileOutputStream.html +++ b/docs/reference/gio/html/GFileOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

monitor :

a GFileMonitor. +a GFileMonitor.

file :

a GFile. +a GFile.

other_file :

a GFile. +a GFile.

event_type :

a GFileMonitorEvent. +a GFileMonitorEvent.
@@ -75,28 +45,28 @@ #include <gio/gio.h> GFileOutputStream; -GFileInfo * g_file_output_stream_query_info (GFileOutputStream *stream, - const char *attributes, - GCancellable *cancellable, - GError **error); +GFileInfo * g_file_output_stream_query_info (GFileOutputStream *stream, + const char *attributes, + GCancellable *cancellable, + GError **error); voidg_file_output_stream_query_info_async - (GFileOutputStream *stream, - const char *attributes, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GFileOutputStream *stream, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); GFileInfo * g_file_output_stream_query_info_finish - (GFileOutputStream *stream, - GAsyncResult *result, - GError **error); -char * g_file_output_stream_get_etag (GFileOutputStream *stream); + (GFileOutputStream *stream, + GAsyncResult *result, + GError **error); +char * g_file_output_stream_get_etag (GFileOutputStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFileOutputStream
 
@@ -125,7 +95,8 @@ To find out if a file output stream supports seeking, use g_seekable_can_seek().To position a file output stream, use g_seekable_seek(). To find out if a file output stream supports truncating, use g_seekable_can_truncate(). To truncate a file output -stream, use g_seekable_truncate().

+stream, use g_seekable_truncate(). +

Details

@@ -137,15 +108,16 @@ A subclass of GOutputStream for opened files. This adds a few file-specific operations and seeking and truncating.

-GFileOutputStream implements GSeekable.

+GFileOutputStream implements GSeekable. +


g_file_output_stream_query_info ()

-
GFileInfo *         g_file_output_stream_query_info     (GFileOutputStream *stream,
-                                                         const char *attributes,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GFileInfo *         g_file_output_stream_query_info     (GFileOutputStream *stream,
+                                                         const char *attributes,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Queries a file output stream for the given attributes. This function blocks while querying the stream. For the asynchronous @@ -159,39 +131,40 @@ Can fail if the stream was already closed (with erro G_IO_ERROR_CLOSED), the stream has pending operations (with error being set to G_IO_ERROR_PENDING), or if querying info is not supported for the stream's interface (with error being set to G_IO_ERROR_NOT_SUPPORTED). In -all cases of failure, NULL will be returned. +all cases of failure, NULL will be returned.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be set, and NULL will -be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be set, and NULL will +be returned. +

- - - - - @@ -201,12 +174,12 @@ be returned.

g_file_output_stream_query_info_async ()

void                g_file_output_stream_query_info_async
-                                                        (GFileOutputStream *stream,
-                                                         const char *attributes,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GFileOutputStream *stream, + const char *attributes, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously queries the stream for a GFileInfo. When completed, callback will be called with a GAsyncResult which can be used to @@ -214,39 +187,40 @@ finish the operation with g_file_output_stream_query_info().

+g_file_output_stream_query_info(). +

stream :

a GFileOutputStream. +a GFileOutputStream.

attributes :

a file attribute query string. +a file attribute query string.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.

Returns :

a GFileInfo for the stream, or NULL on error. + a GFileInfo for the stream, or NULL on error.
- - - - - - @@ -256,28 +230,29 @@ For the synchronous version of this function, see

g_file_output_stream_query_info_finish ()

GFileInfo *         g_file_output_stream_query_info_finish
-                                                        (GFileOutputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+ (GFileOutputStream *stream, + GAsyncResult *result, + GError **error);

Finalizes the asynchronous query started -by g_file_output_stream_query_info_async().

+by g_file_output_stream_query_info_async(). +

stream :

a GFileOutputStream. +a GFileOutputStream.

attributes :

a file attribute query string. +a file attribute query string.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - @@ -291,17 +266,18 @@ by

g_file_output_stream_get_etag ()

-
char *              g_file_output_stream_get_etag       (GFileOutputStream *stream);
+
char *              g_file_output_stream_get_etag       (GFileOutputStream *stream);

Gets the entity tag for the file when it has been written. This must be called after the stream has been written -and closed, as the etag can change while writing.

+and closed, as the etag can change while writing. +

stream :

a GFileOutputStream. +a GFileOutputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError, NULL to ignore. +a GError, NULL to ignore.
- @@ -320,6 +296,6 @@ and closed, as the etag can change while writing.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFilenameCompleter.html b/docs/reference/gio/html/GFilenameCompleter.html index 2c57716..0143ee0 100644 --- a/docs/reference/gio/html/GFilenameCompleter.html +++ b/docs/reference/gio/html/GFilenameCompleter.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GFileOutputStream. +a GFileOutputStream.
@@ -75,21 +45,21 @@ #include <gio/gio.h> GFilenameCompleter; -GFilenameCompleter * g_filename_completer_new (void); +GFilenameCompleter * g_filename_completer_new (void); char * g_filename_completer_get_completion_suffix - (GFilenameCompleter *completer, - const char *initial_text); + (GFilenameCompleter *completer, + const char *initial_text); char ** g_filename_completer_get_completions - (GFilenameCompleter *completer, - const char *initial_text); -void g_filename_completer_set_dirs_only (GFilenameCompleter *completer, - gboolean dirs_only); + (GFilenameCompleter *completer, + const char *initial_text); +void g_filename_completer_set_dirs_only (GFilenameCompleter *completer, + gboolean dirs_only);

Object Hierarchy

-  GObject
+  GObject
    +----GFilenameCompleter
 
@@ -104,7 +74,8 @@

Completes partial file and directory names given a partial string by looking in the file system for clues. Can return a list of possible -completion strings for widget implementations.

+completion strings for widget implementations. +

Details

@@ -112,14 +83,16 @@ completion strings for widget implementations.

GFilenameCompleter

typedef struct _GFilenameCompleter GFilenameCompleter;

-Completes filenames based on files that exist within the file system.

+Completes filenames based on files that exist within the file system. +


g_filename_completer_new ()

-
GFilenameCompleter * g_filename_completer_new           (void);
+
GFilenameCompleter * g_filename_completer_new           (void);

-Creates a new filename completer.

+Creates a new filename completer. +

@@ -133,27 +106,28 @@ Creates a new filename completer.

g_filename_completer_get_completion_suffix ()

char *              g_filename_completer_get_completion_suffix
-                                                        (GFilenameCompleter *completer,
-                                                         const char *initial_text);
+ (GFilenameCompleter *completer, + const char *initial_text);

-Obtains a completion for initial_text from completer.

+Obtains a completion for initial_text from completer. +

- - - @@ -164,27 +138,28 @@ Obtains a completion for initial_text fr

g_filename_completer_get_completions ()

char **             g_filename_completer_get_completions
-                                                        (GFilenameCompleter *completer,
-                                                         const char *initial_text);
+ (GFilenameCompleter *completer, + const char *initial_text);

-Gets an array of completion strings for a given initial text.

+Gets an array of completion strings for a given initial text. +

completer :

the filename completer. +the filename completer.

initial_text :

text to be completed. +text to be completed.

Returns :

a completed string, or NULL if no completion exists. - This string is not owned by GIO, so remember to g_free() it + a completed string, or NULL if no completion exists. + This string is not owned by GIO, so remember to g_free() it when finished.
- - @@ -193,22 +168,23 @@ This array must be freed by

g_filename_completer_set_dirs_only ()

-
void                g_filename_completer_set_dirs_only  (GFilenameCompleter *completer,
-                                                         gboolean dirs_only);
+
void                g_filename_completer_set_dirs_only  (GFilenameCompleter *completer,
+                                                         gboolean dirs_only);

-If dirs_only is TRUE, completer will only -complete directory names, and not file names.

+If dirs_only is TRUE, completer will only +complete directory names, and not file names. +

completer :

the filename completer. +the filename completer.

initial_text :

text to be completed. +text to be completed.

Returns :

array of strings with possible completions for initial_text. -This array must be freed by g_strfreev() when finished. +This array must be freed by g_strfreev() when finished.
- - @@ -220,9 +196,10 @@ complete directory names, and not file names.

The "got-completion-data" signal

void                user_function                      (GFilenameCompleter *arg0,
-                                                        gpointer            user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the file name completion information comes available.

+Emitted when the file name completion information comes available. +

completer :

the filename completer. +the filename completer.

dirs_only :

a gboolean. +a gboolean.
@@ -235,6 +212,6 @@ Emitted when the file name completion information comes available.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFilterInputStream.html b/docs/reference/gio/html/GFilterInputStream.html index a32815e..31bd52d 100644 --- a/docs/reference/gio/html/GFilterInputStream.html +++ b/docs/reference/gio/html/GFilterInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -76,18 +46,18 @@ GFilterInputStream; GInputStream * g_filter_input_stream_get_base_stream - (GFilterInputStream *stream); -gboolean g_filter_input_stream_get_close_base_stream - (GFilterInputStream *stream); + (GFilterInputStream *stream); +gboolean g_filter_input_stream_get_close_base_stream + (GFilterInputStream *stream); void g_filter_input_stream_set_close_base_stream - (GFilterInputStream *stream, - gboolean close_base); + (GFilterInputStream *stream, + gboolean close_base);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFilterInputStream
                +----GBufferedInputStream
@@ -98,7 +68,7 @@
 

Properties

   "base-stream"              GInputStream*         : Read / Write / Construct Only
-  "close-base-stream"        gboolean              : Read / Write / Construct Only
+  "close-base-stream"        gboolean              : Read / Write / Construct Only
 
@@ -110,21 +80,23 @@

GFilterInputStream

typedef struct _GFilterInputStream GFilterInputStream;

-A base class for all input streams that work on an underlying stream.

+A base class for all input streams that work on an underlying stream. +


g_filter_input_stream_get_base_stream ()

GInputStream *      g_filter_input_stream_get_base_stream
-                                                        (GFilterInputStream *stream);
+ (GFilterInputStream *stream);

-Gets the base stream for the filter stream.

+Gets the base stream for the filter stream. +

- @@ -138,22 +110,23 @@ Gets the base stream for the filter stream.


g_filter_input_stream_get_close_base_stream ()

-
gboolean            g_filter_input_stream_get_close_base_stream
-                                                        (GFilterInputStream *stream);
+
gboolean            g_filter_input_stream_get_close_base_stream
+                                                        (GFilterInputStream *stream);

Returns whether the base stream will be closed when stream is -closed.

+closed. +

stream :

a GFilterInputStream. +a GFilterInputStream.
- - @@ -163,21 +136,23 @@ closed.

g_filter_input_stream_set_close_base_stream ()

void                g_filter_input_stream_set_close_base_stream
-                                                        (GFilterInputStream *stream,
-                                                         gboolean close_base);
+ (GFilterInputStream *stream, + gboolean close_base);

-Sets whether the base stream will be closed when stream is closed.

+Sets whether the base stream will be closed when stream is closed. +

stream :

a GFilterInputStream. +a GFilterInputStream.

Returns :

TRUE if the base stream will be closed. + TRUE if the base stream will be closed.
- - @@ -194,7 +169,7 @@ Sets whether the base stream will be closed when str

The "close-base-stream" property

-
  "close-base-stream"        gboolean              : Read / Write / Construct Only
+
  "close-base-stream"        gboolean              : Read / Write / Construct Only

If the base stream should be closed when the filter stream is closed.

Default value: TRUE

@@ -202,6 +177,6 @@ Sets whether the base stream will be closed when str + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GFilterOutputStream.html b/docs/reference/gio/html/GFilterOutputStream.html index 22f03d8..394d7c7 100644 --- a/docs/reference/gio/html/GFilterOutputStream.html +++ b/docs/reference/gio/html/GFilterOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GFilterInputStream. +a GFilterInputStream.

close_base :

TRUE to close the base stream. + +TRUE to close the base stream.
@@ -76,18 +46,18 @@ GFilterOutputStream; GOutputStream * g_filter_output_stream_get_base_stream - (GFilterOutputStream *stream); -gboolean g_filter_output_stream_get_close_base_stream - (GFilterOutputStream *stream); + (GFilterOutputStream *stream); +gboolean g_filter_output_stream_get_close_base_stream + (GFilterOutputStream *stream); void g_filter_output_stream_set_close_base_stream - (GFilterOutputStream *stream, - gboolean close_base); + (GFilterOutputStream *stream, + gboolean close_base);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFilterOutputStream
                +----GBufferedOutputStream
@@ -99,7 +69,7 @@
 

Properties

   "base-stream"              GOutputStream*        : Read / Write / Construct Only
-  "close-base-stream"        gboolean              : Read / Write / Construct Only
+  "close-base-stream"        gboolean              : Read / Write / Construct Only
 
@@ -111,21 +81,23 @@

GFilterOutputStream

typedef struct _GFilterOutputStream GFilterOutputStream;

-A base class for all output streams that work on an underlying stream.

+A base class for all output streams that work on an underlying stream. +


g_filter_output_stream_get_base_stream ()

GOutputStream *     g_filter_output_stream_get_base_stream
-                                                        (GFilterOutputStream *stream);
+ (GFilterOutputStream *stream);

-Gets the base stream for the filter stream.

+Gets the base stream for the filter stream. +

- @@ -139,22 +111,23 @@ Gets the base stream for the filter stream.


g_filter_output_stream_get_close_base_stream ()

-
gboolean            g_filter_output_stream_get_close_base_stream
-                                                        (GFilterOutputStream *stream);
+
gboolean            g_filter_output_stream_get_close_base_stream
+                                                        (GFilterOutputStream *stream);

Returns whether the base stream will be closed when stream is -closed.

+closed. +

stream :

a GFilterOutputStream. +a GFilterOutputStream.
- - @@ -164,21 +137,23 @@ closed.

g_filter_output_stream_set_close_base_stream ()

void                g_filter_output_stream_set_close_base_stream
-                                                        (GFilterOutputStream *stream,
-                                                         gboolean close_base);
+ (GFilterOutputStream *stream, + gboolean close_base);

-Sets whether the base stream will be closed when stream is closed.

+Sets whether the base stream will be closed when stream is closed. +

stream :

a GFilterOutputStream. +a GFilterOutputStream.

Returns :

TRUE if the base stream will be closed. + TRUE if the base stream will be closed.
- - @@ -195,7 +170,7 @@ Sets whether the base stream will be closed when str

The "close-base-stream" property

-
  "close-base-stream"        gboolean              : Read / Write / Construct Only
+
  "close-base-stream"        gboolean              : Read / Write / Construct Only

If the base stream should be closed when the filter stream is closed.

Default value: TRUE

@@ -203,6 +178,6 @@ Sets whether the base stream will be closed when str + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GIOModule.html b/docs/reference/gio/html/GIOModule.html index 6c77af2..23f65a2 100644 --- a/docs/reference/gio/html/GIOModule.html +++ b/docs/reference/gio/html/GIOModule.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GFilterOutputStream. +a GFilterOutputStream.

close_base :

TRUE to close the base stream. + +TRUE to close the base stream.
@@ -75,19 +45,19 @@ #include <gio/gio.h> GIOModule; -GIOModule * g_io_module_new (const gchar *filename); -GList * g_io_modules_load_all_in_directory (const gchar *dirname); -void g_io_modules_scan_all_in_directory (const char *dirname); -void g_io_module_load (GIOModule *module); -void g_io_module_unload (GIOModule *module); -char ** g_io_module_query (void); +GIOModule * g_io_module_new (const gchar *filename); +GList * g_io_modules_load_all_in_directory (const gchar *dirname); +void g_io_modules_scan_all_in_directory (const char *dirname); +void g_io_module_load (GIOModule *module); +void g_io_module_unload (GIOModule *module); +char ** g_io_module_query (void);

Object Hierarchy

-  GObject
-   +----GTypeModule
+  GObject
+   +----GTypeModule
          +----GIOModule
 
@@ -95,14 +65,15 @@

Implemented Interfaces

GIOModule implements - GTypePlugin.

+ GTypePlugin.

Description

Provides an interface and default functions for loading and unloading modules. This is used internally to make GIO extensible, but can also -be used by others to implement module loading.

+be used by others to implement module loading. +

Details

@@ -110,27 +81,29 @@ be used by others to implement module loading.

GIOModule

typedef struct _GIOModule GIOModule;

-Opaque module base class for extending GIO.

+Opaque module base class for extending GIO. +


g_io_module_new ()

-
GIOModule *         g_io_module_new                     (const gchar *filename);
+
GIOModule *         g_io_module_new                     (const gchar *filename);

Creates a new GIOModule that will load the specific -shared library when in use.

+shared library when in use. +

- @@ -139,20 +112,21 @@ or

g_io_modules_load_all_in_directory ()

-
GList *             g_io_modules_load_all_in_directory  (const gchar *dirname);
+
GList *             g_io_modules_load_all_in_directory  (const gchar *dirname);

Loads all the modules in the specified directory.

If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() -which allows delayed/lazy loading of modules.

+which allows delayed/lazy loading of modules. +

filename :

filename of the shared library module. +filename of the shared library module.

Returns :

a GIOModule from given filename, -or NULL on error. +or NULL on error.
- @@ -160,8 +134,8 @@ which allows delayed/lazy loading of modules.

@@ -170,7 +144,7 @@ which allows delayed/lazy loading of modules.


g_io_modules_scan_all_in_directory ()

-
void                g_io_modules_scan_all_in_directory  (const char *dirname);
+
void                g_io_modules_scan_all_in_directory  (const char *dirname);

Scans all the modules in the specified directory, ensuring that any extension point implemented by a module is registered. @@ -184,12 +158,13 @@ an extension point it implementes is used with e.g.

If you need to guarantee that all types are loaded in all the modules, -use g_io_modules_scan_all_in_directory().

+use g_io_modules_scan_all_in_directory(). +

dirname :

pathname for a directory containing modules to load. +pathname for a directory containing modules to load.
a list of GIOModules loaded from the directory, All the modules are loaded into memory, if you want to unload them (enabling on-demand loading) you must call - g_type_module_unuse() on all the modules. Free the list - with g_list_free(). + g_type_module_unuse() on all the modules. Free the list + with g_list_free().
-

dirname :

pathname for a directory containing modules to scan. +pathname for a directory containing modules to scan.
@@ -198,16 +173,17 @@ use

g_io_module_load ()

-
void                g_io_module_load                    (GIOModule *module);
+
void                g_io_module_load                    (GIOModule *module);

Required API for GIO modules to implement. This function is ran after the module has been loaded into GIO, -to initialize the module.

+to initialize the module. +

-

module :

a GIOModule. +a GIOModule.
@@ -215,16 +191,17 @@ to initialize the module.


g_io_module_unload ()

-
void                g_io_module_unload                  (GIOModule *module);
+
void                g_io_module_unload                  (GIOModule *module);

Required API for GIO modules to implement. This function is ran when the module is being unloaded from GIO, -to finalize the module.

+to finalize the module. +

-

module :

a GIOModule. +a GIOModule.
@@ -232,7 +209,7 @@ to finalize the module.


g_io_module_query ()

-
char **             g_io_module_query                   (void);
+
char **             g_io_module_query                   (void);

Optional API for GIO modules to implement.

@@ -260,14 +237,15 @@ must be returned by When installing a module that implements g_io_module_query you must run gio-querymodules in order to build the cache files required for -lazy loading.

+lazy loading. +

- @@ -278,6 +256,6 @@ lazy loading.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GIOStream.html b/docs/reference/gio/html/GIOStream.html index 551e264..d083a74 100644 --- a/docs/reference/gio/html/GIOStream.html +++ b/docs/reference/gio/html/GIOStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Returns :

A NULL-terminated array of strings, listing the supported + A NULL-terminated array of strings, listing the supported extension points of the module. The array must be suitable for - freeing with g_strfreev(). + freeing with g_strfreev().
@@ -75,30 +45,30 @@ #include <gio/gio.h> GIOStream; -GInputStream * g_io_stream_get_input_stream (GIOStream *stream); -GOutputStream * g_io_stream_get_output_stream (GIOStream *stream); -gbooleang_io_stream_close (GIOStream *stream, - GCancellable *cancellable, - GError **error); -voidg_io_stream_close_async (GIOStream *stream, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_io_stream_close_finish (GIOStream *stream, - GAsyncResult *result, - GError **error); -gbooleang_io_stream_is_closed (GIOStream *stream); -gbooleang_io_stream_has_pending (GIOStream *stream); -gbooleang_io_stream_set_pending (GIOStream *stream, - GError **error); -voidg_io_stream_clear_pending (GIOStream *stream); +GInputStream * g_io_stream_get_input_stream (GIOStream *stream); +GOutputStream * g_io_stream_get_output_stream (GIOStream *stream); +gbooleang_io_stream_close (GIOStream *stream, + GCancellable *cancellable, + GError **error); +voidg_io_stream_close_async (GIOStream *stream, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_io_stream_close_finish (GIOStream *stream, + GAsyncResult *result, + GError **error); +gbooleang_io_stream_is_closed (GIOStream *stream); +gbooleang_io_stream_has_pending (GIOStream *stream); +gbooleang_io_stream_set_pending (GIOStream *stream, + GError **error); +voidg_io_stream_clear_pending (GIOStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GIOStream
          +----GFileIOStream
          +----GSocketConnection
@@ -107,7 +77,7 @@
 

Properties

-  "closed"                   gboolean              : Read / Write
+  "closed"                   gboolean              : Read / Write
   "input-stream"             GInputStream*         : Read
   "output-stream"            GOutputStream*        : Read
 
@@ -142,7 +112,8 @@ stream object and also the individual substreams. You can also close the substreams themselves. In most cases this only marks the substream as closed, so further I/O on it fails. However, some streams may support "half-closed" states where one direction of the stream -is actually shut down.

+is actually shut down. +

Details

@@ -150,21 +121,23 @@ is actually shut down.

GIOStream

typedef struct _GIOStream GIOStream;

-Base class for read-write streams.

+Base class for read-write streams. +


g_io_stream_get_input_stream ()

-
GInputStream *      g_io_stream_get_input_stream        (GIOStream *stream);
+
GInputStream *      g_io_stream_get_input_stream        (GIOStream *stream);

Gets the input stream for this object. This is used -for reading.

+for reading. +

- @@ -180,16 +153,17 @@ for reading.


g_io_stream_get_output_stream ()

-
GOutputStream *     g_io_stream_get_output_stream       (GIOStream *stream);
+
GOutputStream *     g_io_stream_get_output_stream       (GIOStream *stream);

Gets the output stream for this object. This is used for -writing.

+writing. +

stream :

a GIOStream +a GIOStream
- @@ -205,9 +179,9 @@ writing.


g_io_stream_close ()

-
gboolean            g_io_stream_close                   (GIOStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_io_stream_close                   (GIOStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Closes the stream, releasing resources related to it. This will also closes the individual input and output streams, if they are not already @@ -248,28 +222,29 @@ can use a faster close that doesn't block to e.g. check errors.

The default implementation of this method just calls close on the -individual input/output streams.

+individual input/output streams. +

stream :

a GIOStream +a GIOStream
- - - - @@ -280,11 +255,11 @@ individual input/output streams.


g_io_stream_close_async ()

-
void                g_io_stream_close_async             (GIOStream *stream,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_io_stream_close_async             (GIOStream *stream,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Requests an asynchronous close of the stream, releasing resources related to it. When the operation is finished callback will be @@ -297,33 +272,34 @@ For behaviour details see

stream :

a GIOStream +a GIOStream

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE on failure + TRUE on success, FALSE on failure
- - - - - @@ -333,33 +309,34 @@ classes. However, if you override one you must override all.


g_io_stream_close_finish ()

-
gboolean            g_io_stream_close_finish            (GIOStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_io_stream_close_finish            (GIOStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Closes a stream.

+Closes a stream. +

stream :

a GIOStream +a GIOStream

io_priority :

the io priority of the request +the io priority of the request

cancellable :

optional cancellable object +optional cancellable object

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -370,20 +347,21 @@ Closes a stream.


g_io_stream_is_closed ()

-
gboolean            g_io_stream_is_closed               (GIOStream *stream);
+
gboolean            g_io_stream_is_closed               (GIOStream *stream);

-Checks if a stream is closed.

+Checks if a stream is closed. +

stream :

a GIOStream +a GIOStream

result :

a GAsyncResult +a GAsyncResult

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore

Returns :

TRUE if stream was successfully closed, FALSE otherwise. + TRUE if stream was successfully closed, FALSE otherwise.
- - @@ -394,20 +372,21 @@ Checks if a stream is closed.


g_io_stream_has_pending ()

-
gboolean            g_io_stream_has_pending             (GIOStream *stream);
+
gboolean            g_io_stream_has_pending             (GIOStream *stream);

-Checks if a stream has pending actions.

+Checks if a stream has pending actions. +

stream :

a GIOStream +a GIOStream

Returns :

TRUE if the stream is closed. + TRUE if the stream is closed.
- - @@ -418,29 +397,30 @@ Checks if a stream has pending actions.


g_io_stream_set_pending ()

-
gboolean            g_io_stream_set_pending             (GIOStream *stream,
-                                                         GError **error);
+
gboolean            g_io_stream_set_pending             (GIOStream *stream,
+                                                         GError **error);

Sets stream to have actions pending. If the pending flag is -already set or stream is closed, it will return FALSE and set -error.

+already set or stream is closed, it will return FALSE and set +error. +

stream :

a GIOStream +a GIOStream

Returns :

TRUE if stream has pending actions. + TRUE if stream has pending actions.
- - - @@ -451,14 +431,15 @@ already set or stream is closed, it will

g_io_stream_clear_pending ()

-
void                g_io_stream_clear_pending           (GIOStream *stream);
+
void                g_io_stream_clear_pending           (GIOStream *stream);

-Clears the pending flag on stream.

+Clears the pending flag on stream. +

stream :

a GIOStream +a GIOStream

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore

Returns :

TRUE if pending was previously unset and is now set. + TRUE if pending was previously unset and is now set.
-

stream :

a GIOStream +a GIOStream
@@ -469,7 +450,7 @@ Clears the pending flag on stream.

Property Details

The "closed" property

-
  "closed"                   gboolean              : Read / Write
+
  "closed"                   gboolean              : Read / Write

Is the stream closed.

Default value: FALSE

@@ -493,6 +474,6 @@ Clears the pending flag on stream.

+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/GIcon.html b/docs/reference/gio/html/GIcon.html index 297d5b0..fc4b16d 100644 --- a/docs/reference/gio/html/GIcon.html +++ b/docs/reference/gio/html/GIcon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -80,12 +50,12 @@ GIcon; GIconIface; -guintg_icon_hash (gconstpointer icon); -gbooleang_icon_equal (GIcon *icon1, - GIcon *icon2); -gchar * g_icon_to_string (GIcon *icon); -GIcon * g_icon_new_for_string (const gchar *str, - GError **error); +guintg_icon_hash (gconstpointer icon); +gbooleang_icon_equal (GIcon *icon1, + GIcon *icon2); +gchar * g_icon_to_string (GIcon *icon); +GIcon * g_icon_new_for_string (const gchar *str, + GError **error);
@@ -99,7 +69,7 @@

Prerequisites

GIcon requires - GObject.

+ GObject.

Known Derived Interfaces

@@ -111,7 +81,7 @@ GIcon is required by

Known Implementations

GIcon is implemented by - GThemedIcon, GFileIcon, GEmblem and GEmblemedIcon.

+ GEmblem, GEmblemedIcon, GFileIcon and GThemedIcon.

Description

@@ -137,8 +107,9 @@ For serializing a GIcon -implementations you need to ensure that each GType is registered -with the type system prior to calling g_icon_new_for_string().

+implementations you need to ensure that each GType is registered +with the type system prior to calling g_icon_new_for_string(). +

Details

@@ -146,7 +117,8 @@ with the type system prior to calling

GIcon

typedef struct _GIcon GIcon;

-An abstract type that specifies an icon.

+An abstract type that specifies an icon. +


@@ -171,35 +143,36 @@ An abstract type that specifies an icon.

GIconIface is used to implement GIcon types for various different systems. See GThemedIcon and GLoadableIcon for -examples of how to implement this interface.

+examples of how to implement this interface. +

- - + - - - - @@ -210,21 +183,23 @@ serialized (Since 2.20).

g_icon_hash ()

-
guint               g_icon_hash                         (gconstpointer icon);
+
guint               g_icon_hash                         (gconstpointer icon);

-Gets a hash for an icon.

+Gets a hash for an icon. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

hash ()

A hash for a given GIcon. +A hash for a given GIcon.

equal ()

Checks if two GIcons are equal. +Checks if two GIcons are equal.

to_tokens ()

Serializes a GIcon into tokens. The tokens must not +Serializes a GIcon into tokens. The tokens must not contain any whitespace. Don't implement if the GIcon can't be serialized (Since 2.20).

from_tokens ()

Constructs a GIcon from tokens. Set the GError if +Constructs a GIcon from tokens. Set the GError if the tokens are malformed. Don't implement if the GIcon can't be serialized (Since 2.20).
- - @@ -233,26 +208,27 @@ use in a

g_icon_equal ()

-
gboolean            g_icon_equal                        (GIcon *icon1,
-                                                         GIcon *icon2);
+
gboolean            g_icon_equal                        (GIcon *icon1,
+                                                         GIcon *icon2);

-Checks if two icons are equal.

+Checks if two icons are equal. +

icon :

gconstpointer to an icon object. + +gconstpointer to an icon object.

Returns :

a guint containing a hash for the icon, suitable for -use in a GHashTable or similar data structure. + a guint containing a hash for the icon, suitable for +use in a GHashTable or similar data structure.
- - - @@ -261,7 +237,7 @@ Checks if two icons are equal.


g_icon_to_string ()

-
gchar *             g_icon_to_string                    (GIcon *icon);
+
gchar *             g_icon_to_string                    (GIcon *icon);

Generates a textual representation of icon that can be used for serialization such as when passing icon to a different process or @@ -287,18 +263,20 @@ in the following two cases simply the name (such as network-server).

+

+

icon1 :

pointer to the first GIcon. +pointer to the first GIcon.

icon2 :

pointer to the second GIcon. +pointer to the second GIcon.

Returns :

TRUE if icon1 is equal to icon2. FALSE otherwise. + TRUE if icon1 is equal to icon2. FALSE otherwise.
- - @@ -309,32 +287,33 @@ be serialized. Use

g_icon_new_for_string ()

-
GIcon *             g_icon_new_for_string               (const gchar *str,
-                                                         GError **error);
+
GIcon *             g_icon_new_for_string               (const gchar *str,
+                                                         GError **error);

Generate a GIcon instance from str. This function can fail if str is not valid - see g_icon_to_string() for discussion.

If your application or library provides one or more GIcon -implementations you need to ensure that each GType is registered -with the type system prior to calling g_icon_new_for_string().

+implementations you need to ensure that each GType is registered +with the type system prior to calling g_icon_new_for_string(). +

icon :

a GIcon. +a GIcon.

Returns :

An allocated NUL-terminated UTF8 string or NULL if icon can't -be serialized. Use g_free() to free. + An allocated NUL-terminated UTF8 string or NULL if icon can't +be serialized. Use g_free() to free.
- - - @@ -347,6 +326,6 @@ with the type system prior to calling
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GInetAddress.html b/docs/reference/gio/html/GInetAddress.html index c3c9b8e..5d7b0c1 100644 --- a/docs/reference/gio/html/GInetAddress.html +++ b/docs/reference/gio/html/GInetAddress.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

str :

A string obtained via g_icon_to_string(). +A string obtained via g_icon_to_string().

error :

Return location for error. +Return location for error.

Returns :

An object implementing the GIcon interface or NULL if + An object implementing the GIcon interface or NULL if error is set.
@@ -72,49 +42,49 @@

Synopsis

                    GInetAddress;
-GInetAddress *      g_inet_address_new_from_string      (const gchar *string);
-GInetAddress *      g_inet_address_new_from_bytes       (const guint8 *bytes,
-                                                         GSocketFamily family);
-GInetAddress *      g_inet_address_new_any              (GSocketFamily family);
-GInetAddress *      g_inet_address_new_loopback         (GSocketFamily family);
-const guint8 *      g_inet_address_to_bytes             (GInetAddress *address);
-gsize               g_inet_address_get_native_size      (GInetAddress *address);
-gchar *             g_inet_address_to_string            (GInetAddress *address);
-GSocketFamily       g_inet_address_get_family           (GInetAddress *address);
-gboolean            g_inet_address_get_is_any           (GInetAddress *address);
-gboolean            g_inet_address_get_is_loopback      (GInetAddress *address);
-gboolean            g_inet_address_get_is_link_local    (GInetAddress *address);
-gboolean            g_inet_address_get_is_site_local    (GInetAddress *address);
-gboolean            g_inet_address_get_is_multicast     (GInetAddress *address);
-gboolean            g_inet_address_get_is_mc_link_local (GInetAddress *address);
-gboolean            g_inet_address_get_is_mc_node_local (GInetAddress *address);
-gboolean            g_inet_address_get_is_mc_site_local (GInetAddress *address);
-gboolean            g_inet_address_get_is_mc_org_local  (GInetAddress *address);
-gboolean            g_inet_address_get_is_mc_global     (GInetAddress *address);
+GInetAddress *      g_inet_address_new_from_string      (const gchar *string);
+GInetAddress *      g_inet_address_new_from_bytes       (const guint8 *bytes,
+                                                         GSocketFamily family);
+GInetAddress *      g_inet_address_new_any              (GSocketFamily family);
+GInetAddress *      g_inet_address_new_loopback         (GSocketFamily family);
+const guint8 *      g_inet_address_to_bytes             (GInetAddress *address);
+gsize               g_inet_address_get_native_size      (GInetAddress *address);
+gchar *             g_inet_address_to_string            (GInetAddress *address);
+GSocketFamily       g_inet_address_get_family           (GInetAddress *address);
+gboolean            g_inet_address_get_is_any           (GInetAddress *address);
+gboolean            g_inet_address_get_is_loopback      (GInetAddress *address);
+gboolean            g_inet_address_get_is_link_local    (GInetAddress *address);
+gboolean            g_inet_address_get_is_site_local    (GInetAddress *address);
+gboolean            g_inet_address_get_is_multicast     (GInetAddress *address);
+gboolean            g_inet_address_get_is_mc_link_local (GInetAddress *address);
+gboolean            g_inet_address_get_is_mc_node_local (GInetAddress *address);
+gboolean            g_inet_address_get_is_mc_site_local (GInetAddress *address);
+gboolean            g_inet_address_get_is_mc_org_local  (GInetAddress *address);
+gboolean            g_inet_address_get_is_mc_global     (GInetAddress *address);
 

Object Hierarchy

-  GObject
+  GObject
    +----GInetAddress
 

Properties

-  "bytes"                    gpointer              : Read / Write / Construct Only
+  "bytes"                    gpointer              : Read / Write / Construct Only
   "family"                   GSocketFamily         : Read / Write / Construct Only
-  "is-any"                   gboolean              : Read
-  "is-link-local"            gboolean              : Read
-  "is-loopback"              gboolean              : Read
-  "is-mc-global"             gboolean              : Read
-  "is-mc-link-local"         gboolean              : Read
-  "is-mc-node-local"         gboolean              : Read
-  "is-mc-org-local"          gboolean              : Read
-  "is-mc-site-local"         gboolean              : Read
-  "is-multicast"             gboolean              : Read
-  "is-site-local"            gboolean              : Read
+  "is-any"                   gboolean              : Read
+  "is-link-local"            gboolean              : Read
+  "is-loopback"              gboolean              : Read
+  "is-mc-global"             gboolean              : Read
+  "is-mc-link-local"         gboolean              : Read
+  "is-mc-node-local"         gboolean              : Read
+  "is-mc-org-local"          gboolean              : Read
+  "is-mc-site-local"         gboolean              : Read
+  "is-multicast"             gboolean              : Read
+  "is-site-local"            gboolean              : Read
 
@@ -130,7 +100,8 @@ look up the To actually connect to a remote host, you will need a GInetSocketAddress (which includes a GInetAddress as well as a -port number).

+port number). +

Details

@@ -138,25 +109,27 @@ port number).

GInetAddress

typedef struct _GInetAddress GInetAddress;

-An IPv4 or IPv6 internet address.

+An IPv4 or IPv6 internet address. +


g_inet_address_new_from_string ()

-
GInetAddress *      g_inet_address_new_from_string      (const gchar *string);
+
GInetAddress *      g_inet_address_new_from_string      (const gchar *string);

-Parses string as an IP address and creates a new GInetAddress.

+Parses string as an IP address and creates a new GInetAddress. +

- - @@ -168,23 +141,24 @@ Parses string as an IP address and creat

g_inet_address_new_from_bytes ()

-
GInetAddress *      g_inet_address_new_from_bytes       (const guint8 *bytes,
-                                                         GSocketFamily family);
+
GInetAddress *      g_inet_address_new_from_bytes       (const guint8 *bytes,
+                                                         GSocketFamily family);

Creates a new GInetAddress from the given family and bytes. bytes should be 4 bytes for G_INET_ADDRESS_IPV4 and 16 bytes for -G_INET_ADDRESS_IPV6.

+G_INET_ADDRESS_IPV6. +

string :

a string representation of an IP address +a string representation of an IP address

Returns :

a new GInetAddress corresponding to string, or NULL if + a new GInetAddress corresponding to string, or NULL if string could not be parsed.
- - @@ -200,16 +174,17 @@ Creates a new

g_inet_address_new_any ()

-
GInetAddress *      g_inet_address_new_any              (GSocketFamily family);
+
GInetAddress *      g_inet_address_new_any              (GSocketFamily family);

Creates a GInetAddress for the "any" address (unassigned/"don't -care") for family.

+care") for family. +

bytes :

raw address data +raw address data

family :

the address family of bytes +the address family of bytes
- @@ -226,15 +201,16 @@ for family.

g_inet_address_new_loopback ()

-
GInetAddress *      g_inet_address_new_loopback         (GSocketFamily family);
+
GInetAddress *      g_inet_address_new_loopback         (GSocketFamily family);

-Creates a GInetAddress for the loopback address for family.

+Creates a GInetAddress for the loopback address for family. +

family :

the address family +the address family
- @@ -251,15 +227,16 @@ for family.

g_inet_address_to_bytes ()

-
const guint8 *      g_inet_address_to_bytes             (GInetAddress *address);
+
const guint8 *      g_inet_address_to_bytes             (GInetAddress *address);

-Gets the raw binary address data from address.

+Gets the raw binary address data from address. +

family :

the address family +the address family
- @@ -277,16 +254,17 @@ array can be gotten with

g_inet_address_get_native_size ()

-
gsize               g_inet_address_get_native_size      (GInetAddress *address);
+
gsize               g_inet_address_get_native_size      (GInetAddress *address);

Gets the size of the native raw binary address for address. This -is the size of the data that you get from g_inet_address_to_bytes().

+is the size of the data that you get from g_inet_address_to_bytes(). +

address :

a GInetAddress +a GInetAddress
- @@ -302,15 +280,16 @@ is the size of the data that you get from

g_inet_address_to_string ()

-
gchar *             g_inet_address_to_string            (GInetAddress *address);
+
gchar *             g_inet_address_to_string            (GInetAddress *address);

-Converts address to string form.

+Converts address to string form. +

address :

a GInetAddress +a GInetAddress
- @@ -327,15 +306,16 @@ freed after use.

g_inet_address_get_family ()

-
GSocketFamily       g_inet_address_get_family           (GInetAddress *address);
+
GSocketFamily       g_inet_address_get_family           (GInetAddress *address);

-Gets address's family

+Gets address's family +

address :

a GInetAddress +a GInetAddress
- @@ -351,20 +331,21 @@ Gets address's family


g_inet_address_get_is_any ()

-
gboolean            g_inet_address_get_is_any           (GInetAddress *address);
+
gboolean            g_inet_address_get_is_any           (GInetAddress *address);

-Tests whether address is the "any" address for its family.

+Tests whether address is the "any" address for its family. +

address :

a GInetAddress +a GInetAddress
- - @@ -375,20 +356,21 @@ Tests whether address is the "any" addre

g_inet_address_get_is_loopback ()

-
gboolean            g_inet_address_get_is_loopback      (GInetAddress *address);
+
gboolean            g_inet_address_get_is_loopback      (GInetAddress *address);

-Tests whether address is the loopback address for its family.

+Tests whether address is the loopback address for its family. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is the "any" address for its family. + TRUE if address is the "any" address for its family.
- - @@ -399,22 +381,23 @@ Tests whether address is the loopback ad

g_inet_address_get_is_link_local ()

-
gboolean            g_inet_address_get_is_link_local    (GInetAddress *address);
+
gboolean            g_inet_address_get_is_link_local    (GInetAddress *address);

Tests whether address is a link-local address (that is, if it identifies a host on a local network that is not connected to the -Internet).

+Internet). +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is the loopback address for its family. + TRUE if address is the loopback address for its family.
- - @@ -425,23 +408,24 @@ Internet).


g_inet_address_get_is_site_local ()

-
gboolean            g_inet_address_get_is_site_local    (GInetAddress *address);
+
gboolean            g_inet_address_get_is_site_local    (GInetAddress *address);

Tests whether address is a site-local address such as 10.0.0.1 (that is, the address identifies a host on a local network that can not be reached directly from the Internet, but which may have -outgoing Internet connectivity via a NAT or firewall).

+outgoing Internet connectivity via a NAT or firewall). +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a link-local address. + TRUE if address is a link-local address.
- - @@ -452,20 +436,21 @@ outgoing Internet connectivity via a NAT or firewall).


g_inet_address_get_is_multicast ()

-
gboolean            g_inet_address_get_is_multicast     (GInetAddress *address);
+
gboolean            g_inet_address_get_is_multicast     (GInetAddress *address);

-Tests whether address is a multicast address.

+Tests whether address is a multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a site-local address. + TRUE if address is a site-local address.
- - @@ -476,20 +461,21 @@ Tests whether address is a multicast add

g_inet_address_get_is_mc_link_local ()

-
gboolean            g_inet_address_get_is_mc_link_local (GInetAddress *address);
+
gboolean            g_inet_address_get_is_mc_link_local (GInetAddress *address);

-Tests whether address is a link-local multicast address.

+Tests whether address is a link-local multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a multicast address. + TRUE if address is a multicast address.
- - @@ -500,20 +486,21 @@ Tests whether address is a link-local mu

g_inet_address_get_is_mc_node_local ()

-
gboolean            g_inet_address_get_is_mc_node_local (GInetAddress *address);
+
gboolean            g_inet_address_get_is_mc_node_local (GInetAddress *address);

-Tests whether address is a node-local multicast address.

+Tests whether address is a node-local multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a link-local multicast address. + TRUE if address is a link-local multicast address.
- - @@ -524,20 +511,21 @@ Tests whether address is a node-local mu

g_inet_address_get_is_mc_site_local ()

-
gboolean            g_inet_address_get_is_mc_site_local (GInetAddress *address);
+
gboolean            g_inet_address_get_is_mc_site_local (GInetAddress *address);

-Tests whether address is a site-local multicast address.

+Tests whether address is a site-local multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a node-local multicast address. + TRUE if address is a node-local multicast address.
- - @@ -548,20 +536,21 @@ Tests whether address is a site-local mu

g_inet_address_get_is_mc_org_local ()

-
gboolean            g_inet_address_get_is_mc_org_local  (GInetAddress *address);
+
gboolean            g_inet_address_get_is_mc_org_local  (GInetAddress *address);

-Tests whether address is an organization-local multicast address.

+Tests whether address is an organization-local multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a site-local multicast address. + TRUE if address is a site-local multicast address.
- - @@ -572,20 +561,21 @@ Tests whether address is an organization

g_inet_address_get_is_mc_global ()

-
gboolean            g_inet_address_get_is_mc_global     (GInetAddress *address);
+
gboolean            g_inet_address_get_is_mc_global     (GInetAddress *address);

-Tests whether address is a global multicast address.

+Tests whether address is a global multicast address. +

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is an organization-local multicast address. + TRUE if address is an organization-local multicast address.
- - @@ -598,7 +588,7 @@ Tests whether address is a global multic

Property Details

The "bytes" property

-
  "bytes"                    gpointer              : Read / Write / Construct Only
+
  "bytes"                    gpointer              : Read / Write / Construct Only

The raw address data.


@@ -611,100 +601,110 @@ Tests whether address is a global multic

The "is-any" property

-
  "is-any"                   gboolean              : Read
+
  "is-any"                   gboolean              : Read

Whether this is the "any" address for its family. -See g_inet_address_get_is_any().

+See g_inet_address_get_is_any(). +

Default value: FALSE

Since 2.22


The "is-link-local" property

-
  "is-link-local"            gboolean              : Read
+
  "is-link-local"            gboolean              : Read

Whether this is a link-local address. -See g_inet_address_get_is_link_local().

+See g_inet_address_get_is_link_local(). +

Default value: FALSE

Since 2.22


The "is-loopback" property

-
  "is-loopback"              gboolean              : Read
+
  "is-loopback"              gboolean              : Read

Whether this is the loopback address for its family. -See g_inet_address_get_is_loopback().

+See g_inet_address_get_is_loopback(). +

Default value: FALSE

Since 2.22


The "is-mc-global" property

-
  "is-mc-global"             gboolean              : Read
+
  "is-mc-global"             gboolean              : Read

Whether this is a global multicast address. -See g_inet_address_get_is_mc_global().

+See g_inet_address_get_is_mc_global(). +

Default value: FALSE

Since 2.22


The "is-mc-link-local" property

-
  "is-mc-link-local"         gboolean              : Read
+
  "is-mc-link-local"         gboolean              : Read

Whether this is a link-local multicast address. -See g_inet_address_get_is_mc_link_local().

+See g_inet_address_get_is_mc_link_local(). +

Default value: FALSE

Since 2.22


The "is-mc-node-local" property

-
  "is-mc-node-local"         gboolean              : Read
+
  "is-mc-node-local"         gboolean              : Read

Whether this is a node-local multicast address. -See g_inet_address_get_is_mc_node_local().

+See g_inet_address_get_is_mc_node_local(). +

Default value: FALSE

Since 2.22


The "is-mc-org-local" property

-
  "is-mc-org-local"          gboolean              : Read
+
  "is-mc-org-local"          gboolean              : Read

Whether this is an organization-local multicast address. -See g_inet_address_get_is_mc_org_local().

+See g_inet_address_get_is_mc_org_local(). +

Default value: FALSE

Since 2.22


The "is-mc-site-local" property

-
  "is-mc-site-local"         gboolean              : Read
+
  "is-mc-site-local"         gboolean              : Read

Whether this is a site-local multicast address. -See g_inet_address_get_is_mc_site_local().

+See g_inet_address_get_is_mc_site_local(). +

Default value: FALSE

Since 2.22


The "is-multicast" property

-
  "is-multicast"             gboolean              : Read
+
  "is-multicast"             gboolean              : Read

Whether this is a multicast address. -See g_inet_address_get_is_multicast().

+See g_inet_address_get_is_multicast(). +

Default value: FALSE

Since 2.22


The "is-site-local" property

-
  "is-site-local"            gboolean              : Read
+
  "is-site-local"            gboolean              : Read

Whether this is a site-local address. -See g_inet_address_get_is_loopback().

+See g_inet_address_get_is_loopback(). +

Default value: FALSE

Since 2.22

@@ -712,6 +712,6 @@ See + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GInetSocketAddress.html b/docs/reference/gio/html/GInetSocketAddress.html index 13ba7d6..db2d09d 100644 --- a/docs/reference/gio/html/GInetSocketAddress.html +++ b/docs/reference/gio/html/GInetSocketAddress.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

address :

a GInetAddress +a GInetAddress

Returns :

TRUE if address is a global multicast address. + TRUE if address is a global multicast address.
@@ -74,16 +44,16 @@

Object Hierarchy

-  GObject
+  GObject
    +----GSocketAddress
          +----GInetSocketAddress
 
@@ -98,14 +68,15 @@ GInetSocketAddress implements

Properties

   "address"                  GInetAddress*         : Read / Write / Construct Only
-  "port"                     guint                 : Read / Write / Construct Only
+  "port"                     guint                 : Read / Write / Construct Only
 

Description

An IPv4 or IPv6 socket address; that is, the combination of a -GInetAddress and a port number.

+GInetAddress and a port number. +

Details

@@ -114,26 +85,28 @@ An IPv4 or IPv6 socket address; that is, the combination of a
typedef struct _GInetSocketAddress GInetSocketAddress;

An IPv4 or IPv6 socket address, corresponding to a struct -sockaddr_in or struct sockaddr_in6.

+sockaddr_in or struct sockaddr_in6. +


g_inet_socket_address_new ()

-
GSocketAddress *    g_inet_socket_address_new           (GInetAddress *address,
-                                                         guint16 port);
+
GSocketAddress *    g_inet_socket_address_new           (GInetAddress *address,
+                                                         guint16 port);

-Creates a new GInetSocketAddress for address and port.

+Creates a new GInetSocketAddress for address and port. +

- - @@ -149,21 +122,22 @@ Creates a new

g_inet_socket_address_get_address ()

-
GInetAddress *      g_inet_socket_address_get_address   (GInetSocketAddress *address);
+
GInetAddress *      g_inet_socket_address_get_address   (GInetSocketAddress *address);

-Gets address's GInetAddress.

+Gets address's GInetAddress. +

address :

a GInetAddress +a GInetAddress

port :

a port number +a port number
- @@ -174,15 +148,16 @@ Gets address's

g_inet_socket_address_get_port ()

-
guint16             g_inet_socket_address_get_port      (GInetSocketAddress *address);
+
guint16             g_inet_socket_address_get_port      (GInetSocketAddress *address);

-Gets address's port.

+Gets address's port. +

address :

a GInetSocketAddress +a GInetSocketAddress

Returns :

the GInetAddress for address, which must be -g_object_ref()'d if it will be stored +g_object_ref()'d if it will be stored
- @@ -206,7 +181,7 @@ Gets address's port.


The "port" property

-
  "port"                     guint                 : Read / Write / Construct Only
+
  "port"                     guint                 : Read / Write / Construct Only

The port.

Allowed values: <= 65535

Default value: 0

@@ -215,6 +190,6 @@ Gets address's port.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GInitable.html b/docs/reference/gio/html/GInitable.html index 6de9336..13ae1dd 100644 --- a/docs/reference/gio/html/GInitable.html +++ b/docs/reference/gio/html/GInitable.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

address :

a GInetSocketAddress +a GInetSocketAddress
@@ -78,24 +48,24 @@ GInitable; GInitableIface; -gbooleang_initable_init (GInitable *initable, - GCancellable *cancellable, - GError **error); -gpointerg_initable_new (GType object_type, - GCancellable *cancellable, - GError **error, - const gchar *first_property_name, - ...); -GObject* g_initable_new_valist (GType object_type, - const gchar *first_property_name, - va_list var_args, - GCancellable *cancellable, - GError **error); -gpointerg_initable_newv (GType object_type, - guint n_parameters, - GParameter *parameters, - GCancellable *cancellable, - GError **error); +gbooleang_initable_init (GInitable *initable, + GCancellable *cancellable, + GError **error); +gpointerg_initable_new (GType object_type, + GCancellable *cancellable, + GError **error, + const gchar *first_property_name, + ...); +GObject* g_initable_new_valist (GType object_type, + const gchar *first_property_name, + va_list var_args, + GCancellable *cancellable, + GError **error); +gpointerg_initable_newv (GType object_type, + guint n_parameters, + GParameter *parameters, + GCancellable *cancellable, + GError **error);
@@ -109,7 +79,7 @@

Prerequisites

GInitable requires - GObject.

+ GObject.

Known Implementations

@@ -132,14 +102,15 @@ Users of objects implementing this are not intended to use the interface method directly, instead it will be used automatically in various ways. For C applications you generally just call g_initable_new() directly, or indirectly via a foo_thing_new() wrapper. -This will call g_initable_init() under the cover, returning NULL and -setting a GError on failure. +This will call g_initable_init() under the cover, returning NULL and +setting a GError on failure.

For bindings in languages where the native constructor supports exceptions the binding could check for objects implemention GInitable during normal construction and automatically initialize them, throwing -an exception on failure.

+an exception on failure. +

Details

@@ -147,7 +118,8 @@ an exception on failure.

GInitable

typedef struct _GInitable GInitable;

-Interface for initializable objects.

+Interface for initializable objects. +

Since 2.22


@@ -165,18 +137,19 @@ Interface for initializable objects.

Provides an interface for initializing object such that initialization -may fail.

+may fail. +

- - + - @@ -186,18 +159,18 @@ may fail.


g_initable_init ()

-
gboolean            g_initable_init                     (GInitable *initable,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_initable_init                     (GInitable *initable,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Initializes the object implementing the interface. This must be done before any real use of the object after initial construction.

-Implementations may also support cancellation. If cancellable is not NULL, +Implementations may also support cancellation. If cancellable is not NULL, then initialization can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error -G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL and +G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL and the object doesn't support cancellable initialization the error G_IO_ERROR_NOT_SUPPORTED will be returned.

@@ -211,30 +184,31 @@ Implementations of this method must be idempotent, i.e. multiple calls to this function with the same argument should return the same results. Only the first call initializes the object, further calls return the result of the first call. This is so that its safe to implement the singleton -pattern in the GObject constructor function.

+pattern in the GObject constructor function. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

init ()

Initializes the object. +Initializes the object.
- - - - @@ -245,49 +219,50 @@ ignore.

g_initable_new ()

-
gpointer            g_initable_new                      (GType object_type,
-                                                         GCancellable *cancellable,
-                                                         GError **error,
-                                                         const gchar *first_property_name,
-                                                         ...);
+
gpointer            g_initable_new                      (GType object_type,
+                                                         GCancellable *cancellable,
+                                                         GError **error,
+                                                         const gchar *first_property_name,
+                                                         ...);

Helper function for constructing GInitiable object. This is -similar to g_object_new() but also initializes the object -and returns NULL, setting an error on failure.

+similar to g_object_new() but also initializes the object +and returns NULL, setting an error on failure. +

initable :

a GInitable. +a GInitable.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if successful. If an error has occurred, this function will - return FALSE and set error appropriately if present. + TRUE if successful. If an error has occurred, this function will + return FALSE and set error appropriately if present.
- - - - - - @@ -298,48 +273,49 @@ and returns

g_initable_new_valist ()

-
GObject*            g_initable_new_valist               (GType object_type,
-                                                         const gchar *first_property_name,
-                                                         va_list var_args,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GObject*            g_initable_new_valist               (GType object_type,
+                                                         const gchar *first_property_name,
+                                                         va_list var_args,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Helper function for constructing GInitiable object. This is -similar to g_object_new_valist() but also initializes the object -and returns NULL, setting an error on failure.

+similar to g_object_new_valist() but also initializes the object +and returns NULL, setting an error on failure. +

object_type :

a GType supporting GInitable. +a GType supporting GInitable.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

first_property_name :

the name of the first property, or NULL if no +the name of the first property, or NULL if no properties

... :

the value if the first property, followed by and other property - value pairs, and ended by NULL. +the value if the first property, followed by and other property + value pairs, and ended by NULL.

Returns :

a newly allocated GObject, or NULL on error + a newly allocated GObject, or NULL on error
- - - - - - @@ -350,47 +326,48 @@ the value, and other property value pairs, and ended by

g_initable_newv ()

-
gpointer            g_initable_newv                     (GType object_type,
-                                                         guint n_parameters,
-                                                         GParameter *parameters,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gpointer            g_initable_newv                     (GType object_type,
+                                                         guint n_parameters,
+                                                         GParameter *parameters,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Helper function for constructing GInitiable object. This is -similar to g_object_newv() but also initializes the object -and returns NULL, setting an error on failure.

+similar to g_object_newv() but also initializes the object +and returns NULL, setting an error on failure. +

object_type :

a GType supporting GInitable. +a GType supporting GInitable.

first_property_name :

the name of the first property, followed by -the value, and other property value pairs, and ended by NULL. +the name of the first property, followed by +the value, and other property value pairs, and ended by NULL.

var_args :

The var args list generated from first_property_name. +The var args list generated from first_property_name.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a newly allocated GObject, or NULL on error + a newly allocated GObject, or NULL on error
- - - - - - @@ -406,6 +383,6 @@ and returns
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GInputStream.html b/docs/reference/gio/html/GInputStream.html index d19d2b7..c7f775f 100644 --- a/docs/reference/gio/html/GInputStream.html +++ b/docs/reference/gio/html/GInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

object_type :

a GType supporting GInitable. +a GType supporting GInitable.

n_parameters :

the number of parameters in parameters +the number of parameters in parameters

parameters :

the parameters to use to construct the object +the parameters to use to construct the object

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a newly allocated GObject, or NULL on error + a newly allocated GObject, or NULL on error
@@ -73,62 +43,62 @@ #include <gio/gio.h> GInputStream; -gssizeg_input_stream_read (GInputStream *stream, - void *buffer, - gsize count, - GCancellable *cancellable, - GError **error); -gbooleang_input_stream_read_all (GInputStream *stream, - void *buffer, - gsize count, - gsize *bytes_read, - GCancellable *cancellable, - GError **error); -gssizeg_input_stream_skip (GInputStream *stream, - gsize count, - GCancellable *cancellable, - GError **error); -gbooleang_input_stream_close (GInputStream *stream, - GCancellable *cancellable, - GError **error); -voidg_input_stream_read_async (GInputStream *stream, - void *buffer, - gsize count, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gssizeg_input_stream_read_finish (GInputStream *stream, - GAsyncResult *result, - GError **error); -voidg_input_stream_skip_async (GInputStream *stream, - gsize count, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gssizeg_input_stream_skip_finish (GInputStream *stream, - GAsyncResult *result, - GError **error); -voidg_input_stream_close_async (GInputStream *stream, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_input_stream_close_finish (GInputStream *stream, - GAsyncResult *result, - GError **error); -gbooleang_input_stream_is_closed (GInputStream *stream); -gbooleang_input_stream_has_pending (GInputStream *stream); -gbooleang_input_stream_set_pending (GInputStream *stream, - GError **error); -voidg_input_stream_clear_pending (GInputStream *stream); +gssizeg_input_stream_read (GInputStream *stream, + void *buffer, + gsize count, + GCancellable *cancellable, + GError **error); +gbooleang_input_stream_read_all (GInputStream *stream, + void *buffer, + gsize count, + gsize *bytes_read, + GCancellable *cancellable, + GError **error); +gssizeg_input_stream_skip (GInputStream *stream, + gsize count, + GCancellable *cancellable, + GError **error); +gbooleang_input_stream_close (GInputStream *stream, + GCancellable *cancellable, + GError **error); +voidg_input_stream_read_async (GInputStream *stream, + void *buffer, + gsize count, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gssizeg_input_stream_read_finish (GInputStream *stream, + GAsyncResult *result, + GError **error); +voidg_input_stream_skip_async (GInputStream *stream, + gsize count, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gssizeg_input_stream_skip_finish (GInputStream *stream, + GAsyncResult *result, + GError **error); +voidg_input_stream_close_async (GInputStream *stream, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_input_stream_close_finish (GInputStream *stream, + GAsyncResult *result, + GError **error); +gbooleang_input_stream_is_closed (GInputStream *stream); +gbooleang_input_stream_has_pending (GInputStream *stream); +gbooleang_input_stream_set_pending (GInputStream *stream, + GError **error); +voidg_input_stream_clear_pending (GInputStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFilterInputStream
          +----GFileInputStream
@@ -148,7 +118,8 @@ To copy the content of an input stream to an output stream without
 manually handling the reads and writes, use g_output_stream_splice(). 
 

-All of these functions have async variants too.

+All of these functions have async variants too. +

Details

@@ -156,23 +127,24 @@ All of these functions have async variants too.

GInputStream

typedef struct _GInputStream GInputStream;

-Base class for streaming input operations.

+Base class for streaming input operations. +


g_input_stream_read ()

-
gssize              g_input_stream_read                 (GInputStream *stream,
-                                                         void *buffer,
-                                                         gsize count,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_input_stream_read                 (GInputStream *stream,
+                                                         void *buffer,
+                                                         gsize count,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to read count bytes from the stream into the buffer starting at buffer. Will block during this read.

If count is zero returns zero and does nothing. A value of count -larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error. +larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

On success, the number of bytes read into the buffer is returned. @@ -188,33 +160,34 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error.

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

- - - - - @@ -228,12 +201,12 @@ On error -1 is returned and error is set

g_input_stream_read_all ()

-
gboolean            g_input_stream_read_all             (GInputStream *stream,
-                                                         void *buffer,
-                                                         gsize count,
-                                                         gsize *bytes_read,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_input_stream_read_all             (GInputStream *stream,
+                                                         void *buffer,
+                                                         gsize count,
+                                                         gsize *bytes_read,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to read count bytes from the stream into the buffer starting at buffer. Will block during this read. @@ -244,49 +217,50 @@ read as many bytes as requested, only stopping on an error or end of stream.

On a successful read of count bytes, or if we reached the end of the -stream, TRUE is returned, and bytes_read is set to the number of bytes +stream, TRUE is returned, and bytes_read is set to the number of bytes read into buffer.

-If there is an error during the operation FALSE is returned and error +If there is an error during the operation FALSE is returned and error is set to indicate the error status, bytes_read is updated to contain -the number of bytes read into buffer before the error occurred.

+the number of bytes read into buffer before the error occurred. +

stream :

a GInputStream. +a GInputStream.

buffer :

a buffer to read data into (which should be at least count bytes long). +a buffer to read data into (which should be at least count bytes long).

count :

the number of bytes that will be read from the stream +the number of bytes that will be read from the stream

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore
- - - - - - - @@ -295,10 +269,10 @@ the number of bytes read into buffer bef

g_input_stream_skip ()

-
gssize              g_input_stream_skip                 (GInputStream *stream,
-                                                         gsize count,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_input_stream_skip                 (GInputStream *stream,
+                                                         gsize count,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to skip count bytes from the stream. Will block during the operation.

@@ -312,32 +286,33 @@ This function is optional for inherited classes, as the default implementation emulates it using read.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the -partial result will be returned, without an error.

+partial result will be returned, without an error. +

stream :

a GInputStream. +a GInputStream.

buffer :

a buffer to read data into (which should be at least count bytes long). +a buffer to read data into (which should be at least count bytes long).

count :

the number of bytes that will be read from the stream +the number of bytes that will be read from the stream

bytes_read :

location to store the number of bytes that was read from the stream +location to store the number of bytes that was read from the stream

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE if there was an error + TRUE on success, FALSE if there was an error
- - - - @@ -351,9 +326,9 @@ partial result will be returned, without an error.


g_input_stream_close ()

-
gboolean            g_input_stream_close                (GInputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_input_stream_close                (GInputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Closes the stream, releasing resources related to it.

@@ -382,28 +357,29 @@ If cancellable is not NULL, then the ope triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. Cancelling a close will still leave the stream closed, but some streams -can use a faster close that doesn't block to e.g. check errors.

+can use a faster close that doesn't block to e.g. check errors. +

stream :

a GInputStream. +a GInputStream.

count :

the number of bytes that will be skipped from the stream +the number of bytes that will be skipped from the stream

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore
- - - - @@ -412,13 +388,13 @@ can use a faster close that doesn't block to e.g. check errors.


g_input_stream_read_async ()

-
void                g_input_stream_read_async           (GInputStream *stream,
-                                                         void *buffer,
-                                                         gsize count,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_input_stream_read_async           (GInputStream *stream,
+                                                         void *buffer,
+                                                         gsize count,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Request an asynchronous read of count bytes from the stream into the buffer starting at buffer. When the operation is finished callback will be called. @@ -430,7 +406,7 @@ During an async request no other sync and async calls are allowed on G_IO_ERROR_PENDING errors.

-A value of count larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error. +A value of count larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

On success, the number of bytes read into the buffer will be passed to the @@ -442,49 +418,50 @@ as many bytes as requested. Zero is returned on end of file

Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default -priority is G_PRIORITY_DEFAULT. +priority is G_PRIORITY_DEFAULT.

The asyncronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you -override one you must override all.

+override one you must override all. +

stream :

A GInputStream. +A GInputStream.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE on failure + TRUE on success, FALSE on failure
- - - - - - - @@ -493,27 +470,28 @@ of the request.

g_input_stream_read_finish ()

-
gssize              g_input_stream_read_finish          (GInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gssize              g_input_stream_read_finish          (GInputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes an asynchronous stream read operation.

+Finishes an asynchronous stream read operation. +

stream :

A GInputStream. +A GInputStream.

buffer :

a buffer to read data into (which should be at least count bytes long). +a buffer to read data into (which should be at least count bytes long).

count :

the number of bytes that will be read from the stream +the number of bytes that will be read from the stream

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - @@ -528,12 +506,12 @@ ignore.

g_input_stream_skip_async ()

-
void                g_input_stream_skip_async           (GInputStream *stream,
-                                                         gsize count,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_input_stream_skip_async           (GInputStream *stream,
+                                                         gsize count,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Request an asynchronous skip of count bytes from the stream. When the operation is finished callback will be called. @@ -545,7 +523,7 @@ During an async request no other sync and async calls are allowed, and will result in G_IO_ERROR_PENDING errors.

-A value of count larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error. +A value of count larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

On success, the number of bytes skipped will be passed to the @@ -557,44 +535,45 @@ as many bytes as requested. Zero is returned on end of file

Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default -priority is G_PRIORITY_DEFAULT. +priority is G_PRIORITY_DEFAULT.

The asyncronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you -override one you must override all.

+override one you must override all. +

stream :

a GInputStream. +a GInputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.
- - - - - - @@ -603,27 +582,28 @@ of the request.

g_input_stream_skip_finish ()

-
gssize              g_input_stream_skip_finish          (GInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gssize              g_input_stream_skip_finish          (GInputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes a stream skip operation.

+Finishes a stream skip operation. +

stream :

A GInputStream. +A GInputStream.

count :

the number of bytes that will be skipped from the stream +the number of bytes that will be skipped from the stream

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - @@ -638,11 +618,11 @@ ignore.

g_input_stream_close_async ()

-
void                g_input_stream_close_async          (GInputStream *stream,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_input_stream_close_async          (GInputStream *stream,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Requests an asynchronous closes of the stream, releasing resources related to it. When the operation is finished callback will be called. @@ -655,34 +635,35 @@ For behaviour details see

stream :

a GInputStream. +a GInputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.
- - - - - @@ -691,33 +672,34 @@ of the request.

g_input_stream_close_finish ()

-
gboolean            g_input_stream_close_finish         (GInputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_input_stream_close_finish         (GInputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes closing a stream asynchronously, started from g_input_stream_close_async().

+Finishes closing a stream asynchronously, started from g_input_stream_close_async(). +

stream :

A GInputStream. +A GInputStream.

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional cancellable object +optional cancellable object

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -726,20 +708,21 @@ ignore.

g_input_stream_is_closed ()

-
gboolean            g_input_stream_is_closed            (GInputStream *stream);
+
gboolean            g_input_stream_is_closed            (GInputStream *stream);

-Checks if an input stream is closed.

+Checks if an input stream is closed. +

stream :

a GInputStream. +a GInputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the stream was closed successfully. + TRUE if the stream was closed successfully.
- - @@ -748,20 +731,21 @@ Checks if an input stream is closed.


g_input_stream_has_pending ()

-
gboolean            g_input_stream_has_pending          (GInputStream *stream);
+
gboolean            g_input_stream_has_pending          (GInputStream *stream);

-Checks if an input stream has pending actions.

+Checks if an input stream has pending actions. +

stream :

input stream. +input stream.

Returns :

TRUE if the stream is closed. + TRUE if the stream is closed.
- - @@ -770,29 +754,30 @@ Checks if an input stream has pending actions.


g_input_stream_set_pending ()

-
gboolean            g_input_stream_set_pending          (GInputStream *stream,
-                                                         GError **error);
+
gboolean            g_input_stream_set_pending          (GInputStream *stream,
+                                                         GError **error);

Sets stream to have actions pending. If the pending flag is -already set or stream is closed, it will return FALSE and set -error.

+already set or stream is closed, it will return FALSE and set +error. +

stream :

input stream. +input stream.

Returns :

TRUE if stream has pending actions. + TRUE if stream has pending actions.
- - - @@ -801,14 +786,15 @@ ignore.

g_input_stream_clear_pending ()

-
void                g_input_stream_clear_pending        (GInputStream *stream);
+
void                g_input_stream_clear_pending        (GInputStream *stream);

-Clears the pending flag on stream.

+Clears the pending flag on stream. +

stream :

input stream +input stream

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if pending was previously unset and is now set. + TRUE if pending was previously unset and is now set.
-

stream :

input stream +input stream
@@ -817,6 +803,6 @@ Clears the pending flag on stream.

+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/GLoadableIcon.html b/docs/reference/gio/html/GLoadableIcon.html index 584fe6d..e4f6360 100644 --- a/docs/reference/gio/html/GLoadableIcon.html +++ b/docs/reference/gio/html/GLoadableIcon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -78,20 +48,20 @@ GLoadableIcon; GLoadableIconIface; -GInputStream * g_loadable_icon_load (GLoadableIcon *icon, - int size, - char **type, - GCancellable *cancellable, - GError **error); -voidg_loadable_icon_load_async (GLoadableIcon *icon, - int size, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GInputStream * g_loadable_icon_load_finish (GLoadableIcon *icon, - GAsyncResult *res, - char **type, - GError **error); +GInputStream * g_loadable_icon_load (GLoadableIcon *icon, + int size, + char **type, + GCancellable *cancellable, + GError **error); +voidg_loadable_icon_load_async (GLoadableIcon *icon, + int size, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GInputStream * g_loadable_icon_load_finish (GLoadableIcon *icon, + GAsyncResult *res, + char **type, + GError **error);
@@ -105,7 +75,7 @@

Prerequisites

GLoadableIcon requires - GIcon and GObject.

+ GIcon and GObject.

Known Implementations

@@ -117,7 +87,8 @@ GLoadableIcon is implemented by

Description

Extends the GIcon interface and adds the ability to -load icons from streams.

+load icons from streams. +

Details

@@ -126,7 +97,8 @@ load icons from streams.

typedef struct _GLoadableIcon GLoadableIcon;

Generic type for all kinds of icons that can be loaded -as a stream.

+as a stream. +


@@ -153,28 +125,29 @@ as a stream.

} GLoadableIconIface;

-Interface for icons that can be loaded as a stream.

+Interface for icons that can be loaded as a stream. +

- - + - - - @@ -183,40 +156,41 @@ Interface for icons that can be loaded as a stream.


g_loadable_icon_load ()

-
GInputStream *      g_loadable_icon_load                (GLoadableIcon *icon,
-                                                         int size,
-                                                         char **type,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GInputStream *      g_loadable_icon_load                (GLoadableIcon *icon,
+                                                         int size,
+                                                         char **type,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Loads a loadable icon. For the asynchronous version of this function, -see g_loadable_icon_load_async().

+see g_loadable_icon_load_async(). +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

load ()

Loads an icon. +Loads an icon.

load_async ()

Loads an icon asynchronously. +Loads an icon asynchronously.

load_finish ()

Finishes an asynchronous icon load. +Finishes an asynchronous icon load.
- - - - - @@ -231,41 +205,42 @@ ignore.

g_loadable_icon_load_async ()

-
void                g_loadable_icon_load_async          (GLoadableIcon *icon,
-                                                         int size,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_loadable_icon_load_async          (GLoadableIcon *icon,
+                                                         int size,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking -version of this function, see g_loadable_icon_load().

+version of this function, see g_loadable_icon_load(). +

icon :

a GLoadableIcon. +a GLoadableIcon.

size :

an integer. +an integer.

type :

a location to store the type of the loaded icon, NULL to ignore. +a location to store the type of the loaded icon, NULL to ignore.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.
- - - - - @@ -274,33 +249,34 @@ version of this function, see

g_loadable_icon_load_finish ()

-
GInputStream *      g_loadable_icon_load_finish         (GLoadableIcon *icon,
-                                                         GAsyncResult *res,
-                                                         char **type,
-                                                         GError **error);
+
GInputStream *      g_loadable_icon_load_finish         (GLoadableIcon *icon,
+                                                         GAsyncResult *res,
+                                                         char **type,
+                                                         GError **error);

-Finishes an asynchronous icon load started in g_loadable_icon_load_async().

+Finishes an asynchronous icon load started in g_loadable_icon_load_async(). +

icon :

a GLoadableIcon. +a GLoadableIcon.

size :

an integer. +an integer.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -320,6 +296,6 @@ ignore. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GMemoryInputStream.html b/docs/reference/gio/html/GMemoryInputStream.html index 3198c5e..ccb0cb3 100644 --- a/docs/reference/gio/html/GMemoryInputStream.html +++ b/docs/reference/gio/html/GMemoryInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

icon :

a GLoadableIcon. +a GLoadableIcon.

res :

a GAsyncResult. +a GAsyncResult.

type :

a location to store the type of the loaded icon, NULL to ignore. +a location to store the type of the loaded icon, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.
@@ -75,20 +45,20 @@ #include <gio/gio.h> GMemoryInputStream; -GInputStream * g_memory_input_stream_new (void); -GInputStream * g_memory_input_stream_new_from_data (const void *data, - gssize len, - GDestroyNotify destroy); -voidg_memory_input_stream_add_data (GMemoryInputStream *stream, - const void *data, - gssize len, - GDestroyNotify destroy); +GInputStream * g_memory_input_stream_new (void); +GInputStream * g_memory_input_stream_new_from_data (const void *data, + gssize len, + GDestroyNotify destroy); +voidg_memory_input_stream_add_data (GMemoryInputStream *stream, + const void *data, + gssize len, + GDestroyNotify destroy);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GMemoryInputStream
 
@@ -103,7 +73,8 @@ GMemoryInputStream implements

Description

GMemoryInputStream is a class for using arbitrary -memory chunks as input for GIO streaming input operations.

+memory chunks as input for GIO streaming input operations. +

Details

@@ -111,14 +82,16 @@ memory chunks as input for GIO streaming input operations.

GMemoryInputStream

typedef struct _GMemoryInputStream GMemoryInputStream;

-Implements GInputStream for arbitrary memory chunks.

+Implements GInputStream for arbitrary memory chunks. +


g_memory_input_stream_new ()

-
GInputStream *      g_memory_input_stream_new           (void);
+
GInputStream *      g_memory_input_stream_new           (void);

-Creates a new empty GMemoryInputStream.

+Creates a new empty GMemoryInputStream. +

@@ -131,27 +104,28 @@ Creates a new empty

g_memory_input_stream_new_from_data ()

-
GInputStream *      g_memory_input_stream_new_from_data (const void *data,
-                                                         gssize len,
-                                                         GDestroyNotify destroy);
+
GInputStream *      g_memory_input_stream_new_from_data (const void *data,
+                                                         gssize len,
+                                                         GDestroyNotify destroy);

-Creates a new GMemoryInputStream with data in memory of a given size.

+Creates a new GMemoryInputStream with data in memory of a given size. +

- - - @@ -165,33 +139,34 @@ Creates a new

g_memory_input_stream_add_data ()

-
void                g_memory_input_stream_add_data      (GMemoryInputStream *stream,
-                                                         const void *data,
-                                                         gssize len,
-                                                         GDestroyNotify destroy);
+
void                g_memory_input_stream_add_data      (GMemoryInputStream *stream,
+                                                         const void *data,
+                                                         gssize len,
+                                                         GDestroyNotify destroy);

-Appends data to data that can be read from the input stream

+Appends data to data that can be read from the input stream +

data :

input data +input data

len :

length of the data, may be -1 if data is a nul-terminated string +length of the data, may be -1 if data is a nul-terminated string

destroy :

function that is called to free data, or NULL +function that is called to free data, or NULL
- - - - @@ -205,6 +180,6 @@ Appends data to data that can be read fr + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GMemoryOutputStream.html b/docs/reference/gio/html/GMemoryOutputStream.html index 55afd03..6e9d38a 100644 --- a/docs/reference/gio/html/GMemoryOutputStream.html +++ b/docs/reference/gio/html/GMemoryOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GMemoryInputStream +a GMemoryInputStream

data :

input data +input data

len :

length of the data, may be -1 if data is a nul-terminated string +length of the data, may be -1 if data is a nul-terminated string

destroy :

function that is called to free data, or NULL +function that is called to free data, or NULL
@@ -76,23 +46,23 @@
 #include <gio/gio.h>
 
-gpointer            (*GReallocFunc)                     (gpointer data,
-                                                         gsize size);
+gpointer            (*GReallocFunc)                     (gpointer data,
+                                                         gsize size);
                     GMemoryOutputStream;
-GOutputStream *     g_memory_output_stream_new          (gpointer data,
-                                                         gsize size,
-                                                         GReallocFunc realloc_function,
-                                                         GDestroyNotify destroy_function);
-gpointer            g_memory_output_stream_get_data     (GMemoryOutputStream *ostream);
-gsize               g_memory_output_stream_get_size     (GMemoryOutputStream *ostream);
-gsize               g_memory_output_stream_get_data_size
-                                                        (GMemoryOutputStream *ostream);
+GOutputStream *     g_memory_output_stream_new          (gpointer data,
+                                                         gsize size,
+                                                         GReallocFunc realloc_function,
+                                                         GDestroyNotify destroy_function);
+gpointer            g_memory_output_stream_get_data     (GMemoryOutputStream *ostream);
+gsize               g_memory_output_stream_get_size     (GMemoryOutputStream *ostream);
+gsize               g_memory_output_stream_get_data_size
+                                                        (GMemoryOutputStream *ostream);
 

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GMemoryOutputStream
 
@@ -106,42 +76,44 @@ GMemoryOutputStream implements

Properties

-  "data"                     gpointer              : Read / Write / Construct Only
-  "data-size"                gulong                : Read
-  "destroy-function"         gpointer              : Read / Write / Construct Only
-  "realloc-function"         gpointer              : Read / Write / Construct Only
-  "size"                     gulong                : Read / Write / Construct Only
+  "data"                     gpointer              : Read / Write / Construct Only
+  "data-size"                gulong                : Read
+  "destroy-function"         gpointer              : Read / Write / Construct Only
+  "realloc-function"         gpointer              : Read / Write / Construct Only
+  "size"                     gulong                : Read / Write / Construct Only
 

Description

GMemoryOutputStream is a class for using arbitrary -memory chunks as output for GIO streaming output operations.

+memory chunks as output for GIO streaming output operations. +

Details

GReallocFunc ()

-
gpointer            (*GReallocFunc)                     (gpointer data,
-                                                         gsize size);
+
gpointer            (*GReallocFunc)                     (gpointer data,
+                                                         gsize size);

Changes the size of the memory block pointed to by data to size bytes.

-The function should have the same semantics as realloc().

+The function should have the same semantics as realloc(). +

- - @@ -157,60 +129,79 @@ The function should have the same semantics as realloc()<

GMemoryOutputStream

typedef struct _GMemoryOutputStream GMemoryOutputStream;

-Implements GOutputStream for arbitrary memory chunks.

+Implements GOutputStream for arbitrary memory chunks. +


g_memory_output_stream_new ()

-
GOutputStream *     g_memory_output_stream_new          (gpointer data,
-                                                         gsize size,
-                                                         GReallocFunc realloc_function,
-                                                         GDestroyNotify destroy_function);
+
GOutputStream *     g_memory_output_stream_new          (gpointer data,
+                                                         gsize size,
+                                                         GReallocFunc realloc_function,
+                                                         GDestroyNotify destroy_function);

Creates a new GMemoryOutputStream.

-If data is non-NULL, the stream will use that for its internal storage. -If realloc_fn is non-NULL, it will be used for resizing the internal +If data is non-NULL, the stream will use that for its internal storage. +If realloc_fn is non-NULL, it will be used for resizing the internal storage when necessary. To construct a fixed-size output stream, -pass NULL as realloc_fn. +pass NULL as realloc_fn.

-
-/* a stream that can grow */
-stream = g_memory_output_stream_new (NULL, 0, realloc, free);
+
+

data :

memory block to reallocate +memory block to reallocate

size :

size to reallocate data to +size to reallocate data to
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
/* a stream that can grow */
+stream = g_memory_output_stream_new (NULL, 0, realloc, free);
+
+/* another stream that can grow */
+stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
 
-/* another stream that can grow */
-stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
+/* a fixed-size stream */
+data = malloc (200);
+stream3 = g_memory_output_stream_new (data, 200, NULL, free);
+ -/* a fixed-size stream */ -data = malloc (200); -stream3 = g_memory_output_stream_new (data, 200, NULL, free); - +

+

- - - - @@ -224,19 +215,20 @@ stream3 = g_memory_output_stream_new (data, 200, NULL, free);

g_memory_output_stream_get_data ()

-
gpointer            g_memory_output_stream_get_data     (GMemoryOutputStream *ostream);
+
gpointer            g_memory_output_stream_get_data     (GMemoryOutputStream *ostream);

Gets any loaded data from the ostream.

Note that the returned pointer may become invalid on the next -write or truncate operation on the stream.

+write or truncate operation on the stream. +

data :

pointer to a chunk of memory to use, or NULL +pointer to a chunk of memory to use, or NULL

size :

the size of data +the size of data

realloc_function :

a function with realloc() semantics (like g_realloc()) - to be called when data needs to be grown, or NULL +a function with realloc() semantics (like g_realloc()) + to be called when data needs to be grown, or NULL

destroy_function :

a function to be called on data when the stream is - finalized, or NULL +a function to be called on data when the stream is + finalized, or NULL
- @@ -250,7 +242,7 @@ write or truncate operation on the stream.


g_memory_output_stream_get_size ()

-
gsize               g_memory_output_stream_get_size     (GMemoryOutputStream *ostream);
+
gsize               g_memory_output_stream_get_size     (GMemoryOutputStream *ostream);

Gets the size of the currently allocated data area (availible from g_memory_output_stream_get_data()). If the stream isn't @@ -264,13 +256,14 @@ the next write or truncate operation on the stream.

If you want the number of bytes currently written to the stream, use -g_memory_output_stream_get_data_size().

+g_memory_output_stream_get_data_size(). +

ostream :

a GMemoryOutputStream +a GMemoryOutputStream
- @@ -284,18 +277,19 @@ If you want the number of bytes currently written to the stream, use

g_memory_output_stream_get_data_size ()

-
gsize               g_memory_output_stream_get_data_size
-                                                        (GMemoryOutputStream *ostream);
+
gsize               g_memory_output_stream_get_data_size
+                                                        (GMemoryOutputStream *ostream);

Returns the number of bytes from the start up to including the last byte written in the stream -that has not been truncated away.

+that has not been truncated away. +

ostream :

a GMemoryOutputStream +a GMemoryOutputStream
- @@ -313,41 +307,46 @@ that has not been truncated away.

Property Details

The "data" property

-
  "data"                     gpointer              : Read / Write / Construct Only
+
  "data"                     gpointer              : Read / Write / Construct Only

-Pointer to buffer where data will be written.

+Pointer to buffer where data will be written. +

Since 2.24


The "data-size" property

-
  "data-size"                gulong                : Read
+
  "data-size"                gulong                : Read

-Size of data written to the buffer.

+Size of data written to the buffer. +

Since 2.24


The "destroy-function" property

-
  "destroy-function"         gpointer              : Read / Write / Construct Only
+
  "destroy-function"         gpointer              : Read / Write / Construct Only

-Function called with the buffer as argument when the stream is destroyed.

+Function called with the buffer as argument when the stream is destroyed. +

Since 2.24


The "realloc-function" property

-
  "realloc-function"         gpointer              : Read / Write / Construct Only
+
  "realloc-function"         gpointer              : Read / Write / Construct Only

-Function with realloc semantics called to enlarge the buffer.

+Function with realloc semantics called to enlarge the buffer. +

Since 2.24


The "size" property

-
  "size"                     gulong                : Read / Write / Construct Only
+
  "size"                     gulong                : Read / Write / Construct Only

-Current size of the data buffer.

+Current size of the data buffer. +

Since 2.24

@@ -358,6 +357,6 @@ Current size of the data buffer.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GMount.html b/docs/reference/gio/html/GMount.html index 3c5065a..f4db8b2 100644 --- a/docs/reference/gio/html/GMount.html +++ b/docs/reference/gio/html/GMount.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

ostream :

a GMemoryOutputStream +a GMemoryOutputStream
@@ -80,76 +50,76 @@ GMount; GMountIface; -char * g_mount_get_name (GMount *mount); -char * g_mount_get_uuid (GMount *mount); -GIcon * g_mount_get_icon (GMount *mount); -GDrive * g_mount_get_drive (GMount *mount); -GFile * g_mount_get_root (GMount *mount); -GVolume * g_mount_get_volume (GMount *mount); -GFile * g_mount_get_default_location (GMount *mount); -gbooleang_mount_can_unmount (GMount *mount); +char * g_mount_get_name (GMount *mount); +char * g_mount_get_uuid (GMount *mount); +GIcon * g_mount_get_icon (GMount *mount); +GDrive * g_mount_get_drive (GMount *mount); +GFile * g_mount_get_root (GMount *mount); +GVolume * g_mount_get_volume (GMount *mount); +GFile * g_mount_get_default_location (GMount *mount); +gbooleang_mount_can_unmount (GMount *mount); enum GMountMountFlags; enum GMountUnmountFlags; -voidg_mount_unmount (GMount *mount, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_mount_unmount_finish (GMount *mount, - GAsyncResult *result, - GError **error); -voidg_mount_unmount_with_operation (GMount *mount, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_mount_unmount_with_operation_finish - (GMount *mount, - GAsyncResult *result, - GError **error); -voidg_mount_remount (GMount *mount, - GMountMountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_mount_remount_finish (GMount *mount, - GAsyncResult *result, - GError **error); -gbooleang_mount_can_eject (GMount *mount); -voidg_mount_eject (GMount *mount, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_mount_eject_finish (GMount *mount, - GAsyncResult *result, - GError **error); -voidg_mount_eject_with_operation (GMount *mount, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gbooleang_mount_eject_with_operation_finish (GMount *mount, - GAsyncResult *result, - GError **error); -voidg_mount_guess_content_type (GMount *mount, - gboolean force_rescan, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gchar ** g_mount_guess_content_type_finish (GMount *mount, - GAsyncResult *result, - GError **error); -gchar ** g_mount_guess_content_type_sync (GMount *mount, - gboolean force_rescan, - GCancellable *cancellable, - GError **error); -gbooleang_mount_is_shadowed (GMount *mount); -voidg_mount_shadow (GMount *mount); -voidg_mount_unshadow (GMount *mount); +voidg_mount_unmount (GMount *mount, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_mount_unmount_finish (GMount *mount, + GAsyncResult *result, + GError **error); +voidg_mount_unmount_with_operation (GMount *mount, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_mount_unmount_with_operation_finish + (GMount *mount, + GAsyncResult *result, + GError **error); +voidg_mount_remount (GMount *mount, + GMountMountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_mount_remount_finish (GMount *mount, + GAsyncResult *result, + GError **error); +gbooleang_mount_can_eject (GMount *mount); +voidg_mount_eject (GMount *mount, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_mount_eject_finish (GMount *mount, + GAsyncResult *result, + GError **error); +voidg_mount_eject_with_operation (GMount *mount, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gbooleang_mount_eject_with_operation_finish (GMount *mount, + GAsyncResult *result, + GError **error); +voidg_mount_guess_content_type (GMount *mount, + gboolean force_rescan, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gchar ** g_mount_guess_content_type_finish (GMount *mount, + GAsyncResult *result, + GError **error); +gchar ** g_mount_guess_content_type_sync (GMount *mount, + gboolean force_rescan, + GCancellable *cancellable, + GError **error); +gbooleang_mount_is_shadowed (GMount *mount); +voidg_mount_shadow (GMount *mount); +voidg_mount_unshadow (GMount *mount);
@@ -163,7 +133,7 @@ enum

Prerequisites

GMount requires - GObject.

+ GObject.

Signals

@@ -177,7 +147,7 @@ GMount requires

Description

The GMount interface represents user-visible mounts. Note, when -porting from GnomeVFS, GMount is the moral equivalent of GnomeVFSVolume. +porting from GnomeVFS, GMount is the moral equivalent of GnomeVFSVolume.

GMount is a "mounted" filesystem that you can access. Mounted is in @@ -196,7 +166,8 @@ operation has resolved (either with success or failure), and a callback should then call g_mount_unmount_with_operation_finish() with the GMount and the GAsyncReady data to see if the operation was completed successfully. If an error is present when g_mount_unmount_with_operation_finish() -is called, then it will be filled with any error information.

+is called, then it will be filled with any error information. +

Details

@@ -204,7 +175,8 @@ is called, then it will be filled with any error information.

GMount

typedef struct _GMount GMount;

-A handle to an object implementing the GMountIface interface.

+A handle to an object implementing the GMountIface interface. +


@@ -295,140 +267,141 @@ A handle to an object implementing the
- - + - - - - - - - - - - - - - - - - - - - - - - - - - @@ -437,21 +410,22 @@ Interface for implementing operations for mounts.


g_mount_get_name ()

-
char *              g_mount_get_name                    (GMount *mount);
+
char *              g_mount_get_name                    (GMount *mount);

-Gets the name of mount.

+Gets the name of mount. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

changed ()

Changed signal that is emitted when the mount's state has changed. +Changed signal that is emitted when the mount's state has changed.

unmounted ()

The unmounted signal that is emitted when the GMount have been unmounted. If the recipient is holding references to the object they should release them so the object can be finalized. +The unmounted signal that is emitted when the GMount have been unmounted. If the recipient is holding references to the object they should release them so the object can be finalized.

get_root ()

Gets a GFile to the root directory of the GMount. +Gets a GFile to the root directory of the GMount.

get_name ()

Gets a string containing the name of the GMount. +Gets a string containing the name of the GMount.

get_icon ()

Gets a GIcon for the GMount. +Gets a GIcon for the GMount.

get_uuid ()

Gets the UUID for the GMount. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns NULL if there is no UUID available. +Gets the UUID for the GMount. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns NULL if there is no UUID available.

get_volume ()

Gets a GVolume the mount is located on. Returns NULL if the GMount is not associated with a GVolume. +Gets a GVolume the mount is located on. Returns NULL if the GMount is not associated with a GVolume.

get_drive ()

Gets a GDrive the volume of the mount is located on. Returns NULL if the GMount is not associated with a GDrive or a GVolume. This is convenience method for getting the GVolume and using that to get the GDrive. +Gets a GDrive the volume of the mount is located on. Returns NULL if the GMount is not associated with a GDrive or a GVolume. This is convenience method for getting the GVolume and using that to get the GDrive.

can_unmount ()

Checks if a GMount can be unmounted. +Checks if a GMount can be unmounted.

can_eject ()

Checks if a GMount can be ejected. +Checks if a GMount can be ejected.

unmount ()

Starts unmounting a GMount. +Starts unmounting a GMount.

unmount_finish ()

Finishes an unmounting operation. +Finishes an unmounting operation.

eject ()

Starts ejecting a GMount. +Starts ejecting a GMount.

eject_finish ()

Finishes an eject operation. +Finishes an eject operation.

remount ()

Starts remounting a GMount. +Starts remounting a GMount.

remount_finish ()

Finishes a remounting operation. +Finishes a remounting operation.

guess_content_type ()

Starts guessing the type of the content of a GMount. +Starts guessing the type of the content of a GMount. See g_mount_guess_content_type() for more information on content type guessing. This operation was added in 2.18.

guess_content_type_finish ()

Finishes a contenet type guessing operation. Added in 2.18. +Finishes a contenet type guessing operation. Added in 2.18.

guess_content_type_sync ()

Synchronous variant of guess_content_type. Added in 2.18 +Synchronous variant of guess_content_type. Added in 2.18

pre_unmount ()

The pre_unmout signal that is emitted when the GMount will soon be emitted. If the recipient is somehow holding the mount open by keeping an open file on it it should close the file. +The pre_unmout signal that is emitted when the GMount will soon be emitted. If the recipient is somehow holding the mount open by keeping an open file on it it should close the file.

unmount_with_operation ()

Starts unmounting a GMount using a GMountOperation. Since 2.22. +Starts unmounting a GMount using a GMountOperation. Since 2.22.

unmount_with_operation_finish ()

Finishes an unmounting operation using a GMountOperation. Since 2.22. +Finishes an unmounting operation using a GMountOperation. Since 2.22.

eject_with_operation ()

Starts ejecting a GMount using a GMountOperation. Since 2.22. +Starts ejecting a GMount using a GMountOperation. Since 2.22.

eject_with_operation_finish ()

Finishes an eject operation using a GMountOperation. Since 2.22. +Finishes an eject operation using a GMountOperation. Since 2.22.

get_default_location ()

Gets a GFile indication a start location that can be use as the entry point for this mount. Since 2.24. +Gets a GFile indication a start location that can be use as the entry point for this mount. Since 2.24.
- @@ -461,24 +435,25 @@ Gets the name of mount.


g_mount_get_uuid ()

-
char *              g_mount_get_uuid                    (GMount *mount);
+
char *              g_mount_get_uuid                    (GMount *mount);

Gets the UUID for the mount. The reference is typically based on the file system UUID for the mount in question and should be -considered an opaque string. Returns NULL if there is no UUID -available.

+considered an opaque string. Returns NULL if there is no UUID +available. +

mount :

a GMount. +a GMount.

Returns :

the name for the given mount. - The returned string should be freed with g_free() + The returned string should be freed with g_free() when no longer needed.
- - @@ -488,22 +463,23 @@ available.


g_mount_get_icon ()

-
GIcon *             g_mount_get_icon                    (GMount *mount);
+
GIcon *             g_mount_get_icon                    (GMount *mount);

-Gets the icon for mount.

+Gets the icon for mount. +

mount :

a GMount. +a GMount.

Returns :

the UUID for mount or NULL if no UUID can be computed. - The returned string should be freed with g_free() + the UUID for mount or NULL if no UUID can be computed. + The returned string should be freed with g_free() when no longer needed.
- @@ -512,26 +488,27 @@ Gets the icon for mount.


g_mount_get_drive ()

-
GDrive *            g_mount_get_drive                   (GMount *mount);
+
GDrive *            g_mount_get_drive                   (GMount *mount);

Gets the drive for the mount.

This is a convenience method for getting the GVolume and then -using that object to get the GDrive.

+using that object to get the GDrive. +

mount :

a GMount. +a GMount.

Returns :

a GIcon. The returned object should be unreffed with - g_object_unref() when no longer needed. + g_object_unref() when no longer needed.
- - @@ -540,22 +517,23 @@ using that object to get the <

g_mount_get_root ()

-
GFile *             g_mount_get_root                    (GMount *mount);
+
GFile *             g_mount_get_root                    (GMount *mount);

-Gets the root directory on mount.

+Gets the root directory on mount. +

mount :

a GMount. +a GMount.

Returns :

a GDrive or NULL if mount is not associated with a volume or a drive. + a GDrive or NULL if mount is not associated with a volume or a drive. The returned object should be unreffed with - g_object_unref() when no longer needed. + g_object_unref() when no longer needed.
- @@ -564,22 +542,23 @@ Gets the root directory on mount.


g_mount_get_volume ()

-
GVolume *           g_mount_get_volume                  (GMount *mount);
+
GVolume *           g_mount_get_volume                  (GMount *mount);

-Gets the volume for the mount.

+Gets the volume for the mount. +

mount :

a GMount. +a GMount.

Returns :

a GFile. The returned object should be unreffed with - g_object_unref() when no longer needed. + g_object_unref() when no longer needed.
- - @@ -588,24 +567,25 @@ Gets the volume for the mount.


g_mount_get_default_location ()

-
GFile *             g_mount_get_default_location        (GMount *mount);
+
GFile *             g_mount_get_default_location        (GMount *mount);

Gets the default location of mount. The default location of the given mount is a path that reflects the main entry point for the user (e.g. -the home directory, or the root of the volume).

+the home directory, or the root of the volume). +

mount :

a GMount. +a GMount.

Returns :

a GVolume or NULL if mount is not associated with a volume. + a GVolume or NULL if mount is not associated with a volume. The returned object should be unreffed with - g_object_unref() when no longer needed. + g_object_unref() when no longer needed.
- @@ -614,20 +594,21 @@ the home directory, or the root of the volume).


g_mount_can_unmount ()

-
gboolean            g_mount_can_unmount                 (GMount *mount);
+
gboolean            g_mount_can_unmount                 (GMount *mount);

-Checks if mount can be mounted.

+Checks if mount can be mounted. +

mount :

a GMount. +a GMount.

Returns :

a GFile. The returned object should be unreffed with - g_object_unref() when no longer needed. + g_object_unref() when no longer needed.
- - @@ -641,12 +622,13 @@ Checks if mount can be mounted.

} GMountMountFlags;

-Flags used when mounting a mount.

+Flags used when mounting a mount. +

mount :

a GMount. +a GMount.

Returns :

TRUE if the mount can be unmounted. + TRUE if the mount can be unmounted.
-

G_MOUNT_MOUNT_NONE

No flags set. +No flags set.
@@ -660,18 +642,19 @@ Flags used when mounting a mount.

} GMountUnmountFlags;

-Flags used when an unmounting a mount.

+Flags used when an unmounting a mount. +

- - @@ -681,11 +664,11 @@ Flags used when an unmounting a mount.


g_mount_unmount ()

-
void                g_mount_unmount                     (GMount *mount,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_unmount                     (GMount *mount,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_mount_unmount has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_unmount_with_operation() instead.

@@ -693,33 +676,34 @@ Flags used when an unmounting a mount.

Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_finish() with the mount -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

G_MOUNT_UNMOUNT_NONE

No flags set. +No flags set.

G_MOUNT_UNMOUNT_FORCE

Unmount even if there are outstanding +Unmount even if there are outstanding file operations on the mount.
- - - - - @@ -728,38 +712,39 @@ and

g_mount_unmount_finish ()

-
gboolean            g_mount_unmount_finish              (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_mount_unmount_finish              (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_mount_unmount_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_unmount_with_operation_finish() instead.

Finishes unmounting a mount. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

mount :

a GMount. +a GMount.

flags :

flags affecting the operation +flags affecting the operation

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -769,47 +754,48 @@ Finishes unmounting a mount. If any errors occurred during the operation,

g_mount_unmount_with_operation ()

-
void                g_mount_unmount_with_operation      (GMount *mount,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_unmount_with_operation      (GMount *mount,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the mount -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

mount :

a GMount. +a GMount.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the mount was successfully unmounted. FALSE otherwise. + TRUE if the mount was successfully unmounted. FALSE otherwise.
- - - - - - @@ -819,35 +805,36 @@ and

g_mount_unmount_with_operation_finish ()

-
gboolean            g_mount_unmount_with_operation_finish
-                                                        (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_mount_unmount_with_operation_finish
+                                                        (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes unmounting a mount. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

mount :

a GMount. +a GMount.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -858,12 +845,12 @@ Finishes unmounting a mount. If any errors occurred during the operation,

g_mount_remount ()

-
void                g_mount_remount                     (GMount *mount,
-                                                         GMountMountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_remount                     (GMount *mount,
+                                                         GMountMountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Remounts a mount. This is an asynchronous operation, and is finished by calling g_mount_remount_finish() with the mount @@ -874,38 +861,39 @@ Remounting is useful when some setting affecting the operation of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be -unmounted.

+unmounted. +

mount :

a GMount. +a GMount.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the mount was successfully unmounted. FALSE otherwise. + TRUE if the mount was successfully unmounted. FALSE otherwise.
- - - - - - @@ -914,34 +902,35 @@ unmounted.


g_mount_remount_finish ()

-
gboolean            g_mount_remount_finish              (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_mount_remount_finish              (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes remounting a mount. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

mount :

a GMount. +a GMount.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -950,20 +939,21 @@ Finishes remounting a mount. If any errors occurred during the operation,

g_mount_can_eject ()

-
gboolean            g_mount_can_eject                   (GMount *mount);
+
gboolean            g_mount_can_eject                   (GMount *mount);

-Checks if mount can be eject.

+Checks if mount can be eject. +

mount :

a GMount. +a GMount.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the mount was successfully remounted. FALSE otherwise. + TRUE if the mount was successfully remounted. FALSE otherwise.
- - @@ -972,11 +962,11 @@ Checks if mount can be eject.


g_mount_eject ()

-
void                g_mount_eject                       (GMount *mount,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_eject                       (GMount *mount,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_mount_eject has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_eject_with_operation() instead.

@@ -984,33 +974,34 @@ Checks if mount can be eject.

Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_finish() with the mount -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

mount :

a GMount. +a GMount.

Returns :

TRUE if the mount can be ejected. + TRUE if the mount can be ejected.
- - - - - @@ -1019,38 +1010,39 @@ and

g_mount_eject_finish ()

-
gboolean            g_mount_eject_finish                (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_mount_eject_finish                (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_mount_eject_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_eject_with_operation_finish() instead.

Finishes ejecting a mount. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

mount :

a GMount. +a GMount.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -1060,47 +1052,48 @@ Finishes ejecting a mount. If any errors occurred during the operation,

g_mount_eject_with_operation ()

-
void                g_mount_eject_with_operation        (GMount *mount,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_eject_with_operation        (GMount *mount,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the mount -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

mount :

a GMount. +a GMount.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the mount was successfully ejected. FALSE otherwise. + TRUE if the mount was successfully ejected. FALSE otherwise.
- - - - - - @@ -1110,34 +1103,35 @@ and

g_mount_eject_with_operation_finish ()

-
gboolean            g_mount_eject_with_operation_finish (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_mount_eject_with_operation_finish (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes ejecting a mount. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

mount :

a GMount. +a GMount.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -1148,11 +1142,11 @@ Finishes ejecting a mount. If any errors occurred during the operation,

g_mount_guess_content_type ()

-
void                g_mount_guess_content_type          (GMount *mount,
-                                                         gboolean force_rescan,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_mount_guess_content_type          (GMount *mount,
+                                                         gboolean force_rescan,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Tries to guess the type of content stored on mount. Returns one or more textual identifiers of well-known content types (typically @@ -1164,34 +1158,35 @@ specification for more on x-content types. This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the -mount and GAsyncResult data returned in the callback.

+mount and GAsyncResult data returned in the callback. +

mount :

a GMount. +a GMount.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the mount was successfully ejected. FALSE otherwise. + TRUE if the mount was successfully ejected. FALSE otherwise.
- - - - - @@ -1201,38 +1196,39 @@ is finished by calling

g_mount_guess_content_type_finish ()

-
gchar **            g_mount_guess_content_type_finish   (GMount *mount,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gchar **            g_mount_guess_content_type_finish   (GMount *mount,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes guessing content types of mount. If any errors occured during the operation, error will be set to contain the errors and -FALSE will be returned. In particular, you may get an +FALSE will be returned. In particular, you may get an G_IO_ERROR_NOT_SUPPORTED if the mount does not support content -guessing.

+guessing. +

mount :

a GMount +a GMount

force_rescan :

Whether to force a rescan of the content. +Whether to force a rescan of the content. Otherwise a cached result will be used if available

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data passed to callback +user data passed to callback
- - - - @@ -1243,10 +1239,10 @@ guessing.


g_mount_guess_content_type_sync ()

-
gchar **            g_mount_guess_content_type_sync     (GMount *mount,
-                                                         gboolean force_rescan,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gchar **            g_mount_guess_content_type_sync     (GMount *mount,
+                                                         gboolean force_rescan,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to guess the type of content stored on mount. Returns one or more textual identifiers of well-known content types (typically @@ -1256,36 +1252,37 @@ specification for more on x-content types.

This is an synchronous operation and as such may block doing IO; -see g_mount_guess_content_type() for the asynchronous version.

+see g_mount_guess_content_type() for the asynchronous version. +

mount :

a GMount +a GMount

result :

a GAsyncResult +a GAsyncResult

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore

Returns :

a NULL-terminated array of content types or NULL on error. - Caller should free this array with g_strfreev() when done with it. + a NULL-terminated array of content types or NULL on error. + Caller should free this array with g_strfreev() when done with it.
- - - - - @@ -1296,7 +1293,7 @@ see

g_mount_is_shadowed ()

-
gboolean            g_mount_is_shadowed                 (GMount *mount);
+
gboolean            g_mount_is_shadowed                 (GMount *mount);

Determines if mount is shadowed. Applications or libraries should avoid displaying mount in the user interface if it is shadowed. @@ -1323,18 +1320,19 @@ root) that would shadow the original mount.

The proxy monitor in GVfs 2.26 and later, automatically creates and manage shadow mounts (and shadows the underlying mount) if the -activation root on a GVolume is set.

+activation root on a GVolume is set. +

mount :

a GMount +a GMount

force_rescan :

Whether to force a rescan of the content. +Whether to force a rescan of the content. Otherwise a cached result will be used if available

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore

Returns :

a NULL-terminated array of content types or NULL on error. - Caller should free this array with g_strfreev() when done with it. + a NULL-terminated array of content types or NULL on error. + Caller should free this array with g_strfreev() when done with it.
- - @@ -1345,17 +1343,18 @@ activation root on a

g_mount_shadow ()

-
void                g_mount_shadow                      (GMount *mount);
+
void                g_mount_shadow                      (GMount *mount);

Increments the shadow count on mount. Usually used by GVolumeMonitor implementations when creating a shadow mount for mount, see g_mount_is_shadowed() for more information. The caller -will need to emit the "changed" signal on mount manually.

+will need to emit the "changed" signal on mount manually. +

mount :

A GMount. +A GMount.

Returns :

TRUE if mount is shadowed. + TRUE if mount is shadowed.
-

mount :

A GMount. +A GMount.
@@ -1364,17 +1363,18 @@ will need to emit the "changed" signal on mount manually.

+will need to emit the "changed" signal on mount manually. +

-

mount :

A GMount. +A GMount.
@@ -1386,15 +1386,16 @@ will need to emit the

The "changed" signal

void                user_function                      (GMount  *mount,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the mount has been changed.

+Emitted when the mount has been changed. +

- @@ -1408,16 +1409,17 @@ Emitted when the mount has been changed.

The "pre-unmount" signal

void                user_function                      (GMount  *mount,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

This signal is emitted when the GMount is about to be -unmounted.

+unmounted. +

mount :

the object on which the signal is emitted +the object on which the signal is emitted
- @@ -1432,18 +1434,19 @@ unmounted.

The "unmounted" signal

void                user_function                      (GMount  *mount,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

This signal is emitted when the GMount have been unmounted. If the recipient is holding references to the object they should release them so the object can be -finalized.

+finalized. +

mount :

the object on which the signal is emitted +the object on which the signal is emitted
- @@ -1457,6 +1460,6 @@ finalized.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GMountOperation.html b/docs/reference/gio/html/GMountOperation.html index 1c06dd9..f703db7 100644 --- a/docs/reference/gio/html/GMountOperation.html +++ b/docs/reference/gio/html/GMountOperation.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

mount :

the object on which the signal is emitted +the object on which the signal is emitted
@@ -80,45 +50,45 @@ enum GPasswordSave; GMountOperation; enum GMountOperationResult; -GMountOperation * g_mount_operation_new (void); -const char * g_mount_operation_get_username (GMountOperation *op); -voidg_mount_operation_set_username (GMountOperation *op, - const char *username); -const char * g_mount_operation_get_password (GMountOperation *op); -voidg_mount_operation_set_password (GMountOperation *op, - const char *password); -gbooleang_mount_operation_get_anonymous (GMountOperation *op); -voidg_mount_operation_set_anonymous (GMountOperation *op, - gboolean anonymous); -const char * g_mount_operation_get_domain (GMountOperation *op); -voidg_mount_operation_set_domain (GMountOperation *op, - const char *domain); -GPasswordSaveg_mount_operation_get_password_save (GMountOperation *op); -voidg_mount_operation_set_password_save (GMountOperation *op, - GPasswordSave save); -intg_mount_operation_get_choice (GMountOperation *op); -voidg_mount_operation_set_choice (GMountOperation *op, - int choice); -voidg_mount_operation_reply (GMountOperation *op, - GMountOperationResult result); +GMountOperation * g_mount_operation_new (void); +const char * g_mount_operation_get_username (GMountOperation *op); +voidg_mount_operation_set_username (GMountOperation *op, + const char *username); +const char * g_mount_operation_get_password (GMountOperation *op); +voidg_mount_operation_set_password (GMountOperation *op, + const char *password); +gbooleang_mount_operation_get_anonymous (GMountOperation *op); +voidg_mount_operation_set_anonymous (GMountOperation *op, + gboolean anonymous); +const char * g_mount_operation_get_domain (GMountOperation *op); +voidg_mount_operation_set_domain (GMountOperation *op, + const char *domain); +GPasswordSaveg_mount_operation_get_password_save (GMountOperation *op); +voidg_mount_operation_set_password_save (GMountOperation *op, + GPasswordSave save); +intg_mount_operation_get_choice (GMountOperation *op); +voidg_mount_operation_set_choice (GMountOperation *op, + int choice); +voidg_mount_operation_reply (GMountOperation *op, + GMountOperationResult result);

Object Hierarchy

-  GObject
+  GObject
    +----GMountOperation
 

Properties

-  "anonymous"                gboolean              : Read / Write
-  "choice"                   gint                  : Read / Write
-  "domain"                   gchar*                : Read / Write
-  "password"                 gchar*                : Read / Write
+  "anonymous"                gboolean              : Read / Write
+  "choice"                   gint                  : Read / Write
+  "domain"                   gchar*                : Read / Write
+  "password"                 gchar*                : Read / Write
   "password-save"            GPasswordSave         : Read / Write
-  "username"                 gchar*                : Read / Write
+  "username"                 gchar*                : Read / Write
 
@@ -148,9 +118,10 @@ objects – for example it is also used in GtkMountOperation. If no user interaction is desired (for example -when automounting filesystems at login time), usually NULL can be -passed, see each method taking a GMountOperation for details.

+GtkMountOperation. If no user interaction is desired (for example +when automounting filesystems at login time), usually NULL can be +passed, see each method taking a GMountOperation for details. +

Details

@@ -167,33 +138,34 @@ passed, see each method taking a GAskPasswordFlags are used to request specific information from the user, or to notify the user of their choices in an authentication -situation.

+situation. +

- - - - - @@ -213,23 +185,24 @@ situation.

Gvfs stores passwords in the Gnome keyring when this flag allows it -to, and later retrieves it again from there.

+to, and later retrieves it again from there. +

G_ASK_PASSWORD_NEED_PASSWORD

operation requires a password. +operation requires a password.

G_ASK_PASSWORD_NEED_USERNAME

operation requires a username. +operation requires a username.

G_ASK_PASSWORD_NEED_DOMAIN

operation requires a domain. +operation requires a domain.

G_ASK_PASSWORD_SAVING_SUPPORTED

operation supports saving settings. +operation supports saving settings.

G_ASK_PASSWORD_ANONYMOUS_SUPPORTED

operation supports anonymous users. +operation supports anonymous users.
- - - @@ -241,7 +214,8 @@ to, and later retrieves it again from there.

typedef struct _GMountOperation GMountOperation;

Class for providing authentication methods for mounting operations, -such as mounting a file locally, or authenticating with a server.

+such as mounting a file locally, or authenticating with a server. +


@@ -254,25 +228,26 @@ such as mounting a file locally, or authenticating with a server.

GMountOperationResult is returned as a result when a request for -information is send by the mounting operation.

+information is send by the mounting operation. +

G_PASSWORD_SAVE_NEVER

never save a password. +never save a password.

G_PASSWORD_SAVE_FOR_SESSION

save a password for the session. +save a password for the session.

G_PASSWORD_SAVE_PERMANENTLY

save a password permanently. +save a password permanently.
- - - @@ -282,9 +257,10 @@ information is send by the mounting operation.


g_mount_operation_new ()

-
GMountOperation *   g_mount_operation_new               (void);
+
GMountOperation *   g_mount_operation_new               (void);

-Creates a new mount operation.

+Creates a new mount operation. +

G_MOUNT_OPERATION_HANDLED

The request was fulfilled and the +The request was fulfilled and the user specified data is now available

G_MOUNT_OPERATION_ABORTED

The user requested the mount operation +The user requested the mount operation to be aborted

G_MOUNT_OPERATION_UNHANDLED

The request was unhandled (i.e. not +The request was unhandled (i.e. not implemented)
@@ -297,15 +273,16 @@ Creates a new mount operation.


g_mount_operation_get_username ()

-
const char *        g_mount_operation_get_username      (GMountOperation *op);
+
const char *        g_mount_operation_get_username      (GMountOperation *op);

-Get the user name from the mount operation.

+Get the user name from the mount operation. +

- @@ -319,21 +296,22 @@ Get the user name from the mount operation.


g_mount_operation_set_username ()

-
void                g_mount_operation_set_username      (GMountOperation *op,
-                                                         const char *username);
+
void                g_mount_operation_set_username      (GMountOperation *op,
+                                                         const char *username);

-Sets the user name within op to username.

+Sets the user name within op to username. +

op :

a GMountOperation. +a GMountOperation.
- - @@ -342,15 +320,16 @@ Sets the user name within op to

g_mount_operation_get_password ()

-
const char *        g_mount_operation_get_password      (GMountOperation *op);
+
const char *        g_mount_operation_get_password      (GMountOperation *op);

-Gets a password from the mount operation.

+Gets a password from the mount operation. +

op :

a GMountOperation. +a GMountOperation.

username :

input username. +input username.
- @@ -364,21 +343,22 @@ Gets a password from the mount operation.


g_mount_operation_set_password ()

-
void                g_mount_operation_set_password      (GMountOperation *op,
-                                                         const char *password);
+
void                g_mount_operation_set_password      (GMountOperation *op,
+                                                         const char *password);

-Sets the mount operation's password to password.

+Sets the mount operation's password to password. +

op :

a GMountOperation. +a GMountOperation.
- - @@ -387,21 +367,22 @@ Sets the mount operation's password to password

g_mount_operation_get_anonymous ()

-
gboolean            g_mount_operation_get_anonymous     (GMountOperation *op);
+
gboolean            g_mount_operation_get_anonymous     (GMountOperation *op);

Check to see whether the mount operation is being used -for an anonymous user.

+for an anonymous user. +

op :

a GMountOperation. +a GMountOperation.

password :

password to set. +password to set.
- - @@ -410,21 +391,22 @@ for an anonymous user.


g_mount_operation_set_anonymous ()

-
void                g_mount_operation_set_anonymous     (GMountOperation *op,
-                                                         gboolean anonymous);
+
void                g_mount_operation_set_anonymous     (GMountOperation *op,
+                                                         gboolean anonymous);

-Sets the mount operation to use an anonymous user if anonymous is TRUE.

+Sets the mount operation to use an anonymous user if anonymous is TRUE. +

op :

a GMountOperation. +a GMountOperation.

Returns :

TRUE if mount operation is anonymous. + TRUE if mount operation is anonymous.
- - @@ -433,15 +415,16 @@ Sets the mount operation to use an anonymous user if

g_mount_operation_get_domain ()

-
const char *        g_mount_operation_get_domain        (GMountOperation *op);
+
const char *        g_mount_operation_get_domain        (GMountOperation *op);

-Gets the domain of the mount operation.

+Gets the domain of the mount operation. +

op :

a GMountOperation. +a GMountOperation.

anonymous :

boolean value. +boolean value.
- @@ -455,21 +438,22 @@ Gets the domain of the mount operation.


g_mount_operation_set_domain ()

-
void                g_mount_operation_set_domain        (GMountOperation *op,
-                                                         const char *domain);
+
void                g_mount_operation_set_domain        (GMountOperation *op,
+                                                         const char *domain);

-Sets the mount operation's domain.

+Sets the mount operation's domain. +

op :

a GMountOperation. +a GMountOperation.
- - @@ -478,15 +462,16 @@ Sets the mount operation's domain.


g_mount_operation_get_password_save ()

-
GPasswordSave       g_mount_operation_get_password_save (GMountOperation *op);
+
GPasswordSave       g_mount_operation_get_password_save (GMountOperation *op);

-Gets the state of saving passwords for the mount operation.

+Gets the state of saving passwords for the mount operation. +

op :

a GMountOperation. +a GMountOperation.

domain :

the domain to set. +the domain to set.
- @@ -500,21 +485,22 @@ Gets the state of saving passwords for the mount operation.


g_mount_operation_set_password_save ()

-
void                g_mount_operation_set_password_save (GMountOperation *op,
-                                                         GPasswordSave save);
+
void                g_mount_operation_set_password_save (GMountOperation *op,
+                                                         GPasswordSave save);

-Sets the state of saving passwords for the mount operation.

+Sets the state of saving passwords for the mount operation. +

op :

a GMountOperation. +a GMountOperation.
- - @@ -523,15 +509,16 @@ Sets the state of saving passwords for the mount operation.


g_mount_operation_get_choice ()

-
int                 g_mount_operation_get_choice        (GMountOperation *op);
+
int                 g_mount_operation_get_choice        (GMountOperation *op);

-Gets a choice from the mount operation.

+Gets a choice from the mount operation. +

op :

a GMountOperation. +a GMountOperation.

save :

a set of GPasswordSave flags. +a set of GPasswordSave flags.
- @@ -546,21 +533,22 @@ the choice's list, or 0.

g_mount_operation_set_choice ()

-
void                g_mount_operation_set_choice        (GMountOperation *op,
-                                                         int choice);
+
void                g_mount_operation_set_choice        (GMountOperation *op,
+                                                         int choice);

-Sets a default choice for the mount operation.

+Sets a default choice for the mount operation. +

op :

a GMountOperation. +a GMountOperation.
- - @@ -569,21 +557,22 @@ Sets a default choice for the mount operation.


g_mount_operation_reply ()

-
void                g_mount_operation_reply             (GMountOperation *op,
-                                                         GMountOperationResult result);
+
void                g_mount_operation_reply             (GMountOperation *op,
+                                                         GMountOperationResult result);

-Emits the "reply" signal.

+Emits the "reply" signal. +

op :

a GMountOperation. +a GMountOperation.

choice :

an integer. +an integer.
- - @@ -594,36 +583,40 @@ Emits the

Property Details

The "anonymous" property

-
  "anonymous"                gboolean              : Read / Write
+
  "anonymous"                gboolean              : Read / Write

-Whether to use an anonymous user when authenticating.

+Whether to use an anonymous user when authenticating. +

Default value: FALSE


The "choice" property

-
  "choice"                   gint                  : Read / Write
+
  "choice"                   gint                  : Read / Write

The index of the user's choice when a question is asked during the -mount operation. See the "ask-question" signal.

+mount operation. See the "ask-question" signal. +

Allowed values: >= 0

Default value: 0


The "domain" property

-
  "domain"                   gchar*                : Read / Write
+
  "domain"                   gchar*                : Read / Write

-The domain to use for the mount operation.

+The domain to use for the mount operation. +

Default value: NULL


The "password" property

-
  "password"                 gchar*                : Read / Write
+
  "password"                 gchar*                : Read / Write

The password that is used for authentication when carrying out -the mount operation.

+the mount operation. +

Default value: NULL


@@ -631,16 +624,18 @@ the mount operation.

The "password-save" property

  "password-save"            GPasswordSave         : Read / Write

-Determines if and how the password information should be saved.

+Determines if and how the password information should be saved. +

Default value: G_PASSWORD_SAVE_NEVER


The "username" property

-
  "username"                 gchar*                : Read / Write
+
  "username"                 gchar*                : Read / Write

The user name that is used for authentication when carrying out -the mount operation.

+the mount operation. +

Default value: NULL

@@ -649,14 +644,15 @@ the mount operation.

The "aborted" signal

void                user_function                      (GMountOperation *arg0,
-                                                        gpointer         user_data)      : Run Last
+ gpointer user_data) : Run Last

Emitted by the backend when e.g. a device becomes unavailable while a mount operation is in progress.

Implementations of GMountOperation should handle this signal -by dismissing open password dialogs.

+by dismissing open password dialogs. +

op :

a GMountOperation +a GMountOperation

result :

a GMountOperationResult +a GMountOperationResult
@@ -670,44 +666,45 @@ by dismissing open password dialogs.

The "ask-password" signal

void                user_function                      (GMountOperation  *op,
-                                                        gchar            *message,
-                                                        gchar            *default_user,
-                                                        gchar            *default_domain,
+                                                        gchar            *message,
+                                                        gchar            *default_user,
+                                                        gchar            *default_domain,
                                                         GAskPasswordFlags flags,
-                                                        gpointer          user_data)           : Run Last
+ gpointer user_data) : Run Last

Emitted when a mount operation asks the user for a password.

If the message contains a line break, the first line should be presented as a heading. For example, it may be used as the -primary text in a GtkMessageDialog.

+primary text in a GtkMessageDialog. +

- - - - - @@ -721,9 +718,9 @@ primary text in a

The "ask-question" signal

void                user_function                      (GMountOperation *op,
-                                                        gchar           *message,
-                                                        GStrv           *choices,
-                                                        gpointer         user_data)      : Run Last
+ gchar *message, + GStrv *choices, + gpointer user_data) : Run Last

Emitted when asking the user a question and gives a list of choices for the user to choose from. @@ -731,23 +728,24 @@ choices for the user to choose from.

If the message contains a line break, the first line should be presented as a heading. For example, it may be used as the -primary text in a GtkMessageDialog.

+primary text in a GtkMessageDialog. +

op :

a GMountOperation requesting a password. +a GMountOperation requesting a password.

message :

string containing a message to display to the user. +string containing a message to display to the user.

default_user :

string containing the default user name. +string containing the default user name.

default_domain :

string containing the default domain. +string containing the default domain.

flags :

a set of GAskPasswordFlags. +a set of GAskPasswordFlags.
- - - @@ -762,20 +760,21 @@ primary text in a

The "reply" signal

void                user_function                      (GMountOperation      *op,
                                                         GMountOperationResult result,
-                                                        gpointer              user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the user has replied to the mount operation.

+Emitted when the user has replied to the mount operation. +

op :

a GMountOperation asking a question. +a GMountOperation asking a question.

message :

string containing a message to display to the user. +string containing a message to display to the user.

choices :

an array of strings for each possible choice. +an array of strings for each possible choice.
- - @@ -789,10 +788,10 @@ Emitted when the user has replied to the mount operation.

The "show-processes" signal

void                user_function                      (GMountOperation *op,
-                                                        gchar           *message,
-                                                        GArray          *processes,
-                                                        GStrv           *choices,
-                                                        gpointer         user_data)      : Run Last
+ gchar *message, + GArray *processes, + GStrv *choices, + gpointer user_data) : Run Last

Emitted when one or more processes are blocking an operation e.g. unmounting/ejecting a GMount or stopping a GDrive. @@ -807,28 +806,29 @@ the user made).

If the message contains a line break, the first line should be presented as a heading. For example, it may be used as the -primary text in a GtkMessageDialog.

+primary text in a GtkMessageDialog. +

op :

a GMountOperation. +a GMountOperation.

result :

a GMountOperationResult indicating how the request was handled +a GMountOperationResult indicating how the request was handled
- - - - @@ -843,6 +843,6 @@ primary text in a
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GNetworkAddress.html b/docs/reference/gio/html/GNetworkAddress.html index 2fc3201..5d71034 100644 --- a/docs/reference/gio/html/GNetworkAddress.html +++ b/docs/reference/gio/html/GNetworkAddress.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

op :

a GMountOperation. +a GMountOperation.

message :

string containing a message to display to the user. +string containing a message to display to the user.

processes :

an array of GPid for processes blocking the operation. +an array of GPid for processes blocking the operation.

choices :

an array of strings for each possible choice. +an array of strings for each possible choice.
@@ -77,19 +47,19 @@ #include <gio/gio.h> GNetworkAddress; -GSocketConnectable * g_network_address_new (const gchar *hostname, - guint16 port); -const gchar * g_network_address_get_hostname (GNetworkAddress *addr); -guint16 g_network_address_get_port (GNetworkAddress *addr); -GSocketConnectable * g_network_address_parse (const gchar *host_and_port, - guint16 default_port, - GError **error); +GSocketConnectable * g_network_address_new (const gchar *hostname, + guint16 port); +const gchar * g_network_address_get_hostname (GNetworkAddress *addr); +guint16 g_network_address_get_port (GNetworkAddress *addr); +GSocketConnectable * g_network_address_parse (const gchar *host_and_port, + guint16 default_port, + GError **error);

Object Hierarchy

-  GObject
+  GObject
    +----GNetworkAddress
 
@@ -102,8 +72,8 @@ GNetworkAddress implements

Properties

-  "hostname"                 gchar*                : Read / Write / Construct Only
-  "port"                     guint                 : Read / Write / Construct Only
+  "hostname"                 gchar*                : Read / Write / Construct Only
+  "port"                     guint                 : Read / Write / Construct Only
 
@@ -115,7 +85,8 @@ multiple IP addresses and multiple address families.

See GSocketConnectable for and example of using the connectable -interface.

+interface. +

Details

@@ -124,27 +95,29 @@ interface.

typedef struct _GNetworkAddress GNetworkAddress;

A GSocketConnectable for resolving a hostname and connecting to -that host.

+that host. +


g_network_address_new ()

-
GSocketConnectable * g_network_address_new              (const gchar *hostname,
-                                                         guint16 port);
+
GSocketConnectable * g_network_address_new              (const gchar *hostname,
+                                                         guint16 port);

Creates a new GSocketConnectable for connecting to the given -hostname and port.

+hostname and port. +

- - @@ -160,16 +133,17 @@ Creates a new

g_network_address_get_hostname ()

-
const gchar *       g_network_address_get_hostname      (GNetworkAddress *addr);
+
const gchar *       g_network_address_get_hostname      (GNetworkAddress *addr);

Gets addr's hostname. This might be either UTF-8 or ASCII-encoded, -depending on what addr was created with.

+depending on what addr was created with. +

hostname :

the hostname +the hostname

port :

the port +the port
- @@ -185,15 +159,16 @@ depending on what addr was created with.

g_network_address_get_port ()

-
guint16             g_network_address_get_port          (GNetworkAddress *addr);
+
guint16             g_network_address_get_port          (GNetworkAddress *addr);

-Gets addr's port number

+Gets addr's port number +

addr :

a GNetworkAddress +a GNetworkAddress
- @@ -209,12 +184,12 @@ Gets addr's port number


g_network_address_parse ()

-
GSocketConnectable * g_network_address_parse            (const gchar *host_and_port,
-                                                         guint16 default_port,
-                                                         GError **error);
+
GSocketConnectable * g_network_address_parse            (const gchar *host_and_port,
+                                                         guint16 default_port,
+                                                         GError **error);

Creates a new GSocketConnectable for connecting to the given -hostname and port. May fail and return NULL in case +hostname and port. May fail and return NULL in case parsing host_and_port fails.

@@ -232,28 +207,29 @@ used as the port number to connect to.

In general, host_and_port is expected to be provided by the user (allowing them to give the hostname, and a port overide if necessary) -and default_port is expected to be provided by the application.

+and default_port is expected to be provided by the application. +

addr :

a GNetworkAddress +a GNetworkAddress
- - - - @@ -266,14 +242,14 @@ and default_port is expected to be provi

Property Details

The "hostname" property

-
  "hostname"                 gchar*                : Read / Write / Construct Only
+
  "hostname"                 gchar*                : Read / Write / Construct Only

Hostname to resolve.

Default value: NULL


The "port" property

-
  "port"                     guint                 : Read / Write / Construct Only
+
  "port"                     guint                 : Read / Write / Construct Only

Network port.

Allowed values: <= 65535

Default value: 0

@@ -282,6 +258,6 @@ and default_port is expected to be provi
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GNetworkService.html b/docs/reference/gio/html/GNetworkService.html index 05fd830..7628858 100644 --- a/docs/reference/gio/html/GNetworkService.html +++ b/docs/reference/gio/html/GNetworkService.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

host_and_port :

the hostname and optionally a port +the hostname and optionally a port

default_port :

the default port if not in host_and_port +the default port if not in host_and_port

error :

a pointer to a GError, or NULL +a pointer to a GError, or NULL

Returns :

the new GNetworkAddress, or NULL on error + the new GNetworkAddress, or NULL on error
@@ -77,18 +47,18 @@ #include <gio/gio.h> GNetworkService; -GSocketConnectable * g_network_service_new (const gchar *service, - const gchar *protocol, - const gchar *domain); -const gchar * g_network_service_get_service (GNetworkService *srv); -const gchar * g_network_service_get_protocol (GNetworkService *srv); -const gchar * g_network_service_get_domain (GNetworkService *srv); +GSocketConnectable * g_network_service_new (const gchar *service, + const gchar *protocol, + const gchar *domain); +const gchar * g_network_service_get_service (GNetworkService *srv); +const gchar * g_network_service_get_protocol (GNetworkService *srv); +const gchar * g_network_service_get_domain (GNetworkService *srv);

Object Hierarchy

-  GObject
+  GObject
    +----GNetworkService
 
@@ -101,9 +71,9 @@ GNetworkService implements

Properties

-  "domain"                   gchar*                : Read / Write / Construct Only
-  "protocol"                 gchar*                : Read / Write / Construct Only
-  "service"                  gchar*                : Read / Write / Construct Only
+  "domain"                   gchar*                : Read / Write / Construct Only
+  "protocol"                 gchar*                : Read / Write / Construct Only
+  "service"                  gchar*                : Read / Write / Construct Only
 
@@ -118,7 +88,8 @@ address families.

See GSrvTarget for more information about SRV records, and see GSocketConnectable for and example of using the connectable -interface.

+interface. +

Details

@@ -127,34 +98,36 @@ interface.

typedef struct _GNetworkService GNetworkService;

A GSocketConnectable for resolving a SRV record and connecting to -that service.

+that service. +


g_network_service_new ()

-
GSocketConnectable * g_network_service_new              (const gchar *service,
-                                                         const gchar *protocol,
-                                                         const gchar *domain);
+
GSocketConnectable * g_network_service_new              (const gchar *service,
+                                                         const gchar *protocol,
+                                                         const gchar *domain);

Creates a new GNetworkService representing the given service, protocol, and domain. This will initially be unresolved; use the -GSocketConnectable interface to resolve it.

+GSocketConnectable interface to resolve it. +

- - - @@ -170,15 +143,16 @@ Creates a new

g_network_service_get_service ()

-
const gchar *       g_network_service_get_service       (GNetworkService *srv);
+
const gchar *       g_network_service_get_service       (GNetworkService *srv);

-Gets srv's service name (eg, "ldap").

+Gets srv's service name (eg, "ldap"). +

service :

the service type to look up (eg, "ldap") +the service type to look up (eg, "ldap")

protocol :

the networking protocol to use for service (eg, "tcp") +the networking protocol to use for service (eg, "tcp")

domain :

the DNS domain to look up the service in +the DNS domain to look up the service in
- @@ -194,15 +168,16 @@ Gets srv's service name (eg, "ldap").

g_network_service_get_protocol ()

-
const gchar *       g_network_service_get_protocol      (GNetworkService *srv);
+
const gchar *       g_network_service_get_protocol      (GNetworkService *srv);

-Gets srv's protocol name (eg, "tcp").

+Gets srv's protocol name (eg, "tcp"). +

srv :

a GNetworkService +a GNetworkService
- @@ -218,16 +193,17 @@ Gets srv's protocol name (eg, "tcp").

g_network_service_get_domain ()

-
const gchar *       g_network_service_get_domain        (GNetworkService *srv);
+
const gchar *       g_network_service_get_domain        (GNetworkService *srv);

Gets the domain that srv serves. This might be either UTF-8 or -ASCII-encoded, depending on what srv was created with.

+ASCII-encoded, depending on what srv was created with. +

srv :

a GNetworkService +a GNetworkService
- @@ -245,21 +221,21 @@ ASCII-encoded, depending on what srv was

Property Details

The "domain" property

-
  "domain"                   gchar*                : Read / Write / Construct Only
+
  "domain"                   gchar*                : Read / Write / Construct Only

Network domain, eg, "example.com".

Default value: NULL


The "protocol" property

-
  "protocol"                 gchar*                : Read / Write / Construct Only
+
  "protocol"                 gchar*                : Read / Write / Construct Only

Network protocol, eg "tcp".

Default value: NULL


The "service" property

-
  "service"                  gchar*                : Read / Write / Construct Only
+
  "service"                  gchar*                : Read / Write / Construct Only

Service name, eg "ldap".

Default value: NULL

@@ -267,6 +243,6 @@ ASCII-encoded, depending on what srv was + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GOutputStream.html b/docs/reference/gio/html/GOutputStream.html index 5292b4c..eeb0f16 100644 --- a/docs/reference/gio/html/GOutputStream.html +++ b/docs/reference/gio/html/GOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

srv :

a GNetworkService +a GNetworkService
@@ -74,76 +44,76 @@ enum GOutputStreamSpliceFlags; GOutputStream; -gssize g_output_stream_write (GOutputStream *stream, - const void *buffer, - gsize count, - GCancellable *cancellable, - GError **error); -gboolean g_output_stream_write_all (GOutputStream *stream, - const void *buffer, - gsize count, - gsize *bytes_written, - GCancellable *cancellable, - GError **error); -gssize g_output_stream_splice (GOutputStream *stream, - GInputStream *source, - GOutputStreamSpliceFlags flags, - GCancellable *cancellable, - GError **error); -gboolean g_output_stream_flush (GOutputStream *stream, - GCancellable *cancellable, - GError **error); -gboolean g_output_stream_close (GOutputStream *stream, - GCancellable *cancellable, - GError **error); -void g_output_stream_write_async (GOutputStream *stream, - const void *buffer, - gsize count, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gssize g_output_stream_write_finish (GOutputStream *stream, - GAsyncResult *result, - GError **error); -void g_output_stream_splice_async (GOutputStream *stream, - GInputStream *source, - GOutputStreamSpliceFlags flags, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gssize g_output_stream_splice_finish (GOutputStream *stream, - GAsyncResult *result, - GError **error); -void g_output_stream_flush_async (GOutputStream *stream, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_output_stream_flush_finish (GOutputStream *stream, - GAsyncResult *result, - GError **error); -void g_output_stream_close_async (GOutputStream *stream, - int io_priority, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_output_stream_close_finish (GOutputStream *stream, - GAsyncResult *result, - GError **error); -gboolean g_output_stream_is_closing (GOutputStream *stream); -gboolean g_output_stream_is_closed (GOutputStream *stream); -gboolean g_output_stream_has_pending (GOutputStream *stream); -gboolean g_output_stream_set_pending (GOutputStream *stream, - GError **error); -void g_output_stream_clear_pending (GOutputStream *stream); +gssize g_output_stream_write (GOutputStream *stream, + const void *buffer, + gsize count, + GCancellable *cancellable, + GError **error); +gboolean g_output_stream_write_all (GOutputStream *stream, + const void *buffer, + gsize count, + gsize *bytes_written, + GCancellable *cancellable, + GError **error); +gssize g_output_stream_splice (GOutputStream *stream, + GInputStream *source, + GOutputStreamSpliceFlags flags, + GCancellable *cancellable, + GError **error); +gboolean g_output_stream_flush (GOutputStream *stream, + GCancellable *cancellable, + GError **error); +gboolean g_output_stream_close (GOutputStream *stream, + GCancellable *cancellable, + GError **error); +void g_output_stream_write_async (GOutputStream *stream, + const void *buffer, + gsize count, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gssize g_output_stream_write_finish (GOutputStream *stream, + GAsyncResult *result, + GError **error); +void g_output_stream_splice_async (GOutputStream *stream, + GInputStream *source, + GOutputStreamSpliceFlags flags, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gssize g_output_stream_splice_finish (GOutputStream *stream, + GAsyncResult *result, + GError **error); +void g_output_stream_flush_async (GOutputStream *stream, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_output_stream_flush_finish (GOutputStream *stream, + GAsyncResult *result, + GError **error); +void g_output_stream_close_async (GOutputStream *stream, + int io_priority, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_output_stream_close_finish (GOutputStream *stream, + GAsyncResult *result, + GError **error); +gboolean g_output_stream_is_closing (GOutputStream *stream); +gboolean g_output_stream_is_closed (GOutputStream *stream); +gboolean g_output_stream_has_pending (GOutputStream *stream); +gboolean g_output_stream_set_pending (GOutputStream *stream, + GError **error); +void g_output_stream_clear_pending (GOutputStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFilterOutputStream
          +----GFileOutputStream
@@ -163,7 +133,8 @@ To copy the content of an input stream to an output stream without
 manually handling the reads and writes, use g_output_stream_splice(). 
 

-All of these functions have async variants too.

+All of these functions have async variants too. +

Details

@@ -176,24 +147,25 @@ All of these functions have async variants too.

} GOutputStreamSpliceFlags;

-GOutputStreamSpliceFlags determine how streams should be spliced.

+GOutputStreamSpliceFlags determine how streams should be spliced. +

- - - @@ -210,23 +182,24 @@ Base class for writing output.

All classes derived from GOutputStream should implement synchronous writing, splicing, flushing and closing streams, but may implement -asynchronous versions.

+asynchronous versions. +


g_output_stream_write ()

-
gssize              g_output_stream_write               (GOutputStream *stream,
-                                                         const void *buffer,
-                                                         gsize count,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_output_stream_write               (GOutputStream *stream,
+                                                         const void *buffer,
+                                                         gsize count,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to write count bytes from buffer into the stream. Will block during the operation.

If count is zero returns zero and does nothing. A value of count -larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error. +larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

On success, the number of bytes written to the stream is returned. @@ -243,33 +216,34 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error.

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

G_OUTPUT_STREAM_SPLICE_NONE

Do not close either stream. +Do not close either stream.

G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE

Close the source stream after +Close the source stream after the splice.

G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET

Close the target stream after +Close the target stream after the splice.
- - - - - @@ -283,12 +257,12 @@ On error -1 is returned and error is set

g_output_stream_write_all ()

-
gboolean            g_output_stream_write_all           (GOutputStream *stream,
-                                                         const void *buffer,
-                                                         gsize count,
-                                                         gsize *bytes_written,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_output_stream_write_all           (GOutputStream *stream,
+                                                         const void *buffer,
+                                                         gsize count,
+                                                         gsize *bytes_written,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to write count bytes from buffer into the stream. Will block during the operation. @@ -298,50 +272,51 @@ This function is similar to count bytes, TRUE is returned, and bytes_written +On a successful write of count bytes, TRUE is returned, and bytes_written is set to count.

If there is an error during the operation FALSE is returned and error is set to indicate the error status, bytes_written is updated to contain -the number of bytes written into the stream before the error occurred.

+the number of bytes written into the stream before the error occurred. +

stream :

a GOutputStream. +a GOutputStream.

buffer :

the buffer containing the data to write. +the buffer containing the data to write.

count :

the number of bytes to write +the number of bytes to write

cancellable :

optional cancellable object +optional cancellable object

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore
- - - - - - - @@ -350,45 +325,46 @@ the number of bytes written into the stream before the error occurred.


g_output_stream_splice ()

-
gssize              g_output_stream_splice              (GOutputStream *stream,
-                                                         GInputStream *source,
-                                                         GOutputStreamSpliceFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_output_stream_splice              (GOutputStream *stream,
+                                                         GInputStream *source,
+                                                         GOutputStreamSpliceFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

-Splices an input stream into an output stream.

+Splices an input stream into an output stream. +

stream :

a GOutputStream. +a GOutputStream.

buffer :

the buffer containing the data to write. +the buffer containing the data to write.

count :

the number of bytes to write +the number of bytes to write

bytes_written :

location to store the number of bytes that was +location to store the number of bytes that was written to the stream

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE if there was an error + TRUE on success, FALSE if there was an error
- - - - - - @@ -398,9 +374,9 @@ ignore.

g_output_stream_flush ()

-
gboolean            g_output_stream_flush               (GOutputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_output_stream_flush               (GOutputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Flushed any outstanding buffers in the stream. Will block during the operation. Closing the stream will implicitly cause a flush. @@ -409,30 +385,31 @@ the operation. Closing the stream will implicitly cause a flush. This function is optional for inherited classes.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

stream :

a GOutputStream. +a GOutputStream.

source :

a GInputStream. +a GInputStream.

flags :

a set of GOutputStreamSpliceFlags. +a set of GOutputStreamSpliceFlags.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a gssize containing the size of the data spliced, or + a gssize containing the size of the data spliced, or -1 if an error occurred.
- - - - @@ -441,9 +418,9 @@ was cancelled, the error

g_output_stream_close ()

-
gboolean            g_output_stream_close               (GOutputStream *stream,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_output_stream_close               (GOutputStream *stream,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Closes the stream, releasing resources related to it.

@@ -479,28 +456,29 @@ was cancelled, the error

stream :

a GOutputStream. +a GOutputStream.

cancellable :

optional cancellable object +optional cancellable object

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE on error + TRUE on success, FALSE on error
- - - - @@ -509,13 +487,13 @@ data will reach the target.


g_output_stream_write_async ()

-
void                g_output_stream_write_async         (GOutputStream *stream,
-                                                         const void *buffer,
-                                                         gsize count,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_output_stream_write_async         (GOutputStream *stream,
+                                                         const void *buffer,
+                                                         gsize count,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Request an asynchronous write of count bytes from buffer into the stream. When the operation is finished callback will be called. @@ -527,7 +505,7 @@ During an async request no other sync and async calls are allowed, and will result in G_IO_ERROR_PENDING errors.

-A value of count larger than G_MAXSSIZE will cause a +A value of count larger than G_MAXSSIZE will cause a G_IO_ERROR_INVALID_ARGUMENT error.

@@ -539,7 +517,7 @@ but generally we try to write as many bytes as requested.

Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower -priority. Default priority is G_PRIORITY_DEFAULT. +priority. Default priority is G_PRIORITY_DEFAULT.

The asyncronous methods have a default fallback that uses threads @@ -548,43 +526,44 @@ classes. However, if you override one you must override all.

For the synchronous, blocking version of this function, see -g_output_stream_write().

+g_output_stream_write(). +

stream :

A GOutputStream. +A GOutputStream.

cancellable :

optional cancellable object +optional cancellable object

error :

location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore

Returns :

TRUE on success, FALSE on failure + TRUE on success, FALSE on failure
- - - - - - - @@ -593,33 +572,34 @@ For the synchronous, blocking version of this function, see

g_output_stream_write_finish ()

-
gssize              g_output_stream_write_finish        (GOutputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gssize              g_output_stream_write_finish        (GOutputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes a stream write operation.

+Finishes a stream write operation. +

stream :

A GOutputStream. +A GOutputStream.

buffer :

the buffer containing the data to write. +the buffer containing the data to write.

count :

the number of bytes to write +the number of bytes to write

io_priority :

the io priority of the request. +the io priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -628,13 +608,13 @@ ignore.

g_output_stream_splice_async ()

-
void                g_output_stream_splice_async        (GOutputStream *stream,
-                                                         GInputStream *source,
-                                                         GOutputStreamSpliceFlags flags,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_output_stream_splice_async        (GOutputStream *stream,
+                                                         GInputStream *source,
+                                                         GOutputStreamSpliceFlags flags,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Splices a stream asynchronously. When the operation is finished callback will be called. @@ -643,43 +623,44 @@ result of the operation.

For the synchronous, blocking version of this function, see -g_output_stream_splice().

+g_output_stream_splice(). +

stream :

a GOutputStream. +a GOutputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a gssize containing the number of bytes written to the stream. + a gssize containing the number of bytes written to the stream.
- - - - - - - @@ -688,33 +669,34 @@ For the synchronous, blocking version of this function, see

g_output_stream_splice_finish ()

-
gssize              g_output_stream_splice_finish       (GOutputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gssize              g_output_stream_splice_finish       (GOutputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes an asynchronous stream splice operation.

+Finishes an asynchronous stream splice operation. +

stream :

a GOutputStream. +a GOutputStream.

source :

a GInputStream. +a GInputStream.

flags :

a set of GOutputStreamSpliceFlags. +a set of GOutputStreamSpliceFlags.

io_priority :

the io priority of the request. +the io priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -723,11 +705,11 @@ ignore.

g_output_stream_flush_async ()

-
void                g_output_stream_flush_async         (GOutputStream *stream,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_output_stream_flush_async         (GOutputStream *stream,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Flushes a stream asynchronously. For behaviour details see g_output_stream_flush(). @@ -735,33 +717,34 @@ For behaviour details see callback will be called. You can then call g_output_stream_flush_finish() to get the -result of the operation.

+result of the operation. +

stream :

a GOutputStream. +a GOutputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a gssize of the number of bytes spliced. + a gssize of the number of bytes spliced.
- - - - - @@ -770,33 +753,34 @@ result of the operation.


g_output_stream_flush_finish ()

-
gboolean            g_output_stream_flush_finish        (GOutputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_output_stream_flush_finish        (GOutputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes flushing an output stream.

+Finishes flushing an output stream. +

stream :

a GOutputStream. +a GOutputStream.

io_priority :

the io priority of the request. +the io priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -805,11 +789,11 @@ ignore.

g_output_stream_close_async ()

-
void                g_output_stream_close_async         (GOutputStream *stream,
-                                                         int io_priority,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_output_stream_close_async         (GOutputStream *stream,
+                                                         int io_priority,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Requests an asynchronous close of the stream, releasing resources related to it. When the operation is finished callback will be @@ -822,33 +806,34 @@ For behaviour details see

stream :

a GOutputStream. +a GOutputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if flush operation suceeded, FALSE otherwise. + TRUE if flush operation suceeded, FALSE otherwise.
- - - - - @@ -857,33 +842,34 @@ classes. However, if you override one you must override all.


g_output_stream_close_finish ()

-
gboolean            g_output_stream_close_finish        (GOutputStream *stream,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_output_stream_close_finish        (GOutputStream *stream,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Closes an output stream.

+Closes an output stream. +

stream :

A GOutputStream. +A GOutputStream.

io_priority :

the io priority of the request. +the io priority of the request.

cancellable :

optional cancellable object +optional cancellable object

callback :

callback to call when the request is satisfied +callback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -892,23 +878,24 @@ ignore.

g_output_stream_is_closing ()

-
gboolean            g_output_stream_is_closing          (GOutputStream *stream);
+
gboolean            g_output_stream_is_closing          (GOutputStream *stream);

Checks if an output stream is being closed. This can be used inside e.g. a flush implementation to see if the flush (or other i/o operation) is called from within -the closing operation.

+the closing operation. +

stream :

a GOutputStream. +a GOutputStream.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if stream was successfully closed, FALSE otherwise. + TRUE if stream was successfully closed, FALSE otherwise.
- - @@ -919,20 +906,21 @@ the closing operation.


g_output_stream_is_closed ()

-
gboolean            g_output_stream_is_closed           (GOutputStream *stream);
+
gboolean            g_output_stream_is_closed           (GOutputStream *stream);

-Checks if an output stream has already been closed.

+Checks if an output stream has already been closed. +

stream :

a GOutputStream. +a GOutputStream.

Returns :

TRUE if stream is being closed. FALSE otherwise. + TRUE if stream is being closed. FALSE otherwise.
- - @@ -941,20 +929,21 @@ Checks if an output stream has already been closed.


g_output_stream_has_pending ()

-
gboolean            g_output_stream_has_pending         (GOutputStream *stream);
+
gboolean            g_output_stream_has_pending         (GOutputStream *stream);

-Checks if an ouput stream has pending actions.

+Checks if an ouput stream has pending actions. +

stream :

a GOutputStream. +a GOutputStream.

Returns :

TRUE if stream is closed. FALSE otherwise. + TRUE if stream is closed. FALSE otherwise.
- - @@ -963,29 +952,30 @@ Checks if an ouput stream has pending actions.


g_output_stream_set_pending ()

-
gboolean            g_output_stream_set_pending         (GOutputStream *stream,
-                                                         GError **error);
+
gboolean            g_output_stream_set_pending         (GOutputStream *stream,
+                                                         GError **error);

Sets stream to have actions pending. If the pending flag is -already set or stream is closed, it will return FALSE and set -error.

+already set or stream is closed, it will return FALSE and set +error. +

stream :

a GOutputStream. +a GOutputStream.

Returns :

TRUE if stream has pending actions. + TRUE if stream has pending actions.
- - - @@ -994,14 +984,15 @@ ignore.

g_output_stream_clear_pending ()

-
void                g_output_stream_clear_pending       (GOutputStream *stream);
+
void                g_output_stream_clear_pending       (GOutputStream *stream);

-Clears the pending flag on stream.

+Clears the pending flag on stream. +

stream :

a GOutputStream. +a GOutputStream.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if pending was previously unset and is now set. + TRUE if pending was previously unset and is now set.
-

stream :

output stream +output stream
@@ -1010,6 +1001,6 @@ Clears the pending flag on stream.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GResolver.html b/docs/reference/gio/html/GResolver.html index b634768..aecdd6a 100644 --- a/docs/reference/gio/html/GResolver.html +++ b/docs/reference/gio/html/GResolver.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -75,50 +45,50 @@ #include <gio/gio.h> GResolver; -GResolver * g_resolver_get_default (void); -voidg_resolver_set_default (GResolver *resolver); -GList * g_resolver_lookup_by_name (GResolver *resolver, - const gchar *hostname, - GCancellable *cancellable, - GError **error); -voidg_resolver_lookup_by_name_async (GResolver *resolver, - const gchar *hostname, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GList * g_resolver_lookup_by_name_finish (GResolver *resolver, - GAsyncResult *result, - GError **error); -voidg_resolver_free_addresses (GList *addresses); -gchar * g_resolver_lookup_by_address (GResolver *resolver, - GInetAddress *address, - GCancellable *cancellable, - GError **error); -voidg_resolver_lookup_by_address_async (GResolver *resolver, - GInetAddress *address, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gchar * g_resolver_lookup_by_address_finish (GResolver *resolver, - GAsyncResult *result, - GError **error); -GList * g_resolver_lookup_service (GResolver *resolver, - const gchar *service, - const gchar *protocol, - const gchar *domain, - GCancellable *cancellable, - GError **error); -voidg_resolver_lookup_service_async (GResolver *resolver, - const gchar *service, - const gchar *protocol, - const gchar *domain, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GList * g_resolver_lookup_service_finish (GResolver *resolver, - GAsyncResult *result, - GError **error); -voidg_resolver_free_targets (GList *targets); +GResolver * g_resolver_get_default (void); +voidg_resolver_set_default (GResolver *resolver); +GList * g_resolver_lookup_by_name (GResolver *resolver, + const gchar *hostname, + GCancellable *cancellable, + GError **error); +voidg_resolver_lookup_by_name_async (GResolver *resolver, + const gchar *hostname, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GList * g_resolver_lookup_by_name_finish (GResolver *resolver, + GAsyncResult *result, + GError **error); +voidg_resolver_free_addresses (GList *addresses); +gchar * g_resolver_lookup_by_address (GResolver *resolver, + GInetAddress *address, + GCancellable *cancellable, + GError **error); +voidg_resolver_lookup_by_address_async (GResolver *resolver, + GInetAddress *address, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gchar * g_resolver_lookup_by_address_finish (GResolver *resolver, + GAsyncResult *result, + GError **error); +GList * g_resolver_lookup_service (GResolver *resolver, + const gchar *service, + const gchar *protocol, + const gchar *domain, + GCancellable *cancellable, + GError **error); +voidg_resolver_lookup_service_async (GResolver *resolver, + const gchar *service, + const gchar *protocol, + const gchar *domain, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GList * g_resolver_lookup_service_finish (GResolver *resolver, + GAsyncResult *result, + GError **error); +voidg_resolver_free_targets (GList *targets); #define G_RESOLVER_ERROR enum GResolverError; @@ -127,7 +97,7 @@ enum

Object Hierarchy

-  GObject
+  GObject
    +----GResolver
 
@@ -148,7 +118,8 @@ resolution, for hostnames (GNetworkAddress and GNetworkService provide wrappers around GResolver functionality that also implement GSocketConnectable, -making it easy to connect to a remote host/service.

+making it easy to connect to a remote host/service. +

Details

@@ -157,17 +128,19 @@ making it easy to connect to a remote host/service.

typedef struct _GResolver GResolver;

The object that handles DNS resolution. Use g_resolver_get_default() -to get the default resolver.

+to get the default resolver. +


g_resolver_get_default ()

-
GResolver *         g_resolver_get_default              (void);
+
GResolver *         g_resolver_get_default              (void);

Gets the default GResolver. You should unref it when you are done with it. GResolver may use its reference count as a hint about how many threads/processes, etc it should allocate for concurrent DNS -resolutions.

+resolutions. +

@@ -182,7 +155,7 @@ resolutions.


g_resolver_set_default ()

-
void                g_resolver_set_default              (GResolver *resolver);
+
void                g_resolver_set_default              (GResolver *resolver);

Sets resolver to be the application's default resolver (reffing resolver, and unreffing the previous default resolver, if any). @@ -193,12 +166,13 @@ This can be used if an application wants to perform any sort of DNS caching or "pinning"; it can implement its own GResolver that calls the original default resolver for DNS operations, and implements its own cache policies on top of that, and then set -itself as the default resolver for all later code to use.

+itself as the default resolver for all later code to use. +

-

resolver :

the new default GResolver +the new default GResolver
@@ -207,10 +181,10 @@ itself as the default resolver for all later code to use.


g_resolver_lookup_by_name ()

-
GList *             g_resolver_lookup_by_name           (GResolver *resolver,
-                                                         const gchar *hostname,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GList *             g_resolver_lookup_by_name           (GResolver *resolver,
+                                                         const gchar *hostname,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Synchronously resolves hostname to determine its associated IP address(es). hostname may be an ASCII-only or UTF-8 hostname, or @@ -218,50 +192,51 @@ the textual form of an IP address (in which case this just becomes a wrapper around g_inet_address_new_from_string()).

-On success, g_resolver_lookup_by_name() will return a GList of +On success, g_resolver_lookup_by_name() will return a GList of GInetAddress, sorted in order of preference. (That is, you should attempt to connect to the first address first, then the second if the first fails, etc.)

-If the DNS resolution fails, error (if non-NULL) will be set to a +If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError.

-If cancellable is non-NULL, it can be used to cancel the -operation, in which case error (if non-NULL) will be set to +If cancellable is non-NULL, it can be used to cancel the +operation, in which case error (if non-NULL) will be set to G_IO_ERROR_CANCELLED.

If you are planning to connect to a socket on the resolved IP address, it may be easier to create a GNetworkAddress and use its -GSocketConnectable interface.

+GSocketConnectable interface. +

- - - - -

resolver :

a GResolver +a GResolver

hostname :

the hostname to look up +the hostname to look up

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GList of GInetAddress, or NULL on error. You + a GList of GInetAddress, or NULL on error. You must unref each of the addresses and free the list when you are done with it. (You can use g_resolver_free_addresses() to do this.) @@ -274,42 +249,43 @@ done with it. (You can use

g_resolver_lookup_by_name_async ()

-
void                g_resolver_lookup_by_name_async     (GResolver *resolver,
-                                                         const gchar *hostname,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_resolver_lookup_by_name_async     (GResolver *resolver,
+                                                         const gchar *hostname,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls callback, which must call g_resolver_lookup_by_name_finish() to get the result. -See g_resolver_lookup_by_name() for more details.

+See g_resolver_lookup_by_name() for more details. +

- - - - - @@ -319,38 +295,39 @@ See

g_resolver_lookup_by_name_finish ()

-
GList *             g_resolver_lookup_by_name_finish    (GResolver *resolver,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GList *             g_resolver_lookup_by_name_finish    (GResolver *resolver,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Retrieves the result of a call to g_resolver_lookup_by_name_async().

-If the DNS resolution failed, error (if non-NULL) will be set to +If the DNS resolution failed, error (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, -error will be set to G_IO_ERROR_CANCELLED.

+error will be set to G_IO_ERROR_CANCELLED. +

resolver :

a GResolver +a GResolver

hostname :

the hostname to look up the address of +the hostname to look up the address of

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

callback to call after resolution completes +callback to call after resolution completes

user_data :

data for callback +data for callback
- - - - @@ -362,17 +339,18 @@ a value from

g_resolver_free_addresses ()

-
void                g_resolver_free_addresses           (GList *addresses);
+
void                g_resolver_free_addresses           (GList *addresses);

Frees addresses (which should be the return value from g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()). (This is a convenience method; you can also simply free the results -by hand.)

+by hand.) +

resolver :

a GResolver +a GResolver

result :

the result passed to your GAsyncReadyCallback +the result passed to your GAsyncReadyCallback

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GList of GInetAddress, or NULL on error. See + a GList of GInetAddress, or NULL on error. See g_resolver_lookup_by_name() for more details.
-

addresses :

a GList of GInetAddress +a GList of GInetAddress
@@ -381,49 +359,50 @@ by hand.)


g_resolver_lookup_by_address ()

-
gchar *             g_resolver_lookup_by_address        (GResolver *resolver,
-                                                         GInetAddress *address,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gchar *             g_resolver_lookup_by_address        (GResolver *resolver,
+                                                         GInetAddress *address,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Synchronously reverse-resolves address to determine its associated hostname.

-If the DNS resolution fails, error (if non-NULL) will be set to +If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError.

-If cancellable is non-NULL, it can be used to cancel the -operation, in which case error (if non-NULL) will be set to -G_IO_ERROR_CANCELLED.

+If cancellable is non-NULL, it can be used to cancel the +operation, in which case error (if non-NULL) will be set to +G_IO_ERROR_CANCELLED. +

- - - - @@ -434,41 +413,42 @@ operation, in which case error (if non-<

g_resolver_lookup_by_address_async ()

-
void                g_resolver_lookup_by_address_async  (GResolver *resolver,
-                                                         GInetAddress *address,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_resolver_lookup_by_address_async  (GResolver *resolver,
+                                                         GInetAddress *address,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Begins asynchronously reverse-resolving address to determine its associated hostname, and eventually calls callback, which must -call g_resolver_lookup_by_address_finish() to get the final result.

+call g_resolver_lookup_by_address_finish() to get the final result. +

resolver :

a GResolver +a GResolver

address :

the address to reverse-resolve +the address to reverse-resolve

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a hostname (either ASCII-only, or in ASCII-encoded - form), or NULL on error. + form), or NULL on error.
- - - - - @@ -478,39 +458,40 @@ call

g_resolver_lookup_by_address_finish ()

-
gchar *             g_resolver_lookup_by_address_finish (GResolver *resolver,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gchar *             g_resolver_lookup_by_address_finish (GResolver *resolver,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Retrieves the result of a previous call to g_resolver_lookup_by_address_async().

-If the DNS resolution failed, error (if non-NULL) will be set to +If the DNS resolution failed, error (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, -error will be set to G_IO_ERROR_CANCELLED.

+error will be set to G_IO_ERROR_CANCELLED. +

resolver :

a GResolver +a GResolver

address :

the address to reverse-resolve +the address to reverse-resolve

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

callback to call after resolution completes +callback to call after resolution completes

user_data :

data for callback +data for callback
- - - @@ -521,12 +502,12 @@ form), or

g_resolver_lookup_service ()

-
GList *             g_resolver_lookup_service           (GResolver *resolver,
-                                                         const gchar *service,
-                                                         const gchar *protocol,
-                                                         const gchar *domain,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GList *             g_resolver_lookup_service           (GResolver *resolver,
+                                                         const gchar *service,
+                                                         const gchar *protocol,
+                                                         const gchar *domain,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Synchronously performs a DNS SRV lookup for the given service and protocol in the given domain and returns an array of GSrvTarget. @@ -536,60 +517,61 @@ include the leading underscore that appears in the actual DNS entry.

-On success, g_resolver_lookup_service() will return a GList of +On success, g_resolver_lookup_service() will return a GList of GSrvTarget, sorted in order of preference. (That is, you should attempt to connect to the first target first, then the second if the first fails, etc.)

-If the DNS resolution fails, error (if non-NULL) will be set to +If the DNS resolution fails, error (if non-NULL) will be set to a value from GResolverError.

-If cancellable is non-NULL, it can be used to cancel the -operation, in which case error (if non-NULL) will be set to +If cancellable is non-NULL, it can be used to cancel the +operation, in which case error (if non-NULL) will be set to G_IO_ERROR_CANCELLED.

If you are planning to connect to the service, it is usually easier to create a GNetworkService and use its GSocketConnectable -interface.

+interface. +

resolver :

a GResolver +a GResolver

result :

the result passed to your GAsyncReadyCallback +the result passed to your GAsyncReadyCallback

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a hostname (either ASCII-only, or in ASCII-encoded -form), or NULL on error. +form), or NULL on error.
- - - - - - -

resolver :

a GResolver +a GResolver

service :

the service type to look up (eg, "ldap") +the service type to look up (eg, "ldap")

protocol :

the networking protocol to use for service (eg, "tcp") +the networking protocol to use for service (eg, "tcp")

domain :

the DNS domain to look up the service in +the DNS domain to look up the service in

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GList of GSrvTarget, or NULL on error. You must + a GList of GSrvTarget, or NULL on error. You must free each of the targets and the list when you are done with it. (You can use g_resolver_free_targets() to do this.) @@ -602,55 +584,56 @@ free each of the targets and the list when you are done with it.

g_resolver_lookup_service_async ()

-
void                g_resolver_lookup_service_async     (GResolver *resolver,
-                                                         const gchar *service,
-                                                         const gchar *protocol,
-                                                         const gchar *domain,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_resolver_lookup_service_async     (GResolver *resolver,
+                                                         const gchar *service,
+                                                         const gchar *protocol,
+                                                         const gchar *domain,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback, which must call g_resolver_lookup_service_finish() to get the final result. See g_resolver_lookup_service() for more -details.

+details. +

- - - - - - - @@ -660,38 +643,39 @@ details.


g_resolver_lookup_service_finish ()

-
GList *             g_resolver_lookup_service_finish    (GResolver *resolver,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GList *             g_resolver_lookup_service_finish    (GResolver *resolver,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Retrieves the result of a previous call to g_resolver_lookup_service_async().

-If the DNS resolution failed, error (if non-NULL) will be set to +If the DNS resolution failed, error (if non-NULL) will be set to a value from GResolverError. If the operation was cancelled, -error will be set to G_IO_ERROR_CANCELLED.

+error will be set to G_IO_ERROR_CANCELLED. +

resolver :

a GResolver +a GResolver

service :

the service type to look up (eg, "ldap") +the service type to look up (eg, "ldap")

protocol :

the networking protocol to use for service (eg, "tcp") +the networking protocol to use for service (eg, "tcp")

domain :

the DNS domain to look up the service in +the DNS domain to look up the service in

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

callback to call after resolution completes +callback to call after resolution completes

user_data :

data for callback +data for callback
- - - - @@ -703,17 +687,18 @@ a value from

g_resolver_free_targets ()

-
void                g_resolver_free_targets             (GList *targets);
+
void                g_resolver_free_targets             (GList *targets);

Frees targets (which should be the return value from g_resolver_lookup_service() or g_resolver_lookup_service_finish()). (This is a convenience method; you can also simply free the -results by hand.)

+results by hand.) +

resolver :

a GResolver +a GResolver

result :

the result passed to your GAsyncReadyCallback +the result passed to your GAsyncReadyCallback

error :

return location for a GError, or NULL +return location for a GError, or NULL

Returns :

a GList of GSrvTarget, or NULL on error. See + a GList of GSrvTarget, or NULL on error. See g_resolver_lookup_service() for more details.
-

targets :

a GList of GSrvTarget +a GList of GSrvTarget
@@ -726,8 +711,9 @@ results by hand.)

Error domain for GResolver. Errors in this domain will be from the -GResolverError enumeration. See GError for more information on -error domains.

+GResolverError enumeration. See GError for more information on +error domains. +


@@ -739,26 +725,27 @@ error domains.

} GResolverError;

-An error code used with G_RESOLVER_ERROR in a GError returned -from a GResolver routine.

+An error code used with G_RESOLVER_ERROR in a GError returned +from a GResolver routine. +

- - - @@ -771,16 +758,17 @@ from a

The "reload" signal

void                user_function                      (GResolver *resolver,
-                                                        gpointer   user_data)      : Run Last
+ gpointer user_data) : Run Last

Emitted when the resolver notices that the system resolver -configuration has changed.

+configuration has changed. +

G_RESOLVER_ERROR_NOT_FOUND

the requested name/address/service was not +the requested name/address/service was not found

G_RESOLVER_ERROR_TEMPORARY_FAILURE

the requested information could not +the requested information could not be looked up due to a network error or similar problem

G_RESOLVER_ERROR_INTERNAL

unknown error +unknown error
- @@ -794,6 +782,6 @@ configuration has changed.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSeekable.html b/docs/reference/gio/html/GSeekable.html index 5962821..ced9013 100644 --- a/docs/reference/gio/html/GSeekable.html +++ b/docs/reference/gio/html/GSeekable.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

resolver :

a GResolver +a GResolver
@@ -78,18 +48,18 @@ GSeekable; GSeekableIface; -goffsetg_seekable_tell (GSeekable *seekable); -gbooleang_seekable_can_seek (GSeekable *seekable); -gbooleang_seekable_seek (GSeekable *seekable, - goffset offset, - GSeekType type, - GCancellable *cancellable, - GError **error); -gbooleang_seekable_can_truncate (GSeekable *seekable); -gbooleang_seekable_truncate (GSeekable *seekable, - goffset offset, - GCancellable *cancellable, - GError **error); +goffsetg_seekable_tell (GSeekable *seekable); +gbooleang_seekable_can_seek (GSeekable *seekable); +gbooleang_seekable_seek (GSeekable *seekable, + goffset offset, + GSeekType type, + GCancellable *cancellable, + GError **error); +gbooleang_seekable_can_truncate (GSeekable *seekable); +gbooleang_seekable_truncate (GSeekable *seekable, + goffset offset, + GCancellable *cancellable, + GError **error);
@@ -103,19 +73,20 @@

Prerequisites

GSeekable requires - GObject.

+ GObject.

Description

GSeekable is implemented by streams (implementations of -GInputStream or GOutputStream) that support seeking.

+GInputStream or GOutputStream) that support seeking. +

Details

@@ -123,7 +94,8 @@ GSeekable is implemented by

GSeekable

typedef struct _GSeekable GSeekable;

-Seek object for streaming operations.

+Seek object for streaming operations. +


@@ -152,38 +124,39 @@ Seek object for streaming operations.

} GSeekableIface;

-Provides an interface for implementing seekable functionality on I/O Streams.

+Provides an interface for implementing seekable functionality on I/O Streams. +

- - + - - - - - @@ -192,15 +165,16 @@ Provides an interface for implementing seekable functionality on I/O Streams.

g_seekable_tell ()

-
goffset             g_seekable_tell                     (GSeekable *seekable);
+
goffset             g_seekable_tell                     (GSeekable *seekable);

-Tells the current position within the stream.

+Tells the current position within the stream. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

tell ()

Tells the current location within a stream. +Tells the current location within a stream.

can_seek ()

Checks if seeking is supported by the stream. +Checks if seeking is supported by the stream.

seek ()

Seeks to a location within a stream. +Seeks to a location within a stream.

can_truncate ()

Chekcs if truncation is suppored by the stream. +Chekcs if truncation is suppored by the stream.

truncate_fn ()

Truncates a stream. +Truncates a stream.
- @@ -214,20 +188,21 @@ Tells the current position within the stream.


g_seekable_can_seek ()

-
gboolean            g_seekable_can_seek                 (GSeekable *seekable);
+
gboolean            g_seekable_can_seek                 (GSeekable *seekable);

-Tests if the stream supports the GSeekableIface.

+Tests if the stream supports the GSeekableIface. +

seekable :

a GSeekable. +a GSeekable.
- - @@ -236,51 +211,52 @@ Tests if the stream supports the

g_seekable_seek ()

-
gboolean            g_seekable_seek                     (GSeekable *seekable,
-                                                         goffset offset,
-                                                         GSeekType type,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_seekable_seek                     (GSeekable *seekable,
+                                                         goffset offset,
+                                                         GSeekType type,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Seeks in the stream by the given offset, modified by type.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

seekable :

a GSeekable. +a GSeekable.

Returns :

TRUE if seekable can be seeked. FALSE otherwise. + TRUE if seekable can be seeked. FALSE otherwise.
- - - - - - @@ -290,20 +266,21 @@ ignore.

g_seekable_can_truncate ()

-
gboolean            g_seekable_can_truncate             (GSeekable *seekable);
+
gboolean            g_seekable_can_truncate             (GSeekable *seekable);

-Tests if the stream can be truncated.

+Tests if the stream can be truncated. +

seekable :

a GSeekable. +a GSeekable.

offset :

a goffset. +a goffset.

type :

a GSeekType. +a GSeekType.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if successful. If an error - has occurred, this function will return FALSE and set error + TRUE if successful. If an error + has occurred, this function will return FALSE and set error appropriately if present.
- - @@ -312,47 +289,48 @@ Tests if the stream can be truncated.


g_seekable_truncate ()

-
gboolean            g_seekable_truncate                 (GSeekable *seekable,
-                                                         goffset offset,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_seekable_truncate                 (GSeekable *seekable,
+                                                         goffset offset,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Truncates a stream with a given offset.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the -partial result will be returned, without an error.

+partial result will be returned, without an error. +

seekable :

a GSeekable. +a GSeekable.

Returns :

TRUE if the stream can be truncated, FALSE otherwise. + TRUE if the stream can be truncated, FALSE otherwise.
- - - - - @@ -367,6 +345,6 @@ ignore. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSimpleAsyncResult.html b/docs/reference/gio/html/GSimpleAsyncResult.html index 1b02785..8934874 100644 --- a/docs/reference/gio/html/GSimpleAsyncResult.html +++ b/docs/reference/gio/html/GSimpleAsyncResult.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

seekable :

a GSeekable. +a GSeekable.

offset :

a goffset. +a goffset.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if successful. If an error - has occurred, this function will return FALSE and set error + TRUE if successful. If an error + has occurred, this function will return FALSE and set error appropriately if present.
@@ -75,90 +45,90 @@ #include <gio/gio.h> GSimpleAsyncResult; -void (*GSimpleAsyncThreadFunc) (GSimpleAsyncResult *res, - GObject *object, - GCancellable *cancellable); -GSimpleAsyncResult * g_simple_async_result_new (GObject *source_object, - GAsyncReadyCallback callback, - gpointer user_data, - gpointer source_tag); -GSimpleAsyncResult * g_simple_async_result_new_error (GObject *source_object, - GAsyncReadyCallback callback, - gpointer user_data, - GQuark domain, - gint code, - const char *format, - ...); +void (*GSimpleAsyncThreadFunc) (GSimpleAsyncResult *res, + GObject *object, + GCancellable *cancellable); +GSimpleAsyncResult * g_simple_async_result_new (GObject *source_object, + GAsyncReadyCallback callback, + gpointer user_data, + gpointer source_tag); +GSimpleAsyncResult * g_simple_async_result_new_error (GObject *source_object, + GAsyncReadyCallback callback, + gpointer user_data, + GQuark domain, + gint code, + const char *format, + ...); GSimpleAsyncResult * g_simple_async_result_new_from_error - (GObject *source_object, - GAsyncReadyCallback callback, - gpointer user_data, - GError *error); + (GObject *source_object, + GAsyncReadyCallback callback, + gpointer user_data, + GError *error); voidg_simple_async_result_set_op_res_gpointer - (GSimpleAsyncResult *simple, - gpointer op_res, - GDestroyNotify destroy_op_res); -gpointerg_simple_async_result_get_op_res_gpointer - (GSimpleAsyncResult *simple); + (GSimpleAsyncResult *simple, + gpointer op_res, + GDestroyNotify destroy_op_res); +gpointerg_simple_async_result_get_op_res_gpointer + (GSimpleAsyncResult *simple); voidg_simple_async_result_set_op_res_gssize - (GSimpleAsyncResult *simple, - gssize op_res); -gssizeg_simple_async_result_get_op_res_gssize - (GSimpleAsyncResult *simple); + (GSimpleAsyncResult *simple, + gssize op_res); +gssizeg_simple_async_result_get_op_res_gssize + (GSimpleAsyncResult *simple); voidg_simple_async_result_set_op_res_gboolean - (GSimpleAsyncResult *simple, - gboolean op_res); -gbooleang_simple_async_result_get_op_res_gboolean - (GSimpleAsyncResult *simple); -gpointerg_simple_async_result_get_source_tag - (GSimpleAsyncResult *simple); -gbooleang_simple_async_result_is_valid (GAsyncResult *result, - GObject *source, - gpointer source_tag); + (GSimpleAsyncResult *simple, + gboolean op_res); +gbooleang_simple_async_result_get_op_res_gboolean + (GSimpleAsyncResult *simple); +gpointerg_simple_async_result_get_source_tag + (GSimpleAsyncResult *simple); +gbooleang_simple_async_result_is_valid (GAsyncResult *result, + GObject *source, + gpointer source_tag); voidg_simple_async_result_set_handle_cancellation - (GSimpleAsyncResult *simple, - gboolean handle_cancellation); -voidg_simple_async_result_complete (GSimpleAsyncResult *simple); + (GSimpleAsyncResult *simple, + gboolean handle_cancellation); +voidg_simple_async_result_complete (GSimpleAsyncResult *simple); voidg_simple_async_result_complete_in_idle - (GSimpleAsyncResult *simple); -voidg_simple_async_result_run_in_thread (GSimpleAsyncResult *simple, - GSimpleAsyncThreadFunc func, - int io_priority, - GCancellable *cancellable); + (GSimpleAsyncResult *simple); +voidg_simple_async_result_run_in_thread (GSimpleAsyncResult *simple, + GSimpleAsyncThreadFunc func, + int io_priority, + GCancellable *cancellable); voidg_simple_async_result_set_from_error - (GSimpleAsyncResult *simple, - const GError *error); -gbooleang_simple_async_result_propagate_error - (GSimpleAsyncResult *simple, - GError **dest); -voidg_simple_async_result_set_error (GSimpleAsyncResult *simple, - GQuark domain, - gint code, - const char *format, - ...); -voidg_simple_async_result_set_error_va (GSimpleAsyncResult *simple, - GQuark domain, - gint code, - const char *format, - va_list args); -voidg_simple_async_report_error_in_idle (GObject *object, - GAsyncReadyCallback callback, - gpointer user_data, - GQuark domain, - gint code, - const char *format, - ...); + (GSimpleAsyncResult *simple, + const GError *error); +gbooleang_simple_async_result_propagate_error + (GSimpleAsyncResult *simple, + GError **dest); +voidg_simple_async_result_set_error (GSimpleAsyncResult *simple, + GQuark domain, + gint code, + const char *format, + ...); +voidg_simple_async_result_set_error_va (GSimpleAsyncResult *simple, + GQuark domain, + gint code, + const char *format, + va_list args); +voidg_simple_async_report_error_in_idle (GObject *object, + GAsyncReadyCallback callback, + gpointer user_data, + GQuark domain, + gint code, + const char *format, + ...); voidg_simple_async_report_gerror_in_idle - (GObject *object, - GAsyncReadyCallback callback, - gpointer user_data, - GError *error); + (GObject *object, + GAsyncReadyCallback callback, + gpointer user_data, + GError *error);

Object Hierarchy

-  GObject
+  GObject
    +----GSimpleAsyncResult
 
@@ -182,7 +152,7 @@ reporting, operation cancellation and the final state of an operation, completely transparent to the application. Results can be returned as a pointer e.g. for functions that return data that is collected asynchronously, a boolean value for checking the success or failure -of an operation, or a gssize for operations which return the number +of an operation, or a gssize for operations which return the number of bytes modified by the operation; all of the simple return cases are covered.

@@ -201,9 +171,9 @@ together correctly.

To create a new GSimpleAsyncResult, call g_simple_async_result_new(). -If the result needs to be created for a GError, use -g_simple_async_result_new_from_error(). If a GError is not available -(e.g. the asynchronous operation's doesn't take a GError argument), +If the result needs to be created for a GError, use +g_simple_async_result_new_from_error(). If a GError is not available +(e.g. the asynchronous operation's doesn't take a GError argument), but the result still needs to be created for an error condition, use g_simple_async_result_new_error() (or g_simple_async_result_set_error_va() if your application or binding requires passing a variable argument list @@ -213,13 +183,13 @@ directly), and the error can then be propagated through the use of

An asynchronous operation can be made to ignore a cancellation event by calling g_simple_async_result_set_handle_cancellation() with a -GSimpleAsyncResult for the operation and FALSE. This is useful for +GSimpleAsyncResult for the operation and FALSE. This is useful for operations that are dangerous to cancel, such as close (which would cause a leak if cancelled before being run).

-GSimpleAsyncResult can integrate into GLib's event loop, GMainLoop, -or it can use GThreads if available. +GSimpleAsyncResult can integrate into GLib's event loop, GMainLoop, +or it can use GThreads if available. g_simple_async_result_complete() will finish an I/O task directly from the point where it is called. g_simple_async_result_complete_in_idle() will finish it from an idle handler in the thread-default main @@ -241,7 +211,8 @@ Likewise, to get the result of an asynchronous function, g_simple_async_result_get_op_res_gboolean(), and g_simple_async_result_get_op_res_gssize() are provided, getting the operation's result as a gpointer, gboolean, and -gssize, respectively.

+gssize, respectively. +

Details

@@ -249,33 +220,35 @@ gssize, respectively.

GSimpleAsyncResult

typedef struct _GSimpleAsyncResult GSimpleAsyncResult;

-A simple implementation of GAsyncResult.

+A simple implementation of GAsyncResult. +


GSimpleAsyncThreadFunc ()

-
void                (*GSimpleAsyncThreadFunc)           (GSimpleAsyncResult *res,
-                                                         GObject *object,
-                                                         GCancellable *cancellable);
+
void                (*GSimpleAsyncThreadFunc)           (GSimpleAsyncResult *res,
+                                                         GObject *object,
+                                                         GCancellable *cancellable);

Simple thread function that runs an asynchronous operation and -checks for cancellation.

+checks for cancellation. +

- - - @@ -284,34 +257,35 @@ checks for cancellation.


g_simple_async_result_new ()

-
GSimpleAsyncResult * g_simple_async_result_new          (GObject *source_object,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         gpointer source_tag);
+
GSimpleAsyncResult * g_simple_async_result_new          (GObject *source_object,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data,
+                                                         gpointer source_tag);

-Creates a GSimpleAsyncResult.

+Creates a GSimpleAsyncResult. +

res :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

object :

a GObject. +a GObject.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.
- - - - @@ -325,51 +299,52 @@ or

g_simple_async_result_new_error ()

-
GSimpleAsyncResult * g_simple_async_result_new_error    (GObject *source_object,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         GQuark domain,
-                                                         gint code,
-                                                         const char *format,
-                                                         ...);
-

-Creates a new GSimpleAsyncResult with a set error.

+
GSimpleAsyncResult * g_simple_async_result_new_error    (GObject *source_object,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data,
+                                                         GQuark domain,
+                                                         gint code,
+                                                         const char *format,
+                                                         ...);
+

+Creates a new GSimpleAsyncResult with a set error. +

source_object :

a GObject the asynchronous function was called with, -or NULL. +a GObject the asynchronous function was called with, +or NULL.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.

source_tag :

the asynchronous function. +the asynchronous function.
- - - - - - - @@ -384,33 +359,34 @@ Creates a new

g_simple_async_result_new_from_error ()

GSimpleAsyncResult * g_simple_async_result_new_from_error
-                                                        (GObject *source_object,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         GError *error);
+ (GObject *source_object, + GAsyncReadyCallback callback, + gpointer user_data, + GError *error);

-Creates a GSimpleAsyncResult from an error condition.

+Creates a GSimpleAsyncResult from an error condition. +

source_object :

a GObject, or NULL. +a GObject, or NULL.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.

domain :

a GQuark. +a GQuark.

code :

an error code. +an error code.

format :

a string with format characters. +a string with format characters.

... :

a list of values to insert into format. +a list of values to insert into format.
- - - - @@ -425,27 +401,28 @@ Creates a

g_simple_async_result_set_op_res_gpointer ()

void                g_simple_async_result_set_op_res_gpointer
-                                                        (GSimpleAsyncResult *simple,
-                                                         gpointer op_res,
-                                                         GDestroyNotify destroy_op_res);
+ (GSimpleAsyncResult *simple, + gpointer op_res, + GDestroyNotify destroy_op_res);

-Sets the operation result within the asynchronous result to a pointer.

+Sets the operation result within the asynchronous result to a pointer. +

source_object :

a GObject, or NULL. +a GObject, or NULL.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.

error :

a GError location. +a GError location.
- - - @@ -454,16 +431,17 @@ Sets the operation result within the asynchronous result to a pointer.


g_simple_async_result_get_op_res_gpointer ()

-
gpointer            g_simple_async_result_get_op_res_gpointer
-                                                        (GSimpleAsyncResult *simple);
+
gpointer            g_simple_async_result_get_op_res_gpointer
+                                                        (GSimpleAsyncResult *simple);

-Gets a pointer result as returned by the asynchronous function.

+Gets a pointer result as returned by the asynchronous function. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

op_res :

a pointer result from an asynchronous function. +a pointer result from an asynchronous function.

destroy_op_res :

a GDestroyNotify function. +a GDestroyNotify function.
- @@ -478,22 +456,23 @@ Gets a pointer result as returned by the asynchronous function.

g_simple_async_result_set_op_res_gssize ()

void                g_simple_async_result_set_op_res_gssize
-                                                        (GSimpleAsyncResult *simple,
-                                                         gssize op_res);
+ (GSimpleAsyncResult *simple, + gssize op_res);

Sets the operation result within the asynchronous result to -the given op_res.

+the given op_res. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.
- - @@ -502,16 +481,17 @@ the given op_res.


g_simple_async_result_get_op_res_gssize ()

-
gssize              g_simple_async_result_get_op_res_gssize
-                                                        (GSimpleAsyncResult *simple);
+
gssize              g_simple_async_result_get_op_res_gssize
+                                                        (GSimpleAsyncResult *simple);

-Gets a gssize from the asynchronous result.

+Gets a gssize from the asynchronous result. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

op_res :

a gssize. +a gssize.
- @@ -526,21 +506,22 @@ Gets a gssize from the asynchronous result.

g_simple_async_result_set_op_res_gboolean ()

void                g_simple_async_result_set_op_res_gboolean
-                                                        (GSimpleAsyncResult *simple,
-                                                         gboolean op_res);
+ (GSimpleAsyncResult *simple, + gboolean op_res);

-Sets the operation result to a boolean within the asynchronous result.

+Sets the operation result to a boolean within the asynchronous result. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.
- - @@ -549,22 +530,23 @@ Sets the operation result to a boolean within the asynchronous result.


g_simple_async_result_get_op_res_gboolean ()

-
gboolean            g_simple_async_result_get_op_res_gboolean
-                                                        (GSimpleAsyncResult *simple);
+
gboolean            g_simple_async_result_get_op_res_gboolean
+                                                        (GSimpleAsyncResult *simple);

-Gets the operation result boolean from within the asynchronous result.

+Gets the operation result boolean from within the asynchronous result. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

op_res :

a gboolean. +a gboolean.
- - @@ -573,21 +555,22 @@ Gets the operation result boolean from within the asynchronous result.


g_simple_async_result_get_source_tag ()

-
gpointer            g_simple_async_result_get_source_tag
-                                                        (GSimpleAsyncResult *simple);
+
gpointer            g_simple_async_result_get_source_tag
+                                                        (GSimpleAsyncResult *simple);

-Gets the source tag for the GSimpleAsyncResult.

+Gets the source tag for the GSimpleAsyncResult. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

Returns :

TRUE if the operation's result was TRUE, FALSE - if the operation's result was FALSE. + TRUE if the operation's result was TRUE, FALSE + if the operation's result was FALSE.
- - @@ -596,9 +579,9 @@ Gets the source tag for the

g_simple_async_result_is_valid ()

-
gboolean            g_simple_async_result_is_valid      (GAsyncResult *result,
-                                                         GObject *source,
-                                                         gpointer source_tag);
+
gboolean            g_simple_async_result_is_valid      (GAsyncResult *result,
+                                                         GObject *source,
+                                                         gpointer source_tag);

Ensures that the data passed to the _finish function of an async operation is consistent. Three checks are performed. @@ -610,28 +593,29 @@ matches the source object of result. Th checked to ensure that it is equal to the source_tag argument given to g_simple_async_result_new() (which, by convention, is a pointer to the _async function corresponding to the _finish function from -which this function is called).

+which this function is called). +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

Returns :

a gpointer to the source object for the GSimpleAsyncResult. + a gpointer to the source object for the GSimpleAsyncResult.
- - - - @@ -641,21 +625,22 @@ which this function is called).

g_simple_async_result_set_handle_cancellation ()

void                g_simple_async_result_set_handle_cancellation
-                                                        (GSimpleAsyncResult *simple,
-                                                         gboolean handle_cancellation);
+ (GSimpleAsyncResult *simple, + gboolean handle_cancellation);

-Sets whether to handle cancellation within the asynchronous operation.

+Sets whether to handle cancellation within the asynchronous operation. +

result :

the GAsyncResult passed to the _finish function. +the GAsyncResult passed to the _finish function.

source :

the GObject passed to the _finish function. +the GObject passed to the _finish function.

source_tag :

the asynchronous function. +the asynchronous function.

Returns :

TRUE if all checks passed or FALSE if any failed. + TRUE if all checks passed or FALSE if any failed.
- - @@ -664,17 +649,18 @@ Sets whether to handle cancellation within the asynchronous operation.


g_simple_async_result_complete ()

-
void                g_simple_async_result_complete      (GSimpleAsyncResult *simple);
+
void                g_simple_async_result_complete      (GSimpleAsyncResult *simple);

Completes an asynchronous I/O job immediately. Must be called in the thread where the asynchronous result was to be delivered, as it invokes the callback directly. If you are in a different thread use -g_simple_async_result_complete_in_idle().

+g_simple_async_result_complete_in_idle(). +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

handle_cancellation :

a gboolean. +a gboolean.
-

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.
@@ -683,19 +669,20 @@ invokes the callback directly. If you are in a different thread use

g_simple_async_result_complete_in_idle ()

void                g_simple_async_result_complete_in_idle
-                                                        (GSimpleAsyncResult *simple);
+ (GSimpleAsyncResult *simple);

Completes an asynchronous function in an idle handler in the thread-default main loop of the thread that simple was initially created in.

Calling this function takes a reference to simple for as long as -is needed to complete the call.

+is needed to complete the call. +

-

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.
@@ -703,10 +690,10 @@ is needed to complete the call.


g_simple_async_result_run_in_thread ()

-
void                g_simple_async_result_run_in_thread (GSimpleAsyncResult *simple,
-                                                         GSimpleAsyncThreadFunc func,
-                                                         int io_priority,
-                                                         GCancellable *cancellable);
+
void                g_simple_async_result_run_in_thread (GSimpleAsyncResult *simple,
+                                                         GSimpleAsyncThreadFunc func,
+                                                         int io_priority,
+                                                         GCancellable *cancellable);

Runs the asynchronous job in a separate thread and then calls g_simple_async_result_complete_in_idle() on simple to return @@ -714,28 +701,29 @@ the result to the appropriate main loop.

Calling this function takes a reference to simple for as long as -is needed to run the job and report its completion.

+is needed to run the job and report its completion. +

- - - - @@ -745,21 +733,23 @@ is needed to run the job and report its completion.

g_simple_async_result_set_from_error ()

void                g_simple_async_result_set_from_error
-                                                        (GSimpleAsyncResult *simple,
-                                                         const GError *error);
+ (GSimpleAsyncResult *simple, + const GError *error);

-Sets the result from a GError.

+Sets the result from a GError. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

func :

a GSimpleAsyncThreadFunc. +a GSimpleAsyncThreadFunc.

io_priority :

the io priority of the request. +the io priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.
- - @@ -768,28 +758,29 @@ Sets the result from a

g_simple_async_result_propagate_error ()

-
gboolean            g_simple_async_result_propagate_error
-                                                        (GSimpleAsyncResult *simple,
-                                                         GError **dest);
+
gboolean            g_simple_async_result_propagate_error
+                                                        (GSimpleAsyncResult *simple,
+                                                         GError **dest);

Propagates an error from within the simple asynchronous result to -a given destination.

+a given destination. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

error :

GError. + +GError.
- - - @@ -798,39 +789,40 @@ a given destination.


g_simple_async_result_set_error ()

-
void                g_simple_async_result_set_error     (GSimpleAsyncResult *simple,
-                                                         GQuark domain,
-                                                         gint code,
-                                                         const char *format,
-                                                         ...);
+
void                g_simple_async_result_set_error     (GSimpleAsyncResult *simple,
+                                                         GQuark domain,
+                                                         gint code,
+                                                         const char *format,
+                                                         ...);

-Sets an error within the asynchronous result without a GError.

+Sets an error within the asynchronous result without a GError. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

dest :

a location to propegate the error to. +a location to propegate the error to.

Returns :

TRUE if the error was propagated to dest. FALSE otherwise. + TRUE if the error was propagated to dest. FALSE otherwise.
- - - - - @@ -839,40 +831,41 @@ Sets an error within the asynchronous result without a

g_simple_async_result_set_error_va ()

-
void                g_simple_async_result_set_error_va  (GSimpleAsyncResult *simple,
-                                                         GQuark domain,
-                                                         gint code,
-                                                         const char *format,
-                                                         va_list args);
-

-Sets an error within the asynchronous result without a GError. -Unless writing a binding, see g_simple_async_result_set_error().

+
void                g_simple_async_result_set_error_va  (GSimpleAsyncResult *simple,
+                                                         GQuark domain,
+                                                         gint code,
+                                                         const char *format,
+                                                         va_list args);
+

+Sets an error within the asynchronous result without a GError. +Unless writing a binding, see g_simple_async_result_set_error(). +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

domain :

a GQuark (usually G_IO_ERROR). +a GQuark (usually G_IO_ERROR).

code :

an error code. +an error code.

format :

a formatted error reporting string. +a formatted error reporting string.

... :

a list of variables to fill in format. +a list of variables to fill in format.
- - - - - @@ -881,53 +874,54 @@ Unless writing a binding, see

g_simple_async_report_error_in_idle ()

-
void                g_simple_async_report_error_in_idle (GObject *object,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         GQuark domain,
-                                                         gint code,
-                                                         const char *format,
-                                                         ...);
+
void                g_simple_async_report_error_in_idle (GObject *object,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data,
+                                                         GQuark domain,
+                                                         gint code,
+                                                         const char *format,
+                                                         ...);

Reports an error in an asynchronous function in an idle function by directly setting the contents of the GAsyncResult with the given error -information.

+information. +

simple :

a GSimpleAsyncResult. +a GSimpleAsyncResult.

domain :

a GQuark (usually G_IO_ERROR). +a GQuark (usually G_IO_ERROR).

code :

an error code. +an error code.

format :

a formatted error reporting string. +a formatted error reporting string.

args :

va_list of arguments. +va_list of arguments.
- - - - - - - @@ -937,35 +931,36 @@ information.

g_simple_async_report_gerror_in_idle ()

void                g_simple_async_report_gerror_in_idle
-                                                        (GObject *object,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data,
-                                                         GError *error);
+ (GObject *object, + GAsyncReadyCallback callback, + gpointer user_data, + GError *error);

Reports an error in an idle function. Similar to -g_simple_async_report_error_in_idle(), but takes a GError rather -than building a new one.

+g_simple_async_report_error_in_idle(), but takes a GError rather +than building a new one. +

object :

a GObject. +a GObject.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.

domain :

a GQuark containing the error domain (usually G_IO_ERROR). +a GQuark containing the error domain (usually G_IO_ERROR).

code :

a specific error code. +a specific error code.

format :

a formatted error reporting string. +a formatted error reporting string.

... :

a list of variables to fill in format. +a list of variables to fill in format.
- - - - @@ -979,6 +974,6 @@ than building a new one.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocket.html b/docs/reference/gio/html/GSocket.html index b36f4db..bbb0e90 100644 --- a/docs/reference/gio/html/GSocket.html +++ b/docs/reference/gio/html/GSocket.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

object :

a GObject. +a GObject.

callback :

a GAsyncReadyCallback. +a GAsyncReadyCallback.

user_data :

user data passed to callback. +user data passed to callback.

error :

the GError to report +the GError to report
@@ -77,116 +47,116 @@ #include <gio/gio.h> GSocket; -gboolean (*GSocketSourceFunc) (GSocket *socket, - GIOCondition condition, - gpointer user_data); +gboolean (*GSocketSourceFunc) (GSocket *socket, + GIOCondition condition, + gpointer user_data); enum GSocketType; enum GSocketProtocol; enum GSocketMsgFlags; GInputVector; GOutputVector; -GSocket * g_socket_new (GSocketFamily family, - GSocketType type, - GSocketProtocol protocol, - GError **error); -GSocket * g_socket_new_from_fd (gint fd, - GError **error); -gbooleang_socket_bind (GSocket *socket, - GSocketAddress *address, - gboolean allow_reuse, - GError **error); -gbooleang_socket_listen (GSocket *socket, - GError **error); -GSocket * g_socket_accept (GSocket *socket, - GCancellable *cancellable, - GError **error); -gbooleang_socket_connect (GSocket *socket, - GSocketAddress *address, - GCancellable *cancellable, - GError **error); -gbooleang_socket_check_connect_result (GSocket *socket, - GError **error); -gssizeg_socket_receive (GSocket *socket, - gchar *buffer, - gsize size, - GCancellable *cancellable, - GError **error); -gssizeg_socket_receive_from (GSocket *socket, - GSocketAddress **address, - gchar *buffer, - gsize size, - GCancellable *cancellable, - GError **error); -gssizeg_socket_receive_message (GSocket *socket, - GSocketAddress **address, - GInputVector *vectors, - gint num_vectors, - GSocketControlMessage ***messages, - gint *num_messages, - gint *flags, - GCancellable *cancellable, - GError **error); -gssizeg_socket_send (GSocket *socket, - const gchar *buffer, - gsize size, - GCancellable *cancellable, - GError **error); -gssizeg_socket_send_to (GSocket *socket, - GSocketAddress *address, - const gchar *buffer, - gsize size, - GCancellable *cancellable, - GError **error); -gssizeg_socket_send_message (GSocket *socket, - GSocketAddress *address, - GOutputVector *vectors, - gint num_vectors, - GSocketControlMessage **messages, - gint num_messages, - gint flags, - GCancellable *cancellable, - GError **error); -gbooleang_socket_close (GSocket *socket, - GError **error); -gbooleang_socket_is_closed (GSocket *socket); -gbooleang_socket_shutdown (GSocket *socket, - gboolean shutdown_read, - gboolean shutdown_write, - GError **error); -gbooleang_socket_is_connected (GSocket *socket); -GSource * g_socket_create_source (GSocket *socket, - GIOCondition condition, - GCancellable *cancellable); -GIOConditiong_socket_condition_check (GSocket *socket, - GIOCondition condition); -gbooleang_socket_condition_wait (GSocket *socket, - GIOCondition condition, - GCancellable *cancellable, - GError **error); -voidg_socket_set_listen_backlog (GSocket *socket, - gint backlog); -gintg_socket_get_listen_backlog (GSocket *socket); -gbooleang_socket_get_blocking (GSocket *socket); -voidg_socket_set_blocking (GSocket *socket, - gboolean blocking); -gbooleang_socket_get_keepalive (GSocket *socket); -voidg_socket_set_keepalive (GSocket *socket, - gboolean keepalive); -GSocketFamilyg_socket_get_family (GSocket *socket); -intg_socket_get_fd (GSocket *socket); -GSocketAddress * g_socket_get_local_address (GSocket *socket, - GError **error); -GSocketProtocolg_socket_get_protocol (GSocket *socket); -GSocketAddress * g_socket_get_remote_address (GSocket *socket, - GError **error); -GSocketTypeg_socket_get_socket_type (GSocket *socket); -gbooleang_socket_speaks_ipv4 (GSocket *socket); +GSocket * g_socket_new (GSocketFamily family, + GSocketType type, + GSocketProtocol protocol, + GError **error); +GSocket * g_socket_new_from_fd (gint fd, + GError **error); +gbooleang_socket_bind (GSocket *socket, + GSocketAddress *address, + gboolean allow_reuse, + GError **error); +gbooleang_socket_listen (GSocket *socket, + GError **error); +GSocket * g_socket_accept (GSocket *socket, + GCancellable *cancellable, + GError **error); +gbooleang_socket_connect (GSocket *socket, + GSocketAddress *address, + GCancellable *cancellable, + GError **error); +gbooleang_socket_check_connect_result (GSocket *socket, + GError **error); +gssizeg_socket_receive (GSocket *socket, + gchar *buffer, + gsize size, + GCancellable *cancellable, + GError **error); +gssizeg_socket_receive_from (GSocket *socket, + GSocketAddress **address, + gchar *buffer, + gsize size, + GCancellable *cancellable, + GError **error); +gssizeg_socket_receive_message (GSocket *socket, + GSocketAddress **address, + GInputVector *vectors, + gint num_vectors, + GSocketControlMessage ***messages, + gint *num_messages, + gint *flags, + GCancellable *cancellable, + GError **error); +gssizeg_socket_send (GSocket *socket, + const gchar *buffer, + gsize size, + GCancellable *cancellable, + GError **error); +gssizeg_socket_send_to (GSocket *socket, + GSocketAddress *address, + const gchar *buffer, + gsize size, + GCancellable *cancellable, + GError **error); +gssizeg_socket_send_message (GSocket *socket, + GSocketAddress *address, + GOutputVector *vectors, + gint num_vectors, + GSocketControlMessage **messages, + gint num_messages, + gint flags, + GCancellable *cancellable, + GError **error); +gbooleang_socket_close (GSocket *socket, + GError **error); +gbooleang_socket_is_closed (GSocket *socket); +gbooleang_socket_shutdown (GSocket *socket, + gboolean shutdown_read, + gboolean shutdown_write, + GError **error); +gbooleang_socket_is_connected (GSocket *socket); +GSource * g_socket_create_source (GSocket *socket, + GIOCondition condition, + GCancellable *cancellable); +GIOConditiong_socket_condition_check (GSocket *socket, + GIOCondition condition); +gbooleang_socket_condition_wait (GSocket *socket, + GIOCondition condition, + GCancellable *cancellable, + GError **error); +voidg_socket_set_listen_backlog (GSocket *socket, + gint backlog); +gintg_socket_get_listen_backlog (GSocket *socket); +gbooleang_socket_get_blocking (GSocket *socket); +voidg_socket_set_blocking (GSocket *socket, + gboolean blocking); +gbooleang_socket_get_keepalive (GSocket *socket); +voidg_socket_set_keepalive (GSocket *socket, + gboolean keepalive); +GSocketFamilyg_socket_get_family (GSocket *socket); +intg_socket_get_fd (GSocket *socket); +GSocketAddress * g_socket_get_local_address (GSocket *socket, + GError **error); +GSocketProtocolg_socket_get_protocol (GSocket *socket); +GSocketAddress * g_socket_get_remote_address (GSocket *socket, + GError **error); +GSocketTypeg_socket_get_socket_type (GSocket *socket); +gbooleang_socket_speaks_ipv4 (GSocket *socket);

Object Hierarchy

-  GObject
+  GObject
    +----GSocket
 
@@ -199,11 +169,11 @@ GSocket implements

Properties

-  "blocking"                 gboolean              : Read / Write
+  "blocking"                 gboolean              : Read / Write
   "family"                   GSocketFamily         : Read / Write / Construct Only
-  "fd"                       gint                  : Read / Write / Construct Only
-  "keepalive"                gboolean              : Read / Write
-  "listen-backlog"           gint                  : Read / Write
+  "fd"                       gint                  : Read / Write / Construct Only
+  "keepalive"                gboolean              : Read / Write
+  "listen-backlog"           gint                  : Read / Write
   "local-address"            GSocketAddress*       : Read
   "protocol"                 GSocketProtocol       : Read / Write / Construct Only
   "remote-address"           GSocketAddress*       : Read
@@ -226,10 +196,10 @@ direct use of GSocket implements the GInitable interface, so if it is manually constructed
-by e.g. g_object_new() you must call g_initable_init() and check the
+by e.g. g_object_new() you must call g_initable_init() and check the
 results before using the object. This is done automatically in
 g_socket_new() and g_socket_new_from_fd(), so these functions can return
-NULL.
+NULL.
 

Sockets operate in two general modes, blocking or non-blocking. When @@ -238,7 +208,7 @@ is finished or there is an error. In non-blocking mode all calls that would block return immediately with a G_IO_ERROR_WOULD_BLOCK error. To know when a call would successfully run you can call g_socket_condition_check(), or g_socket_condition_wait(). You can also use g_socket_create_source() and -attach it to a GMainContext to get callbacks when I/O is possible. +attach it to a GMainContext to get callbacks when I/O is possible. Note that all sockets are always set to non blocking mode in the system, and blocking mode is emulated in GSocket.

@@ -265,7 +235,8 @@ Note that creating a GSocket, you may need to take into account the fact that your program will not automatically be killed -if it tries to write to stdout after it has been closed.

+if it tries to write to stdout after it has been closed. +

Details

@@ -273,39 +244,41 @@ if it tries to write to stdout after it has been cl

GSocket

typedef struct _GSocket GSocket;

-A lowlevel network socket object.

+A lowlevel network socket object. +

Since 2.22


GSocketSourceFunc ()

-
gboolean            (*GSocketSourceFunc)                (GSocket *socket,
-                                                         GIOCondition condition,
-                                                         gpointer user_data);
+
gboolean            (*GSocketSourceFunc)                (GSocket *socket,
+                                                         GIOCondition condition,
+                                                         gpointer user_data);

-This is the function type of the callback used for the GSource -returned by g_socket_create_source().

+This is the function type of the callback used for the GSource +returned by g_socket_create_source(). +

- - - - @@ -326,29 +299,30 @@ returned by GSocket. Some protocols may not implement -all the socket types.

+all the socket types. +

socket :

the GSocket +the GSocket

condition :

the current condition at the source fired. +the current condition at the source fired.

user_data :

data passed in by the user. +data passed in by the user.

Returns :

it should return FALSE if the source should be removed. + it should return FALSE if the source should be removed.
- - - - @@ -375,33 +349,34 @@ the particular family/type.

This enum contains a set of commonly available and used protocols. You can also pass any other identifiers handled by the platform in order to -use protocols not listed here.

+use protocols not listed here. +

G_SOCKET_TYPE_INVALID

Type unknown or wrong +Type unknown or wrong

G_SOCKET_TYPE_STREAM

Reliable connection-based byte streams (e.g. TCP). +Reliable connection-based byte streams (e.g. TCP).

G_SOCKET_TYPE_DATAGRAM

Connectionless, unreliable datagram passing. +Connectionless, unreliable datagram passing. (e.g. UDP)

G_SOCKET_TYPE_SEQPACKET

Reliable connection-based passing of datagrams +Reliable connection-based passing of datagrams of fixed maximum length (e.g. SCTP).
- - - - - @@ -424,29 +399,30 @@ Flags used in +the right system header and pass in the flag. +

G_SOCKET_PROTOCOL_UNKNOWN

The protocol type is unknown +The protocol type is unknown

G_SOCKET_PROTOCOL_DEFAULT

The default protocol for the family/type +The default protocol for the family/type

G_SOCKET_PROTOCOL_TCP

TCP over IP +TCP over IP

G_SOCKET_PROTOCOL_UDP

UDP over IP +UDP over IP

G_SOCKET_PROTOCOL_SCTP

SCTP over IP +SCTP over IP
- - - - @@ -466,18 +442,19 @@ the right system header and pass in the flag.

Structure used for scatter/gather data input. You generally pass in an array of
GInputVectors and the operation will store the read data starting in the -first buffer, switching to the next as needed.

+first buffer, switching to the next as needed. +

G_SOCKET_MSG_NONE

No flags. +No flags.

G_SOCKET_MSG_OOB

Request to send/receive out of band data. +Request to send/receive out of band data.

G_SOCKET_MSG_PEEK

Read data from the socket without removing it from +Read data from the socket without removing it from the queue.

G_SOCKET_MSG_DONTROUTE

Don't use a gateway to send out the packet, +Don't use a gateway to send out the packet, only send to hosts on directly connected networks.
- - + - - + @@ -496,18 +473,19 @@ first buffer, switching to the next as needed.

Structure used for scatter/gather data output. You generally pass in an array of GOutputVectors and the operation will use all the buffers as if they were -one buffer.

+one buffer. +

gpointer buffer;

Pointer to a buffer where data will be written. +

gpointer buffer;

Pointer to a buffer where data will be written.

gsize size;

the available size in buffer. +

gsize size;

the available size in buffer.
- - + - - + @@ -517,10 +495,10 @@ one buffer.


g_socket_new ()

-
GSocket *           g_socket_new                        (GSocketFamily family,
-                                                         GSocketType type,
-                                                         GSocketProtocol protocol,
-                                                         GError **error);
+
GSocket *           g_socket_new                        (GSocketFamily family,
+                                                         GSocketType type,
+                                                         GSocketProtocol protocol,
+                                                         GError **error);

Creates a new GSocket with the defined family, type and protocol. If protocol is 0 (G_SOCKET_PROTOCOL_DEFAULT) the default protocol type @@ -536,34 +514,36 @@ the family and type.

The protocol id is passed directly to the operating system, so you can use protocols not listed in GSocketProtocol if you -know the protocol number used for it.

+know the protocol number used for it. +

gconstpointer buffer;

Pointer to a buffer of data to read. +

gconstpointer buffer;

Pointer to a buffer of data to read.

gsize size;

the size of buffer. +

gsize size;

the size of buffer.
- - - - - @@ -574,8 +554,8 @@ know the protocol number used for it.


g_socket_new_from_fd ()

-
GSocket *           g_socket_new_from_fd                (gint fd,
-                                                         GError **error);
+
GSocket *           g_socket_new_from_fd                (gint fd,
+                                                         GError **error);

Creates a new GSocket from a native file descriptor or winsock SOCKET handle. @@ -584,24 +564,26 @@ or winsock SOCKET handle. This reads all the settings from the file descriptor so that all properties should work. Note that the file descriptor will be set to non-blocking mode, independent on the blocking -mode of the GSocket.

+mode of the GSocket. +

family :

the socket family to use, e.g. G_SOCKET_FAMILY_IPV4. +the socket family to use, e.g. G_SOCKET_FAMILY_IPV4.

type :

the socket type to use. +the socket type to use.

protocol :

the id of the protocol to use, or 0 for default. +the id of the protocol to use, or 0 for default.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocket or NULL on error. - Free the returned object with g_object_unref(). + a GSocket or NULL on error. + Free the returned object with g_object_unref().
- - - @@ -612,10 +594,10 @@ mode of the

g_socket_bind ()

-
gboolean            g_socket_bind                       (GSocket *socket,
-                                                         GSocketAddress *address,
-                                                         gboolean allow_reuse,
-                                                         GError **error);
+
gboolean            g_socket_bind                       (GSocket *socket,
+                                                         GSocketAddress *address,
+                                                         gboolean allow_reuse,
+                                                         GError **error);

When a socket is created it is attached to an address family, but it doesn't have an address in this family. g_socket_bind() assigns the @@ -628,40 +610,42 @@ In certain situations, you may also want to bind a socket that will be used to initiate connections, though this is not normally required.

-allow_reuse should be TRUE for server sockets (sockets that you will -eventually call g_socket_accept() on), and FALSE for client sockets. -(Specifically, if it is TRUE, then g_socket_bind() will set the +allow_reuse should be TRUE for server sockets (sockets that you will +eventually call g_socket_accept() on), and FALSE for client sockets. +(Specifically, if it is TRUE, then g_socket_bind() will set the SO_REUSEADDR flag on the socket, allowing it to bind address even if that address was previously used by another socket that has not yet been fully cleaned-up by the kernel. Failing to set this flag on a server socket may cause the bind call to return G_IO_ERROR_ADDRESS_IN_USE if -the server program is stopped and then immediately restarted.)

+the server program is stopped and then immediately restarted.) +

fd :

a native socket file descriptor. +a native socket file descriptor.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocket or NULL on error. - Free the returned object with g_object_unref(). + a GSocket or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -672,8 +656,8 @@ the server program is stopped and then immediately restarted.)


g_socket_listen ()

-
gboolean            g_socket_listen                     (GSocket *socket,
-                                                         GError **error);
+
gboolean            g_socket_listen                     (GSocket *socket,
+                                                         GError **error);

Marks the socket as a server socket, i.e. a socket that is used to accept incoming requests using g_socket_accept(). @@ -684,23 +668,25 @@ Before calling this the socket must be bound to a local address using

To set the maximum amount of outstanding clients, use -g_socket_set_listen_backlog().

+g_socket_set_listen_backlog(). +

socket :

a GSocket. +a GSocket.

address :

a GSocketAddress specifying the local address. +a GSocketAddress specifying the local address.

allow_reuse :

whether to allow reusing this address +whether to allow reusing this address

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - @@ -711,9 +697,9 @@ To set the maximum amount of outstanding clients, use

g_socket_accept ()

-
GSocket *           g_socket_accept                     (GSocket *socket,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocket *           g_socket_accept                     (GSocket *socket,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Accept incoming connections on a connection-based socket. This removes the first outstanding connection request from the listening socket and @@ -726,29 +712,31 @@ must be listening for incoming connections (G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled. -To be notified of an incoming connection, wait for the G_IO_IN condition.

+To be notified of an incoming connection, wait for the G_IO_IN condition. +

socket :

a GSocket. +a GSocket.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - - @@ -759,10 +747,10 @@ To be notified of an incoming connection, wait for the

g_socket_connect ()

-
gboolean            g_socket_connect                    (GSocket *socket,
-                                                         GSocketAddress *address,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_socket_connect                    (GSocket *socket,
+                                                         GSocketAddress *address,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Connect the socket to the specified remote address.

@@ -782,33 +770,35 @@ If the connect call needs to do network I/O it will block, unless non-blocking I/O is enabled. Then G_IO_ERROR_PENDING is returned and the user can be notified of the connection finishing by waiting for the G_IO_OUT condition. The result of the connection can then be -checked with g_socket_check_connect_result().

+checked with g_socket_check_connect_result(). +

socket :

a GSocket. +a GSocket.

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a new GSocket, or NULL on error. - Free the returned object with g_object_unref(). + a new GSocket, or NULL on error. + Free the returned object with g_object_unref().
- - - - - @@ -819,28 +809,30 @@ checked with

g_socket_check_connect_result ()

-
gboolean            g_socket_check_connect_result       (GSocket *socket,
-                                                         GError **error);
+
gboolean            g_socket_check_connect_result       (GSocket *socket,
+                                                         GError **error);

Checks and resets the pending connect error for the socket. This is used to check for errors when g_socket_connect() is -used in non-blocking mode.

+used in non-blocking mode. +

socket :

a GSocket. +a GSocket.

address :

a GSocketAddress specifying the remote address. +a GSocketAddress specifying the remote address.

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE if connected, FALSE on error. + TRUE if connected, FALSE on error.
- - - @@ -851,15 +843,15 @@ used in non-blocking mode.


g_socket_receive ()

-
gssize              g_socket_receive                    (GSocket *socket,
-                                                         gchar *buffer,
-                                                         gsize size,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_receive                    (GSocket *socket,
+                                                         gchar *buffer,
+                                                         gsize size,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Receive data (up to size bytes) from a socket. This is mainly used by connection-oriented sockets; it is identical to g_socket_receive_from() -with address set to NULL. +with address set to NULL.

For G_SOCKET_TYPE_DATAGRAM and G_SOCKET_TYPE_SEQPACKET sockets, @@ -879,37 +871,39 @@ If the socket is in blocking mode the call will block until there is some data to receive or there is an error. If there is no data available and the socket is in non-blocking mode, a G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when data is available, wait for the -G_IO_IN condition. +G_IO_IN condition.

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

socket :

a GSocket +a GSocket

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE if no error, FALSE otherwise, setting error to the error + TRUE if no error, FALSE otherwise, setting error to the error
- - - - - @@ -925,54 +919,56 @@ On error -1 is returned and error is set

g_socket_receive_from ()

-
gssize              g_socket_receive_from               (GSocket *socket,
-                                                         GSocketAddress **address,
-                                                         gchar *buffer,
-                                                         gsize size,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_receive_from               (GSocket *socket,
+                                                         GSocketAddress **address,
+                                                         gchar *buffer,
+                                                         gsize size,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Receive data (up to size bytes) from a socket.

-If address is non-NULL then address will be set equal to the +If address is non-NULL then address will be set equal to the source address of the received packet. address is owned by the caller.

-See g_socket_receive() for additional information.

+See g_socket_receive() for additional information. +

socket :

a GSocket +a GSocket

buffer :

a buffer to read data into (which should be at least size +a buffer to read data into (which should be at least size bytes long).

size :

the number of bytes you want to read from the socket +the number of bytes you want to read from the socket

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.
- - - - - - @@ -988,22 +984,22 @@ See

g_socket_receive_message ()

-
gssize              g_socket_receive_message            (GSocket *socket,
-                                                         GSocketAddress **address,
-                                                         GInputVector *vectors,
-                                                         gint num_vectors,
-                                                         GSocketControlMessage ***messages,
-                                                         gint *num_messages,
-                                                         gint *flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_receive_message            (GSocket *socket,
+                                                         GSocketAddress **address,
+                                                         GInputVector *vectors,
+                                                         gint num_vectors,
+                                                         GSocketControlMessage ***messages,
+                                                         gint *num_messages,
+                                                         gint *flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Receive data from a socket. This is the most complicated and fully-featured version of this call. For easier use, see g_socket_receive() and g_socket_receive_from().

-If address is non-NULL then address will be set equal to the +If address is non-NULL then address will be set equal to the source address of the received packet. address is owned by the caller.

@@ -1012,31 +1008,31 @@ source address of the received packet. num_vectors must be the length of this array. These structs describe the buffers that received data will be scattered into. If num_vectors is -1, then vectors is assumed to be terminated -by a GInputVector with a NULL buffer pointer. +by a GInputVector with a NULL buffer pointer.

As a special case, if num_vectors is 0 (in which case, vectors -may of course be NULL), then a single byte is received and +may of course be NULL), then a single byte is received and discarded. This is to facilitate the common practice of sending a single '\0' byte for the purposes of transferring ancillary data.

-messages, if non-NULL, will be set to point to a newly-allocated +messages, if non-NULL, will be set to point to a newly-allocated array of GSocketControlMessage instances. These correspond to the control messages received from the kernel, one GSocketControlMessage per message from the kernel. This array is -NULL-terminated and must be freed by the caller using g_free(). If -messages is NULL, any control messages received will be +NULL-terminated and must be freed by the caller using g_free(). If +messages is NULL, any control messages received will be discarded.

-num_messages, if non-NULL, will be set to the number of control +num_messages, if non-NULL, will be set to the number of control messages received.

-If both messages and num_messages are non-NULL, then +If both messages and num_messages are non-NULL, then num_messages gives the number of GSocketControlMessage instances -in messages (ie: not including the NULL terminator). +in messages (ie: not including the NULL terminator).

flags is an in/out parameter. The commonly available arguments @@ -1059,58 +1055,59 @@ If the socket is in blocking mode the call will block until there is some data to receive or there is an error. If there is no data available and the socket is in non-blocking mode, a G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when -data is available, wait for the G_IO_IN condition. +data is available, wait for the G_IO_IN condition.

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

socket :

a GSocket +a GSocket

address :

a pointer to a GSocketAddress pointer, or NULL +a pointer to a GSocketAddress pointer, or NULL

buffer :

a buffer to read data into (which should be at least size +a buffer to read data into (which should be at least size bytes long).

size :

the number of bytes you want to read from the socket +the number of bytes you want to read from the socket

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.
- - - - - - - - - @@ -1126,54 +1123,56 @@ On error -1 is returned and error is set

g_socket_send ()

-
gssize              g_socket_send                       (GSocket *socket,
-                                                         const gchar *buffer,
-                                                         gsize size,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_send                       (GSocket *socket,
+                                                         const gchar *buffer,
+                                                         gsize size,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to send size bytes from buffer on the socket. This is mainly used by connection-oriented sockets; it is identical to -g_socket_send_to() with address set to NULL. +g_socket_send_to() with address set to NULL.

If the socket is in blocking mode the call will block until there is space for the data in the socket queue. If there is no space available and the socket is in non-blocking mode a G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when space is available, wait for the -G_IO_OUT condition. Note though that you may still receive +G_IO_OUT condition. Note though that you may still receive G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously -notified of a G_IO_OUT condition. (On Windows in particular, this is +notified of a G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.)

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

socket :

a GSocket +a GSocket

address :

a pointer to a GSocketAddress pointer, or NULL +a pointer to a GSocketAddress pointer, or NULL

vectors :

an array of GInputVector structs +an array of GInputVector structs

num_vectors :

the number of elements in vectors, or -1 +the number of elements in vectors, or -1

messages :

a pointer which will be filled with an array of - GSocketControlMessages, or NULL +a pointer which will be filled with an array of + GSocketControlMessages, or NULL

num_messages :

a pointer which will be filled with the number of - elements in messages, or NULL +a pointer which will be filled with the number of + elements in messages, or NULL

flags :

a pointer to an int containing GSocketMsgFlags flags +a pointer to an int containing GSocketMsgFlags flags

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

a GError pointer, or NULL +a GError pointer, or NULL
- - - - - @@ -1190,50 +1189,52 @@ on error

g_socket_send_to ()

-
gssize              g_socket_send_to                    (GSocket *socket,
-                                                         GSocketAddress *address,
-                                                         const gchar *buffer,
-                                                         gsize size,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_send_to                    (GSocket *socket,
+                                                         GSocketAddress *address,
+                                                         const gchar *buffer,
+                                                         gsize size,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to send size bytes from buffer to address. If address is -NULL then the message is sent to the default receiver (set by +NULL then the message is sent to the default receiver (set by g_socket_connect()).

-See g_socket_send() for additional information.

+See g_socket_send() for additional information. +

socket :

a GSocket +a GSocket

buffer :

the buffer containing the data to send. +the buffer containing the data to send.

size :

the number of bytes to send +the number of bytes to send

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.
- - - - - - @@ -1250,39 +1251,39 @@ on error

g_socket_send_message ()

-
gssize              g_socket_send_message               (GSocket *socket,
-                                                         GSocketAddress *address,
-                                                         GOutputVector *vectors,
-                                                         gint num_vectors,
-                                                         GSocketControlMessage **messages,
-                                                         gint num_messages,
-                                                         gint flags,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gssize              g_socket_send_message               (GSocket *socket,
+                                                         GSocketAddress *address,
+                                                         GOutputVector *vectors,
+                                                         gint num_vectors,
+                                                         GSocketControlMessage **messages,
+                                                         gint num_messages,
+                                                         gint flags,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Send data to address on socket. This is the most complicated and fully-featured version of this call. For easier use, see g_socket_send() and g_socket_send_to().

-If address is NULL then the message is sent to the default receiver +If address is NULL then the message is sent to the default receiver (set by g_socket_connect()).

vectors must point to an array of GOutputVector structs and num_vectors must be the length of this array. (If num_vectors is -1, then vectors is assumed to be terminated by a GOutputVector with a -NULL buffer pointer.) The GOutputVector structs describe the buffers +NULL buffer pointer.) The GOutputVector structs describe the buffers that the sent data will be gathered from. Using multiple GOutputVectors is more memory-efficient than manually copying data from multiple sources into a single buffer, and more network-efficient than making multiple calls to g_socket_send().

-messages, if non-NULL, is taken to point to an array of num_messages +messages, if non-NULL, is taken to point to an array of num_messages GSocketControlMessage instances. These correspond to the control messages to be sent on the socket. -If num_messages is -1 then messages is treated as a NULL-terminated +If num_messages is -1 then messages is treated as a NULL-terminated array.

@@ -1296,60 +1297,62 @@ If the socket is in blocking mode the call will block until there is space for the data in the socket queue. If there is no space available and the socket is in non-blocking mode a G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when space is available, wait for the -G_IO_OUT condition. Note though that you may still receive +G_IO_OUT condition. Note though that you may still receive G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously -notified of a G_IO_OUT condition. (On Windows in particular, this is +notified of a G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.)

-On error -1 is returned and error is set accordingly.

+On error -1 is returned and error is set accordingly. +

socket :

a GSocket +a GSocket

address :

a GSocketAddress, or NULL +a GSocketAddress, or NULL

buffer :

the buffer containing the data to send. +the buffer containing the data to send.

size :

the number of bytes to send +the number of bytes to send

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.
- - - - - - - - - @@ -1366,8 +1369,8 @@ on error

g_socket_close ()

-
gboolean            g_socket_close                      (GSocket *socket,
-                                                         GError **error);
+
gboolean            g_socket_close                      (GSocket *socket,
+                                                         GError **error);

Closes the socket, shutting down any active connection.

@@ -1389,7 +1392,7 @@ resources are released as early as possible.

Beware that due to the way that TCP works, it is possible for recently-sent data to be lost if either you close a socket while the -G_IO_IN condition is set, or else if the remote connection tries to +G_IO_IN condition is set, or else if the remote connection tries to send something to you after you close the socket but before it has finished reading all of the data you sent. There is no easy generic way to avoid this problem; the easiest fix is to design the network @@ -1401,23 +1404,25 @@ connection, after which the server can safely call GTcpConnection does if you call g_tcp_connection_set_graceful_disconnect(). But of course, this only works if the client will close its connection after the server -does.)

+does.) +

socket :

a GSocket +a GSocket

address :

a GSocketAddress, or NULL +a GSocketAddress, or NULL

vectors :

an array of GOutputVector structs +an array of GOutputVector structs

num_vectors :

the number of elements in vectors, or -1 +the number of elements in vectors, or -1

messages :

a pointer to an array of GSocketControlMessages, or - NULL. +a pointer to an array of GSocketControlMessages, or + NULL.

num_messages :

number of elements in messages, or -1. +number of elements in messages, or -1.

flags :

an int containing GSocketMsgFlags flags +an int containing GSocketMsgFlags flags

cancellable :

a GCancellable or NULL +a GCancellable or NULL

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.
- - - @@ -1428,20 +1433,21 @@ does.)


g_socket_is_closed ()

-
gboolean            g_socket_is_closed                  (GSocket *socket);
+
gboolean            g_socket_is_closed                  (GSocket *socket);

-Checks whether a socket is closed.

+Checks whether a socket is closed. +

socket :

a GSocket +a GSocket

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error + TRUE on success, FALSE on error
- - @@ -1452,54 +1458,56 @@ Checks whether a socket is closed.


g_socket_shutdown ()

-
gboolean            g_socket_shutdown                   (GSocket *socket,
-                                                         gboolean shutdown_read,
-                                                         gboolean shutdown_write,
-                                                         GError **error);
+
gboolean            g_socket_shutdown                   (GSocket *socket,
+                                                         gboolean shutdown_read,
+                                                         gboolean shutdown_write,
+                                                         GError **error);

Shut down part of a full-duplex connection.

-If shutdown_read is TRUE then the recieving side of the connection +If shutdown_read is TRUE then the recieving side of the connection is shut down, and further reading is disallowed.

-If shutdown_write is TRUE then the sending side of the connection +If shutdown_write is TRUE then the sending side of the connection is shut down, and further writing is disallowed.

-It is allowed for both shutdown_read and shutdown_write to be TRUE. +It is allowed for both shutdown_read and shutdown_write to be TRUE.

One example where this is used is graceful disconnect for TCP connections where you close the sending side, then wait for the other side to close -the connection, thus ensuring that the other side saw all sent data.

+the connection, thus ensuring that the other side saw all sent data. +

socket :

a GSocket +a GSocket

Returns :

TRUE if socket is closed, FALSE otherwise + TRUE if socket is closed, FALSE otherwise
- - - - - @@ -1510,21 +1518,22 @@ the connection, thus ensuring that the other side saw all sent data.


g_socket_is_connected ()

-
gboolean            g_socket_is_connected               (GSocket *socket);
+
gboolean            g_socket_is_connected               (GSocket *socket);

Check whether the socket is connected. This is only useful for -connection-oriented sockets.

+connection-oriented sockets. +

socket :

a GSocket +a GSocket

shutdown_read :

whether to shut down the read side +whether to shut down the read side

shutdown_write :

whether to shut down the write side +whether to shut down the write side

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error + TRUE on success, FALSE on error
- - @@ -1535,47 +1544,48 @@ connection-oriented sockets.


g_socket_create_source ()

-
GSource *           g_socket_create_source              (GSocket *socket,
-                                                         GIOCondition condition,
-                                                         GCancellable *cancellable);
+
GSource *           g_socket_create_source              (GSocket *socket,
+                                                         GIOCondition condition,
+                                                         GCancellable *cancellable);

-Creates a GSource that can be attached to a GMainContext to monitor +Creates a GSource that can be attached to a GMainContext to monitor for the availibility of the specified condition on the socket.

The callback on the source is of the GSocketSourceFunc type.

-It is meaningless to specify G_IO_ERR or G_IO_HUP in condition; +It is meaningless to specify G_IO_ERR or G_IO_HUP in condition; these conditions will always be reported output if they are true.

-cancellable if not NULL can be used to cancel the source, which will +cancellable if not NULL can be used to cancel the source, which will cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using -g_cancellable_is_cancelled().

+g_cancellable_is_cancelled(). +

socket :

a GSocket. +a GSocket.

Returns :

TRUE if socket is connected, FALSE otherwise. + TRUE if socket is connected, FALSE otherwise.
- - - - @@ -1586,8 +1596,8 @@ condition change). You can check for this in the callback using

g_socket_condition_check ()

-
GIOCondition        g_socket_condition_check            (GSocket *socket,
-                                                         GIOCondition condition);
+
GIOCondition        g_socket_condition_check            (GSocket *socket,
+                                                         GIOCondition condition);

Checks on the readiness of socket to perform operations. The operations specified in condition are checked for and masked @@ -1595,22 +1605,23 @@ against the currently-satisfied conditions on socket is returned.

-It is meaningless to specify G_IO_ERR or G_IO_HUP in condition; +It is meaningless to specify G_IO_ERR or G_IO_HUP in condition; these conditions will always be set in the output if they are true.

-This call never blocks.

+This call never blocks. +

socket :

a GSocket +a GSocket

condition :

a GIOCondition mask to monitor +a GIOCondition mask to monitor

cancellable :

a GCancellable or NULL +a GCancellable or NULL

Returns :

a newly allocated GSource, free with g_source_unref(). + a newly allocated GSource, free with g_source_unref().
- - @@ -1626,43 +1637,44 @@ This call never blocks.


g_socket_condition_wait ()

-
gboolean            g_socket_condition_wait             (GSocket *socket,
-                                                         GIOCondition condition,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_socket_condition_wait             (GSocket *socket,
+                                                         GIOCondition condition,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Waits for condition to become true on socket. When the condition -is met, TRUE is returned. +is met, TRUE is returned.

-If cancellable is cancelled before the condition is met then FALSE -is returned and error, if non-NULL, is set to G_IO_ERROR_CANCELLED.

+If cancellable is cancelled before the condition is met then FALSE +is returned and error, if non-NULL, is set to G_IO_ERROR_CANCELLED. +

socket :

a GSocket +a GSocket

condition :

a GIOCondition mask to check +a GIOCondition mask to check
- - - - - @@ -1673,8 +1685,8 @@ is returned and error, if non-

g_socket_set_listen_backlog ()

-
void                g_socket_set_listen_backlog         (GSocket *socket,
-                                                         gint backlog);
+
void                g_socket_set_listen_backlog         (GSocket *socket,
+                                                         gint backlog);

Sets the maximum number of outstanding connections allowed when listening on this socket. If more clients than this are @@ -1683,18 +1695,19 @@ on time then the new connections will be refused.

Note that this must be called before g_socket_listen() and has no -effect if called after that.

+effect if called after that. +

socket :

a GSocket +a GSocket

condition :

a GIOCondition mask to wait for +a GIOCondition mask to wait for

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

a GError pointer, or NULL +a GError pointer, or NULL

Returns :

TRUE if the condition was met, FALSE otherwise + TRUE if the condition was met, FALSE otherwise
- - @@ -1704,16 +1717,17 @@ effect if called after that.


g_socket_get_listen_backlog ()

-
gint                g_socket_get_listen_backlog         (GSocket *socket);
+
gint                g_socket_get_listen_backlog         (GSocket *socket);

Gets the listen backlog setting of the socket. For details on this, -see g_socket_set_listen_backlog().

+see g_socket_set_listen_backlog(). +

socket :

a GSocket. +a GSocket.

backlog :

the maximum number of pending connections. +the maximum number of pending connections.
- @@ -1729,21 +1743,22 @@ see

g_socket_get_blocking ()

-
gboolean            g_socket_get_blocking               (GSocket *socket);
+
gboolean            g_socket_get_blocking               (GSocket *socket);

Gets the blocking mode of the socket. For details on blocking I/O, -see g_socket_set_blocking().

+see g_socket_set_blocking(). +

socket :

a GSocket. +a GSocket.
- - @@ -1754,8 +1769,8 @@ see

g_socket_set_blocking ()

-
void                g_socket_set_blocking               (GSocket *socket,
-                                                         gboolean blocking);
+
void                g_socket_set_blocking               (GSocket *socket,
+                                                         gboolean blocking);

Sets the blocking mode of the socket. In blocking mode all operations block until they succeed or there is an error. In @@ -1765,18 +1780,19 @@ with a All sockets are created in blocking mode. However, note that the platform level socket is always non-blocking, and blocking mode -is a GSocket level feature.

+is a GSocket level feature. +

socket :

a GSocket. +a GSocket.

Returns :

TRUE if blocking I/O is used, FALSE otherwise. + TRUE if blocking I/O is used, FALSE otherwise.
- - @@ -1786,21 +1802,22 @@ is a GSocket level feature.


g_socket_get_keepalive ()

-
gboolean            g_socket_get_keepalive              (GSocket *socket);
+
gboolean            g_socket_get_keepalive              (GSocket *socket);

Gets the keepalive mode of the socket. For details on this, -see g_socket_set_keepalive().

+see g_socket_set_keepalive(). +

socket :

a GSocket. +a GSocket.

blocking :

Whether to use blocking I/O or not. +Whether to use blocking I/O or not.
- - @@ -1811,8 +1828,8 @@ see

g_socket_set_keepalive ()

-
void                g_socket_set_keepalive              (GSocket *socket,
-                                                         gboolean keepalive);
+
void                g_socket_set_keepalive              (GSocket *socket,
+                                                         gboolean keepalive);

Sets or unsets the SO_KEEPALIVE flag on the underlying socket. When this flag is set on a socket, the system will attempt to verify that the @@ -1830,18 +1847,19 @@ The exact time between pings is system- and protocol-dependent, but will normally be at least two hours. Most commonly, you would set this flag on a server socket if you want to allow clients to remain idle for long periods of time, but also want to ensure that connections are eventually -garbage-collected if clients crash or become unreachable.

+garbage-collected if clients crash or become unreachable. +

socket :

a GSocket. +a GSocket.

Returns :

TRUE if keepalive is active, FALSE otherwise. + TRUE if keepalive is active, FALSE otherwise.
- - @@ -1851,15 +1869,16 @@ garbage-collected if clients crash or become unreachable.


g_socket_get_family ()

-
GSocketFamily       g_socket_get_family                 (GSocket *socket);
+
GSocketFamily       g_socket_get_family                 (GSocket *socket);

-Gets the socket family of the socket.

+Gets the socket family of the socket. +

socket :

a GSocket. +a GSocket.

keepalive :

Value for the keepalive flag +Value for the keepalive flag
- @@ -1875,19 +1894,20 @@ Gets the socket family of the socket.


g_socket_get_fd ()

-
int                 g_socket_get_fd                     (GSocket *socket);
+
int                 g_socket_get_fd                     (GSocket *socket);

Returns the underlying OS socket object. On unix this is a socket file descriptor, and on windows this is a Winsock2 SOCKET handle. This may be useful for doing platform specific or otherwise unusual operations -on the socket.

+on the socket. +

socket :

a GSocket. +a GSocket.
- @@ -1903,29 +1923,31 @@ on the socket.


g_socket_get_local_address ()

-
GSocketAddress *    g_socket_get_local_address          (GSocket *socket,
-                                                         GError **error);
+
GSocketAddress *    g_socket_get_local_address          (GSocket *socket,
+                                                         GError **error);

Try to get the local address of a bound socket. This is only useful if the socket has been bound to a local address, -either explicitly or implicitly when connecting.

+either explicitly or implicitly when connecting. +

socket :

a GSocket. +a GSocket.
- - - @@ -1936,16 +1958,17 @@ either explicitly or implicitly when connecting.


g_socket_get_protocol ()

-
GSocketProtocol     g_socket_get_protocol               (GSocket *socket);
+
GSocketProtocol     g_socket_get_protocol               (GSocket *socket);

Gets the socket protocol id the socket was created with. -In case the protocol is unknown, -1 is returned.

+In case the protocol is unknown, -1 is returned. +

socket :

a GSocket. +a GSocket.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketAddress or NULL on error. - Free the returned object with g_object_unref(). + a GSocketAddress or NULL on error. + Free the returned object with g_object_unref().
- @@ -1961,28 +1984,30 @@ In case the protocol is unknown, -1 is returned.


g_socket_get_remote_address ()

-
GSocketAddress *    g_socket_get_remote_address         (GSocket *socket,
-                                                         GError **error);
+
GSocketAddress *    g_socket_get_remote_address         (GSocket *socket,
+                                                         GError **error);

Try to get the remove address of a connected socket. This is only -useful for connection oriented sockets that have been connected.

+useful for connection oriented sockets that have been connected. +

socket :

a GSocket. +a GSocket.
- - - @@ -1993,15 +2018,16 @@ useful for connection oriented sockets that have been connected.


g_socket_get_socket_type ()

-
GSocketType         g_socket_get_socket_type            (GSocket *socket);
+
GSocketType         g_socket_get_socket_type            (GSocket *socket);

-Gets the socket type of the socket.

+Gets the socket type of the socket. +

socket :

a GSocket. +a GSocket.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketAddress or NULL on error. - Free the returned object with g_object_unref(). + a GSocketAddress or NULL on error. + Free the returned object with g_object_unref().
- @@ -2017,7 +2043,7 @@ Gets the socket type of the socket.


g_socket_speaks_ipv4 ()

-
gboolean            g_socket_speaks_ipv4                (GSocket *socket);
+
gboolean            g_socket_speaks_ipv4                (GSocket *socket);

Checks if a socket is capable of speaking IPv4.

@@ -2029,18 +2055,19 @@ information.

No other types of sockets are currently considered as being capable -of speaking IPv4.

+of speaking IPv4. +

socket :

a GSocket. +a GSocket.
- - @@ -2053,7 +2080,7 @@ of speaking IPv4.

Property Details

The "blocking" property

-
  "blocking"                 gboolean              : Read / Write
+
  "blocking"                 gboolean              : Read / Write

Whether or not I/O on this socket is blocking.

Default value: TRUE

@@ -2067,21 +2094,21 @@ of speaking IPv4.


The "fd" property

-
  "fd"                       gint                  : Read / Write / Construct Only
+
  "fd"                       gint                  : Read / Write / Construct Only

The sockets file descriptor.

Default value: -1


The "keepalive" property

-
  "keepalive"                gboolean              : Read / Write
+
  "keepalive"                gboolean              : Read / Write

Keep connection alive by sending periodic pings.

Default value: FALSE


The "listen-backlog" property

-
  "listen-backlog"           gint                  : Read / Write
+
  "listen-backlog"           gint                  : Read / Write

Outstanding connections in the listen queue.

Allowed values: [0,128]

Default value: 10

@@ -2120,6 +2147,6 @@ of speaking IPv4.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketAddress.html b/docs/reference/gio/html/GSocketAddress.html index 7b1b1e1..d043d25 100644 --- a/docs/reference/gio/html/GSocketAddress.html +++ b/docs/reference/gio/html/GSocketAddress.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

socket :

a GSocket +a GSocket

Returns :

TRUE if this socket can be used with IPv4. + TRUE if this socket can be used with IPv4.
@@ -76,20 +46,20 @@ socket communication

Synopsis

                    GSocketAddress;
 enum                GSocketFamily;
-GSocketAddress *    g_socket_address_new_from_native    (gpointer native,
-                                                         gsize len);
-GSocketFamily       g_socket_address_get_family         (GSocketAddress *address);
-gboolean            g_socket_address_to_native          (GSocketAddress *address,
-                                                         gpointer dest,
-                                                         gsize destlen,
-                                                         GError **error);
-gssize              g_socket_address_get_native_size    (GSocketAddress *address);
+GSocketAddress *    g_socket_address_new_from_native    (gpointer native,
+                                                         gsize len);
+GSocketFamily       g_socket_address_get_family         (GSocketAddress *address);
+gboolean            g_socket_address_to_native          (GSocketAddress *address,
+                                                         gpointer dest,
+                                                         gsize destlen,
+                                                         GError **error);
+gssize              g_socket_address_get_native_size    (GSocketAddress *address);
 

Object Hierarchy

-  GObject
+  GObject
    +----GSocketAddress
          +----GInetSocketAddress
          +----GUnixSocketAddress
@@ -113,7 +83,8 @@ GSocketAddress implements
 GSocketAddress is the equivalent of struct sockaddr
 in the BSD sockets API. This is an abstract class; use
 GInetSocketAddress for internet sockets, or GUnixSocketAddress
-for UNIX domain sockets.

+for UNIX domain sockets. +

Details

@@ -122,7 +93,8 @@ for UNIX domain sockets.

typedef struct _GSocketAddress GSocketAddress;

A socket endpoint address, corresponding to struct sockaddr -or one of its subtypes.

+or one of its subtypes. +


@@ -139,28 +111,29 @@ or one of its subtypes.

The protocol family of a GSocketAddress. (These values are identical to the system defines AF_INET, AF_INET6 and AF_UNIX, -if available.)

+if available.) +

- - - - @@ -170,28 +143,29 @@ if available.)


g_socket_address_new_from_native ()

-
GSocketAddress *    g_socket_address_new_from_native    (gpointer native,
-                                                         gsize len);
+
GSocketAddress *    g_socket_address_new_from_native    (gpointer native,
+                                                         gsize len);

Creates a GSocketAddress subclass corresponding to the native -struct sockaddr native.

+struct sockaddr native. +

G_SOCKET_FAMILY_INVALID

no address family +no address family

G_SOCKET_FAMILY_UNIX

the UNIX domain family +the UNIX domain family

G_SOCKET_FAMILY_IPV4

the IPv4 family +the IPv4 family

G_SOCKET_FAMILY_IPV6

the IPv6 family +the IPv6 family
- - @@ -202,15 +176,16 @@ otherwise

g_socket_address_get_family ()

-
GSocketFamily       g_socket_address_get_family         (GSocketAddress *address);
+
GSocketFamily       g_socket_address_get_family         (GSocketAddress *address);

-Gets the socket family type of address.

+Gets the socket family type of address. +

native :

a pointer to a struct sockaddr +a pointer to a struct sockaddr

len :

the size of the memory location pointed to by native +the size of the memory location pointed to by native

Returns :

a new GSocketAddress if native could successfully be converted, -otherwise NULL. +otherwise NULL.
- @@ -226,10 +201,10 @@ Gets the socket family type of address.<

g_socket_address_to_native ()

-
gboolean            g_socket_address_to_native          (GSocketAddress *address,
-                                                         gpointer dest,
-                                                         gsize destlen,
-                                                         GError **error);
+
gboolean            g_socket_address_to_native          (GSocketAddress *address,
+                                                         gpointer dest,
+                                                         gsize destlen,
+                                                         GError **error);

Converts a GSocketAddress to a native struct sockaddr, which can be passed to low-level functions like @@ -238,35 +213,37 @@ sockaddr, which can be passed to low-level functions like

If not enough space is availible, a G_IO_ERROR_NO_SPACE error is returned. If the address type is not known on the system -then a G_IO_ERROR_NOT_SUPPORTED error is returned.

+then a G_IO_ERROR_NOT_SUPPORTED error is returned. +

address :

a GSocketAddress +a GSocketAddress
- - - - - @@ -277,17 +254,18 @@ then a

g_socket_address_get_native_size ()

-
gssize              g_socket_address_get_native_size    (GSocketAddress *address);
+
gssize              g_socket_address_get_native_size    (GSocketAddress *address);

Gets the size of address's native struct sockaddr. You can use this to allocate memory to pass to -g_socket_address_to_native().

+g_socket_address_to_native(). +

address :

a GSocketAddress +a GSocketAddress

dest :

a pointer to a memory location that will contain the native +a pointer to a memory location that will contain the native struct sockaddr.

destlen :

the size of dest. Must be at least as large as +the size of dest. Must be at least as large as g_socket_address_get_native_size().

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE if dest was filled in, FALSE on error + TRUE if dest was filled in, FALSE on error
- @@ -314,6 +292,6 @@ You can use this to allocate memory to pass to + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketClient.html b/docs/reference/gio/html/GSocketClient.html index 8277f7d..ff57c37 100644 --- a/docs/reference/gio/html/GSocketClient.html +++ b/docs/reference/gio/html/GSocketClient.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

address :

a GSocketAddress +a GSocketAddress
@@ -75,69 +45,69 @@ #include <gio/gio.h> GSocketClient; -GSocketClient * g_socket_client_new (void); -GSocketConnection * g_socket_client_connect (GSocketClient *client, - GSocketConnectable *connectable, - GCancellable *cancellable, - GError **error); -void g_socket_client_connect_async (GSocketClient *client, - GSocketConnectable *connectable, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -GSocketConnection * g_socket_client_connect_finish (GSocketClient *client, - GAsyncResult *result, - GError **error); -GSocketConnection * g_socket_client_connect_to_host (GSocketClient *client, - const gchar *host_and_port, - guint16 default_port, - GCancellable *cancellable, - GError **error); +GSocketClient * g_socket_client_new (void); +GSocketConnection * g_socket_client_connect (GSocketClient *client, + GSocketConnectable *connectable, + GCancellable *cancellable, + GError **error); +void g_socket_client_connect_async (GSocketClient *client, + GSocketConnectable *connectable, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +GSocketConnection * g_socket_client_connect_finish (GSocketClient *client, + GAsyncResult *result, + GError **error); +GSocketConnection * g_socket_client_connect_to_host (GSocketClient *client, + const gchar *host_and_port, + guint16 default_port, + GCancellable *cancellable, + GError **error); void g_socket_client_connect_to_host_async - (GSocketClient *client, - const gchar *host_and_port, - guint16 default_port, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GSocketClient *client, + const gchar *host_and_port, + guint16 default_port, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); GSocketConnection * g_socket_client_connect_to_host_finish - (GSocketClient *client, - GAsyncResult *result, - GError **error); -GSocketConnection * g_socket_client_connect_to_service (GSocketClient *client, - const gchar *domain, - const gchar *service, - GCancellable *cancellable, - GError **error); + (GSocketClient *client, + GAsyncResult *result, + GError **error); +GSocketConnection * g_socket_client_connect_to_service (GSocketClient *client, + const gchar *domain, + const gchar *service, + GCancellable *cancellable, + GError **error); void g_socket_client_connect_to_service_async - (GSocketClient *client, - const gchar *domain, - const gchar *service, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + (GSocketClient *client, + const gchar *domain, + const gchar *service, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); GSocketConnection * g_socket_client_connect_to_service_finish - (GSocketClient *client, - GAsyncResult *result, - GError **error); -void g_socket_client_set_family (GSocketClient *client, - GSocketFamily family); -void g_socket_client_set_local_address (GSocketClient *client, - GSocketAddress *address); -void g_socket_client_set_protocol (GSocketClient *client, - GSocketProtocol protocol); -void g_socket_client_set_socket_type (GSocketClient *client, - GSocketType type); -GSocketFamily g_socket_client_get_family (GSocketClient *client); -GSocketAddress * g_socket_client_get_local_address (GSocketClient *client); -GSocketProtocol g_socket_client_get_protocol (GSocketClient *client); -GSocketType g_socket_client_get_socket_type (GSocketClient *client); + (GSocketClient *client, + GAsyncResult *result, + GError **error); +void g_socket_client_set_family (GSocketClient *client, + GSocketFamily family); +void g_socket_client_set_local_address (GSocketClient *client, + GSocketAddress *address); +void g_socket_client_set_protocol (GSocketClient *client, + GSocketProtocol protocol); +void g_socket_client_set_socket_type (GSocketClient *client, + GSocketType type); +GSocketFamily g_socket_client_get_family (GSocketClient *client); +GSocketAddress * g_socket_client_get_local_address (GSocketClient *client); +GSocketProtocol g_socket_client_get_protocol (GSocketClient *client); +GSocketType g_socket_client_get_socket_type (GSocketClient *client);

Object Hierarchy

-  GObject
+  GObject
    +----GSocketClient
 
@@ -164,7 +134,8 @@ subclass on success.

The type of the GSocketConnection object returned depends on the type of the underlying socket that is in use. For instance, for a TCP/IP connection -it will be a GTcpConnection.

+it will be a GTcpConnection. +

Details

@@ -172,21 +143,23 @@ it will be a

GSocketClient

typedef struct _GSocketClient GSocketClient;

-A helper class for network servers to listen for and accept connections.

+A helper class for network servers to listen for and accept connections. +

Since 2.22


g_socket_client_new ()

-
GSocketClient *     g_socket_client_new                 (void);
+
GSocketClient *     g_socket_client_new                 (void);

-Creates a new GSocketClient with the default options.

+Creates a new GSocketClient with the default options. +

@@ -196,10 +169,10 @@ Creates a new

g_socket_client_connect ()

-
GSocketConnection * g_socket_client_connect             (GSocketClient *client,
-                                                         GSocketConnectable *connectable,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocketConnection * g_socket_client_connect             (GSocketClient *client,
+                                                         GSocketConnectable *connectable,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Tries to resolve the connectable and make a network connection to it..

@@ -222,33 +195,35 @@ defaults to

If a local address is specified with g_socket_client_set_local_address() the -socket will be bound to this address before connecting.

+socket will be bound to this address before connecting. +

Returns :

a GSocketClient. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - - - - @@ -259,44 +234,45 @@ socket will be bound to this address before connecting.


g_socket_client_connect_async ()

-
void                g_socket_client_connect_async       (GSocketClient *client,
-                                                         GSocketConnectable *connectable,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_socket_client_connect_async       (GSocketClient *client,
+                                                         GSocketConnectable *connectable,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

This is the asynchronous version of g_socket_client_connect().

When the operation is finished callback will be called. You can then call g_socket_client_connect_finish() to get -the result of the operation.

+the result of the operation. +

client :

a GSocketClient. +a GSocketClient.

connectable :

a GSocketConnectable specifying the remote address. +a GSocketConnectable specifying the remote address.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - - @@ -306,33 +282,34 @@ the result of the operation.


g_socket_client_connect_finish ()

-
GSocketConnection * g_socket_client_connect_finish      (GSocketClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
GSocketConnection * g_socket_client_connect_finish      (GSocketClient *client,
+                                                         GAsyncResult *result,
+                                                         GError **error);

-Finishes an async connect operation. See g_socket_client_connect_async()

+Finishes an async connect operation. See g_socket_client_connect_async() +

client :

a GTcpClient +a GTcpClient

connectable :

a GSocketConnectable specifying the remote address. +a GSocketConnectable specifying the remote address.

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data for the callback +user data for the callback
- - - - @@ -343,11 +320,11 @@ ignore.

g_socket_client_connect_to_host ()

-
GSocketConnection * g_socket_client_connect_to_host     (GSocketClient *client,
-                                                         const gchar *host_and_port,
-                                                         guint16 default_port,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocketConnection * g_socket_client_connect_to_host     (GSocketClient *client,
+                                                         const gchar *host_and_port,
+                                                         guint16 default_port,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

This is a helper function for g_socket_client_connect().

@@ -384,39 +361,40 @@ reference to it when finished with it.

In the event of any failure (DNS error, service not found, no hosts -connectable) NULL is returned and error (if non-NULL) is set -accordingly.

+connectable) NULL is returned and error (if non-NULL) is set +accordingly. +

client :

a GSocketClient. +a GSocketClient.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - - - @@ -428,50 +406,51 @@ accordingly.

g_socket_client_connect_to_host_async ()

void                g_socket_client_connect_to_host_async
-                                                        (GSocketClient *client,
-                                                         const gchar *host_and_port,
-                                                         guint16 default_port,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GSocketClient *client, + const gchar *host_and_port, + guint16 default_port, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

This is the asynchronous version of g_socket_client_connect_to_host().

When the operation is finished callback will be called. You can then call g_socket_client_connect_to_host_finish() to get -the result of the operation.

+the result of the operation. +

client :

a SocketClient +a SocketClient

host_and_port :

the name and optionally port of the host to connect to +the name and optionally port of the host to connect to

default_port :

the default port to connect to +the default port to connect to

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

a pointer to a GError, or NULL +a pointer to a GError, or NULL

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - - - @@ -482,33 +461,34 @@ the result of the operation.

g_socket_client_connect_to_host_finish ()

GSocketConnection * g_socket_client_connect_to_host_finish
-                                                        (GSocketClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+ (GSocketClient *client, + GAsyncResult *result, + GError **error);

-Finishes an async connect operation. See g_socket_client_connect_to_host_async()

+Finishes an async connect operation. See g_socket_client_connect_to_host_async() +

client :

a GTcpClient +a GTcpClient

host_and_port :

the name and optionally the port of the host to connect to +the name and optionally the port of the host to connect to

default_port :

the default port to connect to +the default port to connect to

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data for the callback +user data for the callback
- - - - @@ -519,11 +499,11 @@ ignore.

g_socket_client_connect_to_service ()

-
GSocketConnection * g_socket_client_connect_to_service  (GSocketClient *client,
-                                                         const gchar *domain,
-                                                         const gchar *service,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocketConnection * g_socket_client_connect_to_service  (GSocketClient *client,
+                                                         const gchar *domain,
+                                                         const gchar *service,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Attempts to create a TCP connection to a service.

@@ -540,39 +520,40 @@ reference to it when finished with it.

In the event of any failure (DNS error, service not found, no hosts -connectable) NULL is returned and error (if non-NULL) is set -accordingly.

+connectable) NULL is returned and error (if non-NULL) is set +accordingly. +

client :

a GSocketClient. +a GSocketClient.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - - - @@ -582,46 +563,47 @@ accordingly.

g_socket_client_connect_to_service_async ()

void                g_socket_client_connect_to_service_async
-                                                        (GSocketClient *client,
-                                                         const gchar *domain,
-                                                         const gchar *service,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GSocketClient *client, + const gchar *domain, + const gchar *service, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

This is the asynchronous version of -g_socket_client_connect_to_service().

+g_socket_client_connect_to_service(). +

client :

a GSocketConnection +a GSocketConnection

domain :

a domain name +a domain name

service :

the name of the service to connect to +the name of the service to connect to

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

error :

a pointer to a GError, or NULL +a pointer to a GError, or NULL

Returns :

a GSocketConnection if successful, or NULL on error +a GSocketConnection if successful, or NULL on error
- - - - - - @@ -632,33 +614,34 @@ This is the asynchronous version of

g_socket_client_connect_to_service_finish ()

GSocketConnection * g_socket_client_connect_to_service_finish
-                                                        (GSocketClient *client,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+ (GSocketClient *client, + GAsyncResult *result, + GError **error);

-Finishes an async connect operation. See g_socket_client_connect_to_service_async()

+Finishes an async connect operation. See g_socket_client_connect_to_service_async() +

client :

a GSocketClient +a GSocketClient

domain :

a domain name +a domain name

service :

the name of the service to connect to +the name of the service to connect to

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data for the callback +user data for the callback
- - - - @@ -669,8 +652,8 @@ ignore.

g_socket_client_set_family ()

-
void                g_socket_client_set_family          (GSocketClient *client,
-                                                         GSocketFamily family);
+
void                g_socket_client_set_family          (GSocketClient *client,
+                                                         GSocketFamily family);

Sets the socket family of the socket client. If this is set to something other than G_SOCKET_FAMILY_INVALID @@ -680,18 +663,19 @@ family.

This might be useful for instance if you want to force the local connection to be an ipv4 socket, even though the address might -be an ipv6 mapped to ipv4 address.

+be an ipv6 mapped to ipv4 address. +

client :

a GSocketClient. +a GSocketClient.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - @@ -701,28 +685,29 @@ be an ipv6 mapped to ipv4 address.


g_socket_client_set_local_address ()

-
void                g_socket_client_set_local_address   (GSocketClient *client,
-                                                         GSocketAddress *address);
+
void                g_socket_client_set_local_address   (GSocketClient *client,
+                                                         GSocketAddress *address);

Sets the local address of the socket client. The sockets created by this object will bound to the -specified address (if not NULL) before connecting. +specified address (if not NULL) before connecting.

This is useful if you want to ensure the the local side of the connection is on a specific port, or on -a specific interface.

+a specific interface. +

client :

a GSocketClient. +a GSocketClient.

family :

a GSocketFamily +a GSocketFamily
- - @@ -732,8 +717,8 @@ a specific interface.


g_socket_client_set_protocol ()

-
void                g_socket_client_set_protocol        (GSocketClient *client,
-                                                         GSocketProtocol protocol);
+
void                g_socket_client_set_protocol        (GSocketClient *client,
+                                                         GSocketProtocol protocol);

Sets the protocol of the socket client. The sockets created by this object will use of the specified @@ -741,18 +726,19 @@ protocol.

If protocol is 0 that means to use the default -protocol for the socket family and type.

+protocol for the socket family and type. +

client :

a GSocketClient. +a GSocketClient.

address :

a GSocketAddress, or NULL +a GSocketAddress, or NULL
- - @@ -762,8 +748,8 @@ protocol for the socket family and type.


g_socket_client_set_socket_type ()

-
void                g_socket_client_set_socket_type     (GSocketClient *client,
-                                                         GSocketType type);
+
void                g_socket_client_set_socket_type     (GSocketClient *client,
+                                                         GSocketType type);

Sets the socket type of the socket client. The sockets created by this object will be of the specified @@ -771,18 +757,19 @@ type.

It doesn't make sense to specify a type of G_SOCKET_TYPE_DATAGRAM, -as GSocketClient is used for connection oriented services.

+as GSocketClient is used for connection oriented services. +

client :

a GSocketClient. +a GSocketClient.

protocol :

a GSocketProtocol +a GSocketProtocol
- - @@ -792,18 +779,19 @@ as GSocketClient is used for connection oriented services.


g_socket_client_get_family ()

-
GSocketFamily       g_socket_client_get_family          (GSocketClient *client);
+
GSocketFamily       g_socket_client_get_family          (GSocketClient *client);

Gets the socket family of the socket client.

-See g_socket_client_set_family() for details.

+See g_socket_client_set_family() for details. +

client :

a GSocketClient. +a GSocketClient.

type :

a GSocketType +a GSocketType
- @@ -819,23 +807,24 @@ See

g_socket_client_get_local_address ()

-
GSocketAddress *    g_socket_client_get_local_address   (GSocketClient *client);
+
GSocketAddress *    g_socket_client_get_local_address   (GSocketClient *client);

Gets the local address of the socket client.

-See g_socket_client_set_local_address() for details.

+See g_socket_client_set_local_address() for details. +

client :

a GSocketClient. +a GSocketClient.
- - @@ -846,18 +835,19 @@ See

g_socket_client_get_protocol ()

-
GSocketProtocol     g_socket_client_get_protocol        (GSocketClient *client);
+
GSocketProtocol     g_socket_client_get_protocol        (GSocketClient *client);

Gets the protocol name type of the socket client.

-See g_socket_client_set_protocol() for details.

+See g_socket_client_set_protocol() for details. +

client :

a GSocketClient. +a GSocketClient.

Returns :

a GSocketAddres or NULL. don't free + a GSocketAddres or NULL. don't free
- @@ -873,18 +863,19 @@ See

g_socket_client_get_socket_type ()

-
GSocketType         g_socket_client_get_socket_type     (GSocketClient *client);
+
GSocketType         g_socket_client_get_socket_type     (GSocketClient *client);

Gets the socket type of the socket client.

-See g_socket_client_set_socket_type() for details.

+See g_socket_client_set_socket_type() for details. +

client :

a GSocketClient +a GSocketClient
- @@ -934,6 +925,6 @@ See + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketConnectable.html b/docs/reference/gio/html/GSocketConnectable.html index f4dc998..0ea4bdb 100644 --- a/docs/reference/gio/html/GSocketConnectable.html +++ b/docs/reference/gio/html/GSocketConnectable.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

client :

a GSocketClient. +a GSocketClient.
@@ -76,21 +46,21 @@
                    GSocketConnectable;
                     GSocketConnectableIface;
 GSocketAddressEnumerator * g_socket_connectable_enumerate
-                                                        (GSocketConnectable *connectable);
+                                                        (GSocketConnectable *connectable);
 
                     GSocketAddressEnumerator;
-GSocketAddress *    g_socket_address_enumerator_next    (GSocketAddressEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+GSocketAddress *    g_socket_address_enumerator_next    (GSocketAddressEnumerator *enumerator,
+                                                         GCancellable *cancellable,
+                                                         GError **error);
 void                g_socket_address_enumerator_next_async
-                                                        (GSocketAddressEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+                                                        (GSocketAddressEnumerator *enumerator,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);
 GSocketAddress *    g_socket_address_enumerator_next_finish
-                                                        (GSocketAddressEnumerator *enumerator,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+                                                        (GSocketAddressEnumerator *enumerator,
+                                                         GAsyncResult *result,
+                                                         GError **error);
 
@@ -100,7 +70,7 @@ +----GSocketConnectable
-  GObject
+  GObject
    +----GSocketAddressEnumerator
 
@@ -108,13 +78,13 @@

Prerequisites

GSocketConnectable requires - GObject.

+ GObject.

Description

@@ -127,61 +97,123 @@ in the sample code below.

-
-MyConnectionType *
-connect_to_host (const char    *hostname,
-                 guint16        port,
-                 GCancellable  *cancellable,
-                 GError       **error)
-{
-  MyConnection *conn = NULL;
-  GSocketConnectable *addr;
-  GSocketAddressEnumerator *enumerator;
-  GSocketAddress *sockaddr;
-  GError *conn_error = NULL;
+
+
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
MyConnectionType *
+connect_to_host (const char    *hostname,
+                 guint16        port,
+                 GCancellable  *cancellable,
+                 GError       **error)
+{
+  MyConnection *conn = NULL;
+  GSocketConnectable *addr;
+  GSocketAddressEnumerator *enumerator;
+  GSocketAddress *sockaddr;
+  GError *conn_error = NULL;
 
-  addr = g_network_address_new ("www.gnome.org", 80);
-  enumerator = g_socket_connectable_enumerate (addr);
-  g_object_unref (addr);
+  addr = g_network_address_new ("www.gnome.org", 80);
+  enumerator = g_socket_connectable_enumerate (addr);
+  g_object_unref (addr);
 
-  /* Try each sockaddr until we succeed. Record the first
-   * connection error, but not any further ones (since they'll probably
-   * be basically the same as the first).
-   */
-  while (!conn && (sockaddr = g_socket_address_enumerator_next (enumerator, cancellable, error))
-    {
-      conn = connect_to_sockaddr (sockaddr, conn_error ? NULL : &conn_error);
-      g_object_unref (sockaddr);
-    }
-  g_object_unref (enumerator);
+  /* Try each sockaddr until we succeed. Record the first
+   * connection error, but not any further ones (since they'll probably
+   * be basically the same as the first).
+   */
+  while (!conn && (sockaddr = g_socket_address_enumerator_next (enumerator, cancellable, error))
+    {
+      conn = connect_to_sockaddr (sockaddr, conn_error ? NULL : &conn_error);
+      g_object_unref (sockaddr);
+    }
+  g_object_unref (enumerator);
 
-  if (conn)
-    {
-      if (conn_error)
-        {
-          /* We couldn't connect to the first address, but we succeeded
-           * in connecting to a later address.
-           */
-          g_error_free (conn_error);
-        }
-      return conn;
-    }
-  else if (error)
-    {
-      /* Either the initial lookup failed, or else the caller
-       * cancelled us.
-       */
-      if (conn_error)
-        g_error_free (conn_error);
-      return NULL;
-    }
-  else
-    {
-      g_error_propagate (error, conn_error);
-      return NULL;
-    }
-}
-
+ if (conn) + { + if (conn_error) + { + /* We couldn't connect to the first address, but we succeeded + * in connecting to a later address. + */ + g_error_free (conn_error); + } + return conn; + } + else if (error) + { + /* Either the initial lookup failed, or else the caller + * cancelled us. + */ + if (conn_error) + g_error_free (conn_error); + return NULL; + } + else + { + g_error_propagate (error, conn_error); + return NULL; + } +}
+
+ +

+

Details

@@ -189,7 +221,8 @@ connect_to_host (const char *hostname,

GSocketConnectable

typedef struct _GSocketConnectable GSocketConnectable;

-Interface for objects that contain or generate GSocketAddresses.

+Interface for objects that contain or generate GSocketAddresses. +


@@ -203,18 +236,19 @@ Interface for objects that contain or generate GSocketAddressEnumerator

+Provides an interface for returning a GSocketAddressEnumerator +

- - + - @@ -224,15 +258,16 @@ Provides an interface for returning a

g_socket_connectable_enumerate ()

GSocketAddressEnumerator * g_socket_connectable_enumerate
-                                                        (GSocketConnectable *connectable);
+ (GSocketConnectable *connectable);

-Creates a GSocketAddressEnumerator for connectable.

+Creates a GSocketAddressEnumerator for connectable. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

enumerate ()

Creates a GSocketAddressEnumerator +Creates a GSocketAddressEnumerator
- @@ -251,14 +286,15 @@ Creates a typedef struct _GSocketAddressEnumerator GSocketAddressEnumerator;

Enumerator type for objects that contain or generate -GSocketAddresses.

+GSocketAddresses. +


g_socket_address_enumerator_next ()

-
GSocketAddress *    g_socket_address_enumerator_next    (GSocketAddressEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocketAddress *    g_socket_address_enumerator_next    (GSocketAddressEnumerator *enumerator,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Retrieves the next GSocketAddress from enumerator. Note that this may block for some amount of time. (Eg, a GNetworkAddress may need @@ -273,28 +309,29 @@ is unable to (eg, because of a DNS error), then the first call to in *error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than cancellable being triggered) will be -ignored.

+ignored. +

connectable :

a GSocketConnectable +a GSocketConnectable
- - - - @@ -306,35 +343,36 @@ ignored.

g_socket_address_enumerator_next_async ()

void                g_socket_address_enumerator_next_async
-                                                        (GSocketAddressEnumerator *enumerator,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GSocketAddressEnumerator *enumerator, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

Asynchronously retrieves the next GSocketAddress from enumerator and then calls callback, which must call -g_socket_address_enumerator_next_finish() to get the result.

+g_socket_address_enumerator_next_finish() to get the result. +

enumerator :

a GSocketAddressEnumerator +a GSocketAddressEnumerator

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

a GError. +a GError.

Returns :

a GSocketAddress (owned by the caller), or NULL on + a GSocketAddress (owned by the caller), or NULL on error (in which case *error will be set) or if there are no more addresses.
- - - - @@ -344,35 +382,36 @@ and then calls callback, which must call

g_socket_address_enumerator_next_finish ()

GSocketAddress *    g_socket_address_enumerator_next_finish
-                                                        (GSocketAddressEnumerator *enumerator,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+ (GSocketAddressEnumerator *enumerator, + GAsyncResult *result, + GError **error);

Retrieves the result of a completed call to g_socket_address_enumerator_next_async(). See g_socket_address_enumerator_next() for more information about -error handling.

+error handling. +

enumerator :

a GSocketAddressEnumerator +a GSocketAddressEnumerator

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback to call when the request is satisfied +a GAsyncReadyCallback to call when the request is satisfied

user_data :

the data to pass to callback function +the data to pass to callback function
- - - - @@ -384,6 +423,6 @@ error handling.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketConnection.html b/docs/reference/gio/html/GSocketConnection.html index 348f194..e62e24d 100644 --- a/docs/reference/gio/html/GSocketConnection.html +++ b/docs/reference/gio/html/GSocketConnection.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

enumerator :

a GSocketAddressEnumerator +a GSocketAddressEnumerator

result :

a GAsyncResult +a GAsyncResult

error :

a GError +a GError

Returns :

a GSocketAddress (owned by the caller), or NULL on + a GSocketAddress (owned by the caller), or NULL on error (in which case *error will be set) or if there are no more addresses.
@@ -76,59 +46,59 @@ GSocketConnection; GSocketAddress * g_socket_connection_get_local_address - (GSocketConnection *connection, - GError **error); + (GSocketConnection *connection, + GError **error); GSocketAddress * g_socket_connection_get_remote_address - (GSocketConnection *connection, - GError **error); -GSocket * g_socket_connection_get_socket (GSocketConnection *connection); + (GSocketConnection *connection, + GError **error); +GSocket * g_socket_connection_get_socket (GSocketConnection *connection); GTcpConnection; voidg_tcp_connection_set_graceful_disconnect - (GTcpConnection *connection, - gboolean graceful_disconnect); -gbooleang_tcp_connection_get_graceful_disconnect - (GTcpConnection *connection); + (GTcpConnection *connection, + gboolean graceful_disconnect); +gbooleang_tcp_connection_get_graceful_disconnect + (GTcpConnection *connection); GUnixConnection; -gintg_unix_connection_receive_fd (GUnixConnection *connection, - GCancellable *cancellable, - GError **error); -gbooleang_unix_connection_send_fd (GUnixConnection *connection, - gint fd, - GCancellable *cancellable, - GError **error); +gintg_unix_connection_receive_fd (GUnixConnection *connection, + GCancellable *cancellable, + GError **error); +gbooleang_unix_connection_send_fd (GUnixConnection *connection, + gint fd, + GCancellable *cancellable, + GError **error); GSocketConnection * g_socket_connection_factory_create_connection - (GSocket *socket); -GTypeg_socket_connection_factory_lookup_type - (GSocketFamily family, - GSocketType type, - gint protocol_id); + (GSocket *socket); +GTypeg_socket_connection_factory_lookup_type + (GSocketFamily family, + GSocketType type, + gint protocol_id); voidg_socket_connection_factory_register_type - (GType g_type, - GSocketFamily family, - GSocketType type, - gint protocol); + (GType g_type, + GSocketFamily family, + GSocketType type, + gint protocol);

Object Hierarchy

-  GObject
+  GObject
    +----GIOStream
          +----GSocketConnection
                +----GTcpConnection
                +----GUnixConnection
 
-  GObject
+  GObject
    +----GIOStream
          +----GSocketConnection
                +----GTcpConnection
 
-  GObject
+  GObject
    +----GIOStream
          +----GSocketConnection
                +----GUnixConnection
@@ -138,7 +108,7 @@
 

Properties

   "socket"                   GSocket*              : Read / Write / Construct Only
-  "graceful-disconnect"      gboolean              : Read / Write
+  "graceful-disconnect"      gboolean              : Read / Write
 
@@ -157,7 +127,8 @@ instance, for a TCP/IP connection it will be a g_socket_connection_factory_register_type().

+family/type/protocol using g_socket_connection_factory_register_type(). +

Details

@@ -165,34 +136,37 @@ family/type/protocol using

GSocketConnection

typedef struct _GSocketConnection GSocketConnection;

-A socket connection GIOStream object for connection-oriented sockets.

+A socket connection GIOStream object for connection-oriented sockets. +

Since 2.22


g_socket_connection_get_local_address ()

GSocketAddress *    g_socket_connection_get_local_address
-                                                        (GSocketConnection *connection,
-                                                         GError **error);
+ (GSocketConnection *connection, + GError **error);

-Try to get the local address of a socket connection.

+Try to get the local address of a socket connection. +

- - - @@ -204,27 +178,29 @@ Try to get the local address of a socket connection.

g_socket_connection_get_remote_address ()

GSocketAddress *    g_socket_connection_get_remote_address
-                                                        (GSocketConnection *connection,
-                                                         GError **error);
+ (GSocketConnection *connection, + GError **error);

-Try to get the remote address of a socket connection.

+Try to get the remote address of a socket connection. +

connection :

a GSocketConnection +a GSocketConnection

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketAddress or NULL on error. - Free the returned object with g_object_unref(). + a GSocketAddress or NULL on error. + Free the returned object with g_object_unref().
- - - @@ -235,22 +211,23 @@ Try to get the remote address of a socket connection.


g_socket_connection_get_socket ()

-
GSocket *           g_socket_connection_get_socket      (GSocketConnection *connection);
+
GSocket *           g_socket_connection_get_socket      (GSocketConnection *connection);

Gets the underlying GSocket object of the connection. This can be useful if you want to do something unusual on it -not supported by the GSocketConnection APIs.

+not supported by the GSocketConnection APIs. +

connection :

a GSocketConnection +a GSocketConnection

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketAddress or NULL on error. - Free the returned object with g_object_unref(). + a GSocketAddress or NULL on error. + Free the returned object with g_object_unref().
- - @@ -263,15 +240,16 @@ not supported by the

GTcpConnection

typedef struct _GTcpConnection GTcpConnection;

-A GSocketConnection for UNIX domain socket connections.

+A GSocketConnection for TCP/IP connections. +

Since 2.22


g_tcp_connection_set_graceful_disconnect ()

void                g_tcp_connection_set_graceful_disconnect
-                                                        (GTcpConnection *connection,
-                                                         gboolean graceful_disconnect);
+ (GTcpConnection *connection, + gboolean graceful_disconnect);

This enabled graceful disconnects on close. A graceful disconnect means that we signal the recieving end that the connection is terminated @@ -282,18 +260,19 @@ A graceful disconnect means that we can be sure that we successfully sent all the outstanding data to the other end, or get an error reported. However, it also means we have to wait for all the data to reach the other side and for it to acknowledge this by closing the socket, which may -take a while. For this reason it is disabled by default.

+take a while. For this reason it is disabled by default. +

connection :

a GSocketConnection +a GSocketConnection

Returns :

a GSocketAddress or NULL on error. + a GSocketAddress or NULL on error.
- - @@ -303,22 +282,23 @@ take a while. For this reason it is disabled by default.


g_tcp_connection_get_graceful_disconnect ()

-
gboolean            g_tcp_connection_get_graceful_disconnect
-                                                        (GTcpConnection *connection);
+
gboolean            g_tcp_connection_get_graceful_disconnect
+                                                        (GTcpConnection *connection);

Checks if graceful disconnects are used. See -g_tcp_connection_set_graceful_disconnect().

+g_tcp_connection_set_graceful_disconnect(). +

connection :

a GTcpConnection +a GTcpConnection

graceful_disconnect :

Whether to do graceful disconnects or not +Whether to do graceful disconnects or not
- - @@ -336,9 +316,9 @@ Checks if graceful disconnects are used. See

g_unix_connection_receive_fd ()

-
gint                g_unix_connection_receive_fd        (GUnixConnection *connection,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gint                g_unix_connection_receive_fd        (GUnixConnection *connection,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Receives a file descriptor from the sending end of the connection. The sending end has to call g_unix_connection_send_fd() for this @@ -347,23 +327,25 @@ to work.

As well as reading the fd this also reads a single byte from the stream, as this is required for fd passing to work on some -implementations.

+implementations. +

connection :

a GTcpConnection +a GTcpConnection

Returns :

TRUE if graceful disconnect is used on close, FALSE otherwise + TRUE if graceful disconnect is used on close, FALSE otherwise
- - - @@ -379,10 +361,10 @@ implementations.


g_unix_connection_send_fd ()

-
gboolean            g_unix_connection_send_fd           (GUnixConnection *connection,
-                                                         gint fd,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
gboolean            g_unix_connection_send_fd           (GUnixConnection *connection,
+                                                         gint fd,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Passes a file descriptor to the recieving side of the connection. The recieving end has to call g_unix_connection_receive_fd() @@ -391,33 +373,35 @@ to accept the file descriptor.

As well as sending the fd this also writes a single byte to the stream, as this is required for fd passing to work on some -implementations.

+implementations. +

connection :

a GUnixConnection +a GUnixConnection

cancellable :

optional GCancellable object, NULL to ignore +optional GCancellable object, NULL to ignore

error :

GError for error reporting, or NULL to ignore + +GError for error reporting, or NULL to ignore
- - - - - @@ -429,16 +413,17 @@ implementations.

g_socket_connection_factory_create_connection ()

GSocketConnection * g_socket_connection_factory_create_connection
-                                                        (GSocket *socket);
+ (GSocket *socket);

Creates a GSocketConnection subclass of the right type for -socket.

+socket. +

connection :

a GUnixConnection +a GUnixConnection

fd :

a file descriptor +a file descriptor

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a TRUE on success, NULL on error. + a TRUE on success, NULL on error.
- @@ -454,37 +439,38 @@ Creates a

g_socket_connection_factory_lookup_type ()

-
GType               g_socket_connection_factory_lookup_type
-                                                        (GSocketFamily family,
-                                                         GSocketType type,
-                                                         gint protocol_id);
+
GType               g_socket_connection_factory_lookup_type
+                                                        (GSocketFamily family,
+                                                         GSocketType type,
+                                                         gint protocol_id);

-Looks up the GType to be used when creating socket connections on +Looks up the GType to be used when creating socket connections on sockets with the specified family,type and protocol_id.

-If no type is registered, the GSocketConnection base type is returned.

+If no type is registered, the GSocketConnection base type is returned. +

socket :

a GSocket +a GSocket
- - - - @@ -496,37 +482,38 @@ If no type is registered, the

g_socket_connection_factory_register_type ()

void                g_socket_connection_factory_register_type
-                                                        (GType g_type,
-                                                         GSocketFamily family,
-                                                         GSocketType type,
-                                                         gint protocol);
+ (GType g_type, + GSocketFamily family, + GSocketType type, + gint protocol);

-Looks up the GType to be used when creating socket connections on +Looks up the GType to be used when creating socket connections on sockets with the specified family,type and protocol.

-If no type is registered, the GSocketConnection base type is returned.

+If no type is registered, the GSocketConnection base type is returned. +

family :

a GSocketFamily +a GSocketFamily

type :

a GSocketType +a GSocketType

protocol_id :

a protocol id +a protocol id

Returns :

a GType + a GType
- - - - @@ -544,7 +531,7 @@ If no type is registered, the

The "graceful-disconnect" property

-
  "graceful-disconnect"      gboolean              : Read / Write
+
  "graceful-disconnect"      gboolean              : Read / Write

Whether or not close does a graceful disconnect.

Default value: FALSE

@@ -556,6 +543,6 @@ If no type is registered, the + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketControlMessage.html b/docs/reference/gio/html/GSocketControlMessage.html index 91345ef..2a3056f 100644 --- a/docs/reference/gio/html/GSocketControlMessage.html +++ b/docs/reference/gio/html/GSocketControlMessage.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

g_type :

a GType, inheriting from G_TYPE_SOCKET_CONNECTION +a GType, inheriting from G_TYPE_SOCKET_CONNECTION

family :

a GSocketFamily +a GSocketFamily

type :

a GSocketType +a GSocketType

protocol :

a protocol id +a protocol id
@@ -71,22 +41,22 @@

Synopsis

                    GSocketControlMessage;
 GSocketControlMessage * g_socket_control_message_deserialize
-                                                        (int level,
-                                                         int type,
-                                                         gsize size,
-                                                         gpointer data);
-int                 g_socket_control_message_get_level  (GSocketControlMessage *message);
+                                                        (int level,
+                                                         int type,
+                                                         gsize size,
+                                                         gpointer data);
+int                 g_socket_control_message_get_level  (GSocketControlMessage *message);
 int                 g_socket_control_message_get_msg_type
-                                                        (GSocketControlMessage *message);
-gsize               g_socket_control_message_get_size   (GSocketControlMessage *message);
-void                g_socket_control_message_serialize  (GSocketControlMessage *message,
-                                                         gpointer data);
+                                                        (GSocketControlMessage *message);
+gsize               g_socket_control_message_get_size   (GSocketControlMessage *message);
+void                g_socket_control_message_serialize  (GSocketControlMessage *message,
+                                                         gpointer data);
 

Object Hierarchy

-  GObject
+  GObject
    +----GSocketControlMessage
          +----GUnixFDMessage
 
@@ -117,7 +87,8 @@ methods. To extend the set of control messages that can be received, subclass this class and implement the deserialize method. Also, make sure your class is registered with the GType typesystem before calling -g_socket_receive_message() to read such a message.

+g_socket_receive_message() to read such a message. +

Details

@@ -126,16 +97,17 @@ class is registered with the GType typesystem before calling
typedef struct _GSocketControlMessage GSocketControlMessage;

Base class for socket-type specific control messages that can be sent and -received over GSocket.

+received over GSocket. +


g_socket_control_message_deserialize ()

GSocketControlMessage * g_socket_control_message_deserialize
-                                                        (int level,
-                                                         int type,
-                                                         gsize size,
-                                                         gpointer data);
+ (int level, + int type, + gsize size, + gpointer data);

Tries to deserialize a socket control message of a given level and type. This will ask all known (to GType) subclasses @@ -143,34 +115,35 @@ of GSocketControlMessage.

-If there is no implementation for this kind of control message, NULL -will be returned.

+If there is no implementation for this kind of control message, NULL +will be returned. +

- - - - - @@ -181,16 +154,17 @@ will be returned.


g_socket_control_message_get_level ()

-
int                 g_socket_control_message_get_level  (GSocketControlMessage *message);
+
int                 g_socket_control_message_get_level  (GSocketControlMessage *message);

Returns the "level" (i.e. the originating protocol) of the control message. -This is often SOL_SOCKET.

+This is often SOL_SOCKET. +

level :

a socket level +a socket level

type :

a socket control message type for the given level +a socket control message type for the given level

size :

the size of the data in bytes +the size of the data in bytes

data :

pointer to the message data +pointer to the message data

Returns :

the deserialized message or NULL + the deserialized message or NULL
- @@ -207,16 +181,17 @@ This is often SOL_SOCKET.

g_socket_control_message_get_msg_type ()

int                 g_socket_control_message_get_msg_type
-                                                        (GSocketControlMessage *message);
+ (GSocketControlMessage *message);

Returns the protocol specific type of the control message. -For instance, for UNIX fd passing this would be SCM_RIGHTS.

+For instance, for UNIX fd passing this would be SCM_RIGHTS. +

message :

a GSocketControlMessage +a GSocketControlMessage
- @@ -232,16 +207,17 @@ For instance, for UNIX fd passing this would be SCM_RIGHTS.


g_socket_control_message_get_size ()

-
gsize               g_socket_control_message_get_size   (GSocketControlMessage *message);
+
gsize               g_socket_control_message_get_size   (GSocketControlMessage *message);

Returns the space required for the control message, not including -headers or alignment.

+headers or alignment. +

message :

a GSocketControlMessage +a GSocketControlMessage
- @@ -257,8 +233,8 @@ headers or alignment.


g_socket_control_message_serialize ()

-
void                g_socket_control_message_serialize  (GSocketControlMessage *message,
-                                                         gpointer data);
+
void                g_socket_control_message_serialize  (GSocketControlMessage *message,
+                                                         gpointer data);

Converts the data in the message to bytes placed in the message. @@ -266,18 +242,19 @@ message.

data is guaranteed to have enough space to fit the size returned by g_socket_control_message_get_size() on this -object.

+object. +

message :

a GSocketControlMessage +a GSocketControlMessage
- - @@ -292,6 +269,6 @@ object.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketListener.html b/docs/reference/gio/html/GSocketListener.html index a11e548..193000e 100644 --- a/docs/reference/gio/html/GSocketListener.html +++ b/docs/reference/gio/html/GSocketListener.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

message :

a GSocketControlMessage +a GSocketControlMessage

data :

A buffer to write data to +A buffer to write data to
@@ -72,60 +42,60 @@

Synopsis

                    GSocketListener;
-GSocketListener *   g_socket_listener_new               (void);
-gboolean            g_socket_listener_add_socket        (GSocketListener *listener,
-                                                         GSocket *socket,
-                                                         GObject *source_object,
-                                                         GError **error);
-gboolean            g_socket_listener_add_address       (GSocketListener *listener,
-                                                         GSocketAddress *address,
-                                                         GSocketType type,
-                                                         GSocketProtocol protocol,
-                                                         GObject *source_object,
-                                                         GSocketAddress **effective_address,
-                                                         GError **error);
-gboolean            g_socket_listener_add_inet_port     (GSocketListener *listener,
-                                                         guint16 port,
-                                                         GObject *source_object,
-                                                         GError **error);
-guint16             g_socket_listener_add_any_inet_port (GSocketListener *listener,
-                                                         GObject *source_object,
-                                                         GError **error);
-GSocketConnection * g_socket_listener_accept            (GSocketListener *listener,
-                                                         GObject **source_object,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
-void                g_socket_listener_accept_async      (GSocketListener *listener,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
-GSocketConnection * g_socket_listener_accept_finish     (GSocketListener *listener,
-                                                         GAsyncResult *result,
-                                                         GObject **source_object,
-                                                         GError **error);
-GSocket *           g_socket_listener_accept_socket     (GSocketListener *listener,
-                                                         GObject **source_object,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+GSocketListener *   g_socket_listener_new               (void);
+gboolean            g_socket_listener_add_socket        (GSocketListener *listener,
+                                                         GSocket *socket,
+                                                         GObject *source_object,
+                                                         GError **error);
+gboolean            g_socket_listener_add_address       (GSocketListener *listener,
+                                                         GSocketAddress *address,
+                                                         GSocketType type,
+                                                         GSocketProtocol protocol,
+                                                         GObject *source_object,
+                                                         GSocketAddress **effective_address,
+                                                         GError **error);
+gboolean            g_socket_listener_add_inet_port     (GSocketListener *listener,
+                                                         guint16 port,
+                                                         GObject *source_object,
+                                                         GError **error);
+guint16             g_socket_listener_add_any_inet_port (GSocketListener *listener,
+                                                         GObject *source_object,
+                                                         GError **error);
+GSocketConnection * g_socket_listener_accept            (GSocketListener *listener,
+                                                         GObject **source_object,
+                                                         GCancellable *cancellable,
+                                                         GError **error);
+void                g_socket_listener_accept_async      (GSocketListener *listener,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);
+GSocketConnection * g_socket_listener_accept_finish     (GSocketListener *listener,
+                                                         GAsyncResult *result,
+                                                         GObject **source_object,
+                                                         GError **error);
+GSocket *           g_socket_listener_accept_socket     (GSocketListener *listener,
+                                                         GObject **source_object,
+                                                         GCancellable *cancellable,
+                                                         GError **error);
 void                g_socket_listener_accept_socket_async
-                                                        (GSocketListener *listener,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+                                                        (GSocketListener *listener,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);
 GSocket *           g_socket_listener_accept_socket_finish
-                                                        (GSocketListener *listener,
-                                                         GAsyncResult *result,
-                                                         GObject **source_object,
-                                                         GError **error);
-void                g_socket_listener_close             (GSocketListener *listener);
-void                g_socket_listener_set_backlog       (GSocketListener *listener,
-                                                         int listen_backlog);
+                                                        (GSocketListener *listener,
+                                                         GAsyncResult *result,
+                                                         GObject **source_object,
+                                                         GError **error);
+void                g_socket_listener_close             (GSocketListener *listener);
+void                g_socket_listener_set_backlog       (GSocketListener *listener,
+                                                         int listen_backlog);
 

Object Hierarchy

-  GObject
+  GObject
    +----GSocketListener
          +----GSocketService
 
@@ -133,7 +103,7 @@

Properties

-  "listen-backlog"           gint                  : Read / Write / Construct
+  "listen-backlog"           gint                  : Read / Write / Construct
 
@@ -146,7 +116,8 @@ socket, either sync or async.

If you want to implement a network server, also look at GSocketService and GThreadedSocketService which are subclass of GSocketListener -that makes this even easier.

+that makes this even easier. +

Details

@@ -159,11 +130,12 @@ that makes this even easier.


g_socket_listener_new ()

-
GSocketListener *   g_socket_listener_new               (void);
+
GSocketListener *   g_socket_listener_new               (void);

Creates a new GSocketListener with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() -or g_socket_listener_add_inet_port().

+or g_socket_listener_add_inet_port(). +

@@ -178,10 +150,10 @@ or

g_socket_listener_add_socket ()

-
gboolean            g_socket_listener_add_socket        (GSocketListener *listener,
-                                                         GSocket *socket,
-                                                         GObject *source_object,
-                                                         GError **error);
+
gboolean            g_socket_listener_add_socket        (GSocketListener *listener,
+                                                         GSocket *socket,
+                                                         GObject *source_object,
+                                                         GError **error);

Adds socket to the set of sockets that we try to accept new clients from. The socket must be bound to a local @@ -191,33 +163,35 @@ address and listened to. source_object will be passed out in the various calls to accept to identify this particular source, which is useful if you're listening on multiple addresses and do -different things depending on what address is connected to.

+different things depending on what address is connected to. +

- - - - - @@ -228,13 +202,13 @@ different things depending on what address is connected to.


g_socket_listener_add_address ()

-
gboolean            g_socket_listener_add_address       (GSocketListener *listener,
-                                                         GSocketAddress *address,
-                                                         GSocketType type,
-                                                         GSocketProtocol protocol,
-                                                         GObject *source_object,
-                                                         GSocketAddress **effective_address,
-                                                         GError **error);
+
gboolean            g_socket_listener_add_address       (GSocketListener *listener,
+                                                         GSocketAddress *address,
+                                                         GSocketType type,
+                                                         GSocketProtocol protocol,
+                                                         GObject *source_object,
+                                                         GSocketAddress **effective_address,
+                                                         GError **error);

Creates a socket of type type and protocol protocol, binds it to address and adds it to the set of sockets we're accepting @@ -253,52 +227,54 @@ useful if you're listening on multiple addresses and do different things depending on what address is connected to.

-If successful and effective_address is non-NULL then it will +If successful and effective_address is non-NULL then it will be set to the address that the binding actually occured at. This is helpful for determining the port number that was used for when requesting a binding to port 0 (ie: "any port"). This address, if -requested, belongs to the caller and must be freed.

+requested, belongs to the caller and must be freed. +

listener :

a GSocketListener +a GSocketListener

socket :

a listening GSocket +a listening GSocket

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - - - - - - @@ -309,10 +285,10 @@ requested, belongs to the caller and must be freed.


g_socket_listener_add_inet_port ()

-
gboolean            g_socket_listener_add_inet_port     (GSocketListener *listener,
-                                                         guint16 port,
-                                                         GObject *source_object,
-                                                         GError **error);
+
gboolean            g_socket_listener_add_inet_port     (GSocketListener *listener,
+                                                         guint16 port,
+                                                         GObject *source_object,
+                                                         GError **error);

Helper function for g_socket_listener_add_address() that creates a TCP/IP socket listening on IPv4 and IPv6 (if @@ -322,33 +298,35 @@ supported) on the specified port on all interfaces. source_object will be passed out in the various calls to accept to identify this particular source, which is useful if you're listening on multiple addresses and do -different things depending on what address is connected to.

+different things depending on what address is connected to. +

listener :

a GSocketListener +a GSocketListener

address :

a GSocketAddress +a GSocketAddress

type :

a GSocketType +a GSocketType

protocol :

a GSocketProtocol +a GSocketProtocol

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

effective_address :

location to store the address that was bound to, or NULL. +location to store the address that was bound to, or NULL.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - - - @@ -359,9 +337,9 @@ different things depending on what address is connected to.


g_socket_listener_add_any_inet_port ()

-
guint16             g_socket_listener_add_any_inet_port (GSocketListener *listener,
-                                                         GObject *source_object,
-                                                         GError **error);
+
guint16             g_socket_listener_add_any_inet_port (GSocketListener *listener,
+                                                         GObject *source_object,
+                                                         GError **error);

Listens for TCP connections on any available port number for both IPv6 and IPv4 (if each are available). @@ -374,23 +352,24 @@ but don't care about the specific port number. source_object will be passed out in the various calls to accept to identify this particular source, which is useful if you're listening on multiple addresses and do -different things depending on what address is connected to.

+different things depending on what address is connected to. +

listener :

a GSocketListener +a GSocketListener

port :

an IP port number (non-zero) +an IP port number (non-zero)

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

TRUE on success, FALSE on error. + TRUE on success, FALSE on error.
- - - @@ -407,50 +386,52 @@ ignore.

g_socket_listener_accept ()

-
GSocketConnection * g_socket_listener_accept            (GSocketListener *listener,
-                                                         GObject **source_object,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocketConnection * g_socket_listener_accept            (GSocketListener *listener,
+                                                         GObject **source_object,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Blocks waiting for a client to connect to any of the sockets added to the listener. Returns a GSocketConnection for the socket that was accepted.

-If source_object is not NULL it will be filled out with the source +If source_object is not NULL it will be filled out with the source object specified when the corresponding socket or address was added to the listener.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

listener :

a GSocketListener +a GSocketListener

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.
- - - - - @@ -461,38 +442,39 @@ was cancelled, the error

g_socket_listener_accept_async ()

-
void                g_socket_listener_accept_async      (GSocketListener *listener,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_socket_listener_accept_async      (GSocketListener *listener,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

This is the asynchronous version of g_socket_listener_accept().

When the operation is finished callback will be called. You can then call g_socket_listener_accept_socket() -to get the result of the operation.

+to get the result of the operation. +

listener :

a GSocketListener +a GSocketListener

source_object :

location where GObject pointer will be stored, or NULL +location where GObject pointer will be stored, or NULL

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - @@ -502,39 +484,40 @@ to get the result of the operation.


g_socket_listener_accept_finish ()

-
GSocketConnection * g_socket_listener_accept_finish     (GSocketListener *listener,
-                                                         GAsyncResult *result,
-                                                         GObject **source_object,
-                                                         GError **error);
+
GSocketConnection * g_socket_listener_accept_finish     (GSocketListener *listener,
+                                                         GAsyncResult *result,
+                                                         GObject **source_object,
+                                                         GError **error);

-Finishes an async accept operation. See g_socket_listener_accept_async()

+Finishes an async accept operation. See g_socket_listener_accept_async() +

listener :

a GSocketListener +a GSocketListener

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data for the callback +user data for the callback
- - - - - @@ -545,10 +528,10 @@ ignore.

g_socket_listener_accept_socket ()

-
GSocket *           g_socket_listener_accept_socket     (GSocketListener *listener,
-                                                         GObject **source_object,
-                                                         GCancellable *cancellable,
-                                                         GError **error);
+
GSocket *           g_socket_listener_accept_socket     (GSocketListener *listener,
+                                                         GObject **source_object,
+                                                         GCancellable *cancellable,
+                                                         GError **error);

Blocks waiting for a client to connect to any of the sockets added to the listener. Returns the GSocket that was accepted. @@ -559,40 +542,42 @@ which is often the case, then you should use source_object is not NULL it will be filled out with the source +If source_object is not NULL it will be filled out with the source object specified when the corresponding socket or address was added to the listener.

-If cancellable is not NULL, then the operation can be cancelled by +If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation -was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. +

listener :

a GSocketListener +a GSocketListener

result :

a GAsyncResult. +a GAsyncResult.

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GSocketConnection on success, NULL on error. + a GSocketConnection on success, NULL on error.
- - - - - @@ -604,38 +589,39 @@ was cancelled, the error

g_socket_listener_accept_socket_async ()

void                g_socket_listener_accept_socket_async
-                                                        (GSocketListener *listener,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+ (GSocketListener *listener, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

This is the asynchronous version of g_socket_listener_accept_socket().

When the operation is finished callback will be called. You can then call g_socket_listener_accept_socket_finish() -to get the result of the operation.

+to get the result of the operation. +

listener :

a GSocketListener +a GSocketListener

source_object :

location where GObject pointer will be stored, or NULL +location where GObject pointer will be stored, or NULL

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

error :

GError for error reporting, or NULL to ignore. + +GError for error reporting, or NULL to ignore.

Returns :

a GSocket on success, NULL on error. + a GSocket on success, NULL on error.
- - - - @@ -646,39 +632,40 @@ to get the result of the operation.

g_socket_listener_accept_socket_finish ()

GSocket *           g_socket_listener_accept_socket_finish
-                                                        (GSocketListener *listener,
-                                                         GAsyncResult *result,
-                                                         GObject **source_object,
-                                                         GError **error);
+ (GSocketListener *listener, + GAsyncResult *result, + GObject **source_object, + GError **error);

-Finishes an async accept operation. See g_socket_listener_accept_socket_async()

+Finishes an async accept operation. See g_socket_listener_accept_socket_async() +

listener :

a GSocketListener +a GSocketListener

cancellable :

a GCancellable, or NULL +a GCancellable, or NULL

callback :

a GAsyncReadyCallback +a GAsyncReadyCallback

user_data :

user data for the callback +user data for the callback
- - - - - @@ -689,14 +676,15 @@ ignore.

g_socket_listener_close ()

-
void                g_socket_listener_close             (GSocketListener *listener);
+
void                g_socket_listener_close             (GSocketListener *listener);

-Closes all the sockets in the listener.

+Closes all the sockets in the listener. +

listener :

a GSocketListener +a GSocketListener

result :

a GAsyncResult. +a GAsyncResult.

source_object :

Optional GObject identifying this source +Optional GObject identifying this source

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

a GSocket on success, NULL on error. + a GSocket on success, NULL on error.
-

listener :

a GSocketListener +a GSocketListener
@@ -705,24 +693,25 @@ Closes all the sockets in the listener.


g_socket_listener_set_backlog ()

-
void                g_socket_listener_set_backlog       (GSocketListener *listener,
-                                                         int listen_backlog);
+
void                g_socket_listener_set_backlog       (GSocketListener *listener,
+                                                         int listen_backlog);

Sets the listen backlog on the sockets in the listener.

-See g_socket_set_listen_backlog() for details

+See g_socket_set_listen_backlog() for details +

- - @@ -734,7 +723,7 @@ See

Property Details

The "listen-backlog" property

-
  "listen-backlog"           gint                  : Read / Write / Construct
+
  "listen-backlog"           gint                  : Read / Write / Construct

outstanding connections in the listen queue.

Allowed values: [0,2000]

Default value: 10

@@ -747,6 +736,6 @@ See
- Generated by GTK-Doc V1.13
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GSocketService.html b/docs/reference/gio/html/GSocketService.html index 3f66172..927eeaa 100644 --- a/docs/reference/gio/html/GSocketService.html +++ b/docs/reference/gio/html/GSocketService.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

listener :

a GSocketListener +a GSocketListener

listen_backlog :

an integer +an integer
@@ -72,16 +42,16 @@

Object Hierarchy

-  GObject
+  GObject
    +----GSocketListener
          +----GSocketService
                +----GThreadedSocketService
@@ -123,7 +93,8 @@ blocking code then see 
+handle incoming clients.
+

Details

@@ -132,17 +103,19 @@ handle incoming clients.

typedef struct _GSocketService GSocketService;

A helper class for handling accepting incomming connections in the -glib mainloop.

+glib mainloop. +

Since 2.22


g_socket_service_new ()

-
GSocketService *    g_socket_service_new                (void);
+
GSocketService *    g_socket_service_new                (void);

Creates a new GSocketService with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() -or g_socket_listener_add_inet_port().

+or g_socket_listener_add_inet_port(). +

@@ -157,19 +130,20 @@ or

g_socket_service_start ()

-
void                g_socket_service_start              (GSocketService *service);
+
void                g_socket_service_start              (GSocketService *service);

Starts the service, i.e. start accepting connections from the added sockets when the mainloop runs.

This call is threadsafe, so it may be called from a thread -handling an incomming client request.

+handling an incomming client request. +

-

service :

a GSocketService +a GSocketService
@@ -178,19 +152,20 @@ handling an incomming client request.


g_socket_service_stop ()

-
void                g_socket_service_stop               (GSocketService *service);
+
void                g_socket_service_stop               (GSocketService *service);

Stops the service, i.e. stops accepting connections from the added sockets when the mainloop runs.

This call is threadsafe, so it may be called from a thread -handling an incomming client request.

+handling an incomming client request. +

-

service :

a GSocketService +a GSocketService
@@ -199,23 +174,24 @@ handling an incomming client request.


g_socket_service_is_active ()

-
gboolean            g_socket_service_is_active          (GSocketService *service);
+
gboolean            g_socket_service_is_active          (GSocketService *service);

Check whether the service is active or not. An active service will accept new clients that connect, while a non-active service will let connecting clients queue -up until the service is started.

+up until the service is started. +

- - @@ -228,31 +204,32 @@ up until the service is started.

Signal Details

The "incoming" signal

-
gboolean            user_function                      (GSocketService    *service,
+
gboolean            user_function                      (GSocketService    *service,
                                                         GSocketConnection *connection,
-                                                        GObject           *source_object,
-                                                        gpointer           user_data)          : Run Last
+ GObject *source_object, + gpointer user_data) : Run Last

The ::incoming signal is emitted when a new incoming connection to service needs to be handled. The handler must initiate the handling of connection, but may not block; in essence, -asynchronous operations must be used.

+asynchronous operations must be used. +

service :

a GSocketService +a GSocketService

Returns :

TRUE if the service is active, FALSE otherwise + TRUE if the service is active, FALSE otherwise
- - - @@ -261,7 +238,7 @@ asynchronous operations must be used.

- @@ -276,6 +253,6 @@ asynchronous operations must be used.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GThemedIcon.html b/docs/reference/gio/html/GThemedIcon.html index f37f98d..a7ea58c 100644 --- a/docs/reference/gio/html/GThemedIcon.html +++ b/docs/reference/gio/html/GThemedIcon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

service :

the GSocketService. +the GSocketService.

connection :

a new GSocketConnection object. +a new GSocketConnection object.

source_object :

the source_object passed to g_socket_listener_add_address(). +the source_object passed to g_socket_listener_add_address().

Returns :

TRUE to stop other handlers from being called + TRUE to stop other handlers from being called
@@ -77,22 +47,22 @@ #include <gio/gio.h> GThemedIcon; -GIcon * g_themed_icon_new (const char *iconname); -GIcon * g_themed_icon_new_from_names (char **iconnames, - int len); +GIcon * g_themed_icon_new (const char *iconname); +GIcon * g_themed_icon_new_from_names (char **iconnames, + int len); GIcon * g_themed_icon_new_with_default_fallbacks - (const char *iconname); -voidg_themed_icon_prepend_name (GThemedIcon *icon, - const char *iconname); -voidg_themed_icon_append_name (GThemedIcon *icon, - const char *iconname); -const gchar* const * g_themed_icon_get_names (GThemedIcon *icon); + (const char *iconname); +voidg_themed_icon_prepend_name (GThemedIcon *icon, + const char *iconname); +voidg_themed_icon_append_name (GThemedIcon *icon, + const char *iconname); +const gchar* const * g_themed_icon_get_names (GThemedIcon *icon);

Object Hierarchy

-  GObject
+  GObject
    +----GThemedIcon
 
@@ -105,9 +75,9 @@ GThemedIcon implements

Properties

-  "name"                     gchar*                : Write / Construct Only
-  "names"                    GStrv*                : Read / Write / Construct Only
-  "use-default-fallbacks"    gboolean              : Read / Write / Construct Only
+  "name"                     gchar*                : Write / Construct Only
+  "names"                    GStrv*                : Read / Write / Construct Only
+  "use-default-fallbacks"    gboolean              : Read / Write / Construct Only
 
@@ -117,9 +87,10 @@ GThemedIcon implements GThemedIcon contains a list of all of the icons present in an icon theme, so that icons can be looked up quickly. GThemedIcon does not provide actual pixmaps for icons, just the icon names. -Ideally something like gtk_icon_theme_choose_icon() should be used to +Ideally something like gtk_icon_theme_choose_icon() should be used to resolve the list of names so that fallback icons work nicely with -themes that inherit other themes.

+themes that inherit other themes. +

Details

@@ -127,20 +98,22 @@ themes that inherit other themes.

GThemedIcon

typedef struct _GThemedIcon GThemedIcon;

-An implementation of GIcon for themed icons.

+An implementation of GIcon for themed icons. +


g_themed_icon_new ()

-
GIcon *             g_themed_icon_new                   (const char *iconname);
+
GIcon *             g_themed_icon_new                   (const char *iconname);

-Creates a new themed icon for iconname.

+Creates a new themed icon for iconname. +

- @@ -154,22 +127,23 @@ Creates a new themed icon for iconname.<

g_themed_icon_new_from_names ()

-
GIcon *             g_themed_icon_new_from_names        (char **iconnames,
-                                                         int len);
+
GIcon *             g_themed_icon_new_from_names        (char **iconnames,
+                                                         int len);

-Creates a new themed icon for iconnames.

+Creates a new themed icon for iconnames. +

iconname :

a string containing an icon name. +a string containing an icon name.
- - @@ -184,7 +158,7 @@ Creates a new themed icon for iconnames.

g_themed_icon_new_with_default_fallbacks ()

GIcon *             g_themed_icon_new_with_default_fallbacks
-                                                        (const char *iconname);
+ (const char *iconname);

Creates a new themed icon for iconname, and all the names that can be created by shortening iconname at '-' characters. @@ -192,23 +166,41 @@ that can be created by shortening iconname In the following example, icon1 and icon2 are equivalent:

-
-const char *names[] = { 
-  "gnome-dev-cdrom-audio",
-  "gnome-dev-cdrom",
-  "gnome-dev",
-  "gnome"
-};
+
+

iconnames :

an array of strings containing icon names. +an array of strings containing icon names.

len :

the length of the iconnames array, or -1 if iconnames is - NULL-terminated +the length of the iconnames array, or -1 if iconnames is + NULL-terminated
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
const char *names[] = { 
+  "gnome-dev-cdrom-audio",
+  "gnome-dev-cdrom",
+  "gnome-dev",
+  "gnome"
+};
+
+icon1 = g_themed_icon_new_from_names (names, 4);
+icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
+
-icon1 = g_themed_icon_new_from_names (names, 4); -icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); -
+

+

- @@ -222,8 +214,8 @@ icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");

g_themed_icon_prepend_name ()

-
void                g_themed_icon_prepend_name          (GThemedIcon *icon,
-                                                         const char *iconname);
+
void                g_themed_icon_prepend_name          (GThemedIcon *icon,
+                                                         const char *iconname);

Prepend a name to the list of icons from within icon.

@@ -236,17 +228,19 @@ Note that doing so invalidates the hash computed by prior calls to g_icon_hash().

+

+

iconname :

a string containing an icon name +a string containing an icon name
- - @@ -256,8 +250,8 @@ to

g_themed_icon_append_name ()

-
void                g_themed_icon_append_name           (GThemedIcon *icon,
-                                                         const char *iconname);
+
void                g_themed_icon_append_name           (GThemedIcon *icon,
+                                                         const char *iconname);

Append a name to the list of icons from within icon.

@@ -270,17 +264,19 @@ Note that doing so invalidates the hash computed by prior calls to g_icon_hash().

+

+

icon :

a GThemedIcon +a GThemedIcon

iconname :

name of icon to prepend to list of icons from within icon. +name of icon to prepend to list of icons from within icon.
- - @@ -289,15 +285,16 @@ to

g_themed_icon_get_names ()

-
const gchar* const * g_themed_icon_get_names            (GThemedIcon *icon);
+
const gchar* const * g_themed_icon_get_names            (GThemedIcon *icon);

-Gets the names of icons from within icon.

+Gets the names of icons from within icon. +

icon :

a GThemedIcon +a GThemedIcon

iconname :

name of icon to append to list of icons from within icon. +name of icon to append to list of icons from within icon.
- @@ -313,22 +310,24 @@ Gets the names of icons from within icon

Property Details

The "name" property

-
  "name"                     gchar*                : Write / Construct Only
+
  "name"                     gchar*                : Write / Construct Only

-The icon name.

+The icon name. +

Default value: NULL


The "names" property

-
  "names"                    GStrv*                : Read / Write / Construct Only
+
  "names"                    GStrv*                : Read / Write / Construct Only

-A NULL-terminated array of icon names.

+A NULL-terminated array of icon names. +


The "use-default-fallbacks" property

-
  "use-default-fallbacks"    gboolean              : Read / Write / Construct Only
+
  "use-default-fallbacks"    gboolean              : Read / Write / Construct Only

Whether to use the default fallbacks found by shortening the icon name at '-' characters. If the "names" array has more than one element, @@ -338,15 +337,31 @@ ignores any past the first. For example, if the icon name was "gnome-dev-cdrom-audio", the array would become

-
-{
-  "gnome-dev-cdrom-audio",
-  "gnome-dev-cdrom",
-  "gnome-dev",
-  "gnome",
-  NULL
-};
-
+
+

icon :

a GThemedIcon. +a GThemedIcon.
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
{
+  "gnome-dev-cdrom-audio",
+  "gnome-dev-cdrom",
+  "gnome-dev",
+  "gnome",
+  NULL
+};
+
+ +

+

Default value: FALSE

@@ -357,6 +372,6 @@ would become
+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/GThreadedSocketService.html b/docs/reference/gio/html/GThreadedSocketService.html index 5200d0f..19c6eb6 100644 --- a/docs/reference/gio/html/GThreadedSocketService.html +++ b/docs/reference/gio/html/GThreadedSocketService.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -74,13 +44,13 @@

Object Hierarchy

-  GObject
+  GObject
    +----GSocketListener
          +----GSocketService
                +----GThreadedSocketService
@@ -89,7 +59,7 @@
 

Properties

-  "max-threads"              gint                  : Read / Write / Construct Only
+  "max-threads"              gint                  : Read / Write / Construct Only
 
@@ -118,7 +88,8 @@ new connections when all threads are busy.

As with GSocketService, you may connect to "run", -or subclass and override the default handler.

+or subclass and override the default handler. +

Details

@@ -127,22 +98,24 @@ or subclass and override the default handler.

typedef struct _GThreadedSocketService GThreadedSocketService;

A helper class for handling accepting incomming connections in the -glib mainloop and handling them in a thread.

+glib mainloop and handling them in a thread. +

Since 2.22


g_threaded_socket_service_new ()

-
GSocketService *    g_threaded_socket_service_new       (int max_threads);
+
GSocketService *    g_threaded_socket_service_new       (int max_threads);

Creates a new GThreadedSocketService with no listeners. Listeners -must be added with g_socket_service_add_listeners().

+must be added with g_socket_service_add_listeners(). +

- @@ -161,7 +134,7 @@ must be added with g_socket_service_add_listeners()

Property Details

The "max-threads" property

-
  "max-threads"              gint                  : Read / Write / Construct Only
+
  "max-threads"              gint                  : Read / Write / Construct Only

The max number of threads handling clients for this service.

Allowed values: >= G_MAXULONG

Default value: 10

@@ -171,31 +144,32 @@ must be added with g_socket_service_add_listeners()

Signal Details

The "run" signal

-
gboolean            user_function                      (GThreadedSocketService *service,
+
gboolean            user_function                      (GThreadedSocketService *service,
                                                         GSocketConnection      *connection,
-                                                        GObject                *source_object,
-                                                        gpointer                user_data)          : Run Last
+ GObject *source_object, + gpointer user_data) : Run Last

The ::run signal is emitted in a worker thread in response to an incoming connection. This thread is dedicated to handling connection and may perform blocking IO. The signal handler need -not return until the connection is closed.

+not return until the connection is closed. +

max_threads :

the maximal number of threads to execute concurrently +the maximal number of threads to execute concurrently handling incoming clients, -1 means no limit
- - - @@ -204,7 +178,7 @@ not return until the connection is closed.

- @@ -218,6 +192,6 @@ not return until the connection is closed.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GUnixFDList.html b/docs/reference/gio/html/GUnixFDList.html index 9b74e13..892a281 100644 --- a/docs/reference/gio/html/GUnixFDList.html +++ b/docs/reference/gio/html/GUnixFDList.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

service :

the GThreadedSocketService. +the GThreadedSocketService.

connection :

a new GSocketConnection object. +a new GSocketConnection object.

source_object :

the source_object passed to g_socket_listener_add_address(). +the source_object passed to g_socket_listener_add_address().

Returns :

TRUE to stope further signal handlers from being called + TRUE to stope further signal handlers from being called
@@ -70,26 +40,26 @@

Object Hierarchy

-  GObject
+  GObject
    +----GUnixFDList
 
@@ -102,7 +72,8 @@ descriptors that it contains, closing them when finalized.

It may be wrapped in a GUnixFDMessage and sent over a GSocket in the G_SOCKET_ADDRESS_UNIX family by using g_socket_send_message() -and received using g_socket_receive_message().

+and received using g_socket_receive_message(). +

Details

@@ -115,8 +86,8 @@ and received using

g_unix_fd_list_new_from_array ()

-
GUnixFDList *       g_unix_fd_list_new_from_array       (const gint *fds,
-                                                         gint n_fds);
+
GUnixFDList *       g_unix_fd_list_new_from_array       (const gint *fds,
+                                                         gint n_fds);

Creates a new GUnixFDList containing the file descriptors given in fds. The file descriptors become the property of the new list and @@ -127,18 +98,19 @@ the caller. Each file descriptor in the array should be set to close-on-exec.

-If n_fds is -1 then fds must be terminated with -1.

+If n_fds is -1 then fds must be terminated with -1. +

- - @@ -154,9 +126,10 @@ If n_fds is -1 then

g_unix_fd_list_new ()

-
GUnixFDList *       g_unix_fd_list_new                  (void);
+
GUnixFDList *       g_unix_fd_list_new                  (void);

-Creates a new GUnixFDList containing no file descriptors.

+Creates a new GUnixFDList containing no file descriptors. +

fds :

the initial list of file descriptors +the initial list of file descriptors

n_fds :

the length of fds, or -1 +the length of fds, or -1
@@ -171,16 +144,17 @@ Creates a new

g_unix_fd_list_get_length ()

-
gint                g_unix_fd_list_get_length           (GUnixFDList *list);
+
gint                g_unix_fd_list_get_length           (GUnixFDList *list);

Gets the length of list (ie: the number of file descriptors -contained within).

+contained within). +

- @@ -196,9 +170,9 @@ contained within).


g_unix_fd_list_get ()

-
gint                g_unix_fd_list_get                  (GUnixFDList *list,
-                                                         gint index_,
-                                                         GError **error);
+
gint                g_unix_fd_list_get                  (GUnixFDList *list,
+                                                         gint index_,
+                                                         GError **error);

Gets a file descriptor out of list.

@@ -214,23 +188,24 @@ when you are done.

A possible cause of failure is exceeding the per-process or -system-wide file descriptor limit.

+system-wide file descriptor limit. +

list :

a GUnixFDList +a GUnixFDList
- - - @@ -246,8 +221,8 @@ system-wide file descriptor limit.


g_unix_fd_list_peek_fds ()

-
const gint *        g_unix_fd_list_peek_fds             (GUnixFDList *list,
-                                                         gint *length);
+
const gint *        g_unix_fd_list_peek_fds             (GUnixFDList *list,
+                                                         gint *length);

Returns the array of file descriptors that is contained in this object. @@ -258,24 +233,25 @@ caller must not close them and must not free the array. The array is valid only until list is changed in any way.

-If length is non-NULL then it is set to the number of file +If length is non-NULL then it is set to the number of file descriptors in the returned array. The returned array is also terminated with -1.

-This function never returns NULL. In case there are no file -descriptors contained in list, an empty array is returned.

+This function never returns NULL. In case there are no file +descriptors contained in list, an empty array is returned. +

list :

a GUnixFDList +a GUnixFDList

index_ :

the index into the list +the index into the list

error :

a GError pointer +a GError pointer
- - @@ -291,8 +267,8 @@ descriptors contained in list, an empty

g_unix_fd_list_steal_fds ()

-
gint *              g_unix_fd_list_steal_fds            (GUnixFDList *list,
-                                                         gint *length);
+
gint *              g_unix_fd_list_steal_fds            (GUnixFDList *list,
+                                                         gint *length);

Returns the array of file descriptors that is contained in this object. @@ -303,30 +279,31 @@ After this call, the descriptors are no longer contained in descriptors have been added).

-The return result of this function must be freed with g_free(). +The return result of this function must be freed with g_free(). The caller is also responsible for closing all of the file descriptors. The file descriptors in the array are set to close-on-exec.

-If length is non-NULL then it is set to the number of file +If length is non-NULL then it is set to the number of file descriptors in the returned array. The returned array is also terminated with -1.

-This function never returns NULL. In case there are no file -descriptors contained in list, an empty array is returned.

+This function never returns NULL. In case there are no file +descriptors contained in list, an empty array is returned. +

list :

a GUnixFDList +a GUnixFDList

length :

pointer to the length of the returned array, or NULL +pointer to the length of the returned array, or NULL
- - @@ -342,9 +319,9 @@ descriptors contained in list, an empty

g_unix_fd_list_append ()

-
gint                g_unix_fd_list_append               (GUnixFDList *list,
-                                                         gint fd,
-                                                         GError **error);
+
gint                g_unix_fd_list_append               (GUnixFDList *list,
+                                                         gint fd,
+                                                         GError **error);

Adds a file descriptor to list.

@@ -360,23 +337,24 @@ system-wide file descriptor limit.

The index of the file descriptor in the list is returned. If you use this index with g_unix_fd_list_get() then you will receive back a -duplicated copy of the same file descriptor.

+duplicated copy of the same file descriptor. +

list :

a GUnixFDList +a GUnixFDList

length :

pointer to the length of the returned array, or NULL +pointer to the length of the returned array, or NULL
- - - @@ -398,6 +376,6 @@ duplicated copy of the same file descriptor.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GUnixFDMessage.html b/docs/reference/gio/html/GUnixFDMessage.html index 689fdfa..9481327 100644 --- a/docs/reference/gio/html/GUnixFDMessage.html +++ b/docs/reference/gio/html/GUnixFDMessage.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

list :

a GUnixFDList +a GUnixFDList

fd :

a valid open file descriptor +a valid open file descriptor

error :

a GError pointer +a GError pointer
@@ -73,20 +43,20 @@

Synopsis

                    GUnixFDMessage;
 GSocketControlMessage * g_unix_fd_message_new_with_fd_list
-                                                        (GUnixFDList *fd_list);
-GSocketControlMessage * g_unix_fd_message_new           (void);
-GUnixFDList *       g_unix_fd_message_get_fd_list       (GUnixFDMessage *message);
-gboolean            g_unix_fd_message_append_fd         (GUnixFDMessage *message,
-                                                         gint fd,
-                                                         GError **error);
-gint *              g_unix_fd_message_steal_fds         (GUnixFDMessage *message,
-                                                         gint *length);
+                                                        (GUnixFDList *fd_list);
+GSocketControlMessage * g_unix_fd_message_new           (void);
+GUnixFDList *       g_unix_fd_message_get_fd_list       (GUnixFDMessage *message);
+gboolean            g_unix_fd_message_append_fd         (GUnixFDMessage *message,
+                                                         gint fd,
+                                                         GError **error);
+gint *              g_unix_fd_message_steal_fds         (GUnixFDMessage *message,
+                                                         gint *length);
 

Object Hierarchy

-  GObject
+  GObject
    +----GSocketControlMessage
          +----GUnixFDMessage
 
@@ -109,7 +79,8 @@ between processes by the kernel.

For an easier way to send and receive file descriptors over stream-oriented UNIX sockets, see g_unix_connection_send_fd() and -g_unix_connection_receive_fd().

+g_unix_connection_receive_fd(). +

Details

@@ -123,15 +94,16 @@ stream-oriented UNIX sockets, see

g_unix_fd_message_new_with_fd_list ()

GSocketControlMessage * g_unix_fd_message_new_with_fd_list
-                                                        (GUnixFDList *fd_list);
+ (GUnixFDList *fd_list);

-Creates a new GUnixFDMessage containing list.

+Creates a new GUnixFDMessage containing list. +

- @@ -147,10 +119,11 @@ Creates a new

g_unix_fd_message_new ()

-
GSocketControlMessage * g_unix_fd_message_new           (void);
+
GSocketControlMessage * g_unix_fd_message_new           (void);

Creates a new GUnixFDMessage containing an empty file descriptor -list.

+list. +

fd_list :

a GUnixFDList +a GUnixFDList
@@ -165,17 +138,18 @@ list.


g_unix_fd_message_get_fd_list ()

-
GUnixFDList *       g_unix_fd_message_get_fd_list       (GUnixFDMessage *message);
+
GUnixFDList *       g_unix_fd_message_get_fd_list       (GUnixFDMessage *message);

Gets the GUnixFDList contained in message. This function does not return a reference to the caller, but the returned list is valid for -the lifetime of message.

+the lifetime of message. +

- @@ -191,9 +165,9 @@ the lifetime of message.


g_unix_fd_message_append_fd ()

-
gboolean            g_unix_fd_message_append_fd         (GUnixFDMessage *message,
-                                                         gint fd,
-                                                         GError **error);
+
gboolean            g_unix_fd_message_append_fd         (GUnixFDMessage *message,
+                                                         gint fd,
+                                                         GError **error);

Adds a file descriptor to message.

@@ -204,28 +178,29 @@ when message is finalized.

A possible cause of failure is exceeding the per-process or -system-wide file descriptor limit.

+system-wide file descriptor limit. +

message :

a GUnixFDMessage +a GUnixFDMessage
- - - - @@ -236,8 +211,8 @@ system-wide file descriptor limit.


g_unix_fd_message_steal_fds ()

-
gint *              g_unix_fd_message_steal_fds         (GUnixFDMessage *message,
-                                                         gint *length);
+
gint *              g_unix_fd_message_steal_fds         (GUnixFDMessage *message,
+                                                         gint *length);

Returns the array of file descriptors that is contained in this object. @@ -248,29 +223,30 @@ After this call, the descriptors are no longer contained in descriptors have been added).

-The return result of this function must be freed with g_free(). +The return result of this function must be freed with g_free(). The caller is also responsible for closing all of the file descriptors.

-If length is non-NULL then it is set to the number of file +If length is non-NULL then it is set to the number of file descriptors in the returned array. The returned array is also terminated with -1.

-This function never returns NULL. In case there are no file -descriptors contained in message, an empty array is returned.

+This function never returns NULL. In case there are no file +descriptors contained in message, an empty array is returned. +

message :

a GUnixFDMessage +a GUnixFDMessage

fd :

a valid open file descriptor +a valid open file descriptor

error :

a GError pointer +a GError pointer

Returns :

TRUE in case of success, else FALSE (and error is set) + TRUE in case of success, else FALSE (and error is set)
- - @@ -299,6 +275,6 @@ descriptors contained in message, an emp + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GUnixInputStream.html b/docs/reference/gio/html/GUnixInputStream.html index 61017db..27b3032 100644 --- a/docs/reference/gio/html/GUnixInputStream.html +++ b/docs/reference/gio/html/GUnixInputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

message :

a GUnixFDMessage +a GUnixFDMessage

length :

pointer to the length of the returned array, or NULL +pointer to the length of the returned array, or NULL
@@ -75,18 +45,18 @@ #include <gio/gunixinputstream.h> GUnixInputStream; -GInputStream * g_unix_input_stream_new (gint fd, - gboolean close_fd); -void g_unix_input_stream_set_close_fd (GUnixInputStream *stream, - gboolean close_fd); -gboolean g_unix_input_stream_get_close_fd (GUnixInputStream *stream); -gint g_unix_input_stream_get_fd (GUnixInputStream *stream); +GInputStream * g_unix_input_stream_new (gint fd, + gboolean close_fd); +void g_unix_input_stream_set_close_fd (GUnixInputStream *stream, + gboolean close_fd); +gboolean g_unix_input_stream_get_close_fd (GUnixInputStream *stream); +gint g_unix_input_stream_get_fd (GUnixInputStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GUnixInputStream
 
@@ -94,8 +64,8 @@

Properties

-  "close-fd"                 gboolean              : Read / Write
-  "fd"                       gint                  : Read / Write / Construct Only
+  "close-fd"                 gboolean              : Read / Write
+  "fd"                       gint                  : Read / Write / Construct Only
 
@@ -108,7 +78,8 @@ descriptor must be selectable, so it doesn't work with opened files.

Note that <gio/gunixinputstream.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the -gio-unix-2.0.pc pkg-config file when using it.

+gio-unix-2.0.pc pkg-config file when using it. +

Details

@@ -116,30 +87,33 @@ to the UNIX-specific GIO interfaces, thus you have to use the

GUnixInputStream

typedef struct _GUnixInputStream GUnixInputStream;

-Implements GInputStream for reading from selectable unix file descriptors

+Implements GInputStream for reading from selectable unix file descriptors +


g_unix_input_stream_new ()

-
GInputStream *      g_unix_input_stream_new             (gint fd,
-                                                         gboolean close_fd);
+
GInputStream *      g_unix_input_stream_new             (gint fd,
+                                                         gboolean close_fd);

Creates a new GUnixInputStream for the given fd.

-If close_fd is TRUE, the file descriptor will be closed -when the stream is closed.

+If close_fd is TRUE, the file descriptor will be closed +when the stream is closed. +

- - @@ -153,22 +127,24 @@ when the stream is closed.


g_unix_input_stream_set_close_fd ()

-
void                g_unix_input_stream_set_close_fd    (GUnixInputStream *stream,
-                                                         gboolean close_fd);
+
void                g_unix_input_stream_set_close_fd    (GUnixInputStream *stream,
+                                                         gboolean close_fd);

Sets whether the file descriptor of stream shall be closed -when the stream is closed.

+when the stream is closed. +

fd :

a UNIX file descriptor +a UNIX file descriptor

close_fd :

TRUE to close the file descriptor when done + +TRUE to close the file descriptor when done
- - @@ -178,21 +154,22 @@ when the stream is closed.


g_unix_input_stream_get_close_fd ()

-
gboolean            g_unix_input_stream_get_close_fd    (GUnixInputStream *stream);
+
gboolean            g_unix_input_stream_get_close_fd    (GUnixInputStream *stream);

Returns whether the file descriptor of stream will be -closed when the stream is closed.

+closed when the stream is closed. +

stream :

a GUnixInputStream +a GUnixInputStream

close_fd :

TRUE to close the file descriptor when done + +TRUE to close the file descriptor when done
- - @@ -203,15 +180,16 @@ closed when the stream is closed.


g_unix_input_stream_get_fd ()

-
gint                g_unix_input_stream_get_fd          (GUnixInputStream *stream);
+
gint                g_unix_input_stream_get_fd          (GUnixInputStream *stream);

-Return the UNIX file descriptor that the stream reads from.

+Return the UNIX file descriptor that the stream reads from. +

stream :

a GUnixInputStream +a GUnixInputStream

Returns :

TRUE if the file descriptor is closed when done + TRUE if the file descriptor is closed when done
- @@ -229,18 +207,20 @@ Return the UNIX file descriptor that the stream reads from.

Property Details

The "close-fd" property

-
  "close-fd"                 gboolean              : Read / Write
+
  "close-fd"                 gboolean              : Read / Write

-Whether to close the file descriptor when the stream is closed.

+Whether to close the file descriptor when the stream is closed. +

Default value: TRUE

Since 2.20


The "fd" property

-
  "fd"                       gint                  : Read / Write / Construct Only
+
  "fd"                       gint                  : Read / Write / Construct Only

-The file descriptor that the stream reads from.

+The file descriptor that the stream reads from. +

Default value: -1

Since 2.20

@@ -252,6 +232,6 @@ The file descriptor that the stream reads from.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GUnixOutputStream.html b/docs/reference/gio/html/GUnixOutputStream.html index 2a5da0e..443c9ec 100644 --- a/docs/reference/gio/html/GUnixOutputStream.html +++ b/docs/reference/gio/html/GUnixOutputStream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GUnixInputStream +a GUnixInputStream
@@ -75,18 +45,18 @@ #include <gio/gunixoutputstream.h> GUnixOutputStream; -GOutputStream * g_unix_output_stream_new (gint fd, - gboolean close_fd); -void g_unix_output_stream_set_close_fd (GUnixOutputStream *stream, - gboolean close_fd); -gboolean g_unix_output_stream_get_close_fd (GUnixOutputStream *stream); -gint g_unix_output_stream_get_fd (GUnixOutputStream *stream); +GOutputStream * g_unix_output_stream_new (gint fd, + gboolean close_fd); +void g_unix_output_stream_set_close_fd (GUnixOutputStream *stream, + gboolean close_fd); +gboolean g_unix_output_stream_get_close_fd (GUnixOutputStream *stream); +gint g_unix_output_stream_get_fd (GUnixOutputStream *stream);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GUnixOutputStream
 
@@ -94,8 +64,8 @@

Properties

-  "close-fd"                 gboolean              : Read / Write
-  "fd"                       gint                  : Read / Write / Construct Only
+  "close-fd"                 gboolean              : Read / Write
+  "fd"                       gint                  : Read / Write / Construct Only
 
@@ -108,7 +78,8 @@ descriptor must be selectable, so it doesn't work with opened files.

Note that <gio/gunixoutputstream.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the -gio-unix-2.0.pc pkg-config file when using it.

+gio-unix-2.0.pc pkg-config file when using it. +

Details

@@ -116,30 +87,33 @@ to the UNIX-specific GIO interfaces, thus you have to use the

GUnixOutputStream

typedef struct _GUnixOutputStream GUnixOutputStream;

-Implements GOutputStream for outputting to selectable unix file descriptors

+Implements GOutputStream for outputting to selectable unix file descriptors +


g_unix_output_stream_new ()

-
GOutputStream *     g_unix_output_stream_new            (gint fd,
-                                                         gboolean close_fd);
+
GOutputStream *     g_unix_output_stream_new            (gint fd,
+                                                         gboolean close_fd);

Creates a new GUnixOutputStream for the given fd.

-If close_fd, is TRUE, the file descriptor will be closed when -the output stream is destroyed.

+If close_fd, is TRUE, the file descriptor will be closed when +the output stream is destroyed. +

- - @@ -153,22 +127,24 @@ the output stream is destroyed.


g_unix_output_stream_set_close_fd ()

-
void                g_unix_output_stream_set_close_fd   (GUnixOutputStream *stream,
-                                                         gboolean close_fd);
+
void                g_unix_output_stream_set_close_fd   (GUnixOutputStream *stream,
+                                                         gboolean close_fd);

Sets whether the file descriptor of stream shall be closed -when the stream is closed.

+when the stream is closed. +

fd :

a UNIX file descriptor +a UNIX file descriptor

close_fd :

TRUE to close the file descriptor when done + +TRUE to close the file descriptor when done
- - @@ -178,21 +154,22 @@ when the stream is closed.


g_unix_output_stream_get_close_fd ()

-
gboolean            g_unix_output_stream_get_close_fd   (GUnixOutputStream *stream);
+
gboolean            g_unix_output_stream_get_close_fd   (GUnixOutputStream *stream);

Returns whether the file descriptor of stream will be -closed when the stream is closed.

+closed when the stream is closed. +

stream :

a GUnixOutputStream +a GUnixOutputStream

close_fd :

TRUE to close the file descriptor when done + +TRUE to close the file descriptor when done
- - @@ -203,15 +180,16 @@ closed when the stream is closed.


g_unix_output_stream_get_fd ()

-
gint                g_unix_output_stream_get_fd         (GUnixOutputStream *stream);
+
gint                g_unix_output_stream_get_fd         (GUnixOutputStream *stream);

-Return the UNIX file descriptor that the stream writes to.

+Return the UNIX file descriptor that the stream writes to. +

stream :

a GUnixOutputStream +a GUnixOutputStream

Returns :

TRUE if the file descriptor is closed when done + TRUE if the file descriptor is closed when done
- @@ -229,18 +207,20 @@ Return the UNIX file descriptor that the stream writes to.

Property Details

The "close-fd" property

-
  "close-fd"                 gboolean              : Read / Write
+
  "close-fd"                 gboolean              : Read / Write

-Whether to close the file descriptor when the stream is closed.

+Whether to close the file descriptor when the stream is closed. +

Default value: TRUE

Since 2.20


The "fd" property

-
  "fd"                       gint                  : Read / Write / Construct Only
+
  "fd"                       gint                  : Read / Write / Construct Only

-The file descriptor that the stream writes to.

+The file descriptor that the stream writes to. +

Default value: -1

Since 2.20

@@ -252,6 +232,6 @@ The file descriptor that the stream writes to.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GUnixSocketAddress.html b/docs/reference/gio/html/GUnixSocketAddress.html index 361842b..bbf8ab8 100644 --- a/docs/reference/gio/html/GUnixSocketAddress.html +++ b/docs/reference/gio/html/GUnixSocketAddress.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

stream :

a GUnixOutputStream +a GUnixOutputStream
@@ -74,21 +44,21 @@

Object Hierarchy

-  GObject
+  GObject
    +----GSocketAddress
          +----GUnixSocketAddress
 
@@ -102,15 +72,16 @@ GUnixSocketAddress implements

Properties

-  "abstract"                 gboolean              : Read / Write / Construct Only
-  "path"                     gchar*                : Read / Write / Construct Only
-  "path-as-array"            GByteArray*           : Read / Write / Construct Only
+  "abstract"                 gboolean              : Read / Write / Construct Only
+  "path"                     gchar*                : Read / Write / Construct Only
+  "path-as-array"            GByteArray*           : Read / Write / Construct Only
 

Description

-Support for UNIX-domain (aka local) sockets.

+Support for UNIX-domain (aka local) sockets. +

Details

@@ -119,24 +90,26 @@ Support for UNIX-domain (aka local) sockets.

typedef struct _GUnixSocketAddress GUnixSocketAddress;

A UNIX-domain (local) socket address, corresponding to a -struct sockaddr_un.

+struct sockaddr_un. +


g_unix_socket_address_new ()

-
GSocketAddress *    g_unix_socket_address_new           (const gchar *path);
+
GSocketAddress *    g_unix_socket_address_new           (const gchar *path);

Creates a new GUnixSocketAddress for path.

To create abstract socket addresses, on systems that support that, -use g_unix_socket_address_new_abstract().

+use g_unix_socket_address_new_abstract(). +

- @@ -152,8 +125,8 @@ use

g_unix_socket_address_new_abstract ()

-
GSocketAddress *    g_unix_socket_address_new_abstract  (const gchar *path,
-                                                         int path_len);
+
GSocketAddress *    g_unix_socket_address_new_abstract  (const gchar *path,
+                                                         int path_len);

Creates a new abstract GUnixSocketAddress for path.

@@ -173,18 +146,19 @@ names are supported. If path_len is -1 then path is assumed to be a zero terminated string (although in general abstract names need not be zero terminated and can have embedded nuls). All bytes after path_len up to the max size -of an abstract unix domain name is filled with zero bytes.

+of an abstract unix domain name is filled with zero bytes. +

path :

the socket path +the socket path
- - @@ -200,21 +174,22 @@ of an abstract unix domain name is filled with zero bytes.


g_unix_socket_address_get_is_abstract ()

-
gboolean            g_unix_socket_address_get_is_abstract
-                                                        (GUnixSocketAddress *address);
+
gboolean            g_unix_socket_address_get_is_abstract
+                                                        (GUnixSocketAddress *address);

-Gets address's path.

+Gets address's path. +

path :

the abstract name +the abstract name

path_len :

the length of path, or -1 +the length of path, or -1
- - @@ -225,7 +200,7 @@ Gets address's path.


g_unix_socket_address_get_path ()

-
const char *        g_unix_socket_address_get_path      (GUnixSocketAddress *address);
+
const char *        g_unix_socket_address_get_path      (GUnixSocketAddress *address);

Gets address's path, or for abstract sockets the "name".

@@ -233,13 +208,14 @@ Gets address's path, or for abstract soc Guaranteed to be zero-terminated, but an abstract socket may contain embedded zeros, and thus you should use g_unix_socket_address_get_path_len() to get the true length -of this string.

+of this string. +

address :

a GInetSocketAddress +a GInetSocketAddress

Returns :

TRUE if the address is abstract, FALSE otherwise + TRUE if the address is abstract, FALSE otherwise
- @@ -255,18 +231,19 @@ of this string.


g_unix_socket_address_get_path_len ()

-
gsize               g_unix_socket_address_get_path_len  (GUnixSocketAddress *address);
+
gsize               g_unix_socket_address_get_path_len  (GUnixSocketAddress *address);

Gets the length of address's path.

-For details, see g_unix_socket_address_get_path().

+For details, see g_unix_socket_address_get_path(). +

address :

a GInetSocketAddress +a GInetSocketAddress
- @@ -282,15 +259,16 @@ For details, see

g_unix_socket_address_abstract_names_supported ()

-
gboolean            g_unix_socket_address_abstract_names_supported
-                                                        (void);
+
gboolean            g_unix_socket_address_abstract_names_supported
+                                                        (void);

-Checks if abstract unix domain socket names are supported.

+Checks if abstract unix domain socket names are supported. +

address :

a GInetSocketAddress +a GInetSocketAddress
- @@ -302,27 +280,27 @@ Checks if abstract unix domain socket names are supported.

Property Details

The "abstract" property

-
  "abstract"                 gboolean              : Read / Write / Construct Only
+
  "abstract"                 gboolean              : Read / Write / Construct Only

Whether or not this is an abstract address.

Default value: FALSE


The "path" property

-
  "path"                     gchar*                : Read / Write / Construct Only
+
  "path"                     gchar*                : Read / Write / Construct Only

UNIX socket path.

Default value: NULL


The "path-as-array" property

-
  "path-as-array"            GByteArray*           : Read / Write / Construct Only
+
  "path-as-array"            GByteArray*           : Read / Write / Construct Only

UNIX socket path, as byte array.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GVfs.html b/docs/reference/gio/html/GVfs.html index e244822..da41211 100644 --- a/docs/reference/gio/html/GVfs.html +++ b/docs/reference/gio/html/GVfs.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Returns :

TRUE if supported, FALSE otherwise + TRUE if supported, FALSE otherwise
@@ -74,29 +44,30 @@ GVfs; #define G_VFS_EXTENSION_POINT_NAME -GFile * g_vfs_get_file_for_path (GVfs *vfs, - const char *path); -GFile * g_vfs_get_file_for_uri (GVfs *vfs, - const char *uri); -GFile * g_vfs_parse_name (GVfs *vfs, - const char *parse_name); -GVfs * g_vfs_get_default (void); -GVfs * g_vfs_get_local (void); -gboolean g_vfs_is_active (GVfs *vfs); -const gchar* const * g_vfs_get_supported_uri_schemes (GVfs *vfs); +GFile * g_vfs_get_file_for_path (GVfs *vfs, + const char *path); +GFile * g_vfs_get_file_for_uri (GVfs *vfs, + const char *uri); +GFile * g_vfs_parse_name (GVfs *vfs, + const char *parse_name); +GVfs * g_vfs_get_default (void); +GVfs * g_vfs_get_local (void); +gboolean g_vfs_is_active (GVfs *vfs); +const gchar* const * g_vfs_get_supported_uri_schemes (GVfs *vfs);

Object Hierarchy

-  GObject
+  GObject
    +----GVfs
 

Description

-Entry point for using GIO functionality.

+Entry point for using GIO functionality. +

Details

@@ -104,7 +75,8 @@ Entry point for using GIO functionality.

GVfs

typedef struct _GVfs GVfs;

-Virtual File System object.

+Virtual File System object. +


@@ -113,32 +85,34 @@ Virtual File System object.

Extension point for GVfs functionality. -See Extending GIO.

+See Extending GIO. +


g_vfs_get_file_for_path ()

-
GFile *             g_vfs_get_file_for_path             (GVfs *vfs,
-                                                         const char *path);
+
GFile *             g_vfs_get_file_for_path             (GVfs *vfs,
+                                                         const char *path);

-Gets a GFile for path.

+Gets a GFile for path. +

- - @@ -147,32 +121,33 @@ Gets a GFile<

g_vfs_get_file_for_uri ()

-
GFile *             g_vfs_get_file_for_uri              (GVfs *vfs,
-                                                         const char *uri);
+
GFile *             g_vfs_get_file_for_uri              (GVfs *vfs,
+                                                         const char *uri);

Gets a GFile for uri.

This operation never fails, but the returned object might not support any I/O operation if the URI -is malformed or if the URI scheme is not supported.

+is malformed or if the URI scheme is not supported. +

vfs :

a GVfs. +a GVfs.

path :

a string containing a VFS path. +a string containing a VFS path.

Returns :

a GFile. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - @@ -181,29 +156,30 @@ is malformed or if the URI scheme is not supported.


g_vfs_parse_name ()

-
GFile *             g_vfs_parse_name                    (GVfs *vfs,
-                                                         const char *parse_name);
+
GFile *             g_vfs_parse_name                    (GVfs *vfs,
+                                                         const char *parse_name);

This operation never fails, but the returned object might not support any I/O operations if the parse_name cannot -be parsed by the GVfs module.

+be parsed by the GVfs module. +

vfs :

aGVfs. +aGVfs.

uri :

a string containing a URI +a string containing a URI

Returns :

a GFile. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
- - @@ -212,9 +188,10 @@ be parsed by the

g_vfs_get_default ()

-
GVfs *              g_vfs_get_default                   (void);
+
GVfs *              g_vfs_get_default                   (void);

-Gets the default GVfs for the system.

+Gets the default GVfs for the system. +

vfs :

a GVfs. +a GVfs.

parse_name :

a string to be parsed by the VFS module. +a string to be parsed by the VFS module.

Returns :

a GFile for the given parse_name. - Free the returned object with g_object_unref(). + Free the returned object with g_object_unref().
@@ -227,9 +204,10 @@ Gets the default

g_vfs_get_local ()

-
GVfs *              g_vfs_get_local                     (void);
+
GVfs *              g_vfs_get_local                     (void);

-Gets the local GVfs for the system.

+Gets the local GVfs for the system. +

@@ -242,20 +220,21 @@ Gets the local

g_vfs_is_active ()

-
gboolean            g_vfs_is_active                     (GVfs *vfs);
+
gboolean            g_vfs_is_active                     (GVfs *vfs);

-Checks if the VFS is active.

+Checks if the VFS is active. +

- - @@ -264,20 +243,21 @@ Checks if the VFS is active.


g_vfs_get_supported_uri_schemes ()

-
const gchar* const * g_vfs_get_supported_uri_schemes    (GVfs *vfs);
+
const gchar* const * g_vfs_get_supported_uri_schemes    (GVfs *vfs);

-Gets a list of URI schemes supported by vfs.

+Gets a list of URI schemes supported by vfs. +

vfs :

a GVfs. +a GVfs.

Returns :

TRUE if construction of the vfs was successful and it is now active. + TRUE if construction of the vfs was successful and it is now active.
- - @@ -289,6 +269,6 @@ Gets a list of URI schemes supported by vfs + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GVolume.html b/docs/reference/gio/html/GVolume.html index 8b169be..206deb0 100644 --- a/docs/reference/gio/html/GVolume.html +++ b/docs/reference/gio/html/GVolume.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

vfs :

a GVfs. +a GVfs.

Returns :

a NULL-terminated array of strings. + a NULL-terminated array of strings. The returned array belongs to GIO and must not be freed or modified.
@@ -78,50 +48,50 @@ GVolume; GVolumeIface; -char * g_volume_get_name (GVolume *volume); -char * g_volume_get_uuid (GVolume *volume); -GIcon * g_volume_get_icon (GVolume *volume); -GDrive * g_volume_get_drive (GVolume *volume); -GMount * g_volume_get_mount (GVolume *volume); -gboolean g_volume_can_mount (GVolume *volume); -gboolean g_volume_should_automount (GVolume *volume); -GFile * g_volume_get_activation_root (GVolume *volume); -void g_volume_mount (GVolume *volume, - GMountMountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_volume_mount_finish (GVolume *volume, - GAsyncResult *result, - GError **error); -gboolean g_volume_can_eject (GVolume *volume); -void g_volume_eject (GVolume *volume, - GMountUnmountFlags flags, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_volume_eject_finish (GVolume *volume, - GAsyncResult *result, - GError **error); -void g_volume_eject_with_operation (GVolume *volume, - GMountUnmountFlags flags, - GMountOperation *mount_operation, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); -gboolean g_volume_eject_with_operation_finish - (GVolume *volume, - GAsyncResult *result, - GError **error); +char * g_volume_get_name (GVolume *volume); +char * g_volume_get_uuid (GVolume *volume); +GIcon * g_volume_get_icon (GVolume *volume); +GDrive * g_volume_get_drive (GVolume *volume); +GMount * g_volume_get_mount (GVolume *volume); +gboolean g_volume_can_mount (GVolume *volume); +gboolean g_volume_should_automount (GVolume *volume); +GFile * g_volume_get_activation_root (GVolume *volume); +void g_volume_mount (GVolume *volume, + GMountMountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_volume_mount_finish (GVolume *volume, + GAsyncResult *result, + GError **error); +gboolean g_volume_can_eject (GVolume *volume); +void g_volume_eject (GVolume *volume, + GMountUnmountFlags flags, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_volume_eject_finish (GVolume *volume, + GAsyncResult *result, + GError **error); +void g_volume_eject_with_operation (GVolume *volume, + GMountUnmountFlags flags, + GMountOperation *mount_operation, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data); +gboolean g_volume_eject_with_operation_finish + (GVolume *volume, + GAsyncResult *result, + GError **error); #define G_VOLUME_IDENTIFIER_KIND_HAL_UDI #define G_VOLUME_IDENTIFIER_KIND_LABEL #define G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT #define G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE #define G_VOLUME_IDENTIFIER_KIND_UUID -char ** g_volume_enumerate_identifiers (GVolume *volume); -char * g_volume_get_identifier (GVolume *volume, - const char *kind); +char ** g_volume_enumerate_identifiers (GVolume *volume); +char * g_volume_get_identifier (GVolume *volume, + const char *kind);
@@ -135,7 +105,7 @@

Prerequisites

GVolume requires - GObject.

+ GObject.

Signals

@@ -149,7 +119,7 @@ GVolume requires

The GVolume interface represents user-visible objects that can be mounted. Note, when porting from GnomeVFS, GVolume is the moral -equivalent of GnomeVFSDrive. +equivalent of GnomeVFSDrive.

Mounting a GVolume instance is an asynchronous operation. For more @@ -159,7 +129,7 @@ information about asynchronous operations, see GAsyncReadyGMountOperation object and a GAsyncReadyCallback.

-Typically, one will only want to pass NULL for the +Typically, one will only want to pass NULL for the GMountOperation if automounting all volumes when a desktop session starts since it's not desirable to put up a lot of dialogs asking for credentials. @@ -194,7 +164,8 @@ Note that G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE identifier, which can be used to obtain a hal device by means of -libhal_manger_find_device_string_match().

+libhal_manger_find_device_string_match(). +

Details

@@ -202,7 +173,8 @@ identifier, which can be used to obtain a hal device by means of

GVolume

typedef struct _GVolume GVolume;

-Opaque mountable volume object.

+Opaque mountable volume object. +


@@ -262,63 +234,64 @@ Opaque mountable volume object.

} GVolumeIface;

-Interface for implementing operations for mountable volumes.

+Interface for implementing operations for mountable volumes. +

- - + - - - - - - - - - - - - - - - - - - - @@ -378,21 +351,22 @@ Interface for implementing operations for mountable volumes.


g_volume_get_name ()

-
char *              g_volume_get_name                   (GVolume *volume);
+
char *              g_volume_get_name                   (GVolume *volume);

-Gets the name of volume.

+Gets the name of volume. +

GTypeInterface g_iface;

The parent interface. +

GTypeInterface g_iface;

The parent interface.

changed ()

Changed signal that is emitted when the volume's state has changed. +Changed signal that is emitted when the volume's state has changed.

removed ()

The removed signal that is emitted when the GVolume have been removed. If the recipient is holding references to the object they should release them so the object can be finalized. +The removed signal that is emitted when the GVolume have been removed. If the recipient is holding references to the object they should release them so the object can be finalized.

get_name ()

Gets a string containing the name of the GVolume. +Gets a string containing the name of the GVolume.

get_icon ()

Gets a GIcon for the GVolume. +Gets a GIcon for the GVolume.

get_uuid ()

Gets the UUID for the GVolume. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns NULL if there is no UUID available. +Gets the UUID for the GVolume. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns NULL if there is no UUID available.

get_drive ()

Gets a GDrive the volume is located on. Returns NULL if the GVolume is not associated with a GDrive. +Gets a GDrive the volume is located on. Returns NULL if the GVolume is not associated with a GDrive.

get_mount ()

Gets a GMount representing the mounted volume. Returns NULL if the GVolume is not mounted. +Gets a GMount representing the mounted volume. Returns NULL if the GVolume is not mounted.

can_mount ()

Returns TRUE if the GVolume can be mounted. +Returns TRUE if the GVolume can be mounted.

can_eject ()

Checks if a GVolume can be ejected. +Checks if a GVolume can be ejected.

mount_fn ()

Mounts a given GVolume. +Mounts a given GVolume. GVolume implementations must emit the "aborted" signal before completing a mount operation that is aborted while awaiting input from the user through a GMountOperation instance. @@ -326,50 +299,50 @@ Interface for implementing operations for mountable volumes.

mount_finish ()

Finishes a mount operation. +Finishes a mount operation.

eject ()

Ejects a given GVolume. +Ejects a given GVolume.

eject_finish ()

Finishes an eject operation. +Finishes an eject operation.

get_identifier ()

Returns the identifier of the given kind, or NULL if +Returns the identifier of the given kind, or NULL if the GVolume doesn't have one.

enumerate_identifiers ()

Returns an array strings listing the kinds +Returns an array strings listing the kinds of identifiers which the GVolume has.

should_automount ()

Returns TRUE if the GVolume should be automatically mounted. +Returns TRUE if the GVolume should be automatically mounted.

get_activation_root ()

Returns the activation root for the GVolume if it is known in advance or NULL if +Returns the activation root for the GVolume if it is known in advance or NULL if it is not known.

eject_with_operation ()

Starts ejecting a GVolume using a GMountOperation. Since 2.22. +Starts ejecting a GVolume using a GMountOperation. Since 2.22.

eject_with_operation_finish ()

Finishes an eject operation using a GMountOperation. Since 2.22. +Finishes an eject operation using a GMountOperation. Since 2.22.
- @@ -401,24 +375,25 @@ be freed with

g_volume_get_uuid ()

-
char *              g_volume_get_uuid                   (GVolume *volume);
+
char *              g_volume_get_uuid                   (GVolume *volume);

Gets the UUID for the volume. The reference is typically based on the file system UUID for the volume in question and should be -considered an opaque string. Returns NULL if there is no UUID -available.

+considered an opaque string. Returns NULL if there is no UUID +available. +

volume :

a GVolume. +a GVolume.

Returns :

the name for the given volume. The returned string should -be freed with g_free() when no longer needed. +be freed with g_free() when no longer needed.
- - @@ -428,21 +403,22 @@ available.


g_volume_get_icon ()

-
GIcon *             g_volume_get_icon                   (GVolume *volume);
+
GIcon *             g_volume_get_icon                   (GVolume *volume);

-Gets the icon for volume.

+Gets the icon for volume. +

volume :

a GVolume. +a GVolume.

Returns :

the UUID for volume or NULL if no UUID can be computed. - The returned string should be freed with g_free() + the UUID for volume or NULL if no UUID can be computed. + The returned string should be freed with g_free() when no longer needed.
- @@ -452,21 +428,22 @@ Gets the icon for volume.


g_volume_get_drive ()

-
GDrive *            g_volume_get_drive                  (GVolume *volume);
+
GDrive *            g_volume_get_drive                  (GVolume *volume);

-Gets the drive for the volume.

+Gets the drive for the volume. +

volume :

a GVolume. +a GVolume.

Returns :

a GIcon. - The returned object should be unreffed with g_object_unref() + The returned object should be unreffed with g_object_unref() when no longer needed.
- - @@ -476,21 +453,22 @@ Gets the drive for the volume.


g_volume_get_mount ()

-
GMount *            g_volume_get_mount                  (GVolume *volume);
+
GMount *            g_volume_get_mount                  (GVolume *volume);

-Gets the mount for the volume.

+Gets the mount for the volume. +

volume :

a GVolume. +a GVolume.

Returns :

a GDrive or NULL if volume is not associated with a drive. - The returned object should be unreffed with g_object_unref() + a GDrive or NULL if volume is not associated with a drive. + The returned object should be unreffed with g_object_unref() when no longer needed.
- - @@ -500,20 +478,21 @@ Gets the mount for the volume.


g_volume_can_mount ()

-
gboolean            g_volume_can_mount                  (GVolume *volume);
+
gboolean            g_volume_can_mount                  (GVolume *volume);

-Checks if a volume can be mounted.

+Checks if a volume can be mounted. +

volume :

a GVolume. +a GVolume.

Returns :

a GMount or NULL if volume isn't mounted. - The returned object should be unreffed with g_object_unref() + a GMount or NULL if volume isn't mounted. + The returned object should be unreffed with g_object_unref() when no longer needed.
- - @@ -522,20 +501,21 @@ Checks if a volume can be mounted.


g_volume_should_automount ()

-
gboolean            g_volume_should_automount           (GVolume *volume);
+
gboolean            g_volume_should_automount           (GVolume *volume);

-Returns whether the volume should be automatically mounted.

+Returns whether the volume should be automatically mounted. +

volume :

a GVolume. +a GVolume.

Returns :

TRUE if the volume can be mounted. FALSE otherwise. + TRUE if the volume can be mounted. FALSE otherwise.
- - @@ -544,10 +524,10 @@ Returns whether the volume should be automatically mounted.


g_volume_get_activation_root ()

-
GFile *             g_volume_get_activation_root        (GVolume *volume);
+
GFile *             g_volume_get_activation_root        (GVolume *volume);

Gets the activation root for a GVolume if it is known ahead of -mount time. Returns NULL otherwise. If not NULL and if volume +mount time. Returns NULL otherwise. If not NULL and if volume is mounted, then the result of g_mount_get_root() on the GMount object obtained from g_volume_get_mount() will always either be equal or a prefix of what this function returns. In @@ -578,24 +558,25 @@ then the expression

-will always be TRUE. +will always be TRUE.

Activation roots are typically used in GVolumeMonitor implementations to find the underlying mount to shadow, see -g_mount_is_shadowed() for more details.

+g_mount_is_shadowed() for more details. +

volume :

a GVolume +a GVolume

Returns :

TRUE if the volume should be automatically mounted. + TRUE if the volume should be automatically mounted.
- - @@ -606,47 +587,48 @@ implementations to find the underlying mount to shadow, see

g_volume_mount ()

-
void                g_volume_mount                      (GVolume *volume,
-                                                         GMountMountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_volume_mount                      (GVolume *volume,
+                                                         GMountMountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Mounts a volume. This is an asynchronous operation, and is finished by calling g_volume_mount_finish() with the volume -and GAsyncResult returned in the callback.

+and GAsyncResult returned in the callback. +

volume :

a GVolume +a GVolume

Returns :

the activation root of volume or NULL. Use -g_object_unref() to free. + the activation root of volume or NULL. Use +g_object_unref() to free.
- - - - - - @@ -655,39 +637,40 @@ and

g_volume_mount_finish ()

-
gboolean            g_volume_mount_finish               (GVolume *volume,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_volume_mount_finish               (GVolume *volume,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes mounting a volume. If any errors occured during the operation, -error will be set to contain the errors and FALSE will be returned. +error will be set to contain the errors and FALSE will be returned.

If the mount operation succeeded, g_volume_get_mount() on volume is guaranteed to return the mount right after calling this function; there's no need to listen for the 'mount-added' signal on -GVolumeMonitor.

+GVolumeMonitor. +

volume :

a GVolume. +a GVolume.

flags :

flags affecting the operation +flags affecting the operation

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data that gets passed to callback +user data that gets passed to callback
- - - - @@ -696,20 +679,21 @@ function; there's no need to listen for the 'mount-added' signal on

g_volume_can_eject ()

-
gboolean            g_volume_can_eject                  (GVolume *volume);
+
gboolean            g_volume_can_eject                  (GVolume *volume);

-Checks if a volume can be ejected.

+Checks if a volume can be ejected. +

volume :

a GVolume +a GVolume

result :

a GAsyncResult +a GAsyncResult

error :

a GError location to store an error, or NULL to ignore +a GError location to store an error, or NULL to ignore

Returns :

TRUE, FALSE if operation failed. + TRUE, FALSE if operation failed.
- - @@ -718,11 +702,11 @@ Checks if a volume can be ejected.


g_volume_eject ()

-
void                g_volume_eject                      (GVolume *volume,
-                                                         GMountUnmountFlags flags,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_volume_eject                      (GVolume *volume,
+                                                         GMountUnmountFlags flags,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Warning

g_volume_eject has been deprecated since version 2.22 and should not be used in newly-written code. Use g_volume_eject_with_operation() instead.

@@ -730,33 +714,34 @@ Checks if a volume can be ejected.

Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_finish() with the volume -and GAsyncResult returned in the callback.

+and GAsyncResult returned in the callback. +

volume :

a GVolume. +a GVolume.

Returns :

TRUE if the volume can be ejected. FALSE otherwise. + TRUE if the volume can be ejected. FALSE otherwise.
- - - - - @@ -765,37 +750,38 @@ and

g_volume_eject_finish ()

-
gboolean            g_volume_eject_finish               (GVolume *volume,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_volume_eject_finish               (GVolume *volume,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Warning

g_volume_eject_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_volume_eject_with_operation_finish() instead.

Finishes ejecting a volume. If any errors occured during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

volume :

a GVolume. +a GVolume.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data that gets passed to callback +user data that gets passed to callback
- - - - @@ -805,47 +791,48 @@ Finishes ejecting a volume. If any errors occured during the operation,

g_volume_eject_with_operation ()

-
void                g_volume_eject_with_operation       (GVolume *volume,
-                                                         GMountUnmountFlags flags,
-                                                         GMountOperation *mount_operation,
-                                                         GCancellable *cancellable,
-                                                         GAsyncReadyCallback callback,
-                                                         gpointer user_data);
+
void                g_volume_eject_with_operation       (GVolume *volume,
+                                                         GMountUnmountFlags flags,
+                                                         GMountOperation *mount_operation,
+                                                         GCancellable *cancellable,
+                                                         GAsyncReadyCallback callback,
+                                                         gpointer user_data);

Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_with_operation_finish() with the volume -and GAsyncResult data returned in the callback.

+and GAsyncResult data returned in the callback. +

volume :

pointer to a GVolume. +pointer to a GVolume.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store an error, or NULL to ignore +a GError location to store an error, or NULL to ignore

Returns :

TRUE, FALSE if operation failed. + TRUE, FALSE if operation failed.
- - - - - - @@ -855,35 +842,36 @@ and

g_volume_eject_with_operation_finish ()

-
gboolean            g_volume_eject_with_operation_finish
-                                                        (GVolume *volume,
-                                                         GAsyncResult *result,
-                                                         GError **error);
+
gboolean            g_volume_eject_with_operation_finish
+                                                        (GVolume *volume,
+                                                         GAsyncResult *result,
+                                                         GError **error);

Finishes ejecting a volume. If any errors occurred during the operation, -error will be set to contain the errors and FALSE will be returned.

+error will be set to contain the errors and FALSE will be returned. +

volume :

a GVolume. +a GVolume.

flags :

flags affecting the unmount if required for eject +flags affecting the unmount if required for eject

mount_operation :

a GMountOperation or NULL to avoid user interaction. +a GMountOperation or NULL to avoid user interaction.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

callback :

a GAsyncReadyCallback, or NULL. +a GAsyncReadyCallback, or NULL.

user_data :

user data passed to callback. +user data passed to callback.
- - - - @@ -897,7 +885,8 @@ Finishes ejecting a volume. If any errors occurred during the operation,
#define G_VOLUME_IDENTIFIER_KIND_HAL_UDI "hal-udi"
 

-The string used to obtain a Hal UDI with g_volume_get_identifier().

+The string used to obtain a Hal UDI with g_volume_get_identifier(). +


@@ -905,7 +894,8 @@ The string used to obtain a Hal UDI with #define G_VOLUME_IDENTIFIER_KIND_LABEL "label"

-The string used to obtain a filesystem label with g_volume_get_identifier().

+The string used to obtain a filesystem label with g_volume_get_identifier(). +


@@ -913,7 +903,8 @@ The string used to obtain a filesystem label with #define G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT "nfs-mount"

-The string used to obtain a NFS mount with g_volume_get_identifier().

+The string used to obtain a NFS mount with g_volume_get_identifier(). +


@@ -921,7 +912,8 @@ The string used to obtain a NFS mount with #define G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE "unix-device"

-The string used to obtain a Unix device path with g_volume_get_identifier().

+The string used to obtain a Unix device path with g_volume_get_identifier(). +


@@ -929,28 +921,30 @@ The string used to obtain a Unix device path with #define G_VOLUME_IDENTIFIER_KIND_UUID "uuid"

-The string used to obtain a UUID with g_volume_get_identifier().

+The string used to obtain a UUID with g_volume_get_identifier(). +


g_volume_enumerate_identifiers ()

-
char **             g_volume_enumerate_identifiers      (GVolume *volume);
+
char **             g_volume_enumerate_identifiers      (GVolume *volume);

Gets the kinds of identifiers that volume has. Use g_volume_get_identifer() to obtain -the identifiers themselves.

+the identifiers themselves. +

volume :

a GVolume. +a GVolume.

result :

a GAsyncResult. +a GAsyncResult.

error :

a GError location to store the error occuring, or NULL to +a GError location to store the error occuring, or NULL to ignore.

Returns :

TRUE if the volume was successfully ejected. FALSE otherwise. + TRUE if the volume was successfully ejected. FALSE otherwise.
- - @@ -959,29 +953,30 @@ the identifiers themselves.


g_volume_get_identifier ()

-
char *              g_volume_get_identifier             (GVolume *volume,
-                                                         const char *kind);
+
char *              g_volume_get_identifier             (GVolume *volume,
+                                                         const char *kind);

Gets the identifier of the given kind for volume. See the introduction -for more information about volume identifiers.

+for more information about volume identifiers. +

volume :

a GVolume +a GVolume

Returns :

a NULL-terminated array of strings containing - kinds of identifiers. Use g_strfreev() to free. + a NULL-terminated array of strings containing + kinds of identifiers. Use g_strfreev() to free.
- - @@ -994,9 +989,10 @@ for more information about volume identifiers.

The "changed" signal

void                user_function                      (GVolume *arg0,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the volume has been changed.

+Emitted when the volume has been changed. +

volume :

a GVolume +a GVolume

kind :

the kind of identifier to return +the kind of identifier to return

Returns :

a newly allocated string containing the - requested identfier, or NULL if the GVolume + requested identfier, or NULL if the GVolume doesn't have this kind of identifier
@@ -1009,11 +1005,12 @@ Emitted when the volume has been changed.

The "removed" signal

void                user_function                      (GVolume *arg0,
-                                                        gpointer user_data)      : Run Last
+ gpointer user_data) : Run Last

This signal is emitted when the GVolume have been removed. If the recipient is holding references to the object they should -release them so the object can be finalized.

+release them so the object can be finalized. +

@@ -1026,6 +1023,6 @@ release them so the object can be finalized.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GVolumeMonitor.html b/docs/reference/gio/html/GVolumeMonitor.html index 9af6a87..d8da455 100644 --- a/docs/reference/gio/html/GVolumeMonitor.html +++ b/docs/reference/gio/html/GVolumeMonitor.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -76,23 +46,23 @@ GVolumeMonitor; #define G_VOLUME_MONITOR_EXTENSION_POINT_NAME -GVolumeMonitor * g_volume_monitor_get (void); -GList * g_volume_monitor_get_connected_drives - (GVolumeMonitor *volume_monitor); -GList * g_volume_monitor_get_volumes (GVolumeMonitor *volume_monitor); -GList * g_volume_monitor_get_mounts (GVolumeMonitor *volume_monitor); -GVolume * g_volume_monitor_adopt_orphan_mount (GMount *mount); -GMount * g_volume_monitor_get_mount_for_uuid (GVolumeMonitor *volume_monitor, - const char *uuid); +GVolumeMonitor * g_volume_monitor_get (void); +GList * g_volume_monitor_get_connected_drives + (GVolumeMonitor *volume_monitor); +GList * g_volume_monitor_get_volumes (GVolumeMonitor *volume_monitor); +GList * g_volume_monitor_get_mounts (GVolumeMonitor *volume_monitor); +GVolume * g_volume_monitor_adopt_orphan_mount (GMount *mount); +GMount * g_volume_monitor_get_mount_for_uuid (GVolumeMonitor *volume_monitor, + const char *uuid); GVolume * g_volume_monitor_get_volume_for_uuid - (GVolumeMonitor *volume_monitor, - const char *uuid); + (GVolumeMonitor *volume_monitor, + const char *uuid);

Object Hierarchy

-  GObject
+  GObject
    +----GVolumeMonitor
 
@@ -123,7 +93,8 @@ would show in a sidebar.

GVolumeMonitor is not thread-default-context aware, and so should not be used other than from the main -thread, with no thread-default-context active.

+thread, with no thread-default-context active. +

Details

@@ -131,7 +102,8 @@ thread, with no thread-default-context active.

GVolumeMonitor

typedef struct _GVolumeMonitor GVolumeMonitor;

-A Volume Monitor that watches for volume events.

+A Volume Monitor that watches for volume events. +

@@ -144,20 +116,22 @@ A Volume Monitor that watches for volume events.

Extension point for volume monitor functionality. -See Extending GIO.

+See Extending GIO. +


g_volume_monitor_get ()

-
GVolumeMonitor *    g_volume_monitor_get                (void);
+
GVolumeMonitor *    g_volume_monitor_get                (void);

-Gets the volume monitor used by gio.

+Gets the volume monitor used by gio. +

Returns :

a reference to the GVolumeMonitor used by gio. Call - g_object_unref() when done with it. + g_object_unref() when done with it.
@@ -165,25 +139,26 @@ Gets the volume monitor used by gio.


g_volume_monitor_get_connected_drives ()

-
GList *             g_volume_monitor_get_connected_drives
-                                                        (GVolumeMonitor *volume_monitor);
+
GList *             g_volume_monitor_get_connected_drives
+                                                        (GVolumeMonitor *volume_monitor);

Gets a list of drives connected to the system.

-The returned list should be freed with g_list_free(), after -its elements have been unreffed with g_object_unref().

+The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). +

- - @@ -192,24 +167,25 @@ its elements have been unreffed with

g_volume_monitor_get_volumes ()

-
GList *             g_volume_monitor_get_volumes        (GVolumeMonitor *volume_monitor);
+
GList *             g_volume_monitor_get_volumes        (GVolumeMonitor *volume_monitor);

Gets a list of the volumes on the system.

-The returned list should be freed with g_list_free(), after -its elements have been unreffed with g_object_unref().

+The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). +

volume_monitor :

a GVolumeMonitor. +a GVolumeMonitor.

Returns :

a GList of connected GDrive objects. + a GList of connected GDrive objects.
- - @@ -218,24 +194,25 @@ its elements have been unreffed with

g_volume_monitor_get_mounts ()

-
GList *             g_volume_monitor_get_mounts         (GVolumeMonitor *volume_monitor);
+
GList *             g_volume_monitor_get_mounts         (GVolumeMonitor *volume_monitor);

Gets a list of the mounts on the system.

-The returned list should be freed with g_list_free(), after -its elements have been unreffed with g_object_unref().

+The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). +

volume_monitor :

a GVolumeMonitor. +a GVolumeMonitor.

Returns :

a GList of GVolume objects. + a GList of GVolume objects.
- - @@ -244,7 +221,7 @@ its elements have been unreffed with

g_volume_monitor_adopt_orphan_mount ()

-
GVolume *           g_volume_monitor_adopt_orphan_mount (GMount *mount);
+
GVolume *           g_volume_monitor_adopt_orphan_mount (GMount *mount);

Warning

g_volume_monitor_adopt_orphan_mount has been deprecated since version 2.20 and should not be used in newly-written code. Instead of using this function, GVolumeMonitor @@ -260,7 +237,7 @@ associated with a mount_added signal.

-If the return value is not NULL, the caller must associate the +If the return value is not NULL, the caller must associate the returned GVolume object with the GMount. This involves returning it in its g_mount_get_volume() implementation. The caller must also listen for the "removed" signal on the returned object @@ -286,18 +263,19 @@ assoicated with the The other is for implementing a GVolumeMonitor whose sole purpose is to return GVolume objects representing entries in the users -"favorite servers" list or similar.

+"favorite servers" list or similar. +

volume_monitor :

a GVolumeMonitor. +a GVolumeMonitor.

Returns :

a GList of GMount objects. + a GList of GMount objects.
- - @@ -308,27 +286,28 @@ if no wants to adopt the

g_volume_monitor_get_mount_for_uuid ()

-
GMount *            g_volume_monitor_get_mount_for_uuid (GVolumeMonitor *volume_monitor,
-                                                         const char *uuid);
+
GMount *            g_volume_monitor_get_mount_for_uuid (GVolumeMonitor *volume_monitor,
+                                                         const char *uuid);

-Finds a GMount object by its UUID (see g_mount_get_uuid())

+Finds a GMount object by its UUID (see g_mount_get_uuid()) +

mount :

a GMount object to find a parent for +a GMount object to find a parent for

Returns :

the GVolume object that is the parent for mount or NULL + the GVolume object that is the parent for mount or NULL if no wants to adopt the GMount.
- - - @@ -338,27 +317,28 @@ Finds a GMo

g_volume_monitor_get_volume_for_uuid ()

GVolume *           g_volume_monitor_get_volume_for_uuid
-                                                        (GVolumeMonitor *volume_monitor,
-                                                         const char *uuid);
+ (GVolumeMonitor *volume_monitor, + const char *uuid);

-Finds a GVolume object by its UUID (see g_volume_get_uuid())

+Finds a GVolume object by its UUID (see g_volume_get_uuid()) +

volume_monitor :

a GVolumeMonitor. +a GVolumeMonitor.

uuid :

the UUID to look for +the UUID to look for

Returns :

a GMount or NULL if no such mount is available. - Free the returned object with g_object_unref(). + a GMount or NULL if no such mount is available. + Free the returned object with g_object_unref().
- - - @@ -371,20 +351,21 @@ Finds a G

The "drive-changed" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GDrive         *drive,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a drive changes.

+Emitted when a drive changes. +

volume_monitor :

a GVolumeMonitor. +a GVolumeMonitor.

uuid :

the UUID to look for +the UUID to look for

Returns :

a GVolume or NULL if no such volume is available. - Free the returned object with g_object_unref(). + a GVolume or NULL if no such volume is available. + Free the returned object with g_object_unref().
- - @@ -399,20 +380,21 @@ Emitted when a drive changes.

The "drive-connected" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GDrive         *drive,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a drive is connected to the system.

+Emitted when a drive is connected to the system. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

drive :

the drive that changed +the drive that changed
- - @@ -427,20 +409,21 @@ Emitted when a drive is connected to the system.

The "drive-disconnected" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GDrive         *drive,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a drive is disconnected from the system.

+Emitted when a drive is disconnected from the system. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

drive :

a GDrive that was connected. +a GDrive that was connected.
- - @@ -455,20 +438,21 @@ Emitted when a drive is disconnected from the system.

The "drive-eject-button" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GDrive         *drive,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when the eject button is pressed on drive.

+Emitted when the eject button is pressed on drive. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

drive :

a GDrive that was disconnected. +a GDrive that was disconnected.
- - @@ -484,20 +468,21 @@ Emitted when the eject button is pressed on drive

The "drive-stop-button" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GDrive         *drive,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when the stop button is pressed on drive.

+Emitted when the stop button is pressed on drive. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

drive :

the drive where the eject button was pressed +the drive where the eject button was pressed
- - @@ -513,20 +498,21 @@ Emitted when the stop button is pressed on drive

The "mount-added" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GMount         *mount,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mount is added.

+Emitted when a mount is added. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

drive :

the drive where the stop button was pressed +the drive where the stop button was pressed
- - @@ -541,20 +527,21 @@ Emitted when a mount is added.

The "mount-changed" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GMount         *mount,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mount changes.

+Emitted when a mount changes. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

mount :

a GMount that was added. +a GMount that was added.
- - @@ -569,20 +556,21 @@ Emitted when a mount changes.

The "mount-pre-unmount" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GMount         *mount,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mount is about to be removed.

+Emitted when a mount is about to be removed. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

mount :

a GMount that changed. +a GMount that changed.
- - @@ -597,20 +585,21 @@ Emitted when a mount is about to be removed.

The "mount-removed" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GMount         *mount,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mount is removed.

+Emitted when a mount is removed. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

mount :

a GMount that is being unmounted. +a GMount that is being unmounted.
- - @@ -625,20 +614,21 @@ Emitted when a mount is removed.

The "volume-added" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GVolume        *volume,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mountable volume is added to the system.

+Emitted when a mountable volume is added to the system. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

mount :

a GMount that was removed. +a GMount that was removed.
- - @@ -653,20 +643,21 @@ Emitted when a mountable volume is added to the system.

The "volume-changed" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GVolume        *volume,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when mountable volume is changed.

+Emitted when mountable volume is changed. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

volume :

a GVolume that was added. +a GVolume that was added.
- - @@ -681,20 +672,21 @@ Emitted when mountable volume is changed.

The "volume-removed" signal

void                user_function                      (GVolumeMonitor *volume_monitor,
                                                         GVolume        *volume,
-                                                        gpointer        user_data)           : Run Last
+ gpointer user_data) : Run Last

-Emitted when a mountable volume is removed from the system.

+Emitted when a mountable volume is removed from the system. +

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

volume :

a GVolume that changed. +a GVolume that changed.
- - @@ -712,6 +704,6 @@ Emitted when a mountable volume is removed from the system.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GZlibCompressor.html b/docs/reference/gio/html/GZlibCompressor.html index db24493..7dbe574 100644 --- a/docs/reference/gio/html/GZlibCompressor.html +++ b/docs/reference/gio/html/GZlibCompressor.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

volume_monitor :

The volume monitor emitting the signal. +The volume monitor emitting the signal.

volume :

a GVolume that was removed. +a GVolume that was removed.
@@ -78,14 +48,14 @@ GZlibCompressor; enum GZlibCompressorFormat; -GZlibCompressor * g_zlib_compressor_new (GZlibCompressorFormat format, - int level); +GZlibCompressor * g_zlib_compressor_new (GZlibCompressorFormat format, + int level);

Object Hierarchy

-  GObject
+  GObject
    +----GZlibCompressor
 
@@ -99,14 +69,15 @@ GZlibCompressor implements

Properties

   "format"                   GZlibCompressorFormat  : Read / Write / Construct Only
-  "level"                    gint                  : Read / Write / Construct Only
+  "level"                    gint                  : Read / Write / Construct Only
 

Description

GZlibCompressor is an implementation of GConverter that -compresses data using zlib.

+compresses data using zlib. +

Details

@@ -114,7 +85,8 @@ compresses data using zlib.

GZlibCompressor

typedef struct _GZlibCompressor GZlibCompressor;

-Zlib decompression

+Zlib decompression +


@@ -127,23 +99,24 @@ Zlib decompression

Used to select the type of data format to use for GZlibDecompressor -and GZlibCompressor.

+and GZlibCompressor. +

- - - @@ -153,21 +126,22 @@ and

g_zlib_compressor_new ()

-
GZlibCompressor *   g_zlib_compressor_new               (GZlibCompressorFormat format,
-                                                         int level);
+
GZlibCompressor *   g_zlib_compressor_new               (GZlibCompressorFormat format,
+                                                         int level);

-Creates a new GZlibCompressor.

+Creates a new GZlibCompressor. +

G_ZLIB_COMPRESSOR_FORMAT_ZLIB

deflate compression with zlib header +deflate compression with zlib header

G_ZLIB_COMPRESSOR_FORMAT_GZIP

gzip file format +gzip file format

G_ZLIB_COMPRESSOR_FORMAT_RAW

deflate compression with no header +deflate compression with no header
- - @@ -192,7 +166,7 @@ Creates a new

The "level" property

-
  "level"                    gint                  : Read / Write / Construct Only
+
  "level"                    gint                  : Read / Write / Construct Only

The level of compression from 0 (no compression) to 9 (most compression), -1 for the default level.

Allowed values: [G_MAXULONG,9]

Default value: -1

@@ -201,6 +175,6 @@ Creates a new
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/GZlibDecompressor.html b/docs/reference/gio/html/GZlibDecompressor.html index 12bcc9a..957843d 100644 --- a/docs/reference/gio/html/GZlibDecompressor.html +++ b/docs/reference/gio/html/GZlibDecompressor.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

format :

The format to use for the compressed data +The format to use for the compressed data

level :

compression level (0-9), -1 for default +compression level (0-9), -1 for default
@@ -77,13 +47,13 @@ #include <gio/gio.h> GZlibDecompressor; -GZlibDecompressor * g_zlib_decompressor_new (GZlibCompressorFormat format); +GZlibDecompressor * g_zlib_decompressor_new (GZlibCompressorFormat format);

Object Hierarchy

-  GObject
+  GObject
    +----GZlibDecompressor
 
@@ -103,7 +73,8 @@ GZlibDecompressor implements

Description

GZlibDecompressor is an implementation of GConverter that -decompresses data compressed with zlib.

+decompresses data compressed with zlib. +

Details

@@ -111,20 +82,22 @@ decompresses data compressed with zlib.

GZlibDecompressor

typedef struct _GZlibDecompressor GZlibDecompressor;

-Zlib decompression

+Zlib decompression +


g_zlib_decompressor_new ()

-
GZlibDecompressor * g_zlib_decompressor_new             (GZlibCompressorFormat format);
+
GZlibDecompressor * g_zlib_decompressor_new             (GZlibCompressorFormat format);

-Creates a new GZlibDecompressor.

+Creates a new GZlibDecompressor. +

- @@ -150,6 +123,6 @@ Creates a new
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-2-18.html b/docs/reference/gio/html/api-index-2-18.html index 2eada71..35fd3cb 100644 --- a/docs/reference/gio/html/api-index-2-18.html +++ b/docs/reference/gio/html/api-index-2-18.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

format :

The format to use for the compressed data +The format to use for the compressed data
@@ -72,64 +42,112 @@

Index of new symbols in 2.18

C

-
g_content_type_from_mime_type
+
+g_content_type_from_mime_type, function in GContentType +
-
g_content_type_guess_for_tree
+
+g_content_type_guess_for_tree, function in GContentType +

D

-
g_desktop_app_info_new_from_keyfile
+
+g_desktop_app_info_new_from_keyfile, function in Desktop file based GAppInfo +

E

-
g_emblemed_icon_add_emblem
+
+g_emblemed_icon_add_emblem, function in GEmblemedIcon +
-
g_emblemed_icon_get_emblems
+
+g_emblemed_icon_get_emblems, function in GEmblemedIcon +
-
g_emblemed_icon_get_icon
+
+g_emblemed_icon_get_icon, function in GEmblemedIcon +
-
g_emblemed_icon_new
+
+g_emblemed_icon_new, function in GEmblemedIcon +
-
GEmblemOrigin
+
+GEmblemOrigin, enum in GEmblem +
-
g_emblem_get_icon
+
+g_emblem_get_icon, function in GEmblem +
-
g_emblem_get_origin
+
+g_emblem_get_origin, function in GEmblem +
-
g_emblem_new
+
+g_emblem_new, function in GEmblem +
-
g_emblem_new_with_origin
+
+g_emblem_new_with_origin, function in GEmblem +

F

-
g_file_enumerator_get_container
+
+g_file_enumerator_get_container, function in GFileEnumerator +
-
g_file_make_directory_with_parents
+
+g_file_make_directory_with_parents, function in GFile +
-
g_file_monitor
+
+g_file_monitor, function in GFile +
-
g_file_query_file_type
+
+g_file_query_file_type, function in GFile +

M

-
g_memory_output_stream_get_data_size
+
+g_memory_output_stream_get_data_size, function in GMemoryOutputStream +
-
g_mount_guess_content_type
+
+g_mount_guess_content_type, function in GMount +
-
g_mount_guess_content_type_finish
+
+g_mount_guess_content_type_finish, function in GMount +
-
g_mount_guess_content_type_sync
+
+g_mount_guess_content_type_sync, function in GMount +

T

-
g_themed_icon_prepend_name
+
+g_themed_icon_prepend_name, function in GThemedIcon +

U

-
g_unix_mount_monitor_set_rate_limit
+
+g_unix_mount_monitor_set_rate_limit, function in Unix Mounts +

V

-
GVolumeMonitor::drive-eject-button
+
+GVolumeMonitor::drive-eject-button, object signal in GVolumeMonitor +
-
g_volume_get_activation_root
+
+g_volume_get_activation_root, function in GVolume +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-2-20.html b/docs/reference/gio/html/api-index-2-20.html index 3893831..1868c7d 100644 --- a/docs/reference/gio/html/api-index-2-20.html +++ b/docs/reference/gio/html/api-index-2-20.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -68,66 +38,118 @@

Index of new symbols in 2.20

A

-
g_app_info_can_delete
+
+g_app_info_can_delete, function in GAppInfo +
-
g_app_info_delete
+
+g_app_info_delete, function in GAppInfo +
-
g_app_info_get_commandline
+
+g_app_info_get_commandline, function in GAppInfo +
-
g_app_info_reset_type_associations
+
+g_app_info_reset_type_associations, function in GAppInfo +

D

-
g_data_input_stream_read_line_async
+
+g_data_input_stream_read_line_async, function in GDataInputStream +
-
g_data_input_stream_read_line_finish
+
+g_data_input_stream_read_line_finish, function in GDataInputStream +
-
g_data_input_stream_read_until_async
+
+g_data_input_stream_read_until_async, function in GDataInputStream +
-
g_data_input_stream_read_until_finish
+
+g_data_input_stream_read_until_finish, function in GDataInputStream +

F

-
G_FILE_ATTRIBUTE_PREVIEW_ICON
+
+G_FILE_ATTRIBUTE_PREVIEW_ICON, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE
+
+G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE, macro in GFileInfo +

I

-
g_icon_new_for_string
+
+g_icon_new_for_string, function in GIcon +
-
g_icon_to_string
+
+g_icon_to_string, function in GIcon +

M

-
GMountOperation::aborted
+
+GMountOperation::aborted, object signal in GMountOperation +
-
g_mount_is_shadowed
+
+g_mount_is_shadowed, function in GMount +
-
g_mount_shadow
+
+g_mount_shadow, function in GMount +
-
g_mount_unshadow
+
+g_mount_unshadow, function in GMount +

U

-
GUnixInputStream:close-fd
+
+GUnixInputStream:close-fd, object property in GUnixInputStream +
-
GUnixInputStream:fd
+
+GUnixInputStream:fd, object property in GUnixInputStream +
-
GUnixOutputStream:close-fd
+
+GUnixOutputStream:close-fd, object property in GUnixOutputStream +
-
GUnixOutputStream:fd
+
+GUnixOutputStream:fd, object property in GUnixOutputStream +
-
g_unix_input_stream_get_close_fd
+
+g_unix_input_stream_get_close_fd, function in GUnixInputStream +
-
g_unix_input_stream_get_fd
+
+g_unix_input_stream_get_fd, function in GUnixInputStream +
-
g_unix_input_stream_set_close_fd
+
+g_unix_input_stream_set_close_fd, function in GUnixInputStream +
-
g_unix_output_stream_get_close_fd
+
+g_unix_output_stream_get_close_fd, function in GUnixOutputStream +
-
g_unix_output_stream_get_fd
+
+g_unix_output_stream_get_fd, function in GUnixOutputStream +
-
g_unix_output_stream_set_close_fd
+
+g_unix_output_stream_set_close_fd, function in GUnixOutputStream +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-2-22.html b/docs/reference/gio/html/api-index-2-22.html index b144821..ea345b7 100644 --- a/docs/reference/gio/html/api-index-2-22.html +++ b/docs/reference/gio/html/api-index-2-22.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -82,529 +52,1037 @@

Index of new symbols in 2.22

A

-
GAsyncInitable
+
+GAsyncInitable, struct in GAsyncInitable +
-
GAsyncInitableIface
+
+GAsyncInitableIface, struct in GAsyncInitable +
-
g_async_initable_init_async
+
+g_async_initable_init_async, function in GAsyncInitable +
-
g_async_initable_init_finish
+
+g_async_initable_init_finish, function in GAsyncInitable +
-
g_async_initable_newv_async
+
+g_async_initable_newv_async, function in GAsyncInitable +
-
g_async_initable_new_async
+
+g_async_initable_new_async, function in GAsyncInitable +
-
g_async_initable_new_finish
+
+g_async_initable_new_finish, function in GAsyncInitable +
-
g_async_initable_new_valist_async
+
+g_async_initable_new_valist_async, function in GAsyncInitable +

C

-
g_cancellable_connect
+
+g_cancellable_connect, function in GCancellable +
-
g_cancellable_disconnect
+
+g_cancellable_disconnect, function in GCancellable +
-
g_cancellable_make_pollfd
+
+g_cancellable_make_pollfd, function in GCancellable +
-
g_cancellable_release_fd
+
+g_cancellable_release_fd, function in GCancellable +

D

-
GDrive::stop-button
+
+GDrive::stop-button, object signal in GDrive +
-
GDriveStartFlags
+
+GDriveStartFlags, enum in GDrive +
-
GDriveStartStopType
+
+GDriveStartStopType, enum in GDrive +
-
g_drive_can_start
+
+g_drive_can_start, function in GDrive +
-
g_drive_can_start_degraded
+
+g_drive_can_start_degraded, function in GDrive +
-
g_drive_can_stop
+
+g_drive_can_stop, function in GDrive +
-
g_drive_eject_with_operation
+
+g_drive_eject_with_operation, function in GDrive +
-
g_drive_eject_with_operation_finish
+
+g_drive_eject_with_operation_finish, function in GDrive +
-
g_drive_get_start_stop_type
+
+g_drive_get_start_stop_type, function in GDrive +
-
g_drive_start
+
+g_drive_start, function in GDrive +
-
g_drive_start_finish
+
+g_drive_start_finish, function in GDrive +
-
g_drive_stop
+
+g_drive_stop, function in GDrive +
-
g_drive_stop_finish
+
+g_drive_stop_finish, function in GDrive +

F

-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC
+
+G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE
+
+G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE
+
+G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE, macro in GFileInfo +
-
g_file_create_readwrite
+
+g_file_create_readwrite, function in GFile +
-
g_file_create_readwrite_async
+
+g_file_create_readwrite_async, function in GFile +
-
g_file_create_readwrite_finish
+
+g_file_create_readwrite_finish, function in GFile +
-
g_file_eject_mountable_with_operation
+
+g_file_eject_mountable_with_operation, function in GFile +
-
g_file_eject_mountable_with_operation_finish
+
+g_file_eject_mountable_with_operation_finish, function in GFile +
-
g_file_info_get_attribute_stringv
+
+g_file_info_get_attribute_stringv, function in GFileInfo +
-
g_file_info_has_namespace
+
+g_file_info_has_namespace, function in GFileInfo +
-
g_file_info_set_attribute_status
+
+g_file_info_set_attribute_status, function in GFileInfo +
-
g_file_io_stream_get_etag
+
+g_file_io_stream_get_etag, function in GFileIOStream +
-
g_file_io_stream_query_info
+
+g_file_io_stream_query_info, function in GFileIOStream +
-
g_file_io_stream_query_info_async
+
+g_file_io_stream_query_info_async, function in GFileIOStream +
-
g_file_io_stream_query_info_finish
+
+g_file_io_stream_query_info_finish, function in GFileIOStream +
-
g_file_open_readwrite
+
+g_file_open_readwrite, function in GFile +
-
g_file_open_readwrite_async
+
+g_file_open_readwrite_async, function in GFile +
-
g_file_open_readwrite_finish
+
+g_file_open_readwrite_finish, function in GFile +
-
g_file_poll_mountable
+
+g_file_poll_mountable, function in GFile +
-
g_file_poll_mountable_finish
+
+g_file_poll_mountable_finish, function in GFile +
-
g_file_replace_readwrite
+
+g_file_replace_readwrite, function in GFile +
-
g_file_replace_readwrite_async
+
+g_file_replace_readwrite_async, function in GFile +
-
g_file_replace_readwrite_finish
+
+g_file_replace_readwrite_finish, function in GFile +
-
g_file_start_mountable
+
+g_file_start_mountable, function in GFile +
-
g_file_start_mountable_finish
+
+g_file_start_mountable_finish, function in GFile +
-
g_file_stop_mountable
+
+g_file_stop_mountable, function in GFile +
-
g_file_stop_mountable_finish
+
+g_file_stop_mountable_finish, function in GFile +
-
g_file_supports_thread_contexts
+
+g_file_supports_thread_contexts, function in GFile +
-
g_file_unmount_mountable_with_operation
+
+g_file_unmount_mountable_with_operation, function in GFile +
-
g_file_unmount_mountable_with_operation_finish
+
+g_file_unmount_mountable_with_operation_finish, function in GFile +

I

-
GInetAddress:is-any
+
+GInetAddress:is-any, object property in GInetAddress +
-
GInetAddress:is-link-local
+
+GInetAddress:is-link-local, object property in GInetAddress +
-
GInetAddress:is-loopback
+
+GInetAddress:is-loopback, object property in GInetAddress +
-
GInetAddress:is-mc-global
+
+GInetAddress:is-mc-global, object property in GInetAddress +
-
GInetAddress:is-mc-link-local
+
+GInetAddress:is-mc-link-local, object property in GInetAddress +
-
GInetAddress:is-mc-node-local
+
+GInetAddress:is-mc-node-local, object property in GInetAddress +
-
GInetAddress:is-mc-org-local
+
+GInetAddress:is-mc-org-local, object property in GInetAddress +
-
GInetAddress:is-mc-site-local
+
+GInetAddress:is-mc-site-local, object property in GInetAddress +
-
GInetAddress:is-multicast
+
+GInetAddress:is-multicast, object property in GInetAddress +
-
GInetAddress:is-site-local
+
+GInetAddress:is-site-local, object property in GInetAddress +
-
g_inet_address_get_family
+
+g_inet_address_get_family, function in GInetAddress +
-
g_inet_address_get_is_any
+
+g_inet_address_get_is_any, function in GInetAddress +
-
g_inet_address_get_is_link_local
+
+g_inet_address_get_is_link_local, function in GInetAddress +
-
g_inet_address_get_is_loopback
+
+g_inet_address_get_is_loopback, function in GInetAddress +
-
g_inet_address_get_is_mc_global
+
+g_inet_address_get_is_mc_global, function in GInetAddress +
-
g_inet_address_get_is_mc_link_local
+
+g_inet_address_get_is_mc_link_local, function in GInetAddress +
-
g_inet_address_get_is_mc_node_local
+
+g_inet_address_get_is_mc_node_local, function in GInetAddress +
-
g_inet_address_get_is_mc_org_local
+
+g_inet_address_get_is_mc_org_local, function in GInetAddress +
-
g_inet_address_get_is_mc_site_local
+
+g_inet_address_get_is_mc_site_local, function in GInetAddress +
-
g_inet_address_get_is_multicast
+
+g_inet_address_get_is_multicast, function in GInetAddress +
-
g_inet_address_get_is_site_local
+
+g_inet_address_get_is_site_local, function in GInetAddress +
-
g_inet_address_get_native_size
+
+g_inet_address_get_native_size, function in GInetAddress +
-
g_inet_address_new_any
+
+g_inet_address_new_any, function in GInetAddress +
-
g_inet_address_new_from_bytes
+
+g_inet_address_new_from_bytes, function in GInetAddress +
-
g_inet_address_new_from_string
+
+g_inet_address_new_from_string, function in GInetAddress +
-
g_inet_address_new_loopback
+
+g_inet_address_new_loopback, function in GInetAddress +
-
g_inet_address_to_bytes
+
+g_inet_address_to_bytes, function in GInetAddress +
-
g_inet_address_to_string
+
+g_inet_address_to_string, function in GInetAddress +
-
g_inet_socket_address_get_address
+
+g_inet_socket_address_get_address, function in GInetSocketAddress +
-
g_inet_socket_address_get_port
+
+g_inet_socket_address_get_port, function in GInetSocketAddress +
-
g_inet_socket_address_new
+
+g_inet_socket_address_new, function in GInetSocketAddress +
-
GInitable
+
+GInitable, struct in GInitable +
-
GInitableIface
+
+GInitableIface, struct in GInitable +
-
g_initable_init
+
+g_initable_init, function in GInitable +
-
g_initable_new
+
+g_initable_new, function in GInitable +
-
g_initable_newv
+
+g_initable_newv, function in GInitable +
-
g_initable_new_valist
+
+g_initable_new_valist, function in GInitable +
-
GInputVector
+
+GInputVector, struct in GSocket +
-
g_io_stream_clear_pending
+
+g_io_stream_clear_pending, function in GIOStream +
-
g_io_stream_close
+
+g_io_stream_close, function in GIOStream +
-
g_io_stream_close_async
+
+g_io_stream_close_async, function in GIOStream +
-
g_io_stream_close_finish
+
+g_io_stream_close_finish, function in GIOStream +
-
g_io_stream_get_input_stream
+
+g_io_stream_get_input_stream, function in GIOStream +
-
g_io_stream_get_output_stream
+
+g_io_stream_get_output_stream, function in GIOStream +
-
g_io_stream_has_pending
+
+g_io_stream_has_pending, function in GIOStream +
-
g_io_stream_is_closed
+
+g_io_stream_is_closed, function in GIOStream +
-
g_io_stream_set_pending
+
+g_io_stream_set_pending, function in GIOStream +

M

-
GMount::pre-unmount
+
+GMount::pre-unmount, object signal in GMount +
-
GMountOperation::show-processes
+
+GMountOperation::show-processes, object signal in GMountOperation +
-
g_mount_eject_with_operation
+
+g_mount_eject_with_operation, function in GMount +
-
g_mount_eject_with_operation_finish
+
+g_mount_eject_with_operation_finish, function in GMount +
-
g_mount_unmount_with_operation
+
+g_mount_unmount_with_operation, function in GMount +
-
g_mount_unmount_with_operation_finish
+
+g_mount_unmount_with_operation_finish, function in GMount +

N

-
g_network_address_get_hostname
+
+g_network_address_get_hostname, function in GNetworkAddress +
-
g_network_address_get_port
+
+g_network_address_get_port, function in GNetworkAddress +
-
g_network_address_new
+
+g_network_address_new, function in GNetworkAddress +
-
g_network_address_parse
+
+g_network_address_parse, function in GNetworkAddress +
-
g_network_service_get_domain
+
+g_network_service_get_domain, function in GNetworkService +
-
g_network_service_get_protocol
+
+g_network_service_get_protocol, function in GNetworkService +
-
g_network_service_get_service
+
+g_network_service_get_service, function in GNetworkService +
-
g_network_service_new
+
+g_network_service_new, function in GNetworkService +

O

-
GOutputVector
+
+GOutputVector, struct in GSocket +

R

-
GResolverError
+
+GResolverError, enum in GResolver +
-
g_resolver_free_addresses
+
+g_resolver_free_addresses, function in GResolver +
-
g_resolver_free_targets
+
+g_resolver_free_targets, function in GResolver +
-
g_resolver_get_default
+
+g_resolver_get_default, function in GResolver +
-
g_resolver_lookup_by_address
+
+g_resolver_lookup_by_address, function in GResolver +
-
g_resolver_lookup_by_address_async
+
+g_resolver_lookup_by_address_async, function in GResolver +
-
g_resolver_lookup_by_address_finish
+
+g_resolver_lookup_by_address_finish, function in GResolver +
-
g_resolver_lookup_by_name
+
+g_resolver_lookup_by_name, function in GResolver +
-
g_resolver_lookup_by_name_async
+
+g_resolver_lookup_by_name_async, function in GResolver +
-
g_resolver_lookup_by_name_finish
+
+g_resolver_lookup_by_name_finish, function in GResolver +
-
g_resolver_lookup_service
+
+g_resolver_lookup_service, function in GResolver +
-
g_resolver_lookup_service_async
+
+g_resolver_lookup_service_async, function in GResolver +
-
g_resolver_lookup_service_finish
+
+g_resolver_lookup_service_finish, function in GResolver +
-
g_resolver_set_default
+
+g_resolver_set_default, function in GResolver +

S

-
GSocket
+
+GSocket, struct in GSocket +
-
GSocketClient
+
+GSocketClient, struct in GSocketClient +
-
GSocketConnection
+
+GSocketConnection, struct in GSocketConnection +
-
GSocketFamily
+
+GSocketFamily, enum in GSocketAddress +
-
GSocketMsgFlags
+
+GSocketMsgFlags, enum in GSocket +
-
GSocketProtocol
+
+GSocketProtocol, enum in GSocket +
-
GSocketService
+
+GSocketService, struct in GSocketService +
-
GSocketService::incoming
+
+GSocketService::incoming, object signal in GSocketService +
-
GSocketSourceFunc
+
+GSocketSourceFunc, user_function in GSocket +
-
GSocketType
+
+GSocketType, enum in GSocket +
-
g_socket_accept
+
+g_socket_accept, function in GSocket +
-
g_socket_address_get_family
+
+g_socket_address_get_family, function in GSocketAddress +
-
g_socket_address_get_native_size
+
+g_socket_address_get_native_size, function in GSocketAddress +
-
g_socket_address_new_from_native
+
+g_socket_address_new_from_native, function in GSocketAddress +
-
g_socket_address_to_native
+
+g_socket_address_to_native, function in GSocketAddress +
-
g_socket_bind
+
+g_socket_bind, function in GSocket +
-
g_socket_check_connect_result
+
+g_socket_check_connect_result, function in GSocket +
-
g_socket_client_connect
+
+g_socket_client_connect, function in GSocketClient +
-
g_socket_client_connect_async
+
+g_socket_client_connect_async, function in GSocketClient +
-
g_socket_client_connect_finish
+
+g_socket_client_connect_finish, function in GSocketClient +
-
g_socket_client_connect_to_host
+
+g_socket_client_connect_to_host, function in GSocketClient +
-
g_socket_client_connect_to_host_async
+
+g_socket_client_connect_to_host_async, function in GSocketClient +
-
g_socket_client_connect_to_host_finish
+
+g_socket_client_connect_to_host_finish, function in GSocketClient +
-
g_socket_client_connect_to_service_async
+
+g_socket_client_connect_to_service_async, function in GSocketClient +
-
g_socket_client_connect_to_service_finish
+
+g_socket_client_connect_to_service_finish, function in GSocketClient +
-
g_socket_client_get_family
+
+g_socket_client_get_family, function in GSocketClient +
-
g_socket_client_get_local_address
+
+g_socket_client_get_local_address, function in GSocketClient +
-
g_socket_client_get_protocol
+
+g_socket_client_get_protocol, function in GSocketClient +
-
g_socket_client_get_socket_type
+
+g_socket_client_get_socket_type, function in GSocketClient +
-
g_socket_client_new
+
+g_socket_client_new, function in GSocketClient +
-
g_socket_client_set_family
+
+g_socket_client_set_family, function in GSocketClient +
-
g_socket_client_set_local_address
+
+g_socket_client_set_local_address, function in GSocketClient +
-
g_socket_client_set_protocol
+
+g_socket_client_set_protocol, function in GSocketClient +
-
g_socket_client_set_socket_type
+
+g_socket_client_set_socket_type, function in GSocketClient +
-
g_socket_close
+
+g_socket_close, function in GSocket +
-
g_socket_condition_check
+
+g_socket_condition_check, function in GSocket +
-
g_socket_condition_wait
+
+g_socket_condition_wait, function in GSocket +
-
g_socket_connect
+
+g_socket_connect, function in GSocket +
-
g_socket_connectable_enumerate
+
+g_socket_connectable_enumerate, function in GSocketConnectable +
-
g_socket_connection_factory_create_connection
+
+g_socket_connection_factory_create_connection, function in GSocketConnection +
-
g_socket_connection_factory_lookup_type
+
+g_socket_connection_factory_lookup_type, function in GSocketConnection +
-
g_socket_connection_factory_register_type
+
+g_socket_connection_factory_register_type, function in GSocketConnection +
-
g_socket_connection_get_local_address
+
+g_socket_connection_get_local_address, function in GSocketConnection +
-
g_socket_connection_get_remote_address
+
+g_socket_connection_get_remote_address, function in GSocketConnection +
-
g_socket_connection_get_socket
+
+g_socket_connection_get_socket, function in GSocketConnection +
-
g_socket_control_message_deserialize
+
+g_socket_control_message_deserialize, function in GSocketControlMessage +
-
g_socket_control_message_get_level
+
+g_socket_control_message_get_level, function in GSocketControlMessage +
-
g_socket_control_message_get_msg_type
+
+g_socket_control_message_get_msg_type, function in GSocketControlMessage +
-
g_socket_control_message_get_size
+
+g_socket_control_message_get_size, function in GSocketControlMessage +
-
g_socket_control_message_serialize
+
+g_socket_control_message_serialize, function in GSocketControlMessage +
-
g_socket_create_source
+
+g_socket_create_source, function in GSocket +
-
g_socket_get_blocking
+
+g_socket_get_blocking, function in GSocket +
-
g_socket_get_family
+
+g_socket_get_family, function in GSocket +
-
g_socket_get_fd
+
+g_socket_get_fd, function in GSocket +
-
g_socket_get_keepalive
+
+g_socket_get_keepalive, function in GSocket +
-
g_socket_get_listen_backlog
+
+g_socket_get_listen_backlog, function in GSocket +
-
g_socket_get_local_address
+
+g_socket_get_local_address, function in GSocket +
-
g_socket_get_protocol
+
+g_socket_get_protocol, function in GSocket +
-
g_socket_get_remote_address
+
+g_socket_get_remote_address, function in GSocket +
-
g_socket_get_socket_type
+
+g_socket_get_socket_type, function in GSocket +
-
g_socket_is_closed
+
+g_socket_is_closed, function in GSocket +
-
g_socket_is_connected
+
+g_socket_is_connected, function in GSocket +
-
g_socket_listen
+
+g_socket_listen, function in GSocket +
-
g_socket_listener_accept
+
+g_socket_listener_accept, function in GSocketListener +
-
g_socket_listener_accept_async
+
+g_socket_listener_accept_async, function in GSocketListener +
-
g_socket_listener_accept_finish
+
+g_socket_listener_accept_finish, function in GSocketListener +
-
g_socket_listener_accept_socket
+
+g_socket_listener_accept_socket, function in GSocketListener +
-
g_socket_listener_accept_socket_async
+
+g_socket_listener_accept_socket_async, function in GSocketListener +
-
g_socket_listener_accept_socket_finish
+
+g_socket_listener_accept_socket_finish, function in GSocketListener +
-
g_socket_listener_add_address
+
+g_socket_listener_add_address, function in GSocketListener +
-
g_socket_listener_add_inet_port
+
+g_socket_listener_add_inet_port, function in GSocketListener +
-
g_socket_listener_add_socket
+
+g_socket_listener_add_socket, function in GSocketListener +
-
g_socket_listener_close
+
+g_socket_listener_close, function in GSocketListener +
-
g_socket_listener_new
+
+g_socket_listener_new, function in GSocketListener +
-
g_socket_listener_set_backlog
+
+g_socket_listener_set_backlog, function in GSocketListener +
-
g_socket_new
+
+g_socket_new, function in GSocket +
-
g_socket_new_from_fd
+
+g_socket_new_from_fd, function in GSocket +
-
g_socket_receive
+
+g_socket_receive, function in GSocket +
-
g_socket_receive_from
+
+g_socket_receive_from, function in GSocket +
-
g_socket_receive_message
+
+g_socket_receive_message, function in GSocket +
-
g_socket_send
+
+g_socket_send, function in GSocket +
-
g_socket_send_message
+
+g_socket_send_message, function in GSocket +
-
g_socket_send_to
+
+g_socket_send_to, function in GSocket +
-
g_socket_service_is_active
+
+g_socket_service_is_active, function in GSocketService +
-
g_socket_service_new
+
+g_socket_service_new, function in GSocketService +
-
g_socket_service_start
+
+g_socket_service_start, function in GSocketService +
-
g_socket_service_stop
+
+g_socket_service_stop, function in GSocketService +
-
g_socket_set_blocking
+
+g_socket_set_blocking, function in GSocket +
-
g_socket_set_keepalive
+
+g_socket_set_keepalive, function in GSocket +
-
g_socket_set_listen_backlog
+
+g_socket_set_listen_backlog, function in GSocket +
-
g_socket_shutdown
+
+g_socket_shutdown, function in GSocket +
-
g_socket_speaks_ipv4
+
+g_socket_speaks_ipv4, function in GSocket +
-
g_srv_target_copy
+
+g_srv_target_copy, function in GSrvTarget +
-
g_srv_target_free
+
+g_srv_target_free, function in GSrvTarget +
-
g_srv_target_get_hostname
+
+g_srv_target_get_hostname, function in GSrvTarget +
-
g_srv_target_get_port
+
+g_srv_target_get_port, function in GSrvTarget +
-
g_srv_target_get_priority
+
+g_srv_target_get_priority, function in GSrvTarget +
-
g_srv_target_get_weight
+
+g_srv_target_get_weight, function in GSrvTarget +
-
g_srv_target_list_sort
+
+g_srv_target_list_sort, function in GSrvTarget +
-
g_srv_target_new
+
+g_srv_target_new, function in GSrvTarget +

T

-
GTcpConnection
+
+GTcpConnection, struct in GSocketConnection +
-
g_tcp_connection_get_graceful_disconnect
+
+g_tcp_connection_get_graceful_disconnect, function in GSocketConnection +
-
g_tcp_connection_set_graceful_disconnect
+
+g_tcp_connection_set_graceful_disconnect, function in GSocketConnection +
-
GThreadedSocketService
+
+GThreadedSocketService, struct in GThreadedSocketService +
-
g_threaded_socket_service_new
+
+g_threaded_socket_service_new, function in GThreadedSocketService +

U

-
g_unix_connection_receive_fd
+
+g_unix_connection_receive_fd, function in GSocketConnection +
-
g_unix_connection_send_fd
+
+g_unix_connection_send_fd, function in GSocketConnection +
-
g_unix_fd_message_append_fd
+
+g_unix_fd_message_append_fd, function in GUnixFDMessage +
-
g_unix_fd_message_new
+
+g_unix_fd_message_new, function in GUnixFDMessage +
-
g_unix_fd_message_steal_fds
+
+g_unix_fd_message_steal_fds, function in GUnixFDMessage +
-
g_unix_socket_address_abstract_names_supported
+
+g_unix_socket_address_abstract_names_supported, function in GUnixSocketAddress +
-
g_unix_socket_address_get_is_abstract
+
+g_unix_socket_address_get_is_abstract, function in GUnixSocketAddress +
-
g_unix_socket_address_get_path
+
+g_unix_socket_address_get_path, function in GUnixSocketAddress +
-
g_unix_socket_address_get_path_len
+
+g_unix_socket_address_get_path_len, function in GUnixSocketAddress +
-
g_unix_socket_address_new
+
+g_unix_socket_address_new, function in GUnixSocketAddress +
-
g_unix_socket_address_new_abstract
+
+g_unix_socket_address_new_abstract, function in GUnixSocketAddress +

V

-
GVolumeMonitor::drive-stop-button
+
+GVolumeMonitor::drive-stop-button, object signal in GVolumeMonitor +
-
g_volume_eject_with_operation
+
+g_volume_eject_with_operation, function in GVolume +
-
g_volume_eject_with_operation_finish
+
+g_volume_eject_with_operation_finish, function in GVolume +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-2-24.html b/docs/reference/gio/html/api-index-2-24.html index 711f01e..3ae9469 100644 --- a/docs/reference/gio/html/api-index-2-24.html +++ b/docs/reference/gio/html/api-index-2-24.html @@ -7,38 +7,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -75,90 +45,162 @@

Index of new symbols in 2.24

A

-
g_app_info_get_display_name
+
+g_app_info_get_display_name, function in GAppInfo +

C

-
g_charset_converter_get_num_fallbacks
+
+g_charset_converter_get_num_fallbacks, function in GCharsetConverter +
-
g_charset_converter_get_use_fallback
+
+g_charset_converter_get_use_fallback, function in GCharsetConverter +
-
g_charset_converter_new
+
+g_charset_converter_new, function in GCharsetConverter +
-
g_charset_converter_set_use_fallback
+
+g_charset_converter_set_use_fallback, function in GCharsetConverter +
-
GConverter
+
+GConverter, struct in GConverter +
-
GConverterIface
+
+GConverterIface, struct in GConverter +
-
GConverterResult
+
+GConverterResult, enum in GConverter +
-
g_converter_convert
+
+g_converter_convert, function in GConverter +
-
g_converter_input_stream_get_converter
+
+g_converter_input_stream_get_converter, function in GConverterInputstream +
-
g_converter_output_stream_get_converter
+
+g_converter_output_stream_get_converter, function in GConverterOutputstream +
-
g_converter_reset
+
+g_converter_reset, function in GConverter +

D

-
g_desktop_app_info_get_filename
+
+g_desktop_app_info_get_filename, function in Desktop file based GAppInfo +

F

-
g_file_descriptor_based_get_fd
+
+g_file_descriptor_based_get_fd, function in GFileDescriptorBased +
-
g_file_has_parent
+
+g_file_has_parent, function in GFile +

I

-
g_io_modules_scan_all_in_directory
+
+g_io_modules_scan_all_in_directory, function in GIOModule +
-
g_io_module_query
+
+g_io_module_query, function in GIOModule +

M

-
GMemoryOutputStream:data
+
+GMemoryOutputStream:data, object property in GMemoryOutputStream +
-
GMemoryOutputStream:data-size
+
+GMemoryOutputStream:data-size, object property in GMemoryOutputStream +
-
GMemoryOutputStream:destroy-function
+
+GMemoryOutputStream:destroy-function, object property in GMemoryOutputStream +
-
GMemoryOutputStream:realloc-function
+
+GMemoryOutputStream:realloc-function, object property in GMemoryOutputStream +
-
GMemoryOutputStream:size
+
+GMemoryOutputStream:size, object property in GMemoryOutputStream +

O

-
g_output_stream_is_closing
+
+g_output_stream_is_closing, function in GOutputStream +

S

-
g_socket_listener_add_any_inet_port
+
+g_socket_listener_add_any_inet_port, function in GSocketListener +

U

-
g_unix_fd_list_append
+
+g_unix_fd_list_append, function in GUnixFDList +
-
g_unix_fd_list_get
+
+g_unix_fd_list_get, function in GUnixFDList +
-
g_unix_fd_list_get_length
+
+g_unix_fd_list_get_length, function in GUnixFDList +
-
g_unix_fd_list_new
+
+g_unix_fd_list_new, function in GUnixFDList +
-
g_unix_fd_list_new_from_array
+
+g_unix_fd_list_new_from_array, function in GUnixFDList +
-
g_unix_fd_list_peek_fds
+
+g_unix_fd_list_peek_fds, function in GUnixFDList +
-
g_unix_fd_list_steal_fds
+
+g_unix_fd_list_steal_fds, function in GUnixFDList +
-
g_unix_fd_message_get_fd_list
+
+g_unix_fd_message_get_fd_list, function in GUnixFDMessage +
-
g_unix_fd_message_new_with_fd_list
+
+g_unix_fd_message_new_with_fd_list, function in GUnixFDMessage +

Z

-
GZlibCompressorFormat
+
+GZlibCompressorFormat, enum in GZlibCompressor +
-
g_zlib_compressor_new
+
+g_zlib_compressor_new, function in GZlibCompressor +
-
g_zlib_decompressor_new
+
+g_zlib_decompressor_new, function in GZlibDecompressor +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-deprecated.html b/docs/reference/gio/html/api-index-deprecated.html index 15aa7ae..8e23904 100644 --- a/docs/reference/gio/html/api-index-deprecated.html +++ b/docs/reference/gio/html/api-index-deprecated.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -64,38 +34,64 @@

Index of deprecated symbols

D

-
g_drive_eject
+
+g_drive_eject, function in GDrive +
-
g_drive_eject_finish
+
+g_drive_eject_finish, function in GDrive +

F

-
g_file_eject_mountable
+
+g_file_eject_mountable, function in GFile +
-
g_file_eject_mountable_finish
+
+g_file_eject_mountable_finish, function in GFile +
-
g_file_unmount_mountable
+
+g_file_unmount_mountable, function in GFile +
-
g_file_unmount_mountable_finish
+
+g_file_unmount_mountable_finish, function in GFile +

M

-
g_mount_eject
+
+g_mount_eject, function in GMount +
-
g_mount_eject_finish
+
+g_mount_eject_finish, function in GMount +
-
g_mount_unmount
+
+g_mount_unmount, function in GMount +
-
g_mount_unmount_finish
+
+g_mount_unmount_finish, function in GMount +

V

-
g_volume_eject
+
+g_volume_eject, function in GVolume +
-
g_volume_eject_finish
+
+g_volume_eject_finish, function in GVolume +
-
g_volume_monitor_adopt_orphan_mount
+
+g_volume_monitor_adopt_orphan_mount, function in GVolumeMonitor +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/api-index-full.html b/docs/reference/gio/html/api-index-full.html index b26e885..9a6d980 100644 --- a/docs/reference/gio/html/api-index-full.html +++ b/docs/reference/gio/html/api-index-full.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -92,2232 +62,4438 @@

Index

A

-
GAppInfo
+
+GAppInfo, struct in GAppInfo +
-
GAppInfoCreateFlags
+
+GAppInfoCreateFlags, enum in GAppInfo +
-
GAppInfoIface
+
+GAppInfoIface, struct in GAppInfo +
-
GAppLaunchContext
+
+GAppLaunchContext, struct in GAppInfo +
-
g_app_info_add_supports_type
+
+g_app_info_add_supports_type, function in GAppInfo +
-
g_app_info_can_delete
+
+g_app_info_can_delete, function in GAppInfo +
-
g_app_info_can_remove_supports_type
+
+g_app_info_can_remove_supports_type, function in GAppInfo +
-
g_app_info_create_from_commandline
+
+g_app_info_create_from_commandline, function in GAppInfo +
-
g_app_info_delete
+
+g_app_info_delete, function in GAppInfo +
-
g_app_info_dup
+
+g_app_info_dup, function in GAppInfo +
-
g_app_info_equal
+
+g_app_info_equal, function in GAppInfo +
-
g_app_info_get_all
+
+g_app_info_get_all, function in GAppInfo +
-
g_app_info_get_all_for_type
+
+g_app_info_get_all_for_type, function in GAppInfo +
-
g_app_info_get_commandline
+
+g_app_info_get_commandline, function in GAppInfo +
-
g_app_info_get_default_for_type
+
+g_app_info_get_default_for_type, function in GAppInfo +
-
g_app_info_get_default_for_uri_scheme
+
+g_app_info_get_default_for_uri_scheme, function in GAppInfo +
-
g_app_info_get_description
+
+g_app_info_get_description, function in GAppInfo +
-
g_app_info_get_display_name
+
+g_app_info_get_display_name, function in GAppInfo +
-
g_app_info_get_executable
+
+g_app_info_get_executable, function in GAppInfo +
-
g_app_info_get_icon
+
+g_app_info_get_icon, function in GAppInfo +
-
g_app_info_get_id
+
+g_app_info_get_id, function in GAppInfo +
-
g_app_info_get_name
+
+g_app_info_get_name, function in GAppInfo +
-
g_app_info_launch
+
+g_app_info_launch, function in GAppInfo +
-
g_app_info_launch_default_for_uri
+
+g_app_info_launch_default_for_uri, function in GAppInfo +
-
g_app_info_launch_uris
+
+g_app_info_launch_uris, function in GAppInfo +
-
g_app_info_remove_supports_type
+
+g_app_info_remove_supports_type, function in GAppInfo +
-
g_app_info_reset_type_associations
+
+g_app_info_reset_type_associations, function in GAppInfo +
-
g_app_info_set_as_default_for_extension
+
+g_app_info_set_as_default_for_extension, function in GAppInfo +
-
g_app_info_set_as_default_for_type
+
+g_app_info_set_as_default_for_type, function in GAppInfo +
-
g_app_info_should_show
+
+g_app_info_should_show, function in GAppInfo +
-
g_app_info_supports_files
+
+g_app_info_supports_files, function in GAppInfo +
-
g_app_info_supports_uris
+
+g_app_info_supports_uris, function in GAppInfo +
-
g_app_launch_context_get_display
+
+g_app_launch_context_get_display, function in GAppInfo +
-
g_app_launch_context_get_startup_notify_id
+
+g_app_launch_context_get_startup_notify_id, function in GAppInfo +
-
g_app_launch_context_launch_failed
+
+g_app_launch_context_launch_failed, function in GAppInfo +
-
g_app_launch_context_new
+
+g_app_launch_context_new, function in GAppInfo +
-
GAskPasswordFlags
+
+GAskPasswordFlags, enum in GMountOperation +
-
GAsyncInitable
+
+GAsyncInitable, struct in GAsyncInitable +
-
GAsyncInitableIface
+
+GAsyncInitableIface, struct in GAsyncInitable +
-
GAsyncReadyCallback
+
+GAsyncReadyCallback, user_function in GAsyncResult +
-
GAsyncResult
+
+GAsyncResult, struct in GAsyncResult +
-
GAsyncResultIface
+
+GAsyncResultIface, struct in GAsyncResult +
-
g_async_initable_init_async
+
+g_async_initable_init_async, function in GAsyncInitable +
-
g_async_initable_init_finish
+
+g_async_initable_init_finish, function in GAsyncInitable +
-
g_async_initable_newv_async
+
+g_async_initable_newv_async, function in GAsyncInitable +
-
g_async_initable_new_async
+
+g_async_initable_new_async, function in GAsyncInitable +
-
g_async_initable_new_finish
+
+g_async_initable_new_finish, function in GAsyncInitable +
-
g_async_initable_new_valist_async
+
+g_async_initable_new_valist_async, function in GAsyncInitable +
-
g_async_result_get_source_object
+
+g_async_result_get_source_object, function in GAsyncResult +
-
g_async_result_get_user_data
+
+g_async_result_get_user_data, function in GAsyncResult +

B

-
GBufferedInputStream
+
+GBufferedInputStream, struct in GBufferedInputStream +
-
GBufferedInputStream:buffer-size
+
+GBufferedInputStream:buffer-size, object property in GBufferedInputStream +
-
GBufferedOutputStream
+
+GBufferedOutputStream, struct in GBufferedOutputStream +
-
GBufferedOutputStream:auto-grow
+
+GBufferedOutputStream:auto-grow, object property in GBufferedOutputStream +
-
GBufferedOutputStream:buffer-size
+
+GBufferedOutputStream:buffer-size, object property in GBufferedOutputStream +
-
g_buffered_input_stream_fill
+
+g_buffered_input_stream_fill, function in GBufferedInputStream +
-
g_buffered_input_stream_fill_async
+
+g_buffered_input_stream_fill_async, function in GBufferedInputStream +
-
g_buffered_input_stream_fill_finish
+
+g_buffered_input_stream_fill_finish, function in GBufferedInputStream +
-
g_buffered_input_stream_get_available
+
+g_buffered_input_stream_get_available, function in GBufferedInputStream +
-
g_buffered_input_stream_get_buffer_size
+
+g_buffered_input_stream_get_buffer_size, function in GBufferedInputStream +
-
g_buffered_input_stream_new
+
+g_buffered_input_stream_new, function in GBufferedInputStream +
-
g_buffered_input_stream_new_sized
+
+g_buffered_input_stream_new_sized, function in GBufferedInputStream +
-
g_buffered_input_stream_peek
+
+g_buffered_input_stream_peek, function in GBufferedInputStream +
-
g_buffered_input_stream_peek_buffer
+
+g_buffered_input_stream_peek_buffer, function in GBufferedInputStream +
-
g_buffered_input_stream_read_byte
+
+g_buffered_input_stream_read_byte, function in GBufferedInputStream +
-
g_buffered_input_stream_set_buffer_size
+
+g_buffered_input_stream_set_buffer_size, function in GBufferedInputStream +
-
g_buffered_output_stream_get_auto_grow
+
+g_buffered_output_stream_get_auto_grow, function in GBufferedOutputStream +
-
g_buffered_output_stream_get_buffer_size
+
+g_buffered_output_stream_get_buffer_size, function in GBufferedOutputStream +
-
g_buffered_output_stream_new
+
+g_buffered_output_stream_new, function in GBufferedOutputStream +
-
g_buffered_output_stream_new_sized
+
+g_buffered_output_stream_new_sized, function in GBufferedOutputStream +
-
g_buffered_output_stream_set_auto_grow
+
+g_buffered_output_stream_set_auto_grow, function in GBufferedOutputStream +
-
g_buffered_output_stream_set_buffer_size
+
+g_buffered_output_stream_set_buffer_size, function in GBufferedOutputStream +

C

-
GCancellable
+
+GCancellable, struct in GCancellable +
-
GCancellable::cancelled
+
+GCancellable::cancelled, object signal in GCancellable +
-
g_cancellable_cancel
+
+g_cancellable_cancel, function in GCancellable +
-
g_cancellable_connect
+
+g_cancellable_connect, function in GCancellable +
-
g_cancellable_disconnect
+
+g_cancellable_disconnect, function in GCancellable +
-
g_cancellable_get_current
+
+g_cancellable_get_current, function in GCancellable +
-
g_cancellable_get_fd
+
+g_cancellable_get_fd, function in GCancellable +
-
g_cancellable_is_cancelled
+
+g_cancellable_is_cancelled, function in GCancellable +
-
g_cancellable_make_pollfd
+
+g_cancellable_make_pollfd, function in GCancellable +
-
g_cancellable_new
+
+g_cancellable_new, function in GCancellable +
-
g_cancellable_pop_current
+
+g_cancellable_pop_current, function in GCancellable +
-
g_cancellable_push_current
+
+g_cancellable_push_current, function in GCancellable +
-
g_cancellable_release_fd
+
+g_cancellable_release_fd, function in GCancellable +
-
g_cancellable_reset
+
+g_cancellable_reset, function in GCancellable +
-
g_cancellable_set_error_if_cancelled
+
+g_cancellable_set_error_if_cancelled, function in GCancellable +
-
GCharsetConverter
+
+GCharsetConverter, struct in GCharsetConverter +
-
GCharsetConverter:from-charset
+
+GCharsetConverter:from-charset, object property in GCharsetConverter +
-
GCharsetConverter:to-charset
+
+GCharsetConverter:to-charset, object property in GCharsetConverter +
-
GCharsetConverter:use-fallback
+
+GCharsetConverter:use-fallback, object property in GCharsetConverter +
-
g_charset_converter_get_num_fallbacks
+
+g_charset_converter_get_num_fallbacks, function in GCharsetConverter +
-
g_charset_converter_get_use_fallback
+
+g_charset_converter_get_use_fallback, function in GCharsetConverter +
-
g_charset_converter_new
+
+g_charset_converter_new, function in GCharsetConverter +
-
g_charset_converter_set_use_fallback
+
+g_charset_converter_set_use_fallback, function in GCharsetConverter +
-
g_content_types_get_registered
+
+g_content_types_get_registered, function in GContentType +
-
g_content_type_can_be_executable
+
+g_content_type_can_be_executable, function in GContentType +
-
g_content_type_equals
+
+g_content_type_equals, function in GContentType +
-
g_content_type_from_mime_type
+
+g_content_type_from_mime_type, function in GContentType +
-
g_content_type_get_description
+
+g_content_type_get_description, function in GContentType +
-
g_content_type_get_icon
+
+g_content_type_get_icon, function in GContentType +
-
g_content_type_get_mime_type
+
+g_content_type_get_mime_type, function in GContentType +
-
g_content_type_guess
+
+g_content_type_guess, function in GContentType +
-
g_content_type_guess_for_tree
+
+g_content_type_guess_for_tree, function in GContentType +
-
g_content_type_is_a
+
+g_content_type_is_a, function in GContentType +
-
g_content_type_is_unknown
+
+g_content_type_is_unknown, function in GContentType +
-
GConverter
+
+GConverter, struct in GConverter +
-
GConverterIface
+
+GConverterIface, struct in GConverter +
-
GConverterInputStream
+
+GConverterInputStream, struct in GConverterInputstream +
-
GConverterInputStream:converter
+
+GConverterInputStream:converter, object property in GConverterInputstream +
-
GConverterOutputStream
+
+GConverterOutputStream, struct in GConverterOutputstream +
-
GConverterOutputStream:converter
+
+GConverterOutputStream:converter, object property in GConverterOutputstream +
-
GConverterResult
+
+GConverterResult, enum in GConverter +
-
g_converter_convert
+
+g_converter_convert, function in GConverter +
-
g_converter_input_stream_get_converter
+
+g_converter_input_stream_get_converter, function in GConverterInputstream +
-
g_converter_input_stream_new
+
+g_converter_input_stream_new, function in GConverterInputstream +
-
g_converter_output_stream_get_converter
+
+g_converter_output_stream_get_converter, function in GConverterOutputstream +
-
g_converter_output_stream_new
+
+g_converter_output_stream_new, function in GConverterOutputstream +
-
g_converter_reset
+
+g_converter_reset, function in GConverter +

D

-
GDataInputStream
+
+GDataInputStream, struct in GDataInputStream +
-
GDataInputStream:byte-order
+
+GDataInputStream:byte-order, object property in GDataInputStream +
-
GDataInputStream:newline-type
+
+GDataInputStream:newline-type, object property in GDataInputStream +
-
GDataOutputStream
+
+GDataOutputStream, struct in GDataOutputStream +
-
GDataOutputStream:byte-order
+
+GDataOutputStream:byte-order, object property in GDataOutputStream +
-
GDataStreamByteOrder
+
+GDataStreamByteOrder, enum in GDataInputStream +
-
GDataStreamNewlineType
+
+GDataStreamNewlineType, enum in GDataInputStream +
-
g_data_input_stream_get_byte_order
+
+g_data_input_stream_get_byte_order, function in GDataInputStream +
-
g_data_input_stream_get_newline_type
+
+g_data_input_stream_get_newline_type, function in GDataInputStream +
-
g_data_input_stream_new
+
+g_data_input_stream_new, function in GDataInputStream +
-
g_data_input_stream_read_byte
+
+g_data_input_stream_read_byte, function in GDataInputStream +
-
g_data_input_stream_read_int16
+
+g_data_input_stream_read_int16, function in GDataInputStream +
-
g_data_input_stream_read_int32
+
+g_data_input_stream_read_int32, function in GDataInputStream +
-
g_data_input_stream_read_int64
+
+g_data_input_stream_read_int64, function in GDataInputStream +
-
g_data_input_stream_read_line
+
+g_data_input_stream_read_line, function in GDataInputStream +
-
g_data_input_stream_read_line_async
+
+g_data_input_stream_read_line_async, function in GDataInputStream +
-
g_data_input_stream_read_line_finish
+
+g_data_input_stream_read_line_finish, function in GDataInputStream +
-
g_data_input_stream_read_uint16
+
+g_data_input_stream_read_uint16, function in GDataInputStream +
-
g_data_input_stream_read_uint32
+
+g_data_input_stream_read_uint32, function in GDataInputStream +
-
g_data_input_stream_read_uint64
+
+g_data_input_stream_read_uint64, function in GDataInputStream +
-
g_data_input_stream_read_until
+
+g_data_input_stream_read_until, function in GDataInputStream +
-
g_data_input_stream_read_until_async
+
+g_data_input_stream_read_until_async, function in GDataInputStream +
-
g_data_input_stream_read_until_finish
+
+g_data_input_stream_read_until_finish, function in GDataInputStream +
-
g_data_input_stream_set_byte_order
+
+g_data_input_stream_set_byte_order, function in GDataInputStream +
-
g_data_input_stream_set_newline_type
+
+g_data_input_stream_set_newline_type, function in GDataInputStream +
-
g_data_output_stream_get_byte_order
+
+g_data_output_stream_get_byte_order, function in GDataOutputStream +
-
g_data_output_stream_new
+
+g_data_output_stream_new, function in GDataOutputStream +
-
g_data_output_stream_put_byte
+
+g_data_output_stream_put_byte, function in GDataOutputStream +
-
g_data_output_stream_put_int16
+
+g_data_output_stream_put_int16, function in GDataOutputStream +
-
g_data_output_stream_put_int32
+
+g_data_output_stream_put_int32, function in GDataOutputStream +
-
g_data_output_stream_put_int64
+
+g_data_output_stream_put_int64, function in GDataOutputStream +
-
g_data_output_stream_put_string
+
+g_data_output_stream_put_string, function in GDataOutputStream +
-
g_data_output_stream_put_uint16
+
+g_data_output_stream_put_uint16, function in GDataOutputStream +
-
g_data_output_stream_put_uint32
+
+g_data_output_stream_put_uint32, function in GDataOutputStream +
-
g_data_output_stream_put_uint64
+
+g_data_output_stream_put_uint64, function in GDataOutputStream +
-
g_data_output_stream_set_byte_order
+
+g_data_output_stream_set_byte_order, function in GDataOutputStream +
-
GDesktopAppInfo
+
+GDesktopAppInfo, struct in Desktop file based GAppInfo +
-
GDesktopAppInfoLookup
+
+GDesktopAppInfoLookup, struct in Desktop file based GAppInfo +
-
g_desktop_app_info_get_filename
+
+g_desktop_app_info_get_filename, function in Desktop file based GAppInfo +
-
g_desktop_app_info_get_is_hidden
+
+g_desktop_app_info_get_is_hidden, function in Desktop file based GAppInfo +
-
G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME
+
+G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME, macro in Desktop file based GAppInfo +
-
g_desktop_app_info_lookup_get_default_for_uri_scheme
+
+g_desktop_app_info_lookup_get_default_for_uri_scheme, function in Desktop file based GAppInfo +
-
g_desktop_app_info_new
+
+g_desktop_app_info_new, function in Desktop file based GAppInfo +
-
g_desktop_app_info_new_from_filename
+
+g_desktop_app_info_new_from_filename, function in Desktop file based GAppInfo +
-
g_desktop_app_info_new_from_keyfile
+
+g_desktop_app_info_new_from_keyfile, function in Desktop file based GAppInfo +
-
g_desktop_app_info_set_desktop_env
+
+g_desktop_app_info_set_desktop_env, function in Desktop file based GAppInfo +
-
GDrive
+
+GDrive, struct in GDrive +
-
GDrive::changed
+
+GDrive::changed, object signal in GDrive +
-
GDrive::disconnected
+
+GDrive::disconnected, object signal in GDrive +
-
GDrive::eject-button
+
+GDrive::eject-button, object signal in GDrive +
-
GDrive::stop-button
+
+GDrive::stop-button, object signal in GDrive +
-
GDriveIface
+
+GDriveIface, struct in GDrive +
-
GDriveStartFlags
+
+GDriveStartFlags, enum in GDrive +
-
GDriveStartStopType
+
+GDriveStartStopType, enum in GDrive +
-
g_drive_can_eject
+
+g_drive_can_eject, function in GDrive +
-
g_drive_can_poll_for_media
+
+g_drive_can_poll_for_media, function in GDrive +
-
g_drive_can_start
+
+g_drive_can_start, function in GDrive +
-
g_drive_can_start_degraded
+
+g_drive_can_start_degraded, function in GDrive +
-
g_drive_can_stop
+
+g_drive_can_stop, function in GDrive +
-
g_drive_eject
+
+g_drive_eject, function in GDrive +
-
g_drive_eject_finish
+
+g_drive_eject_finish, function in GDrive +
-
g_drive_eject_with_operation
+
+g_drive_eject_with_operation, function in GDrive +
-
g_drive_eject_with_operation_finish
+
+g_drive_eject_with_operation_finish, function in GDrive +
-
g_drive_enumerate_identifiers
+
+g_drive_enumerate_identifiers, function in GDrive +
-
g_drive_get_icon
+
+g_drive_get_icon, function in GDrive +
-
g_drive_get_identifier
+
+g_drive_get_identifier, function in GDrive +
-
g_drive_get_name
+
+g_drive_get_name, function in GDrive +
-
g_drive_get_start_stop_type
+
+g_drive_get_start_stop_type, function in GDrive +
-
g_drive_get_volumes
+
+g_drive_get_volumes, function in GDrive +
-
g_drive_has_media
+
+g_drive_has_media, function in GDrive +
-
g_drive_has_volumes
+
+g_drive_has_volumes, function in GDrive +
-
g_drive_is_media_check_automatic
+
+g_drive_is_media_check_automatic, function in GDrive +
-
g_drive_is_media_removable
+
+g_drive_is_media_removable, function in GDrive +
-
g_drive_poll_for_media
+
+g_drive_poll_for_media, function in GDrive +
-
g_drive_poll_for_media_finish
+
+g_drive_poll_for_media_finish, function in GDrive +
-
g_drive_start
+
+g_drive_start, function in GDrive +
-
g_drive_start_finish
+
+g_drive_start_finish, function in GDrive +
-
g_drive_stop
+
+g_drive_stop, function in GDrive +
-
g_drive_stop_finish
+
+g_drive_stop_finish, function in GDrive +

E

-
GEmblem
+
+GEmblem, struct in GEmblem +
-
GEmblem:icon
+
+GEmblem:icon, object property in GEmblem +
-
GEmblem:origin
+
+GEmblem:origin, object property in GEmblem +
-
GEmblemedIcon
+
+GEmblemedIcon, struct in GEmblemedIcon +
-
g_emblemed_icon_add_emblem
+
+g_emblemed_icon_add_emblem, function in GEmblemedIcon +
-
g_emblemed_icon_get_emblems
+
+g_emblemed_icon_get_emblems, function in GEmblemedIcon +
-
g_emblemed_icon_get_icon
+
+g_emblemed_icon_get_icon, function in GEmblemedIcon +
-
g_emblemed_icon_new
+
+g_emblemed_icon_new, function in GEmblemedIcon +
-
GEmblemOrigin
+
+GEmblemOrigin, enum in GEmblem +
-
g_emblem_get_icon
+
+g_emblem_get_icon, function in GEmblem +
-
g_emblem_get_origin
+
+g_emblem_get_origin, function in GEmblem +
-
g_emblem_new
+
+g_emblem_new, function in GEmblem +
-
g_emblem_new_with_origin
+
+g_emblem_new_with_origin, function in GEmblem +

F

-
GFile
+
+GFile, struct in GFile +
-
GFileAttributeInfo
+
+GFileAttributeInfo, struct in GFileAttribute +
-
GFileAttributeInfoFlags
+
+GFileAttributeInfoFlags, enum in GFileAttribute +
-
GFileAttributeInfoList
+
+GFileAttributeInfoList, struct in GFileAttribute +
-
GFileAttributeMatcher
+
+GFileAttributeMatcher, struct in GFileInfo +
-
GFileAttributeStatus
+
+GFileAttributeStatus, enum in GFileAttribute +
-
GFileAttributeType
+
+GFileAttributeType, enum in GFileAttribute +
-
GFileCopyFlags
+
+GFileCopyFlags, enum in GFile +
-
GFileCreateFlags
+
+GFileCreateFlags, enum in GFile +
-
GFileDescriptorBased
+
+GFileDescriptorBased, struct in GFileDescriptorBased +
-
GFileEnumerator
+
+GFileEnumerator, struct in GFileEnumerator +
-
GFileEnumerator:container
+
+GFileEnumerator:container, object property in GFileEnumerator +
-
GFileIcon
+
+GFileIcon, struct in GFileIcon +
-
GFileIcon:file
+
+GFileIcon:file, object property in GFileIcon +
-
GFileIface
+
+GFileIface, struct in GFile +
-
GFileInfo
+
+GFileInfo, struct in GFileInfo +
-
GFileInputStream
+
+GFileInputStream, struct in GFileInputStream +
-
GFileIOStream
+
+GFileIOStream, struct in GFileIOStream +
-
GFileMonitor
+
+GFileMonitor, struct in GFileMonitor +
-
GFileMonitor::changed
+
+GFileMonitor::changed, object signal in GFileMonitor +
-
GFileMonitor:cancelled
+
+GFileMonitor:cancelled, object property in GFileMonitor +
-
GFileMonitor:rate-limit
+
+GFileMonitor:rate-limit, object property in GFileMonitor +
-
GFileMonitorEvent
+
+GFileMonitorEvent, enum in GFileMonitor +
-
GFileMonitorFlags
+
+GFileMonitorFlags, enum in GFile +
-
GFilenameCompleter
+
+GFilenameCompleter, struct in GFilenameCompleter +
-
GFilenameCompleter::got-completion-data
+
+GFilenameCompleter::got-completion-data, object signal in GFilenameCompleter +
-
g_filename_completer_get_completions
+
+g_filename_completer_get_completions, function in GFilenameCompleter +
-
g_filename_completer_get_completion_suffix
+
+g_filename_completer_get_completion_suffix, function in GFilenameCompleter +
-
g_filename_completer_new
+
+g_filename_completer_new, function in GFilenameCompleter +
-
g_filename_completer_set_dirs_only
+
+g_filename_completer_set_dirs_only, function in GFilenameCompleter +
-
GFileOutputStream
+
+GFileOutputStream, struct in GFileOutputStream +
-
GFileProgressCallback
+
+GFileProgressCallback, user_function in GFile +
-
GFileQueryInfoFlags
+
+GFileQueryInfoFlags, enum in GFile +
-
GFileReadMoreCallback
+
+GFileReadMoreCallback, user_function in GFile +
-
GFilesystemPreviewType
+
+GFilesystemPreviewType, enum in GFile +
-
GFileType
+
+GFileType, enum in GFileInfo +
-
g_file_append_to
+
+g_file_append_to, function in GFile +
-
g_file_append_to_async
+
+g_file_append_to_async, function in GFile +
-
g_file_append_to_finish
+
+g_file_append_to_finish, function in GFile +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_READ
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_READ, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE
+
+G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE
+
+G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_DOS_IS_SYSTEM
+
+G_FILE_ATTRIBUTE_DOS_IS_SYSTEM, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ETAG_VALUE
+
+G_FILE_ATTRIBUTE_ETAG_VALUE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_FILESYSTEM_FREE
+
+G_FILE_ATTRIBUTE_FILESYSTEM_FREE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_FILESYSTEM_READONLY
+
+G_FILE_ATTRIBUTE_FILESYSTEM_READONLY, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
+
+G_FILE_ATTRIBUTE_FILESYSTEM_SIZE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_FILESYSTEM_TYPE
+
+G_FILE_ATTRIBUTE_FILESYSTEM_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW
+
+G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_GVFS_BACKEND
+
+G_FILE_ATTRIBUTE_GVFS_BACKEND, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ID_FILE
+
+G_FILE_ATTRIBUTE_ID_FILE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_ID_FILESYSTEM
+
+G_FILE_ATTRIBUTE_ID_FILESYSTEM, macro in GFileInfo +
-
g_file_attribute_info_list_add
+
+g_file_attribute_info_list_add, function in GFileAttribute +
-
g_file_attribute_info_list_dup
+
+g_file_attribute_info_list_dup, function in GFileAttribute +
-
g_file_attribute_info_list_lookup
+
+g_file_attribute_info_list_lookup, function in GFileAttribute +
-
g_file_attribute_info_list_new
+
+g_file_attribute_info_list_new, function in GFileAttribute +
-
g_file_attribute_info_list_ref
+
+g_file_attribute_info_list_ref, function in GFileAttribute +
-
g_file_attribute_info_list_unref
+
+g_file_attribute_info_list_unref, function in GFileAttribute +
-
g_file_attribute_matcher_enumerate_namespace
+
+g_file_attribute_matcher_enumerate_namespace, function in GFileInfo +
-
g_file_attribute_matcher_enumerate_next
+
+g_file_attribute_matcher_enumerate_next, function in GFileInfo +
-
g_file_attribute_matcher_matches
+
+g_file_attribute_matcher_matches, function in GFileInfo +
-
g_file_attribute_matcher_matches_only
+
+g_file_attribute_matcher_matches_only, function in GFileInfo +
-
g_file_attribute_matcher_new
+
+g_file_attribute_matcher_new, function in GFileInfo +
-
g_file_attribute_matcher_ref
+
+g_file_attribute_matcher_ref, function in GFileInfo +
-
g_file_attribute_matcher_unref
+
+g_file_attribute_matcher_unref, function in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT
+
+G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI
+
+G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC
+
+G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE
+
+G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE
+
+G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE
+
+G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_OWNER_GROUP
+
+G_FILE_ATTRIBUTE_OWNER_GROUP, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_OWNER_USER
+
+G_FILE_ATTRIBUTE_OWNER_USER, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_OWNER_USER_REAL
+
+G_FILE_ATTRIBUTE_OWNER_USER_REAL, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_PREVIEW_ICON
+
+G_FILE_ATTRIBUTE_PREVIEW_ICON, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_SELINUX_CONTEXT
+
+G_FILE_ATTRIBUTE_SELINUX_CONTEXT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE
+
+G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE
+
+G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_COPY_NAME
+
+G_FILE_ATTRIBUTE_STANDARD_COPY_NAME, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION
+
+G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
+
+G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME
+
+G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE
+
+G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_ICON
+
+G_FILE_ATTRIBUTE_STANDARD_ICON, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP
+
+G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN
+
+G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK
+
+G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL
+
+G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_NAME
+
+G_FILE_ATTRIBUTE_STANDARD_NAME, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_SIZE
+
+G_FILE_ATTRIBUTE_STANDARD_SIZE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER
+
+G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET
+
+G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_TARGET_URI
+
+G_FILE_ATTRIBUTE_STANDARD_TARGET_URI, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_STANDARD_TYPE
+
+G_FILE_ATTRIBUTE_STANDARD_TYPE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_THUMBNAILING_FAILED
+
+G_FILE_ATTRIBUTE_THUMBNAILING_FAILED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_THUMBNAIL_PATH
+
+G_FILE_ATTRIBUTE_THUMBNAIL_PATH, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_ACCESS
+
+G_FILE_ATTRIBUTE_TIME_ACCESS, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_ACCESS_USEC
+
+G_FILE_ATTRIBUTE_TIME_ACCESS_USEC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_CHANGED
+
+G_FILE_ATTRIBUTE_TIME_CHANGED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_CHANGED_USEC
+
+G_FILE_ATTRIBUTE_TIME_CHANGED_USEC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_CREATED
+
+G_FILE_ATTRIBUTE_TIME_CREATED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_CREATED_USEC
+
+G_FILE_ATTRIBUTE_TIME_CREATED_USEC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_MODIFIED
+
+G_FILE_ATTRIBUTE_TIME_MODIFIED, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC
+
+G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT
+
+G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_BLOCKS
+
+G_FILE_ATTRIBUTE_UNIX_BLOCKS, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE
+
+G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_DEVICE
+
+G_FILE_ATTRIBUTE_UNIX_DEVICE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_GID
+
+G_FILE_ATTRIBUTE_UNIX_GID, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_INODE
+
+G_FILE_ATTRIBUTE_UNIX_INODE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT
+
+G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_MODE
+
+G_FILE_ATTRIBUTE_UNIX_MODE, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_NLINK
+
+G_FILE_ATTRIBUTE_UNIX_NLINK, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_RDEV
+
+G_FILE_ATTRIBUTE_UNIX_RDEV, macro in GFileInfo +
-
G_FILE_ATTRIBUTE_UNIX_UID
+
+G_FILE_ATTRIBUTE_UNIX_UID, macro in GFileInfo +
-
g_file_copy
+
+g_file_copy, function in GFile +
-
g_file_copy_async
+
+g_file_copy_async, function in GFile +
-
g_file_copy_attributes
+
+g_file_copy_attributes, function in GFile +
-
g_file_copy_finish
+
+g_file_copy_finish, function in GFile +
-
g_file_create
+
+g_file_create, function in GFile +
-
g_file_create_async
+
+g_file_create_async, function in GFile +
-
g_file_create_finish
+
+g_file_create_finish, function in GFile +
-
g_file_create_readwrite
+
+g_file_create_readwrite, function in GFile +
-
g_file_create_readwrite_async
+
+g_file_create_readwrite_async, function in GFile +
-
g_file_create_readwrite_finish
+
+g_file_create_readwrite_finish, function in GFile +
-
g_file_delete
+
+g_file_delete, function in GFile +
-
g_file_descriptor_based_get_fd
+
+g_file_descriptor_based_get_fd, function in GFileDescriptorBased +
-
g_file_dup
+
+g_file_dup, function in GFile +
-
g_file_eject_mountable
+
+g_file_eject_mountable, function in GFile +
-
g_file_eject_mountable_finish
+
+g_file_eject_mountable_finish, function in GFile +
-
g_file_eject_mountable_with_operation
+
+g_file_eject_mountable_with_operation, function in GFile +
-
g_file_eject_mountable_with_operation_finish
+
+g_file_eject_mountable_with_operation_finish, function in GFile +
-
g_file_enumerate_children
+
+g_file_enumerate_children, function in GFile +
-
g_file_enumerate_children_async
+
+g_file_enumerate_children_async, function in GFile +
-
g_file_enumerate_children_finish
+
+g_file_enumerate_children_finish, function in GFile +
-
g_file_enumerator_close
+
+g_file_enumerator_close, function in GFileEnumerator +
-
g_file_enumerator_close_async
+
+g_file_enumerator_close_async, function in GFileEnumerator +
-
g_file_enumerator_close_finish
+
+g_file_enumerator_close_finish, function in GFileEnumerator +
-
g_file_enumerator_get_container
+
+g_file_enumerator_get_container, function in GFileEnumerator +
-
g_file_enumerator_has_pending
+
+g_file_enumerator_has_pending, function in GFileEnumerator +
-
g_file_enumerator_is_closed
+
+g_file_enumerator_is_closed, function in GFileEnumerator +
-
g_file_enumerator_next_file
+
+g_file_enumerator_next_file, function in GFileEnumerator +
-
g_file_enumerator_next_files_async
+
+g_file_enumerator_next_files_async, function in GFileEnumerator +
-
g_file_enumerator_next_files_finish
+
+g_file_enumerator_next_files_finish, function in GFileEnumerator +
-
g_file_enumerator_set_pending
+
+g_file_enumerator_set_pending, function in GFileEnumerator +
-
g_file_equal
+
+g_file_equal, function in GFile +
-
g_file_find_enclosing_mount
+
+g_file_find_enclosing_mount, function in GFile +
-
g_file_find_enclosing_mount_async
+
+g_file_find_enclosing_mount_async, function in GFile +
-
g_file_find_enclosing_mount_finish
+
+g_file_find_enclosing_mount_finish, function in GFile +
-
g_file_get_basename
+
+g_file_get_basename, function in GFile +
-
g_file_get_child
+
+g_file_get_child, function in GFile +
-
g_file_get_child_for_display_name
+
+g_file_get_child_for_display_name, function in GFile +
-
g_file_get_parent
+
+g_file_get_parent, function in GFile +
-
g_file_get_parse_name
+
+g_file_get_parse_name, function in GFile +
-
g_file_get_path
+
+g_file_get_path, function in GFile +
-
g_file_get_relative_path
+
+g_file_get_relative_path, function in GFile +
-
g_file_get_uri
+
+g_file_get_uri, function in GFile +
-
g_file_get_uri_scheme
+
+g_file_get_uri_scheme, function in GFile +
-
g_file_hash
+
+g_file_hash, function in GFile +
-
g_file_has_parent
+
+g_file_has_parent, function in GFile +
-
g_file_has_prefix
+
+g_file_has_prefix, function in GFile +
-
g_file_has_uri_scheme
+
+g_file_has_uri_scheme, function in GFile +
-
g_file_icon_get_file
+
+g_file_icon_get_file, function in GFileIcon +
-
g_file_icon_new
+
+g_file_icon_new, function in GFileIcon +
-
g_file_info_clear_status
+
+g_file_info_clear_status, function in GFileInfo +
-
g_file_info_copy_into
+
+g_file_info_copy_into, function in GFileInfo +
-
g_file_info_dup
+
+g_file_info_dup, function in GFileInfo +
-
g_file_info_get_attribute_as_string
+
+g_file_info_get_attribute_as_string, function in GFileInfo +
-
g_file_info_get_attribute_boolean
+
+g_file_info_get_attribute_boolean, function in GFileInfo +
-
g_file_info_get_attribute_byte_string
+
+g_file_info_get_attribute_byte_string, function in GFileInfo +
-
g_file_info_get_attribute_data
+
+g_file_info_get_attribute_data, function in GFileInfo +
-
g_file_info_get_attribute_int32
+
+g_file_info_get_attribute_int32, function in GFileInfo +
-
g_file_info_get_attribute_int64
+
+g_file_info_get_attribute_int64, function in GFileInfo +
-
g_file_info_get_attribute_object
+
+g_file_info_get_attribute_object, function in GFileInfo +
-
g_file_info_get_attribute_status
+
+g_file_info_get_attribute_status, function in GFileInfo +
-
g_file_info_get_attribute_string
+
+g_file_info_get_attribute_string, function in GFileInfo +
-
g_file_info_get_attribute_stringv
+
+g_file_info_get_attribute_stringv, function in GFileInfo +
-
g_file_info_get_attribute_type
+
+g_file_info_get_attribute_type, function in GFileInfo +
-
g_file_info_get_attribute_uint32
+
+g_file_info_get_attribute_uint32, function in GFileInfo +
-
g_file_info_get_attribute_uint64
+
+g_file_info_get_attribute_uint64, function in GFileInfo +
-
g_file_info_get_content_type
+
+g_file_info_get_content_type, function in GFileInfo +
-
g_file_info_get_display_name
+
+g_file_info_get_display_name, function in GFileInfo +
-
g_file_info_get_edit_name
+
+g_file_info_get_edit_name, function in GFileInfo +
-
g_file_info_get_etag
+
+g_file_info_get_etag, function in GFileInfo +
-
g_file_info_get_file_type
+
+g_file_info_get_file_type, function in GFileInfo +
-
g_file_info_get_icon
+
+g_file_info_get_icon, function in GFileInfo +
-
g_file_info_get_is_backup
+
+g_file_info_get_is_backup, function in GFileInfo +
-
g_file_info_get_is_hidden
+
+g_file_info_get_is_hidden, function in GFileInfo +
-
g_file_info_get_is_symlink
+
+g_file_info_get_is_symlink, function in GFileInfo +
-
g_file_info_get_modification_time
+
+g_file_info_get_modification_time, function in GFileInfo +
-
g_file_info_get_name
+
+g_file_info_get_name, function in GFileInfo +
-
g_file_info_get_size
+
+g_file_info_get_size, function in GFileInfo +
-
g_file_info_get_sort_order
+
+g_file_info_get_sort_order, function in GFileInfo +
-
g_file_info_get_symlink_target
+
+g_file_info_get_symlink_target, function in GFileInfo +
-
g_file_info_has_attribute
+
+g_file_info_has_attribute, function in GFileInfo +
-
g_file_info_has_namespace
+
+g_file_info_has_namespace, function in GFileInfo +
-
g_file_info_list_attributes
+
+g_file_info_list_attributes, function in GFileInfo +
-
g_file_info_new
+
+g_file_info_new, function in GFileInfo +
-
g_file_info_remove_attribute
+
+g_file_info_remove_attribute, function in GFileInfo +
-
g_file_info_set_attribute
+
+g_file_info_set_attribute, function in GFileInfo +
-
g_file_info_set_attribute_boolean
+
+g_file_info_set_attribute_boolean, function in GFileInfo +
-
g_file_info_set_attribute_byte_string
+
+g_file_info_set_attribute_byte_string, function in GFileInfo +
-
g_file_info_set_attribute_int32
+
+g_file_info_set_attribute_int32, function in GFileInfo +
-
g_file_info_set_attribute_int64
+
+g_file_info_set_attribute_int64, function in GFileInfo +
-
g_file_info_set_attribute_mask
+
+g_file_info_set_attribute_mask, function in GFileInfo +
-
g_file_info_set_attribute_object
+
+g_file_info_set_attribute_object, function in GFileInfo +
-
g_file_info_set_attribute_status
+
+g_file_info_set_attribute_status, function in GFileInfo +
-
g_file_info_set_attribute_string
+
+g_file_info_set_attribute_string, function in GFileInfo +
-
g_file_info_set_attribute_stringv
+
+g_file_info_set_attribute_stringv, function in GFileInfo +
-
g_file_info_set_attribute_uint32
+
+g_file_info_set_attribute_uint32, function in GFileInfo +
-
g_file_info_set_attribute_uint64
+
+g_file_info_set_attribute_uint64, function in GFileInfo +
-
g_file_info_set_content_type
+
+g_file_info_set_content_type, function in GFileInfo +
-
g_file_info_set_display_name
+
+g_file_info_set_display_name, function in GFileInfo +
-
g_file_info_set_edit_name
+
+g_file_info_set_edit_name, function in GFileInfo +
-
g_file_info_set_file_type
+
+g_file_info_set_file_type, function in GFileInfo +
-
g_file_info_set_icon
+
+g_file_info_set_icon, function in GFileInfo +
-
g_file_info_set_is_hidden
+
+g_file_info_set_is_hidden, function in GFileInfo +
-
g_file_info_set_is_symlink
+
+g_file_info_set_is_symlink, function in GFileInfo +
-
g_file_info_set_modification_time
+
+g_file_info_set_modification_time, function in GFileInfo +
-
g_file_info_set_name
+
+g_file_info_set_name, function in GFileInfo +
-
g_file_info_set_size
+
+g_file_info_set_size, function in GFileInfo +
-
g_file_info_set_sort_order
+
+g_file_info_set_sort_order, function in GFileInfo +
-
g_file_info_set_symlink_target
+
+g_file_info_set_symlink_target, function in GFileInfo +
-
g_file_info_unset_attribute_mask
+
+g_file_info_unset_attribute_mask, function in GFileInfo +
-
g_file_input_stream_query_info
+
+g_file_input_stream_query_info, function in GFileInputStream +
-
g_file_input_stream_query_info_async
+
+g_file_input_stream_query_info_async, function in GFileInputStream +
-
g_file_input_stream_query_info_finish
+
+g_file_input_stream_query_info_finish, function in GFileInputStream +
-
g_file_io_stream_get_etag
+
+g_file_io_stream_get_etag, function in GFileIOStream +
-
g_file_io_stream_query_info
+
+g_file_io_stream_query_info, function in GFileIOStream +
-
g_file_io_stream_query_info_async
+
+g_file_io_stream_query_info_async, function in GFileIOStream +
-
g_file_io_stream_query_info_finish
+
+g_file_io_stream_query_info_finish, function in GFileIOStream +
-
g_file_is_native
+
+g_file_is_native, function in GFile +
-
g_file_load_contents
+
+g_file_load_contents, function in GFile +
-
g_file_load_contents_async
+
+g_file_load_contents_async, function in GFile +
-
g_file_load_contents_finish
+
+g_file_load_contents_finish, function in GFile +
-
g_file_load_partial_contents_async
+
+g_file_load_partial_contents_async, function in GFile +
-
g_file_load_partial_contents_finish
+
+g_file_load_partial_contents_finish, function in GFile +
-
g_file_make_directory
+
+g_file_make_directory, function in GFile +
-
g_file_make_directory_with_parents
+
+g_file_make_directory_with_parents, function in GFile +
-
g_file_make_symbolic_link
+
+g_file_make_symbolic_link, function in GFile +
-
g_file_monitor
+
+g_file_monitor, function in GFile +
-
g_file_monitor_cancel
+
+g_file_monitor_cancel, function in GFileMonitor +
-
g_file_monitor_directory
+
+g_file_monitor_directory, function in GFile +
-
g_file_monitor_emit_event
+
+g_file_monitor_emit_event, function in GFileMonitor +
-
g_file_monitor_file
+
+g_file_monitor_file, function in GFile +
-
g_file_monitor_is_cancelled
+
+g_file_monitor_is_cancelled, function in GFileMonitor +
-
g_file_monitor_set_rate_limit
+
+g_file_monitor_set_rate_limit, function in GFileMonitor +
-
g_file_mount_enclosing_volume
+
+g_file_mount_enclosing_volume, function in GFile +
-
g_file_mount_enclosing_volume_finish
+
+g_file_mount_enclosing_volume_finish, function in GFile +
-
g_file_mount_mountable
+
+g_file_mount_mountable, function in GFile +
-
g_file_mount_mountable_finish
+
+g_file_mount_mountable_finish, function in GFile +
-
g_file_move
+
+g_file_move, function in GFile +
-
g_file_new_for_commandline_arg
+
+g_file_new_for_commandline_arg, function in GFile +
-
g_file_new_for_path
+
+g_file_new_for_path, function in GFile +
-
g_file_new_for_uri
+
+g_file_new_for_uri, function in GFile +
-
g_file_open_readwrite
+
+g_file_open_readwrite, function in GFile +
-
g_file_open_readwrite_async
+
+g_file_open_readwrite_async, function in GFile +
-
g_file_open_readwrite_finish
+
+g_file_open_readwrite_finish, function in GFile +
-
g_file_output_stream_get_etag
+
+g_file_output_stream_get_etag, function in GFileOutputStream +
-
g_file_output_stream_query_info
+
+g_file_output_stream_query_info, function in GFileOutputStream +
-
g_file_output_stream_query_info_async
+
+g_file_output_stream_query_info_async, function in GFileOutputStream +
-
g_file_output_stream_query_info_finish
+
+g_file_output_stream_query_info_finish, function in GFileOutputStream +
-
g_file_parse_name
+
+g_file_parse_name, function in GFile +
-
g_file_poll_mountable
+
+g_file_poll_mountable, function in GFile +
-
g_file_poll_mountable_finish
+
+g_file_poll_mountable_finish, function in GFile +
-
g_file_query_default_handler
+
+g_file_query_default_handler, function in GFile +
-
g_file_query_exists
+
+g_file_query_exists, function in GFile +
-
g_file_query_filesystem_info
+
+g_file_query_filesystem_info, function in GFile +
-
g_file_query_filesystem_info_async
+
+g_file_query_filesystem_info_async, function in GFile +
-
g_file_query_filesystem_info_finish
+
+g_file_query_filesystem_info_finish, function in GFile +
-
g_file_query_file_type
+
+g_file_query_file_type, function in GFile +
-
g_file_query_info
+
+g_file_query_info, function in GFile +
-
g_file_query_info_async
+
+g_file_query_info_async, function in GFile +
-
g_file_query_info_finish
+
+g_file_query_info_finish, function in GFile +
-
g_file_query_settable_attributes
+
+g_file_query_settable_attributes, function in GFile +
-
g_file_query_writable_namespaces
+
+g_file_query_writable_namespaces, function in GFile +
-
g_file_read
+
+g_file_read, function in GFile +
-
g_file_read_async
+
+g_file_read_async, function in GFile +
-
g_file_read_finish
+
+g_file_read_finish, function in GFile +
-
g_file_replace
+
+g_file_replace, function in GFile +
-
g_file_replace_async
+
+g_file_replace_async, function in GFile +
-
g_file_replace_contents
+
+g_file_replace_contents, function in GFile +
-
g_file_replace_contents_async
+
+g_file_replace_contents_async, function in GFile +
-
g_file_replace_contents_finish
+
+g_file_replace_contents_finish, function in GFile +
-
g_file_replace_finish
+
+g_file_replace_finish, function in GFile +
-
g_file_replace_readwrite
+
+g_file_replace_readwrite, function in GFile +
-
g_file_replace_readwrite_async
+
+g_file_replace_readwrite_async, function in GFile +
-
g_file_replace_readwrite_finish
+
+g_file_replace_readwrite_finish, function in GFile +
-
g_file_resolve_relative_path
+
+g_file_resolve_relative_path, function in GFile +
-
g_file_set_attribute
+
+g_file_set_attribute, function in GFile +
-
g_file_set_attributes_async
+
+g_file_set_attributes_async, function in GFile +
-
g_file_set_attributes_finish
+
+g_file_set_attributes_finish, function in GFile +
-
g_file_set_attributes_from_info
+
+g_file_set_attributes_from_info, function in GFile +
-
g_file_set_attribute_byte_string
+
+g_file_set_attribute_byte_string, function in GFile +
-
g_file_set_attribute_int32
+
+g_file_set_attribute_int32, function in GFile +
-
g_file_set_attribute_int64
+
+g_file_set_attribute_int64, function in GFile +
-
g_file_set_attribute_string
+
+g_file_set_attribute_string, function in GFile +
-
g_file_set_attribute_uint32
+
+g_file_set_attribute_uint32, function in GFile +
-
g_file_set_attribute_uint64
+
+g_file_set_attribute_uint64, function in GFile +
-
g_file_set_display_name
+
+g_file_set_display_name, function in GFile +
-
g_file_set_display_name_async
+
+g_file_set_display_name_async, function in GFile +
-
g_file_set_display_name_finish
+
+g_file_set_display_name_finish, function in GFile +
-
g_file_start_mountable
+
+g_file_start_mountable, function in GFile +
-
g_file_start_mountable_finish
+
+g_file_start_mountable_finish, function in GFile +
-
g_file_stop_mountable
+
+g_file_stop_mountable, function in GFile +
-
g_file_stop_mountable_finish
+
+g_file_stop_mountable_finish, function in GFile +
-
g_file_supports_thread_contexts
+
+g_file_supports_thread_contexts, function in GFile +
-
g_file_trash
+
+g_file_trash, function in GFile +
-
g_file_unmount_mountable
+
+g_file_unmount_mountable, function in GFile +
-
g_file_unmount_mountable_finish
+
+g_file_unmount_mountable_finish, function in GFile +
-
g_file_unmount_mountable_with_operation
+
+g_file_unmount_mountable_with_operation, function in GFile +
-
g_file_unmount_mountable_with_operation_finish
+
+g_file_unmount_mountable_with_operation_finish, function in GFile +
-
GFilterInputStream
+
+GFilterInputStream, struct in GFilterInputStream +
-
GFilterInputStream:base-stream
+
+GFilterInputStream:base-stream, object property in GFilterInputStream +
-
GFilterInputStream:close-base-stream
+
+GFilterInputStream:close-base-stream, object property in GFilterInputStream +
-
GFilterOutputStream
+
+GFilterOutputStream, struct in GFilterOutputStream +
-
GFilterOutputStream:base-stream
+
+GFilterOutputStream:base-stream, object property in GFilterOutputStream +
-
GFilterOutputStream:close-base-stream
+
+GFilterOutputStream:close-base-stream, object property in GFilterOutputStream +
-
g_filter_input_stream_get_base_stream
+
+g_filter_input_stream_get_base_stream, function in GFilterInputStream +
-
g_filter_input_stream_get_close_base_stream
+
+g_filter_input_stream_get_close_base_stream, function in GFilterInputStream +
-
g_filter_input_stream_set_close_base_stream
+
+g_filter_input_stream_set_close_base_stream, function in GFilterInputStream +
-
g_filter_output_stream_get_base_stream
+
+g_filter_output_stream_get_base_stream, function in GFilterOutputStream +
-
g_filter_output_stream_get_close_base_stream
+
+g_filter_output_stream_get_close_base_stream, function in GFilterOutputStream +
-
g_filter_output_stream_set_close_base_stream
+
+g_filter_output_stream_set_close_base_stream, function in GFilterOutputStream +

I

-
GIcon
+
+GIcon, struct in GIcon +
-
GIconIface
+
+GIconIface, struct in GIcon +
-
g_icon_equal
+
+g_icon_equal, function in GIcon +
-
g_icon_hash
+
+g_icon_hash, function in GIcon +
-
g_icon_new_for_string
+
+g_icon_new_for_string, function in GIcon +
-
g_icon_to_string
+
+g_icon_to_string, function in GIcon +
-
GInetAddress
+
+GInetAddress, struct in GInetAddress +
-
GInetAddress:bytes
+
+GInetAddress:bytes, object property in GInetAddress +
-
GInetAddress:family
+
+GInetAddress:family, object property in GInetAddress +
-
GInetAddress:is-any
+
+GInetAddress:is-any, object property in GInetAddress +
-
GInetAddress:is-link-local
+
+GInetAddress:is-link-local, object property in GInetAddress +
-
GInetAddress:is-loopback
+
+GInetAddress:is-loopback, object property in GInetAddress +
-
GInetAddress:is-mc-global
+
+GInetAddress:is-mc-global, object property in GInetAddress +
-
GInetAddress:is-mc-link-local
+
+GInetAddress:is-mc-link-local, object property in GInetAddress +
-
GInetAddress:is-mc-node-local
+
+GInetAddress:is-mc-node-local, object property in GInetAddress +
-
GInetAddress:is-mc-org-local
+
+GInetAddress:is-mc-org-local, object property in GInetAddress +
-
GInetAddress:is-mc-site-local
+
+GInetAddress:is-mc-site-local, object property in GInetAddress +
-
GInetAddress:is-multicast
+
+GInetAddress:is-multicast, object property in GInetAddress +
-
GInetAddress:is-site-local
+
+GInetAddress:is-site-local, object property in GInetAddress +
-
GInetSocketAddress
+
+GInetSocketAddress, struct in GInetSocketAddress +
-
GInetSocketAddress:address
+
+GInetSocketAddress:address, object property in GInetSocketAddress +
-
GInetSocketAddress:port
+
+GInetSocketAddress:port, object property in GInetSocketAddress +
-
g_inet_address_get_family
+
+g_inet_address_get_family, function in GInetAddress +
-
g_inet_address_get_is_any
+
+g_inet_address_get_is_any, function in GInetAddress +
-
g_inet_address_get_is_link_local
+
+g_inet_address_get_is_link_local, function in GInetAddress +
-
g_inet_address_get_is_loopback
+
+g_inet_address_get_is_loopback, function in GInetAddress +
-
g_inet_address_get_is_mc_global
+
+g_inet_address_get_is_mc_global, function in GInetAddress +
-
g_inet_address_get_is_mc_link_local
+
+g_inet_address_get_is_mc_link_local, function in GInetAddress +
-
g_inet_address_get_is_mc_node_local
+
+g_inet_address_get_is_mc_node_local, function in GInetAddress +
-
g_inet_address_get_is_mc_org_local
+
+g_inet_address_get_is_mc_org_local, function in GInetAddress +
-
g_inet_address_get_is_mc_site_local
+
+g_inet_address_get_is_mc_site_local, function in GInetAddress +
-
g_inet_address_get_is_multicast
+
+g_inet_address_get_is_multicast, function in GInetAddress +
-
g_inet_address_get_is_site_local
+
+g_inet_address_get_is_site_local, function in GInetAddress +
-
g_inet_address_get_native_size
+
+g_inet_address_get_native_size, function in GInetAddress +
-
g_inet_address_new_any
+
+g_inet_address_new_any, function in GInetAddress +
-
g_inet_address_new_from_bytes
+
+g_inet_address_new_from_bytes, function in GInetAddress +
-
g_inet_address_new_from_string
+
+g_inet_address_new_from_string, function in GInetAddress +
-
g_inet_address_new_loopback
+
+g_inet_address_new_loopback, function in GInetAddress +
-
g_inet_address_to_bytes
+
+g_inet_address_to_bytes, function in GInetAddress +
-
g_inet_address_to_string
+
+g_inet_address_to_string, function in GInetAddress +
-
g_inet_socket_address_get_address
+
+g_inet_socket_address_get_address, function in GInetSocketAddress +
-
g_inet_socket_address_get_port
+
+g_inet_socket_address_get_port, function in GInetSocketAddress +
-
g_inet_socket_address_new
+
+g_inet_socket_address_new, function in GInetSocketAddress +
-
GInitable
+
+GInitable, struct in GInitable +
-
GInitableIface
+
+GInitableIface, struct in GInitable +
-
g_initable_init
+
+g_initable_init, function in GInitable +
-
g_initable_new
+
+g_initable_new, function in GInitable +
-
g_initable_newv
+
+g_initable_newv, function in GInitable +
-
g_initable_new_valist
+
+g_initable_new_valist, function in GInitable +
-
GInputStream
+
+GInputStream, struct in GInputStream +
-
GInputVector
+
+GInputVector, struct in GSocket +
-
g_input_stream_clear_pending
+
+g_input_stream_clear_pending, function in GInputStream +
-
g_input_stream_close
+
+g_input_stream_close, function in GInputStream +
-
g_input_stream_close_async
+
+g_input_stream_close_async, function in GInputStream +
-
g_input_stream_close_finish
+
+g_input_stream_close_finish, function in GInputStream +
-
g_input_stream_has_pending
+
+g_input_stream_has_pending, function in GInputStream +
-
g_input_stream_is_closed
+
+g_input_stream_is_closed, function in GInputStream +
-
g_input_stream_read
+
+g_input_stream_read, function in GInputStream +
-
g_input_stream_read_all
+
+g_input_stream_read_all, function in GInputStream +
-
g_input_stream_read_async
+
+g_input_stream_read_async, function in GInputStream +
-
g_input_stream_read_finish
+
+g_input_stream_read_finish, function in GInputStream +
-
g_input_stream_set_pending
+
+g_input_stream_set_pending, function in GInputStream +
-
g_input_stream_skip
+
+g_input_stream_skip, function in GInputStream +
-
g_input_stream_skip_async
+
+g_input_stream_skip_async, function in GInputStream +
-
g_input_stream_skip_finish
+
+g_input_stream_skip_finish, function in GInputStream +
-
GIOErrorEnum
+
+GIOErrorEnum, enum in GIOError +
-
GIOExtension
+
+GIOExtension, struct in Extension Points +
-
GIOExtensionPoint
+
+GIOExtensionPoint, struct in Extension Points +
-
GIOModule
+
+GIOModule, struct in GIOModule +
-
GIOSchedulerJob
+
+GIOSchedulerJob, struct in GIOScheduler +
-
GIOSchedulerJobFunc
+
+GIOSchedulerJobFunc, user_function in GIOScheduler +
-
GIOStream
+
+GIOStream, struct in GIOStream +
-
GIOStream:closed
+
+GIOStream:closed, object property in GIOStream +
-
GIOStream:input-stream
+
+GIOStream:input-stream, object property in GIOStream +
-
GIOStream:output-stream
+
+GIOStream:output-stream, object property in GIOStream +
-
G_IO_ERROR
+
+G_IO_ERROR, macro in GIOError +
-
g_io_error_from_errno
+
+g_io_error_from_errno, function in GIOError +
-
g_io_extension_get_name
+
+g_io_extension_get_name, function in Extension Points +
-
g_io_extension_get_priority
+
+g_io_extension_get_priority, function in Extension Points +
-
g_io_extension_get_type
+
+g_io_extension_get_type, function in Extension Points +
-
g_io_extension_point_get_extensions
+
+g_io_extension_point_get_extensions, function in Extension Points +
-
g_io_extension_point_get_extension_by_name
+
+g_io_extension_point_get_extension_by_name, function in Extension Points +
-
g_io_extension_point_get_required_type
+
+g_io_extension_point_get_required_type, function in Extension Points +
-
g_io_extension_point_implement
+
+g_io_extension_point_implement, function in Extension Points +
-
g_io_extension_point_lookup
+
+g_io_extension_point_lookup, function in Extension Points +
-
g_io_extension_point_register
+
+g_io_extension_point_register, function in Extension Points +
-
g_io_extension_point_set_required_type
+
+g_io_extension_point_set_required_type, function in Extension Points +
-
g_io_extension_ref_class
+
+g_io_extension_ref_class, function in Extension Points +
-
g_io_modules_load_all_in_directory
+
+g_io_modules_load_all_in_directory, function in GIOModule +
-
g_io_modules_scan_all_in_directory
+
+g_io_modules_scan_all_in_directory, function in GIOModule +
-
g_io_module_load
+
+g_io_module_load, function in GIOModule +
-
g_io_module_new
+
+g_io_module_new, function in GIOModule +
-
g_io_module_query
+
+g_io_module_query, function in GIOModule +
-
g_io_module_unload
+
+g_io_module_unload, function in GIOModule +
-
g_io_scheduler_cancel_all_jobs
+
+g_io_scheduler_cancel_all_jobs, function in GIOScheduler +
-
g_io_scheduler_job_send_to_mainloop
+
+g_io_scheduler_job_send_to_mainloop, function in GIOScheduler +
-
g_io_scheduler_job_send_to_mainloop_async
+
+g_io_scheduler_job_send_to_mainloop_async, function in GIOScheduler +
-
g_io_scheduler_push_job
+
+g_io_scheduler_push_job, function in GIOScheduler +
-
g_io_stream_clear_pending
+
+g_io_stream_clear_pending, function in GIOStream +
-
g_io_stream_close
+
+g_io_stream_close, function in GIOStream +
-
g_io_stream_close_async
+
+g_io_stream_close_async, function in GIOStream +
-
g_io_stream_close_finish
+
+g_io_stream_close_finish, function in GIOStream +
-
g_io_stream_get_input_stream
+
+g_io_stream_get_input_stream, function in GIOStream +
-
g_io_stream_get_output_stream
+
+g_io_stream_get_output_stream, function in GIOStream +
-
g_io_stream_has_pending
+
+g_io_stream_has_pending, function in GIOStream +
-
g_io_stream_is_closed
+
+g_io_stream_is_closed, function in GIOStream +
-
g_io_stream_set_pending
+
+g_io_stream_set_pending, function in GIOStream +

L

-
GLoadableIcon
+
+GLoadableIcon, struct in GLoadableIcon +
-
GLoadableIconIface
+
+GLoadableIconIface, struct in GLoadableIcon +
-
g_loadable_icon_load
+
+g_loadable_icon_load, function in GLoadableIcon +
-
g_loadable_icon_load_async
+
+g_loadable_icon_load_async, function in GLoadableIcon +
-
g_loadable_icon_load_finish
+
+g_loadable_icon_load_finish, function in GLoadableIcon +

M

-
GMemoryInputStream
+
+GMemoryInputStream, struct in GMemoryInputStream +
-
GMemoryOutputStream
+
+GMemoryOutputStream, struct in GMemoryOutputStream +
-
GMemoryOutputStream:data
+
+GMemoryOutputStream:data, object property in GMemoryOutputStream +
-
GMemoryOutputStream:data-size
+
+GMemoryOutputStream:data-size, object property in GMemoryOutputStream +
-
GMemoryOutputStream:destroy-function
+
+GMemoryOutputStream:destroy-function, object property in GMemoryOutputStream +
-
GMemoryOutputStream:realloc-function
+
+GMemoryOutputStream:realloc-function, object property in GMemoryOutputStream +
-
GMemoryOutputStream:size
+
+GMemoryOutputStream:size, object property in GMemoryOutputStream +
-
g_memory_input_stream_add_data
+
+g_memory_input_stream_add_data, function in GMemoryInputStream +
-
g_memory_input_stream_new
+
+g_memory_input_stream_new, function in GMemoryInputStream +
-
g_memory_input_stream_new_from_data
+
+g_memory_input_stream_new_from_data, function in GMemoryInputStream +
-
g_memory_output_stream_get_data
+
+g_memory_output_stream_get_data, function in GMemoryOutputStream +
-
g_memory_output_stream_get_data_size
+
+g_memory_output_stream_get_data_size, function in GMemoryOutputStream +
-
g_memory_output_stream_get_size
+
+g_memory_output_stream_get_size, function in GMemoryOutputStream +
-
g_memory_output_stream_new
+
+g_memory_output_stream_new, function in GMemoryOutputStream +
-
GMount
+
+GMount, struct in GMount +
-
GMount::changed
+
+GMount::changed, object signal in GMount +
-
GMount::pre-unmount
+
+GMount::pre-unmount, object signal in GMount +
-
GMount::unmounted
+
+GMount::unmounted, object signal in GMount +
-
GMountIface
+
+GMountIface, struct in GMount +
-
GMountMountFlags
+
+GMountMountFlags, enum in GMount +
-
GMountOperation
+
+GMountOperation, struct in GMountOperation +
-
GMountOperation::aborted
+
+GMountOperation::aborted, object signal in GMountOperation +
-
GMountOperation::ask-password
+
+GMountOperation::ask-password, object signal in GMountOperation +
-
GMountOperation::ask-question
+
+GMountOperation::ask-question, object signal in GMountOperation +
-
GMountOperation::reply
+
+GMountOperation::reply, object signal in GMountOperation +
-
GMountOperation::show-processes
+
+GMountOperation::show-processes, object signal in GMountOperation +
-
GMountOperation:anonymous
+
+GMountOperation:anonymous, object property in GMountOperation +
-
GMountOperation:choice
+
+GMountOperation:choice, object property in GMountOperation +
-
GMountOperation:domain
+
+GMountOperation:domain, object property in GMountOperation +
-
GMountOperation:password
+
+GMountOperation:password, object property in GMountOperation +
-
GMountOperation:password-save
+
+GMountOperation:password-save, object property in GMountOperation +
-
GMountOperation:username
+
+GMountOperation:username, object property in GMountOperation +
-
GMountOperationResult
+
+GMountOperationResult, enum in GMountOperation +
-
GMountUnmountFlags
+
+GMountUnmountFlags, enum in GMount +
-
g_mount_can_eject
+
+g_mount_can_eject, function in GMount +
-
g_mount_can_unmount
+
+g_mount_can_unmount, function in GMount +
-
g_mount_eject
+
+g_mount_eject, function in GMount +
-
g_mount_eject_finish
+
+g_mount_eject_finish, function in GMount +
-
g_mount_eject_with_operation
+
+g_mount_eject_with_operation, function in GMount +
-
g_mount_eject_with_operation_finish
+
+g_mount_eject_with_operation_finish, function in GMount +
-
g_mount_get_default_location
+
+g_mount_get_default_location, function in GMount +
-
g_mount_get_drive
+
+g_mount_get_drive, function in GMount +
-
g_mount_get_icon
+
+g_mount_get_icon, function in GMount +
-
g_mount_get_name
+
+g_mount_get_name, function in GMount +
-
g_mount_get_root
+
+g_mount_get_root, function in GMount +
-
g_mount_get_uuid
+
+g_mount_get_uuid, function in GMount +
-
g_mount_get_volume
+
+g_mount_get_volume, function in GMount +
-
g_mount_guess_content_type
+
+g_mount_guess_content_type, function in GMount +
-
g_mount_guess_content_type_finish
+
+g_mount_guess_content_type_finish, function in GMount +
-
g_mount_guess_content_type_sync
+
+g_mount_guess_content_type_sync, function in GMount +
-
g_mount_is_shadowed
+
+g_mount_is_shadowed, function in GMount +
-
g_mount_operation_get_anonymous
+
+g_mount_operation_get_anonymous, function in GMountOperation +
-
g_mount_operation_get_choice
+
+g_mount_operation_get_choice, function in GMountOperation +
-
g_mount_operation_get_domain
+
+g_mount_operation_get_domain, function in GMountOperation +
-
g_mount_operation_get_password
+
+g_mount_operation_get_password, function in GMountOperation +
-
g_mount_operation_get_password_save
+
+g_mount_operation_get_password_save, function in GMountOperation +
-
g_mount_operation_get_username
+
+g_mount_operation_get_username, function in GMountOperation +
-
g_mount_operation_new
+
+g_mount_operation_new, function in GMountOperation +
-
g_mount_operation_reply
+
+g_mount_operation_reply, function in GMountOperation +
-
g_mount_operation_set_anonymous
+
+g_mount_operation_set_anonymous, function in GMountOperation +
-
g_mount_operation_set_choice
+
+g_mount_operation_set_choice, function in GMountOperation +
-
g_mount_operation_set_domain
+
+g_mount_operation_set_domain, function in GMountOperation +
-
g_mount_operation_set_password
+
+g_mount_operation_set_password, function in GMountOperation +
-
g_mount_operation_set_password_save
+
+g_mount_operation_set_password_save, function in GMountOperation +
-
g_mount_operation_set_username
+
+g_mount_operation_set_username, function in GMountOperation +
-
g_mount_remount
+
+g_mount_remount, function in GMount +
-
g_mount_remount_finish
+
+g_mount_remount_finish, function in GMount +
-
g_mount_shadow
+
+g_mount_shadow, function in GMount +
-
g_mount_unmount
+
+g_mount_unmount, function in GMount +
-
g_mount_unmount_finish
+
+g_mount_unmount_finish, function in GMount +
-
g_mount_unmount_with_operation
+
+g_mount_unmount_with_operation, function in GMount +
-
g_mount_unmount_with_operation_finish
+
+g_mount_unmount_with_operation_finish, function in GMount +
-
g_mount_unshadow
+
+g_mount_unshadow, function in GMount +

N

-
GNetworkAddress
+
+GNetworkAddress, struct in GNetworkAddress +
-
GNetworkAddress:hostname
+
+GNetworkAddress:hostname, object property in GNetworkAddress +
-
GNetworkAddress:port
+
+GNetworkAddress:port, object property in GNetworkAddress +
-
GNetworkService
+
+GNetworkService, struct in GNetworkService +
-
GNetworkService:domain
+
+GNetworkService:domain, object property in GNetworkService +
-
GNetworkService:protocol
+
+GNetworkService:protocol, object property in GNetworkService +
-
GNetworkService:service
+
+GNetworkService:service, object property in GNetworkService +
-
g_network_address_get_hostname
+
+g_network_address_get_hostname, function in GNetworkAddress +
-
g_network_address_get_port
+
+g_network_address_get_port, function in GNetworkAddress +
-
g_network_address_new
+
+g_network_address_new, function in GNetworkAddress +
-
g_network_address_parse
+
+g_network_address_parse, function in GNetworkAddress +
-
g_network_service_get_domain
+
+g_network_service_get_domain, function in GNetworkService +
-
g_network_service_get_protocol
+
+g_network_service_get_protocol, function in GNetworkService +
-
g_network_service_get_service
+
+g_network_service_get_service, function in GNetworkService +
-
g_network_service_new
+
+g_network_service_new, function in GNetworkService +

O

-
GOutputStream
+
+GOutputStream, struct in GOutputStream +
-
GOutputStreamSpliceFlags
+
+GOutputStreamSpliceFlags, enum in GOutputStream +
-
GOutputVector
+
+GOutputVector, struct in GSocket +
-
g_output_stream_clear_pending
+
+g_output_stream_clear_pending, function in GOutputStream +
-
g_output_stream_close
+
+g_output_stream_close, function in GOutputStream +
-
g_output_stream_close_async
+
+g_output_stream_close_async, function in GOutputStream +
-
g_output_stream_close_finish
+
+g_output_stream_close_finish, function in GOutputStream +
-
g_output_stream_flush
+
+g_output_stream_flush, function in GOutputStream +
-
g_output_stream_flush_async
+
+g_output_stream_flush_async, function in GOutputStream +
-
g_output_stream_flush_finish
+
+g_output_stream_flush_finish, function in GOutputStream +
-
g_output_stream_has_pending
+
+g_output_stream_has_pending, function in GOutputStream +
-
g_output_stream_is_closed
+
+g_output_stream_is_closed, function in GOutputStream +
-
g_output_stream_is_closing
+
+g_output_stream_is_closing, function in GOutputStream +
-
g_output_stream_set_pending
+
+g_output_stream_set_pending, function in GOutputStream +
-
g_output_stream_splice
+
+g_output_stream_splice, function in GOutputStream +
-
g_output_stream_splice_async
+
+g_output_stream_splice_async, function in GOutputStream +
-
g_output_stream_splice_finish
+
+g_output_stream_splice_finish, function in GOutputStream +
-
g_output_stream_write
+
+g_output_stream_write, function in GOutputStream +
-
g_output_stream_write_all
+
+g_output_stream_write_all, function in GOutputStream +
-
g_output_stream_write_async
+
+g_output_stream_write_async, function in GOutputStream +
-
g_output_stream_write_finish
+
+g_output_stream_write_finish, function in GOutputStream +

P

-
GPasswordSave
+
+GPasswordSave, enum in GMountOperation +

R

-
GReallocFunc
+
+GReallocFunc, user_function in GMemoryOutputStream +
-
GResolver
+
+GResolver, struct in GResolver +
-
GResolver::reload
+
+GResolver::reload, object signal in GResolver +
-
GResolverError
+
+GResolverError, enum in GResolver +
-
G_RESOLVER_ERROR
+
+G_RESOLVER_ERROR, macro in GResolver +
-
g_resolver_free_addresses
+
+g_resolver_free_addresses, function in GResolver +
-
g_resolver_free_targets
+
+g_resolver_free_targets, function in GResolver +
-
g_resolver_get_default
+
+g_resolver_get_default, function in GResolver +
-
g_resolver_lookup_by_address
+
+g_resolver_lookup_by_address, function in GResolver +
-
g_resolver_lookup_by_address_async
+
+g_resolver_lookup_by_address_async, function in GResolver +
-
g_resolver_lookup_by_address_finish
+
+g_resolver_lookup_by_address_finish, function in GResolver +
-
g_resolver_lookup_by_name
+
+g_resolver_lookup_by_name, function in GResolver +
-
g_resolver_lookup_by_name_async
+
+g_resolver_lookup_by_name_async, function in GResolver +
-
g_resolver_lookup_by_name_finish
+
+g_resolver_lookup_by_name_finish, function in GResolver +
-
g_resolver_lookup_service
+
+g_resolver_lookup_service, function in GResolver +
-
g_resolver_lookup_service_async
+
+g_resolver_lookup_service_async, function in GResolver +
-
g_resolver_lookup_service_finish
+
+g_resolver_lookup_service_finish, function in GResolver +
-
g_resolver_set_default
+
+g_resolver_set_default, function in GResolver +

S

-
GSeekable
+
+GSeekable, struct in GSeekable +
-
GSeekableIface
+
+GSeekableIface, struct in GSeekable +
-
g_seekable_can_seek
+
+g_seekable_can_seek, function in GSeekable +
-
g_seekable_can_truncate
+
+g_seekable_can_truncate, function in GSeekable +
-
g_seekable_seek
+
+g_seekable_seek, function in GSeekable +
-
g_seekable_tell
+
+g_seekable_tell, function in GSeekable +
-
g_seekable_truncate
+
+g_seekable_truncate, function in GSeekable +
-
GSimpleAsyncResult
+
+GSimpleAsyncResult, struct in GSimpleAsyncResult +
-
GSimpleAsyncThreadFunc
+
+GSimpleAsyncThreadFunc, user_function in GSimpleAsyncResult +
-
g_simple_async_report_error_in_idle
+
+g_simple_async_report_error_in_idle, function in GSimpleAsyncResult +
-
g_simple_async_report_gerror_in_idle
+
+g_simple_async_report_gerror_in_idle, function in GSimpleAsyncResult +
-
g_simple_async_result_complete
+
+g_simple_async_result_complete, function in GSimpleAsyncResult +
-
g_simple_async_result_complete_in_idle
+
+g_simple_async_result_complete_in_idle, function in GSimpleAsyncResult +
-
g_simple_async_result_get_op_res_gboolean
+
+g_simple_async_result_get_op_res_gboolean, function in GSimpleAsyncResult +
-
g_simple_async_result_get_op_res_gpointer
+
+g_simple_async_result_get_op_res_gpointer, function in GSimpleAsyncResult +
-
g_simple_async_result_get_op_res_gssize
+
+g_simple_async_result_get_op_res_gssize, function in GSimpleAsyncResult +
-
g_simple_async_result_get_source_tag
+
+g_simple_async_result_get_source_tag, function in GSimpleAsyncResult +
-
g_simple_async_result_is_valid
+
+g_simple_async_result_is_valid, function in GSimpleAsyncResult +
-
g_simple_async_result_new
+
+g_simple_async_result_new, function in GSimpleAsyncResult +
-
g_simple_async_result_new_error
+
+g_simple_async_result_new_error, function in GSimpleAsyncResult +
-
g_simple_async_result_new_from_error
+
+g_simple_async_result_new_from_error, function in GSimpleAsyncResult +
-
g_simple_async_result_propagate_error
+
+g_simple_async_result_propagate_error, function in GSimpleAsyncResult +
-
g_simple_async_result_run_in_thread
+
+g_simple_async_result_run_in_thread, function in GSimpleAsyncResult +
-
g_simple_async_result_set_error
+
+g_simple_async_result_set_error, function in GSimpleAsyncResult +
-
g_simple_async_result_set_error_va
+
+g_simple_async_result_set_error_va, function in GSimpleAsyncResult +
-
g_simple_async_result_set_from_error
+
+g_simple_async_result_set_from_error, function in GSimpleAsyncResult +
-
g_simple_async_result_set_handle_cancellation
+
+g_simple_async_result_set_handle_cancellation, function in GSimpleAsyncResult +
-
g_simple_async_result_set_op_res_gboolean
+
+g_simple_async_result_set_op_res_gboolean, function in GSimpleAsyncResult +
-
g_simple_async_result_set_op_res_gpointer
+
+g_simple_async_result_set_op_res_gpointer, function in GSimpleAsyncResult +
-
g_simple_async_result_set_op_res_gssize
+
+g_simple_async_result_set_op_res_gssize, function in GSimpleAsyncResult +
-
GSocket
+
+GSocket, struct in GSocket +
-
GSocket:blocking
+
+GSocket:blocking, object property in GSocket +
-
GSocket:family
+
+GSocket:family, object property in GSocket +
-
GSocket:fd
+
+GSocket:fd, object property in GSocket +
-
GSocket:keepalive
+
+GSocket:keepalive, object property in GSocket +
-
GSocket:listen-backlog
+
+GSocket:listen-backlog, object property in GSocket +
-
GSocket:local-address
+
+GSocket:local-address, object property in GSocket +
-
GSocket:protocol
+
+GSocket:protocol, object property in GSocket +
-
GSocket:remote-address
+
+GSocket:remote-address, object property in GSocket +
-
GSocket:type
+
+GSocket:type, object property in GSocket +
-
GSocketAddress
+
+GSocketAddress, struct in GSocketAddress +
-
GSocketAddress:family
+
+GSocketAddress:family, object property in GSocketAddress +
-
GSocketAddressEnumerator
+
+GSocketAddressEnumerator, struct in GSocketConnectable +
-
GSocketClient
+
+GSocketClient, struct in GSocketClient +
-
GSocketClient:family
+
+GSocketClient:family, object property in GSocketClient +
-
GSocketClient:local-address
+
+GSocketClient:local-address, object property in GSocketClient +
-
GSocketClient:protocol
+
+GSocketClient:protocol, object property in GSocketClient +
-
GSocketClient:type
+
+GSocketClient:type, object property in GSocketClient +
-
GSocketConnectable
+
+GSocketConnectable, struct in GSocketConnectable +
-
GSocketConnectableIface
+
+GSocketConnectableIface, struct in GSocketConnectable +
-
GSocketConnection
+
+GSocketConnection, struct in GSocketConnection +
-
GSocketConnection:socket
+
+GSocketConnection:socket, object property in GSocketConnection +
-
GSocketControlMessage
+
+GSocketControlMessage, struct in GSocketControlMessage +
-
GSocketFamily
+
+GSocketFamily, enum in GSocketAddress +
-
GSocketListener
+
+GSocketListener, struct in GSocketListener +
-
GSocketListener:listen-backlog
+
+GSocketListener:listen-backlog, object property in GSocketListener +
-
GSocketMsgFlags
+
+GSocketMsgFlags, enum in GSocket +
-
GSocketProtocol
+
+GSocketProtocol, enum in GSocket +
-
GSocketService
+
+GSocketService, struct in GSocketService +
-
GSocketService::incoming
+
+GSocketService::incoming, object signal in GSocketService +
-
GSocketSourceFunc
+
+GSocketSourceFunc, user_function in GSocket +
-
GSocketType
+
+GSocketType, enum in GSocket +
-
g_socket_accept
+
+g_socket_accept, function in GSocket +
-
g_socket_address_enumerator_next
+
+g_socket_address_enumerator_next, function in GSocketConnectable +
-
g_socket_address_enumerator_next_async
+
+g_socket_address_enumerator_next_async, function in GSocketConnectable +
-
g_socket_address_enumerator_next_finish
+
+g_socket_address_enumerator_next_finish, function in GSocketConnectable +
-
g_socket_address_get_family
+
+g_socket_address_get_family, function in GSocketAddress +
-
g_socket_address_get_native_size
+
+g_socket_address_get_native_size, function in GSocketAddress +
-
g_socket_address_new_from_native
+
+g_socket_address_new_from_native, function in GSocketAddress +
-
g_socket_address_to_native
+
+g_socket_address_to_native, function in GSocketAddress +
-
g_socket_bind
+
+g_socket_bind, function in GSocket +
-
g_socket_check_connect_result
+
+g_socket_check_connect_result, function in GSocket +
-
g_socket_client_connect
+
+g_socket_client_connect, function in GSocketClient +
-
g_socket_client_connect_async
+
+g_socket_client_connect_async, function in GSocketClient +
-
g_socket_client_connect_finish
+
+g_socket_client_connect_finish, function in GSocketClient +
-
g_socket_client_connect_to_host
+
+g_socket_client_connect_to_host, function in GSocketClient +
-
g_socket_client_connect_to_host_async
+
+g_socket_client_connect_to_host_async, function in GSocketClient +
-
g_socket_client_connect_to_host_finish
+
+g_socket_client_connect_to_host_finish, function in GSocketClient +
-
g_socket_client_connect_to_service
+
+g_socket_client_connect_to_service, function in GSocketClient +
-
g_socket_client_connect_to_service_async
+
+g_socket_client_connect_to_service_async, function in GSocketClient +
-
g_socket_client_connect_to_service_finish
+
+g_socket_client_connect_to_service_finish, function in GSocketClient +
-
g_socket_client_get_family
+
+g_socket_client_get_family, function in GSocketClient +
-
g_socket_client_get_local_address
+
+g_socket_client_get_local_address, function in GSocketClient +
-
g_socket_client_get_protocol
+
+g_socket_client_get_protocol, function in GSocketClient +
-
g_socket_client_get_socket_type
+
+g_socket_client_get_socket_type, function in GSocketClient +
-
g_socket_client_new
+
+g_socket_client_new, function in GSocketClient +
-
g_socket_client_set_family
+
+g_socket_client_set_family, function in GSocketClient +
-
g_socket_client_set_local_address
+
+g_socket_client_set_local_address, function in GSocketClient +
-
g_socket_client_set_protocol
+
+g_socket_client_set_protocol, function in GSocketClient +
-
g_socket_client_set_socket_type
+
+g_socket_client_set_socket_type, function in GSocketClient +
-
g_socket_close
+
+g_socket_close, function in GSocket +
-
g_socket_condition_check
+
+g_socket_condition_check, function in GSocket +
-
g_socket_condition_wait
+
+g_socket_condition_wait, function in GSocket +
-
g_socket_connect
+
+g_socket_connect, function in GSocket +
-
g_socket_connectable_enumerate
+
+g_socket_connectable_enumerate, function in GSocketConnectable +
-
g_socket_connection_factory_create_connection
+
+g_socket_connection_factory_create_connection, function in GSocketConnection +
-
g_socket_connection_factory_lookup_type
+
+g_socket_connection_factory_lookup_type, function in GSocketConnection +
-
g_socket_connection_factory_register_type
+
+g_socket_connection_factory_register_type, function in GSocketConnection +
-
g_socket_connection_get_local_address
+
+g_socket_connection_get_local_address, function in GSocketConnection +
-
g_socket_connection_get_remote_address
+
+g_socket_connection_get_remote_address, function in GSocketConnection +
-
g_socket_connection_get_socket
+
+g_socket_connection_get_socket, function in GSocketConnection +
-
g_socket_control_message_deserialize
+
+g_socket_control_message_deserialize, function in GSocketControlMessage +
-
g_socket_control_message_get_level
+
+g_socket_control_message_get_level, function in GSocketControlMessage +
-
g_socket_control_message_get_msg_type
+
+g_socket_control_message_get_msg_type, function in GSocketControlMessage +
-
g_socket_control_message_get_size
+
+g_socket_control_message_get_size, function in GSocketControlMessage +
-
g_socket_control_message_serialize
+
+g_socket_control_message_serialize, function in GSocketControlMessage +
-
g_socket_create_source
+
+g_socket_create_source, function in GSocket +
-
g_socket_get_blocking
+
+g_socket_get_blocking, function in GSocket +
-
g_socket_get_family
+
+g_socket_get_family, function in GSocket +
-
g_socket_get_fd
+
+g_socket_get_fd, function in GSocket +
-
g_socket_get_keepalive
+
+g_socket_get_keepalive, function in GSocket +
-
g_socket_get_listen_backlog
+
+g_socket_get_listen_backlog, function in GSocket +
-
g_socket_get_local_address
+
+g_socket_get_local_address, function in GSocket +
-
g_socket_get_protocol
+
+g_socket_get_protocol, function in GSocket +
-
g_socket_get_remote_address
+
+g_socket_get_remote_address, function in GSocket +
-
g_socket_get_socket_type
+
+g_socket_get_socket_type, function in GSocket +
-
g_socket_is_closed
+
+g_socket_is_closed, function in GSocket +
-
g_socket_is_connected
+
+g_socket_is_connected, function in GSocket +
-
g_socket_listen
+
+g_socket_listen, function in GSocket +
-
g_socket_listener_accept
+
+g_socket_listener_accept, function in GSocketListener +
-
g_socket_listener_accept_async
+
+g_socket_listener_accept_async, function in GSocketListener +
-
g_socket_listener_accept_finish
+
+g_socket_listener_accept_finish, function in GSocketListener +
-
g_socket_listener_accept_socket
+
+g_socket_listener_accept_socket, function in GSocketListener +
-
g_socket_listener_accept_socket_async
+
+g_socket_listener_accept_socket_async, function in GSocketListener +
-
g_socket_listener_accept_socket_finish
+
+g_socket_listener_accept_socket_finish, function in GSocketListener +
-
g_socket_listener_add_address
+
+g_socket_listener_add_address, function in GSocketListener +
-
g_socket_listener_add_any_inet_port
+
+g_socket_listener_add_any_inet_port, function in GSocketListener +
-
g_socket_listener_add_inet_port
+
+g_socket_listener_add_inet_port, function in GSocketListener +
-
g_socket_listener_add_socket
+
+g_socket_listener_add_socket, function in GSocketListener +
-
g_socket_listener_close
+
+g_socket_listener_close, function in GSocketListener +
-
g_socket_listener_new
+
+g_socket_listener_new, function in GSocketListener +
-
g_socket_listener_set_backlog
+
+g_socket_listener_set_backlog, function in GSocketListener +
-
g_socket_new
+
+g_socket_new, function in GSocket +
-
g_socket_new_from_fd
+
+g_socket_new_from_fd, function in GSocket +
-
g_socket_receive
+
+g_socket_receive, function in GSocket +
-
g_socket_receive_from
+
+g_socket_receive_from, function in GSocket +
-
g_socket_receive_message
+
+g_socket_receive_message, function in GSocket +
-
g_socket_send
+
+g_socket_send, function in GSocket +
-
g_socket_send_message
+
+g_socket_send_message, function in GSocket +
-
g_socket_send_to
+
+g_socket_send_to, function in GSocket +
-
g_socket_service_is_active
+
+g_socket_service_is_active, function in GSocketService +
-
g_socket_service_new
+
+g_socket_service_new, function in GSocketService +
-
g_socket_service_start
+
+g_socket_service_start, function in GSocketService +
-
g_socket_service_stop
+
+g_socket_service_stop, function in GSocketService +
-
g_socket_set_blocking
+
+g_socket_set_blocking, function in GSocket +
-
g_socket_set_keepalive
+
+g_socket_set_keepalive, function in GSocket +
-
g_socket_set_listen_backlog
+
+g_socket_set_listen_backlog, function in GSocket +
-
g_socket_shutdown
+
+g_socket_shutdown, function in GSocket +
-
g_socket_speaks_ipv4
+
+g_socket_speaks_ipv4, function in GSocket +
-
GSrvTarget
+
+GSrvTarget, struct in GSrvTarget +
-
g_srv_target_copy
+
+g_srv_target_copy, function in GSrvTarget +
-
g_srv_target_free
+
+g_srv_target_free, function in GSrvTarget +
-
g_srv_target_get_hostname
+
+g_srv_target_get_hostname, function in GSrvTarget +
-
g_srv_target_get_port
+
+g_srv_target_get_port, function in GSrvTarget +
-
g_srv_target_get_priority
+
+g_srv_target_get_priority, function in GSrvTarget +
-
g_srv_target_get_weight
+
+g_srv_target_get_weight, function in GSrvTarget +
-
g_srv_target_list_sort
+
+g_srv_target_list_sort, function in GSrvTarget +
-
g_srv_target_new
+
+g_srv_target_new, function in GSrvTarget +

T

-
GTcpConnection
+
+GTcpConnection, struct in GSocketConnection +
-
GTcpConnection:graceful-disconnect
+
+GTcpConnection:graceful-disconnect, object property in GSocketConnection +
-
g_tcp_connection_get_graceful_disconnect
+
+g_tcp_connection_get_graceful_disconnect, function in GSocketConnection +
-
g_tcp_connection_set_graceful_disconnect
+
+g_tcp_connection_set_graceful_disconnect, function in GSocketConnection +
-
GThemedIcon
+
+GThemedIcon, struct in GThemedIcon +
-
GThemedIcon:name
+
+GThemedIcon:name, object property in GThemedIcon +
-
GThemedIcon:names
+
+GThemedIcon:names, object property in GThemedIcon +
-
GThemedIcon:use-default-fallbacks
+
+GThemedIcon:use-default-fallbacks, object property in GThemedIcon +
-
g_themed_icon_append_name
+
+g_themed_icon_append_name, function in GThemedIcon +
-
g_themed_icon_get_names
+
+g_themed_icon_get_names, function in GThemedIcon +
-
g_themed_icon_new
+
+g_themed_icon_new, function in GThemedIcon +
-
g_themed_icon_new_from_names
+
+g_themed_icon_new_from_names, function in GThemedIcon +
-
g_themed_icon_new_with_default_fallbacks
+
+g_themed_icon_new_with_default_fallbacks, function in GThemedIcon +
-
g_themed_icon_prepend_name
+
+g_themed_icon_prepend_name, function in GThemedIcon +
-
GThreadedSocketService
+
+GThreadedSocketService, struct in GThreadedSocketService +
-
GThreadedSocketService::run
+
+GThreadedSocketService::run, object signal in GThreadedSocketService +
-
GThreadedSocketService:max-threads
+
+GThreadedSocketService:max-threads, object property in GThreadedSocketService +
-
g_threaded_socket_service_new
+
+g_threaded_socket_service_new, function in GThreadedSocketService +

U

-
GUnixConnection
+
+GUnixConnection, struct in GSocketConnection +
-
GUnixFDList
+
+GUnixFDList, struct in GUnixFDList +
-
GUnixFDMessage
+
+GUnixFDMessage, struct in GUnixFDMessage +
-
GUnixFDMessage:fd-list
+
+GUnixFDMessage:fd-list, object property in GUnixFDMessage +
-
GUnixInputStream
+
+GUnixInputStream, struct in GUnixInputStream +
-
GUnixInputStream:close-fd
+
+GUnixInputStream:close-fd, object property in GUnixInputStream +
-
GUnixInputStream:fd
+
+GUnixInputStream:fd, object property in GUnixInputStream +
-
GUnixMount
+
+GUnixMount, struct in Unix Mounts +
-
GUnixMountEntry
+
+GUnixMountEntry, struct in Unix Mounts +
-
GUnixMountMonitor
+
+GUnixMountMonitor, struct in Unix Mounts +
-
GUnixMountMonitor::mountpoints-changed
+
+GUnixMountMonitor::mountpoints-changed, object signal in Unix Mounts +
-
GUnixMountMonitor::mounts-changed
+
+GUnixMountMonitor::mounts-changed, object signal in Unix Mounts +
-
GUnixMountPoint
+
+GUnixMountPoint, struct in Unix Mounts +
-
GUnixOutputStream
+
+GUnixOutputStream, struct in GUnixOutputStream +
-
GUnixOutputStream:close-fd
+
+GUnixOutputStream:close-fd, object property in GUnixOutputStream +
-
GUnixOutputStream:fd
+
+GUnixOutputStream:fd, object property in GUnixOutputStream +
-
GUnixSocketAddress
+
+GUnixSocketAddress, struct in GUnixSocketAddress +
-
GUnixSocketAddress:abstract
+
+GUnixSocketAddress:abstract, object property in GUnixSocketAddress +
-
GUnixSocketAddress:path
+
+GUnixSocketAddress:path, object property in GUnixSocketAddress +
-
GUnixSocketAddress:path-as-array
+
+GUnixSocketAddress:path-as-array, object property in GUnixSocketAddress +
-
g_unix_connection_receive_fd
+
+g_unix_connection_receive_fd, function in GSocketConnection +
-
g_unix_connection_send_fd
+
+g_unix_connection_send_fd, function in GSocketConnection +
-
g_unix_fd_list_append
+
+g_unix_fd_list_append, function in GUnixFDList +
-
g_unix_fd_list_get
+
+g_unix_fd_list_get, function in GUnixFDList +
-
g_unix_fd_list_get_length
+
+g_unix_fd_list_get_length, function in GUnixFDList +
-
g_unix_fd_list_new
+
+g_unix_fd_list_new, function in GUnixFDList +
-
g_unix_fd_list_new_from_array
+
+g_unix_fd_list_new_from_array, function in GUnixFDList +
-
g_unix_fd_list_peek_fds
+
+g_unix_fd_list_peek_fds, function in GUnixFDList +
-
g_unix_fd_list_steal_fds
+
+g_unix_fd_list_steal_fds, function in GUnixFDList +
-
g_unix_fd_message_append_fd
+
+g_unix_fd_message_append_fd, function in GUnixFDMessage +
-
g_unix_fd_message_get_fd_list
+
+g_unix_fd_message_get_fd_list, function in GUnixFDMessage +
-
g_unix_fd_message_new
+
+g_unix_fd_message_new, function in GUnixFDMessage +
-
g_unix_fd_message_new_with_fd_list
+
+g_unix_fd_message_new_with_fd_list, function in GUnixFDMessage +
-
g_unix_fd_message_steal_fds
+
+g_unix_fd_message_steal_fds, function in GUnixFDMessage +
-
g_unix_input_stream_get_close_fd
+
+g_unix_input_stream_get_close_fd, function in GUnixInputStream +
-
g_unix_input_stream_get_fd
+
+g_unix_input_stream_get_fd, function in GUnixInputStream +
-
g_unix_input_stream_new
+
+g_unix_input_stream_new, function in GUnixInputStream +
-
g_unix_input_stream_set_close_fd
+
+g_unix_input_stream_set_close_fd, function in GUnixInputStream +
-
g_unix_is_mount_path_system_internal
+
+g_unix_is_mount_path_system_internal, function in Unix Mounts +
-
g_unix_mounts_changed_since
+
+g_unix_mounts_changed_since, function in Unix Mounts +
-
g_unix_mounts_get
+
+g_unix_mounts_get, function in Unix Mounts +
-
g_unix_mount_at
+
+g_unix_mount_at, function in Unix Mounts +
-
g_unix_mount_compare
+
+g_unix_mount_compare, function in Unix Mounts +
-
g_unix_mount_free
+
+g_unix_mount_free, function in Unix Mounts +
-
g_unix_mount_get_device_path
+
+g_unix_mount_get_device_path, function in Unix Mounts +
-
g_unix_mount_get_fs_type
+
+g_unix_mount_get_fs_type, function in Unix Mounts +
-
g_unix_mount_get_mount_path
+
+g_unix_mount_get_mount_path, function in Unix Mounts +
-
g_unix_mount_guess_can_eject
+
+g_unix_mount_guess_can_eject, function in Unix Mounts +
-
g_unix_mount_guess_icon
+
+g_unix_mount_guess_icon, function in Unix Mounts +
-
g_unix_mount_guess_name
+
+g_unix_mount_guess_name, function in Unix Mounts +
-
g_unix_mount_guess_should_display
+
+g_unix_mount_guess_should_display, function in Unix Mounts +
-
g_unix_mount_is_readonly
+
+g_unix_mount_is_readonly, function in Unix Mounts +
-
g_unix_mount_is_system_internal
+
+g_unix_mount_is_system_internal, function in Unix Mounts +
-
g_unix_mount_monitor_new
+
+g_unix_mount_monitor_new, function in Unix Mounts +
-
g_unix_mount_monitor_set_rate_limit
+
+g_unix_mount_monitor_set_rate_limit, function in Unix Mounts +
-
g_unix_mount_points_changed_since
+
+g_unix_mount_points_changed_since, function in Unix Mounts +
-
g_unix_mount_points_get
+
+g_unix_mount_points_get, function in Unix Mounts +
-
g_unix_mount_point_compare
+
+g_unix_mount_point_compare, function in Unix Mounts +
-
g_unix_mount_point_free
+
+g_unix_mount_point_free, function in Unix Mounts +
-
g_unix_mount_point_get_device_path
+
+g_unix_mount_point_get_device_path, function in Unix Mounts +
-
g_unix_mount_point_get_fs_type
+
+g_unix_mount_point_get_fs_type, function in Unix Mounts +
-
g_unix_mount_point_get_mount_path
+
+g_unix_mount_point_get_mount_path, function in Unix Mounts +
-
g_unix_mount_point_guess_can_eject
+
+g_unix_mount_point_guess_can_eject, function in Unix Mounts +
-
g_unix_mount_point_guess_icon
+
+g_unix_mount_point_guess_icon, function in Unix Mounts +
-
g_unix_mount_point_guess_name
+
+g_unix_mount_point_guess_name, function in Unix Mounts +
-
g_unix_mount_point_is_loopback
+
+g_unix_mount_point_is_loopback, function in Unix Mounts +
-
g_unix_mount_point_is_readonly
+
+g_unix_mount_point_is_readonly, function in Unix Mounts +
-
g_unix_mount_point_is_user_mountable
+
+g_unix_mount_point_is_user_mountable, function in Unix Mounts +
-
g_unix_output_stream_get_close_fd
+
+g_unix_output_stream_get_close_fd, function in GUnixOutputStream +
-
g_unix_output_stream_get_fd
+
+g_unix_output_stream_get_fd, function in GUnixOutputStream +
-
g_unix_output_stream_new
+
+g_unix_output_stream_new, function in GUnixOutputStream +
-
g_unix_output_stream_set_close_fd
+
+g_unix_output_stream_set_close_fd, function in GUnixOutputStream +
-
g_unix_socket_address_abstract_names_supported
+
+g_unix_socket_address_abstract_names_supported, function in GUnixSocketAddress +
-
g_unix_socket_address_get_is_abstract
+
+g_unix_socket_address_get_is_abstract, function in GUnixSocketAddress +
-
g_unix_socket_address_get_path
+
+g_unix_socket_address_get_path, function in GUnixSocketAddress +
-
g_unix_socket_address_get_path_len
+
+g_unix_socket_address_get_path_len, function in GUnixSocketAddress +
-
g_unix_socket_address_new
+
+g_unix_socket_address_new, function in GUnixSocketAddress +
-
g_unix_socket_address_new_abstract
+
+g_unix_socket_address_new_abstract, function in GUnixSocketAddress +

V

-
GVfs
+
+GVfs, struct in GVfs +
-
G_VFS_EXTENSION_POINT_NAME
+
+G_VFS_EXTENSION_POINT_NAME, macro in GVfs +
-
g_vfs_get_default
+
+g_vfs_get_default, function in GVfs +
-
g_vfs_get_file_for_path
+
+g_vfs_get_file_for_path, function in GVfs +
-
g_vfs_get_file_for_uri
+
+g_vfs_get_file_for_uri, function in GVfs +
-
g_vfs_get_local
+
+g_vfs_get_local, function in GVfs +
-
g_vfs_get_supported_uri_schemes
+
+g_vfs_get_supported_uri_schemes, function in GVfs +
-
g_vfs_is_active
+
+g_vfs_is_active, function in GVfs +
-
g_vfs_parse_name
+
+g_vfs_parse_name, function in GVfs +
-
GVolume
+
+GVolume, struct in GVolume +
-
GVolume::changed
+
+GVolume::changed, object signal in GVolume +
-
GVolume::removed
+
+GVolume::removed, object signal in GVolume +
-
GVolumeIface
+
+GVolumeIface, struct in GVolume +
-
GVolumeMonitor
+
+GVolumeMonitor, struct in GVolumeMonitor +
-
GVolumeMonitor::drive-changed
+
+GVolumeMonitor::drive-changed, object signal in GVolumeMonitor +
-
GVolumeMonitor::drive-connected
+
+GVolumeMonitor::drive-connected, object signal in GVolumeMonitor +
-
GVolumeMonitor::drive-disconnected
+
+GVolumeMonitor::drive-disconnected, object signal in GVolumeMonitor +
-
GVolumeMonitor::drive-eject-button
+
+GVolumeMonitor::drive-eject-button, object signal in GVolumeMonitor +
-
GVolumeMonitor::drive-stop-button
+
+GVolumeMonitor::drive-stop-button, object signal in GVolumeMonitor +
-
GVolumeMonitor::mount-added
+
+GVolumeMonitor::mount-added, object signal in GVolumeMonitor +
-
GVolumeMonitor::mount-changed
+
+GVolumeMonitor::mount-changed, object signal in GVolumeMonitor +
-
GVolumeMonitor::mount-pre-unmount
+
+GVolumeMonitor::mount-pre-unmount, object signal in GVolumeMonitor +
-
GVolumeMonitor::mount-removed
+
+GVolumeMonitor::mount-removed, object signal in GVolumeMonitor +
-
GVolumeMonitor::volume-added
+
+GVolumeMonitor::volume-added, object signal in GVolumeMonitor +
-
GVolumeMonitor::volume-changed
+
+GVolumeMonitor::volume-changed, object signal in GVolumeMonitor +
-
GVolumeMonitor::volume-removed
+
+GVolumeMonitor::volume-removed, object signal in GVolumeMonitor +
-
g_volume_can_eject
+
+g_volume_can_eject, function in GVolume +
-
g_volume_can_mount
+
+g_volume_can_mount, function in GVolume +
-
g_volume_eject
+
+g_volume_eject, function in GVolume +
-
g_volume_eject_finish
+
+g_volume_eject_finish, function in GVolume +
-
g_volume_eject_with_operation
+
+g_volume_eject_with_operation, function in GVolume +
-
g_volume_eject_with_operation_finish
+
+g_volume_eject_with_operation_finish, function in GVolume +
-
g_volume_enumerate_identifiers
+
+g_volume_enumerate_identifiers, function in GVolume +
-
g_volume_get_activation_root
+
+g_volume_get_activation_root, function in GVolume +
-
g_volume_get_drive
+
+g_volume_get_drive, function in GVolume +
-
g_volume_get_icon
+
+g_volume_get_icon, function in GVolume +
-
g_volume_get_identifier
+
+g_volume_get_identifier, function in GVolume +
-
g_volume_get_mount
+
+g_volume_get_mount, function in GVolume +
-
g_volume_get_name
+
+g_volume_get_name, function in GVolume +
-
g_volume_get_uuid
+
+g_volume_get_uuid, function in GVolume +
-
G_VOLUME_IDENTIFIER_KIND_HAL_UDI
+
+G_VOLUME_IDENTIFIER_KIND_HAL_UDI, macro in GVolume +
-
G_VOLUME_IDENTIFIER_KIND_LABEL
+
+G_VOLUME_IDENTIFIER_KIND_LABEL, macro in GVolume +
-
G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT
+
+G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT, macro in GVolume +
-
G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE
+
+G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE, macro in GVolume +
-
G_VOLUME_IDENTIFIER_KIND_UUID
+
+G_VOLUME_IDENTIFIER_KIND_UUID, macro in GVolume +
-
g_volume_monitor_adopt_orphan_mount
+
+g_volume_monitor_adopt_orphan_mount, function in GVolumeMonitor +
-
G_VOLUME_MONITOR_EXTENSION_POINT_NAME
+
+G_VOLUME_MONITOR_EXTENSION_POINT_NAME, macro in GVolumeMonitor +
-
g_volume_monitor_get
+
+g_volume_monitor_get, function in GVolumeMonitor +
-
g_volume_monitor_get_connected_drives
+
+g_volume_monitor_get_connected_drives, function in GVolumeMonitor +
-
g_volume_monitor_get_mounts
+
+g_volume_monitor_get_mounts, function in GVolumeMonitor +
-
g_volume_monitor_get_mount_for_uuid
+
+g_volume_monitor_get_mount_for_uuid, function in GVolumeMonitor +
-
g_volume_monitor_get_volumes
+
+g_volume_monitor_get_volumes, function in GVolumeMonitor +
-
g_volume_monitor_get_volume_for_uuid
+
+g_volume_monitor_get_volume_for_uuid, function in GVolumeMonitor +
-
g_volume_mount
+
+g_volume_mount, function in GVolume +
-
g_volume_mount_finish
+
+g_volume_mount_finish, function in GVolume +
-
g_volume_should_automount
+
+g_volume_should_automount, function in GVolume +

Z

-
GZlibCompressor
+
+GZlibCompressor, struct in GZlibCompressor +
-
GZlibCompressor:format
+
+GZlibCompressor:format, object property in GZlibCompressor +
-
GZlibCompressor:level
+
+GZlibCompressor:level, object property in GZlibCompressor +
-
GZlibCompressorFormat
+
+GZlibCompressorFormat, enum in GZlibCompressor +
-
GZlibDecompressor
+
+GZlibDecompressor, struct in GZlibDecompressor +
-
GZlibDecompressor:format
+
+GZlibDecompressor:format, object property in GZlibDecompressor +
-
g_zlib_compressor_new
+
+g_zlib_compressor_new, function in GZlibCompressor +
-
g_zlib_decompressor_new
+
+g_zlib_decompressor_new, function in GZlibDecompressor +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/async.html b/docs/reference/gio/html/async.html index 838d407..eaa808d 100644 --- a/docs/reference/gio/html/async.html +++ b/docs/reference/gio/html/async.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -69,6 +39,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch01.html b/docs/reference/gio/html/ch01.html index 473cf8e..e4e75f1 100644 --- a/docs/reference/gio/html/ch01.html +++ b/docs/reference/gio/html/ch01.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Introduction

+Introduction

GIO is striving to provide a modern, easy-to-use VFS API that sits at the right level in the library stack. The goal is to overcome the @@ -196,6 +166,6 @@

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch02.html b/docs/reference/gio/html/ch02.html index e805d21..c3c6a88 100644 --- a/docs/reference/gio/html/ch02.html +++ b/docs/reference/gio/html/ch02.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Compiling GIO applications

+Compiling GIO applications

GIO comes with a gio-2.0.pc file that you should use together with pkg-config to obtain @@ -70,6 +40,6 @@

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch03.html b/docs/reference/gio/html/ch03.html index f3fe54d..59491d7 100644 --- a/docs/reference/gio/html/ch03.html +++ b/docs/reference/gio/html/ch03.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Running GIO applications

+Running GIO applications

GIO inspects a few of environment variables in addition to the ones used by GLib. @@ -105,6 +75,6 @@

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch19.html b/docs/reference/gio/html/ch19.html index cfe83de..0322a87 100644 --- a/docs/reference/gio/html/ch19.html +++ b/docs/reference/gio/html/ch19.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Migrating from POSIX to GIO

+Migrating from POSIX to GIO

Table 4. Comparison of POSIX and GIO concepts

@@ -100,6 +70,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch20.html b/docs/reference/gio/html/ch20.html index 64e754f..fe66490 100644 --- a/docs/reference/gio/html/ch20.html +++ b/docs/reference/gio/html/ch20.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -51,9 +21,9 @@

-Migrating from GnomeVFS to GIO

+Migrating from GnomeVFS to GIO
@@ -126,7 +96,7 @@

-Trash handling

+Trash handling

The handling of trashed files has been changed in GIO, compared to gnome-vfs. gnome-vfs has a home-grown trash implementation that @@ -146,42 +116,83 @@ implementation has been moved to gvfs and applications can simply monitor that location:

-
-static void
-file_changed (GFileMonitor      *file_monitor,
-              GFile             *child,
-              GFile             *other_file,
-              GFileMonitorEvent  event_type,
-              gpointer           user_data)
-{
-  switch (event_type)
-  {
-  case G_FILE_MONITOR_EVENT_DELETED:
-    g_print ("'%s' removed from trash\n", g_file_get_basename (child));
-    break;
-  case G_FILE_MONITOR_EVENT_CREATED:
-    g_print ("'%s' added to trash\n", g_file_get_basename (child));
-    break;
-  default: ;
-  }
-}
+
+ + + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
static void
+file_changed (GFileMonitor      *file_monitor,
+              GFile             *child,
+              GFile             *other_file,
+              GFileMonitorEvent  event_type,
+              gpointer           user_data)
+{
+  switch (event_type)
+  {
+  case G_FILE_MONITOR_EVENT_DELETED:
+    g_print ("'%s' removed from trash\n", g_file_get_basename (child));
+    break;
+  case G_FILE_MONITOR_EVENT_CREATED:
+    g_print ("'%s' added to trash\n", g_file_get_basename (child));
+    break;
+  default: ;
+  }
+}
 
-static void
-start_monitoring_trash (void)
-{
-  GFile *file;
-  GFileMonitor *monitor;
+static void
+start_monitoring_trash (void)
+{
+  GFile *file;
+  GFileMonitor *monitor;
 
-  file = g_file_new_for_uri ("trash://");
-  monitor = g_file_monitor_directory (file, 0, NULL, NULL);
-  g_object_unref (file);
+  file = g_file_new_for_uri ("trash://");
+  monitor = g_file_monitor_directory (file, 0, NULL, NULL);
+  g_object_unref (file);
 
-  g_signal_connect (monitor, "changed", G_CALLBACK (file_changed), NULL);
+  g_signal_connect (monitor, "changed", G_CALLBACK (file_changed), NULL);
 
-  /* ... */
+  /* ... */
+
+}
+
-} -

GIO exposes some useful metadata about trashed files. There are trash::orig-path and trash::deletion-date attributes. The @@ -193,7 +204,7 @@ start_monitoring_trash (void)

Moving a file to the trash is much simpler with GIO. Instead of - using gnome_vfs_find_directory() with GNOME_VFS_DIRECTORY_KIND_TRASH + using gnome_vfs_find_directory() with GNOME_VFS_DIRECTORY_KIND_TRASH to find out where to move the trashed file, just use the g_file_trash() function.

@@ -201,6 +212,6 @@ start_monitoring_trash (void) + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch20s02.html b/docs/reference/gio/html/ch20s02.html index 0d9a20d..3ea36e3 100644 --- a/docs/reference/gio/html/ch20s02.html +++ b/docs/reference/gio/html/ch20s02.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,9 +21,9 @@

-Operations on multiple files

+Operations on multiple files

- gnome-vfs has the dreaded gnome_vfs_xfer_uri_list() function which + gnome-vfs has the dreaded gnome_vfs_xfer_uri_list() function which has tons of options and offers the equivalent of cp, mv, ln, mkdir and rm at the same time.

@@ -66,6 +36,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/ch20s03.html b/docs/reference/gio/html/ch20s03.html index b8728f1..e99f772 100644 --- a/docs/reference/gio/html/ch20s03.html +++ b/docs/reference/gio/html/ch20s03.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,19 +21,19 @@

-Mime monitoring

+Mime monitoring

gnome-vfs offered a way to monitor the association between mime types - and default handlers for changes, with the GnomeVFSMIMEMonitor object. + and default handlers for changes, with the GnomeVFSMIMEMonitor object. GIO does not offer a replacement for this functionality at this time, since we have not found a compelling use case where - GnomeVFSMIMEMonitor was used. If you think you have such a use + GnomeVFSMIMEMonitor was used. If you think you have such a use case, please report it at bugzilla.gnome.org.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/conversion.html b/docs/reference/gio/html/conversion.html index 368da21..89618e1 100644 --- a/docs/reference/gio/html/conversion.html +++ b/docs/reference/gio/html/conversion.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -69,6 +39,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/extending-gio.html b/docs/reference/gio/html/extending-gio.html index 3844b25..cb5a8f9 100644 --- a/docs/reference/gio/html/extending-gio.html +++ b/docs/reference/gio/html/extending-gio.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -121,6 +91,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/extending.html b/docs/reference/gio/html/extending.html index c127e44..91993cd 100644 --- a/docs/reference/gio/html/extending.html +++ b/docs/reference/gio/html/extending.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -66,6 +36,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/failable_initialization.html b/docs/reference/gio/html/failable_initialization.html index 200f506..ff64899 100644 --- a/docs/reference/gio/html/failable_initialization.html +++ b/docs/reference/gio/html/failable_initialization.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -63,6 +33,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/file_mon.html b/docs/reference/gio/html/file_mon.html index 057539c..6a31df8 100644 --- a/docs/reference/gio/html/file_mon.html +++ b/docs/reference/gio/html/file_mon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -58,6 +28,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/file_ops.html b/docs/reference/gio/html/file_ops.html index 90c02d4..b078511 100644 --- a/docs/reference/gio/html/file_ops.html +++ b/docs/reference/gio/html/file_ops.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -75,6 +45,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-Desktop-file-based-GAppInfo.html b/docs/reference/gio/html/gio-Desktop-file-based-GAppInfo.html index d7d1af3..e93ea09 100644 --- a/docs/reference/gio/html/gio-Desktop-file-based-GAppInfo.html +++ b/docs/reference/gio/html/gio-Desktop-file-based-GAppInfo.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -78,23 +48,23 @@ GDesktopAppInfo; GDesktopAppInfo * g_desktop_app_info_new_from_filename - (const char *filename); -GDesktopAppInfo * g_desktop_app_info_new_from_keyfile (GKeyFile *key_file); -GDesktopAppInfo * g_desktop_app_info_new (const char *desktop_id); -const char * g_desktop_app_info_get_filename (GDesktopAppInfo *info); -gbooleang_desktop_app_info_get_is_hidden (GDesktopAppInfo *info); -voidg_desktop_app_info_set_desktop_env (const char *desktop_env); + (const char *filename); +GDesktopAppInfo * g_desktop_app_info_new_from_keyfile (GKeyFile *key_file); +GDesktopAppInfo * g_desktop_app_info_new (const char *desktop_id); +const char * g_desktop_app_info_get_filename (GDesktopAppInfo *info); +gbooleang_desktop_app_info_get_is_hidden (GDesktopAppInfo *info); +voidg_desktop_app_info_set_desktop_env (const char *desktop_env); GDesktopAppInfoLookup; #define G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAMEGAppInfo * g_desktop_app_info_lookup_get_default_for_uri_scheme - (GDesktopAppInfoLookup *lookup, - const char *uri_scheme); + (GDesktopAppInfoLookup *lookup, + const char *uri_scheme);

Object Hierarchy

-  GObject
+  GObject
    +----GDesktopAppInfo
 
@@ -106,7 +76,7 @@ const char *        

Prerequisites

GDesktopAppInfoLookup requires - GObject.

+ GObject.

Implemented Interfaces

@@ -123,7 +93,8 @@ desktop files.

Note that <gio/gdesktopappinfo.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the -gio-unix-2.0.pc pkg-config file when using it.

+gio-unix-2.0.pc pkg-config file when using it. +

Details

@@ -131,26 +102,28 @@ the UNIX-specific GIO interfaces, thus you have to use the

GDesktopAppInfo

typedef struct _GDesktopAppInfo GDesktopAppInfo;

-Information about an installed application from a desktop file.

+Information about an installed application from a desktop file. +


g_desktop_app_info_new_from_filename ()

GDesktopAppInfo *   g_desktop_app_info_new_from_filename
-                                                        (const char *filename);
+ (const char *filename);

-Creates a new GDesktopAppInfo.

+Creates a new GDesktopAppInfo. +

- - @@ -159,20 +132,21 @@ Creates a new

g_desktop_app_info_new_from_keyfile ()

-
GDesktopAppInfo *   g_desktop_app_info_new_from_keyfile (GKeyFile *key_file);
+
GDesktopAppInfo *   g_desktop_app_info_new_from_keyfile (GKeyFile *key_file);

-Creates a new GDesktopAppInfo.

+Creates a new GDesktopAppInfo. +

filename :

the path of a desktop file, in the GLib filename encoding +the path of a desktop file, in the GLib filename encoding

Returns :

a new GDesktopAppInfo or NULL on error. + a new GDesktopAppInfo or NULL on error.
- - @@ -183,7 +157,7 @@ Creates a new

g_desktop_app_info_new ()

-
GDesktopAppInfo *   g_desktop_app_info_new              (const char *desktop_id);
+
GDesktopAppInfo *   g_desktop_app_info_new              (const char *desktop_id);

Creates a new GDesktopAppInfo based on a desktop file id.

@@ -196,18 +170,19 @@ directories (i.e. the directories specified in the variables). GIO also supports the prefix-to-subdirectory mapping that is described in the Menu Spec (i.e. a desktop id of kde-foo.desktop will match -/usr/share/applications/kde/foo.desktop).

+/usr/share/applications/kde/foo.desktop). +

key_file :

an opened GKeyFile +an opened GKeyFile

Returns :

a new GDesktopAppInfo or NULL on error. + a new GDesktopAppInfo or NULL on error.
- - @@ -216,22 +191,23 @@ described in the

g_desktop_app_info_get_filename ()

-
const char *        g_desktop_app_info_get_filename     (GDesktopAppInfo *info);
+
const char *        g_desktop_app_info_get_filename     (GDesktopAppInfo *info);

When info was created from a known filename, return it. In some situations such as the GDesktopAppInfo returned from -g_desktop_app_info_new_from_keyfile(), this function will return NULL.

+g_desktop_app_info_new_from_keyfile(), this function will return NULL. +

desktop_id :

the desktop file id +the desktop file id

Returns :

a new GDesktopAppInfo, or NULL if no desktop file with that id + a new GDesktopAppInfo, or NULL if no desktop file with that id
- - @@ -241,21 +217,22 @@ situations such as the

g_desktop_app_info_get_is_hidden ()

-
gboolean            g_desktop_app_info_get_is_hidden    (GDesktopAppInfo *info);
+
gboolean            g_desktop_app_info_get_is_hidden    (GDesktopAppInfo *info);

A desktop file is hidden if the Hidden key in it is -set to True.

+set to True. +

info :

a GDesktopAppInfo +a GDesktopAppInfo

Returns :

The full path to the file for info, or NULL if not known. + The full path to the file for info, or NULL if not known.
- - @@ -264,7 +241,7 @@ set to True.


g_desktop_app_info_set_desktop_env ()

-
void                g_desktop_app_info_set_desktop_env  (const char *desktop_env);
+
void                g_desktop_app_info_set_desktop_env  (const char *desktop_env);

Sets the name of the desktop that the application is running in. This is used by g_app_info_should_show() to evaluate the @@ -285,12 +262,13 @@ Menu specification recognizes the following:

-Should be called only once; subsequent calls are ignored.

+Should be called only once; subsequent calls are ignored. +

info :

a GDesktopAppInfo. +a GDesktopAppInfo.

Returns :

TRUE if hidden, FALSE otherwise. + TRUE if hidden, FALSE otherwise.
-

desktop_env :

a string specifying what desktop this is +a string specifying what desktop this is
@@ -301,7 +279,8 @@ Should be called only once; subsequent calls are ignored.

typedef struct _GDesktopAppInfoLookup GDesktopAppInfoLookup;

Interface that is used by backends to associate default -handlers with URI schemes.

+handlers with URI schemes. +


@@ -310,14 +289,15 @@ handlers with URI schemes.

Extension point for default handler to URI association. See -Extending GIO.

+Extending GIO. +


g_desktop_app_info_lookup_get_default_for_uri_scheme ()

GAppInfo *          g_desktop_app_info_lookup_get_default_for_uri_scheme
-                                                        (GDesktopAppInfoLookup *lookup,
-                                                         const char *uri_scheme);
+ (GDesktopAppInfoLookup *lookup, + const char *uri_scheme);

Gets the default application for launching applications using this URI scheme for a particular GDesktopAppInfoLookup @@ -327,23 +307,24 @@ implementation. The GDesktopAppInfoLookup interface and this function is used to implement g_app_info_get_default_for_uri_scheme() backends in a GIO module. There is no reason for applications to use it -directly. Applications should use g_app_info_get_default_for_uri_scheme().

+directly. Applications should use g_app_info_get_default_for_uri_scheme(). +

- - - @@ -353,6 +334,6 @@ directly. Applications should use
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-Extension-Points.html b/docs/reference/gio/html/gio-Extension-Points.html index c85a5f3..e94266f 100644 --- a/docs/reference/gio/html/gio-Extension-Points.html +++ b/docs/reference/gio/html/gio-Extension-Points.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

lookup :

a GDesktopAppInfoLookup +a GDesktopAppInfoLookup

uri_scheme :

a string containing a URI scheme. +a string containing a URI scheme.

Returns :

GAppInfo for given uri_scheme or NULL on error. + GAppInfo for given uri_scheme or NULL on error.
@@ -72,25 +42,25 @@ GIOExtension; GIOExtensionPoint; -const char * g_io_extension_get_name (GIOExtension *extension); -gintg_io_extension_get_priority (GIOExtension *extension); -GTypeg_io_extension_get_type (GIOExtension *extension); +const char * g_io_extension_get_name (GIOExtension *extension); +gintg_io_extension_get_priority (GIOExtension *extension); +GTypeg_io_extension_get_type (GIOExtension *extension); GIOExtension * g_io_extension_point_get_extension_by_name - (GIOExtensionPoint *extension_point, - const char *name); -GList * g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point); -GTypeg_io_extension_point_get_required_type - (GIOExtensionPoint *extension_point); -GIOExtension * g_io_extension_point_implement (const char *extension_point_name, - GType type, - const char *extension_name, - gint priority); -GIOExtensionPoint * g_io_extension_point_lookup (const char *name); -GIOExtensionPoint * g_io_extension_point_register (const char *name); + (GIOExtensionPoint *extension_point, + const char *name); +GList * g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point); +GTypeg_io_extension_point_get_required_type + (GIOExtensionPoint *extension_point); +GIOExtension * g_io_extension_point_implement (const char *extension_point_name, + GType type, + const char *extension_name, + gint priority); +GIOExtensionPoint * g_io_extension_point_lookup (const char *name); +GIOExtensionPoint * g_io_extension_point_register (const char *name); voidg_io_extension_point_set_required_type - (GIOExtensionPoint *extension_point, - GType type); -GTypeClass* g_io_extension_ref_class (GIOExtension *extension); + (GIOExtensionPoint *extension_point, + GType type); +GTypeClass* g_io_extension_ref_class (GIOExtension *extension);
@@ -108,32 +78,57 @@ extension point, and GType +A module can implement an extension point by specifying the GType that implements the functionality. Additionally, each implementation of an extension point has a name, and a priority. Use g_io_extension_point_implement() to implement an extension point.

-
- GIOExtensionPoint *ep;
+
+
+ + + + + + +
1
+2
+3
+4
+5
GIOExtensionPoint *ep;
+
+/* Register an extension point */
+ep = g_io_extension_point_register ("my-extension-point");
+g_io_extension_point_set_required_type (ep, MY_TYPE_EXAMPLE);
+
- /* Register an extension point */ - ep = g_io_extension_point_register ("my-extension-point"); - g_io_extension_point_set_required_type (ep, MY_TYPE_EXAMPLE); -

-
- /* Implement an extension point */
- G_DEFINE_TYPE (MyExampleImpl, my_example_impl, MY_TYPE_EXAMPLE);
- g_io_extension_point_implement ("my-extension-point",
-                                 my_example_impl_get_type (),
-                                 "my-example",
-                                 10);
- 
+
+ + + + + + + +
1
+2
+3
+4
+5
+6
/* Implement an extension point */
+G_DEFINE_TYPE (MyExampleImpl, my_example_impl, MY_TYPE_EXAMPLE);
+g_io_extension_point_implement ("my-extension-point",
+                                my_example_impl_get_type (),
+                                "my-example",
+                                10);
+
+

@@ -141,7 +136,8 @@ of an extension point has a name, and a priority. Use it uses the implementations that have been associated with it. Depending on the use case, it may use all implementations, or only the one with the highest priority, or pick a specific - one by name.

+ one by name. +

Details

@@ -161,19 +157,20 @@ of an extension point has a name, and a priority. Use

g_io_extension_get_name ()

-
const char *        g_io_extension_get_name             (GIOExtension *extension);
+
const char *        g_io_extension_get_name             (GIOExtension *extension);

Gets the name under which extension was registered.

Note that the same type may be registered as extension -for multiple extension points, under different names.

+for multiple extension points, under different names. +

- @@ -187,15 +184,16 @@ for multiple extension points, under different names.


g_io_extension_get_priority ()

-
gint                g_io_extension_get_priority         (GIOExtension *extension);
+
gint                g_io_extension_get_priority         (GIOExtension *extension);

-Gets the priority with which extension was registered.

+Gets the priority with which extension was registered. +

extension :

a GIOExtension +a GIOExtension
- @@ -209,15 +207,16 @@ Gets the priority with which extension w

g_io_extension_get_type ()

-
GType               g_io_extension_get_type             (GIOExtension *extension);
+
GType               g_io_extension_get_type             (GIOExtension *extension);

-Gets the type associated with extension.

+Gets the type associated with extension. +

extension :

a GIOExtension +a GIOExtension
- @@ -232,27 +231,28 @@ Gets the type associated with extension.

g_io_extension_point_get_extension_by_name ()

GIOExtension *      g_io_extension_point_get_extension_by_name
-                                                        (GIOExtensionPoint *extension_point,
-                                                         const char *name);
+ (GIOExtensionPoint *extension_point, + const char *name);

-Finds a GIOExtension for an extension point by name.

+Finds a GIOExtension for an extension point by name. +

extension :

a GIOExtension +a GIOExtension
- - @@ -261,21 +261,22 @@ Finds a

g_io_extension_point_get_extensions ()

-
GList *             g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point);
+
GList *             g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point);

Gets a list of all extensions that implement this extension point. -The list is sorted by priority, beginning with the highest priority.

+The list is sorted by priority, beginning with the highest priority. +

extension_point :

a GIOExtensionPoint +a GIOExtensionPoint

name :

the name of the extension to get +the name of the extension to get

Returns :

the GIOExtension for extension_point that has the - given name, or NULL if there is no extension with that name + given name, or NULL if there is no extension with that name
- - @@ -285,22 +286,23 @@ The list is sorted by priority, beginning with the highest priority.


g_io_extension_point_get_required_type ()

-
GType               g_io_extension_point_get_required_type
-                                                        (GIOExtensionPoint *extension_point);
+
GType               g_io_extension_point_get_required_type
+                                                        (GIOExtensionPoint *extension_point);

-Gets the required type for extension_point.

+Gets the required type for extension_point. +

extension_point :

a GIOExtensionPoint +a GIOExtensionPoint

Returns :

a GList of GIOExtensions. The list is owned by + a GList of GIOExtensions. The list is owned by GIO and should not be modified
- - @@ -309,43 +311,44 @@ Gets the required type for extension_point

g_io_extension_point_implement ()

-
GIOExtension *      g_io_extension_point_implement      (const char *extension_point_name,
-                                                         GType type,
-                                                         const char *extension_name,
-                                                         gint priority);
+
GIOExtension *      g_io_extension_point_implement      (const char *extension_point_name,
+                                                         GType type,
+                                                         const char *extension_name,
+                                                         gint priority);

Registers type as extension for the extension point with name extension_point_name.

If type has already been registered as an extension for this -extension point, the existing GIOExtension object is returned.

+extension point, the existing GIOExtension object is returned. +

extension_point :

a GIOExtensionPoint +a GIOExtensionPoint

Returns :

the GType that all implementations must have, - or G_TYPE_INVALID if the extension point has no required type + the GType that all implementations must have, + or G_TYPE_INVALID if the extension point has no required type
- - - - - @@ -354,20 +357,21 @@ extension point, the existing

g_io_extension_point_lookup ()

-
GIOExtensionPoint * g_io_extension_point_lookup         (const char *name);
+
GIOExtensionPoint * g_io_extension_point_lookup         (const char *name);

-Looks up an existing extension point.

+Looks up an existing extension point. +

extension_point_name :

the name of the extension point +the name of the extension point

type :

the GType to register as extension +the GType to register as extension

extension_name :

the name for the extension +the name for the extension

priority :

the priority for the extension +the priority for the extension

Returns :

a GIOExtension object for GType + a GIOExtension object for GType
- - @@ -377,15 +381,16 @@ Looks up an existing extension point.


g_io_extension_point_register ()

-
GIOExtensionPoint * g_io_extension_point_register       (const char *name);
+
GIOExtensionPoint * g_io_extension_point_register       (const char *name);

-Registers an extension point.

+Registers an extension point. +

name :

the name of the extension point +the name of the extension point

Returns :

the GIOExtensionPoint, or NULL if there is no + the GIOExtensionPoint, or NULL if there is no registered extension point with the given name
- @@ -401,22 +406,23 @@ Registers an extension point.

g_io_extension_point_set_required_type ()

void                g_io_extension_point_set_required_type
-                                                        (GIOExtensionPoint *extension_point,
-                                                         GType type);
+ (GIOExtensionPoint *extension_point, + GType type);

Sets the required type for extension_point to type. -All implementations must henceforth have this type.

+All implementations must henceforth have this type. +

name :

The name of the extension point +The name of the extension point
- - @@ -425,21 +431,22 @@ All implementations must henceforth have this type.


g_io_extension_ref_class ()

-
GTypeClass*         g_io_extension_ref_class            (GIOExtension *extension);
+
GTypeClass*         g_io_extension_ref_class            (GIOExtension *extension);

Gets a reference to the class for the type that is -associated with extension.

+associated with extension. +

extension_point :

a GIOExtensionPoint +a GIOExtensionPoint

type :

the GType to require +the GType to require
- - @@ -453,6 +460,6 @@ Extending GIO + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GContentType.html b/docs/reference/gio/html/gio-GContentType.html index 596f2f3..5f84a14 100644 --- a/docs/reference/gio/html/gio-GContentType.html +++ b/docs/reference/gio/html/gio-GContentType.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

extension :

a GIOExtension +a GIOExtension

Returns :

the GTypeClass for the type of extension + the GTypeClass for the type of extension
@@ -70,22 +40,22 @@
 #include <gio/gio.h>
 
-gboolean            g_content_type_equals               (const char *type1,
-                                                         const char *type2);
-gboolean            g_content_type_is_a                 (const char *type,
-                                                         const char *supertype);
-gboolean            g_content_type_is_unknown           (const char *type);
-char *              g_content_type_get_description      (const char *type);
-char *              g_content_type_get_mime_type        (const char *type);
-GIcon *             g_content_type_get_icon             (const char *type);
-gboolean            g_content_type_can_be_executable    (const char *type);
-char *              g_content_type_from_mime_type       (const char *mime_type);
-char *              g_content_type_guess                (const char *filename,
-                                                         const guchar *data,
-                                                         gsize data_size,
-                                                         gboolean *result_uncertain);
-char **             g_content_type_guess_for_tree       (GFile *root);
-GList *             g_content_types_get_registered      (void);
+gboolean            g_content_type_equals               (const char *type1,
+                                                         const char *type2);
+gboolean            g_content_type_is_a                 (const char *type,
+                                                         const char *supertype);
+gboolean            g_content_type_is_unknown           (const char *type);
+char *              g_content_type_get_description      (const char *type);
+char *              g_content_type_get_mime_type        (const char *type);
+GIcon *             g_content_type_get_icon             (const char *type);
+gboolean            g_content_type_can_be_executable    (const char *type);
+char *              g_content_type_from_mime_type       (const char *mime_type);
+char *              g_content_type_guess                (const char *filename,
+                                                         const guchar *data,
+                                                         gsize data_size,
+                                                         gboolean *result_uncertain);
+char **             g_content_type_guess_for_tree       (GFile *root);
+GList *             g_content_types_get_registered      (void);
 
@@ -94,33 +64,35 @@ A content type is a platform specific string that defines the type of a file. On unix it is a mime type, on win32 it is an extension string like ".doc", ".txt" or a percieved string like "audio". Such strings -can be looked up in the registry at HKEY_CLASSES_ROOT.

+can be looked up in the registry at HKEY_CLASSES_ROOT. +

Details

g_content_type_equals ()

-
gboolean            g_content_type_equals               (const char *type1,
-                                                         const char *type2);
+
gboolean            g_content_type_equals               (const char *type1,
+                                                         const char *type2);

-Compares two content types for equality.

+Compares two content types for equality. +

- - - @@ -129,27 +101,28 @@ Compares two content types for equality.


g_content_type_is_a ()

-
gboolean            g_content_type_is_a                 (const char *type,
-                                                         const char *supertype);
+
gboolean            g_content_type_is_a                 (const char *type,
+                                                         const char *supertype);

-Determines if type is a subset of supertype.

+Determines if type is a subset of supertype. +

type1 :

a content type string. +a content type string.

type2 :

a content type string. +a content type string.

Returns :

TRUE if the two strings are identical or equivalent, -FALSE otherwise. + TRUE if the two strings are identical or equivalent, +FALSE otherwise.
- - - @@ -158,22 +131,23 @@ Determines if type is a subset of

g_content_type_is_unknown ()

-
gboolean            g_content_type_is_unknown           (const char *type);
+
gboolean            g_content_type_is_unknown           (const char *type);

Checks if the content type is the generic "unknown" type. On unix this is the "application/octet-stream" mimetype, -while on win32 it is "*".

+while on win32 it is "*". +

type :

a content type string. +a content type string.

supertype :

a string. +a string.

Returns :

TRUE if type is a kind of supertype, -FALSE otherwise. + TRUE if type is a kind of supertype, +FALSE otherwise.
- - @@ -182,15 +156,16 @@ while on win32 it is "*".


g_content_type_get_description ()

-
char *              g_content_type_get_description      (const char *type);
+
char *              g_content_type_get_description      (const char *type);

-Gets the human readable description of the content type.

+Gets the human readable description of the content type. +

type :

a content type string. +a content type string.

Returns :

TRUE if the type is the unknown type. + TRUE if the type is the unknown type.
- @@ -204,15 +179,16 @@ Gets the human readable description of the content type.


g_content_type_get_mime_type ()

-
char *              g_content_type_get_mime_type        (const char *type);
+
char *              g_content_type_get_mime_type        (const char *type);

-Gets the mime-type for the content type. If one is registered

+Gets the mime-type for the content type. If one is registered +

type :

a content type string. +a content type string.
- @@ -226,15 +202,16 @@ Gets the mime-type for the content type. If one is registered


g_content_type_get_icon ()

-
GIcon *             g_content_type_get_icon             (const char *type);
+
GIcon *             g_content_type_get_icon             (const char *type);

-Gets the icon for a content type.

+Gets the icon for a content type. +

type :

a content type string. +a content type string.
- @@ -248,22 +225,23 @@ Gets the icon for a content type.


g_content_type_can_be_executable ()

-
gboolean            g_content_type_can_be_executable    (const char *type);
+
gboolean            g_content_type_can_be_executable    (const char *type);

Checks if a content type can be executable. Note that for instance -things like text files can be executables (i.e. scripts and batch files).

+things like text files can be executables (i.e. scripts and batch files). +

type :

a content type string. +a content type string.
- - @@ -272,15 +250,16 @@ can be executable,

g_content_type_from_mime_type ()

-
char *              g_content_type_from_mime_type       (const char *mime_type);
+
char *              g_content_type_from_mime_type       (const char *mime_type);

-Tries to find a content type based on the mime type name.

+Tries to find a content type based on the mime type name. +

type :

a content type string. +a content type string.

Returns :

TRUE if the file type corresponds to a type that -can be executable, FALSE otherwise. + TRUE if the file type corresponds to a type that +can be executable, FALSE otherwise.
- @@ -296,36 +275,37 @@ Tries to find a content type based on the mime type name.


g_content_type_guess ()

-
char *              g_content_type_guess                (const char *filename,
-                                                         const guchar *data,
-                                                         gsize data_size,
-                                                         gboolean *result_uncertain);
+
char *              g_content_type_guess                (const char *filename,
+                                                         const guchar *data,
+                                                         gsize data_size,
+                                                         gboolean *result_uncertain);

Guesses the content type based on example data. If the function is -uncertain, result_uncertain will be set to TRUE. Either filename -or data may be NULL, in which case the guess will be based solely -on the other argument.

+uncertain, result_uncertain will be set to TRUE. Either filename +or data may be NULL, in which case the guess will be based solely +on the other argument. +

mime_type :

a mime type string. +a mime type string.
- - - - @@ -340,7 +320,7 @@ given data.

g_content_type_guess_for_tree ()

-
char **             g_content_type_guess_for_tree       (GFile *root);
+
char **             g_content_type_guess_for_tree       (GFile *root);

Tries to guess the type of the tree with root root, by looking at the files it contains. The result is an array @@ -353,19 +333,20 @@ x-content/audio-cdda (for audio CDs) or x-content/image-dcf specification for more on x-content types.

-This function is useful in the implementation of g_mount_guess_content_type().

+This function is useful in the implementation of g_mount_guess_content_type(). +

filename :

a string, or NULL +a string, or NULL

data :

a stream of data, or NULL +a stream of data, or NULL

data_size :

the size of data +the size of data

result_uncertain :

a flag indicating the certainty of the result +a flag indicating the certainty of the result
- - @@ -376,16 +357,17 @@ This function is useful in the implementation of

g_content_types_get_registered ()

-
GList *             g_content_types_get_registered      (void);
+
GList *             g_content_types_get_registered      (void);

Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using -g_list_foreach(list, g_free, NULL) and g_list_free(list)

+g_list_foreach(list, g_free, NULL) and g_list_free(list) +

root :

the root of the tree to guess a type for +the root of the tree to guess a type for

Returns :

an NULL-terminated array of zero or more content types, or NULL. - Free with g_strfreev() + an NULL-terminated array of zero or more content types, or NULL. + Free with g_strfreev()
-

Returns :

GList of the registered content types. + GList of the registered content types.
@@ -394,6 +376,6 @@ known to the system. The list and its data should be freed using
+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/gio-GConverterInputstream.html b/docs/reference/gio/html/gio-GConverterInputstream.html index 97ccf05..4a4ebe3 100644 --- a/docs/reference/gio/html/gio-GConverterInputstream.html +++ b/docs/reference/gio/html/gio-GConverterInputstream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -75,16 +45,16 @@ #include <gio/gio.h> GConverterInputStream; -GInputStream * g_converter_input_stream_new (GInputStream *base_stream, - GConverter *converter); +GInputStream * g_converter_input_stream_new (GInputStream *base_stream, + GConverter *converter); GConverter * g_converter_input_stream_get_converter - (GConverterInputStream *converter_stream); + (GConverterInputStream *converter_stream);

Object Hierarchy

-  GObject
+  GObject
    +----GInputStream
          +----GFilterInputStream
                +----GConverterInputStream
@@ -100,7 +70,8 @@
 

Description

Converter input stream implements GInputStream and allows -conversion of data of various types during reading.

+conversion of data of various types during reading. +

Details

@@ -109,7 +80,8 @@ conversion of data of various types during reading.

typedef struct _GConverterInputStream GConverterInputStream;

An implementation of GFilterInputStream that allows data -conversion.

+conversion. +

@@ -118,21 +90,22 @@ conversion.


g_converter_input_stream_new ()

-
GInputStream *      g_converter_input_stream_new        (GInputStream *base_stream,
-                                                         GConverter *converter);
+
GInputStream *      g_converter_input_stream_new        (GInputStream *base_stream,
+                                                         GConverter *converter);

-Creates a new converter input stream for the base_stream.

+Creates a new converter input stream for the base_stream. +

- - @@ -147,15 +120,16 @@ Creates a new converter input stream for the base_st

g_converter_input_stream_get_converter ()

GConverter *        g_converter_input_stream_get_converter
-                                                        (GConverterInputStream *converter_stream);
+ (GConverterInputStream *converter_stream);

-Gets the GConverter that is used by converter_stream.

+Gets the GConverter that is used by converter_stream. +

base_stream :

a GInputStream +a GInputStream

converter :

a GConverter +a GConverter
- @@ -184,6 +158,6 @@ Gets the
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GConverterOutputstream.html b/docs/reference/gio/html/gio-GConverterOutputstream.html index 65f30d0..4632fe2 100644 --- a/docs/reference/gio/html/gio-GConverterOutputstream.html +++ b/docs/reference/gio/html/gio-GConverterOutputstream.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

converter_stream :

a GConverterInputStream +a GConverterInputStream
@@ -75,16 +45,16 @@ #include <gio/gio.h> GConverterOutputStream; -GOutputStream * g_converter_output_stream_new (GOutputStream *base_stream, - GConverter *converter); +GOutputStream * g_converter_output_stream_new (GOutputStream *base_stream, + GConverter *converter); GConverter * g_converter_output_stream_get_converter - (GConverterOutputStream *converter_stream); + (GConverterOutputStream *converter_stream);

Object Hierarchy

-  GObject
+  GObject
    +----GOutputStream
          +----GFilterOutputStream
                +----GConverterOutputStream
@@ -100,7 +70,8 @@
 

Description

Converter output stream implements GOutputStream and allows -conversion of data of various types during reading.

+conversion of data of various types during reading. +

Details

@@ -109,7 +80,8 @@ conversion of data of various types during reading.

typedef struct _GConverterOutputStream GConverterOutputStream;

An implementation of GFilterOutputStream that allows data -conversion.

+conversion. +

@@ -118,21 +90,22 @@ conversion.


g_converter_output_stream_new ()

-
GOutputStream *     g_converter_output_stream_new       (GOutputStream *base_stream,
-                                                         GConverter *converter);
+
GOutputStream *     g_converter_output_stream_new       (GOutputStream *base_stream,
+                                                         GConverter *converter);

-Creates a new converter output stream for the base_stream.

+Creates a new converter output stream for the base_stream. +

- - @@ -147,15 +120,16 @@ Creates a new converter output stream for the base_s

g_converter_output_stream_get_converter ()

GConverter *        g_converter_output_stream_get_converter
-                                                        (GConverterOutputStream *converter_stream);
+ (GConverterOutputStream *converter_stream);

-Gets the GConverter that is used by converter_stream.

+Gets the GConverter that is used by converter_stream. +

base_stream :

a GOutputStream +a GOutputStream

converter :

a GConverter +a GConverter
- @@ -184,6 +158,6 @@ Gets the
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GFileAttribute.html b/docs/reference/gio/html/gio-GFileAttribute.html index 5ba1a8b..36b77f4 100644 --- a/docs/reference/gio/html/gio-GFileAttribute.html +++ b/docs/reference/gio/html/gio-GFileAttribute.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

converter_stream :

a GConverterOutputStream +a GConverterOutputStream
@@ -75,17 +45,17 @@ enum GFileAttributeStatus; GFileAttributeInfo; GFileAttributeInfoList; -GFileAttributeInfoList * g_file_attribute_info_list_new (void); -GFileAttributeInfoList * g_file_attribute_info_list_ref (GFileAttributeInfoList *list); -void g_file_attribute_info_list_unref (GFileAttributeInfoList *list); -GFileAttributeInfoList * g_file_attribute_info_list_dup (GFileAttributeInfoList *list); +GFileAttributeInfoList * g_file_attribute_info_list_new (void); +GFileAttributeInfoList * g_file_attribute_info_list_ref (GFileAttributeInfoList *list); +void g_file_attribute_info_list_unref (GFileAttributeInfoList *list); +GFileAttributeInfoList * g_file_attribute_info_list_dup (GFileAttributeInfoList *list); const GFileAttributeInfo * g_file_attribute_info_list_lookup - (GFileAttributeInfoList *list, - const char *name); -void g_file_attribute_info_list_add (GFileAttributeInfoList *list, - const char *name, - GFileAttributeType type, - GFileAttributeInfoFlags flags); + (GFileAttributeInfoList *list, + const char *name); +void g_file_attribute_info_list_add (GFileAttributeInfoList *list, + const char *name, + GFileAttributeType type, + GFileAttributeInfoFlags flags);
@@ -122,7 +92,7 @@ attribute key will be registered for the user id for a given file).

-

Table 1. GFileAttributes Default Namespaces

+

Table 1. GFileAttributes Default Namespaces

@@ -156,7 +126,7 @@ to check for loops and to uniquely identify files. @@ -249,7 +219,7 @@ For more information about writing GIO modules, see -

Table 2. GFileAttributes Built-in Keys and Value Types

+

Table 2. GFileAttributes Built-in Keys and Value Types

The "Access" namespace. Used to check if a user has the proper privilidges to access files and perform file operations. Keys in this namespace are made to be generic -and easily understood, e.g. the "can_read" key is TRUE if +and easily understood, e.g. the "can_read" key is TRUE if the current user has permission to read the file. UNIX permissions and NTFS ACLs in Windows should be mapped to these values.
@@ -590,7 +560,8 @@ away the "user." prefix from the extended user attribute, and prepending concatenating "xattr-sys::" with the extended attribute name. All extended attribute values are returned as hex-encoded strings in which bytes outside the ASCII range are encoded as hexadecimal escape sequences of the form -\xnn.

+\xnn. +

Details

@@ -610,58 +581,59 @@ the ASCII range are encoded as hexadecimal escape sequences of the form } GFileAttributeType;

-The data types for file attributes.

+The data types for file attributes. +

- - - - - - - - - - @@ -677,23 +649,24 @@ The data types for file attributes.

} GFileAttributeInfoFlags;

-Flags specifying the behaviour of an attribute.

+Flags specifying the behaviour of an attribute. +

G_FILE_ATTRIBUTE_TYPE_INVALID

indicates an invalid or uninitalized type. +indicates an invalid or uninitalized type.

G_FILE_ATTRIBUTE_TYPE_STRING

a null terminated UTF8 string. +a null terminated UTF8 string.

G_FILE_ATTRIBUTE_TYPE_BYTE_STRING

a zero terminated string of non-zero bytes. +a zero terminated string of non-zero bytes.

G_FILE_ATTRIBUTE_TYPE_BOOLEAN

a boolean value. +a boolean value.

G_FILE_ATTRIBUTE_TYPE_UINT32

an unsigned 4-byte/32-bit integer. +an unsigned 4-byte/32-bit integer.

G_FILE_ATTRIBUTE_TYPE_INT32

a signed 4-byte/32-bit integer. +a signed 4-byte/32-bit integer.

G_FILE_ATTRIBUTE_TYPE_UINT64

an unsigned 8-byte/64-bit integer. +an unsigned 8-byte/64-bit integer.

G_FILE_ATTRIBUTE_TYPE_INT64

a signed 8-byte/64-bit integer. +a signed 8-byte/64-bit integer.

G_FILE_ATTRIBUTE_TYPE_OBJECT

a GObject. +a GObject.

G_FILE_ATTRIBUTE_TYPE_STRINGV

a NULL terminated char **. Since 2.22 +a NULL terminated char **. Since 2.22
- - - @@ -709,23 +682,24 @@ Flags specifying the behaviour of an attribute.

} GFileAttributeStatus;

-Used by g_file_set_attributes_from_info() when setting file attributes.

+Used by g_file_set_attributes_from_info() when setting file attributes. +

G_FILE_ATTRIBUTE_INFO_NONE

no flags set. +no flags set.

G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE

copy the attribute values when the file is copied. +copy the attribute values when the file is copied.

G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED

copy the attribute values when the file is moved. +copy the attribute values when the file is moved.
- - - @@ -741,23 +715,24 @@ Used by

-Information about a specific attribute.

+Information about a specific attribute. +

G_FILE_ATTRIBUTE_STATUS_UNSET

Attribute value is unset (empty). +Attribute value is unset (empty).

G_FILE_ATTRIBUTE_STATUS_SET

Attribute value is set. +Attribute value is set.

G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING

Indicates an error in setting the value. +Indicates an error in setting the value.
- - - @@ -773,18 +748,19 @@ Information about a specific attribute.

Acts as a lightweight registry for possible valid file attributes. -The registry stores Key-Value pair formats as GFileAttributeInfos.

+The registry stores Key-Value pair formats as GFileAttributeInfos. +

char *name;

the name of the attribute. +the name of the attribute.

GFileAttributeType type;

the GFileAttributeType type of the attribute. +the GFileAttributeType type of the attribute.

GFileAttributeInfoFlags flags;

a set of GFileAttributeInfoFlags. +a set of GFileAttributeInfoFlags.
- - @@ -793,9 +769,10 @@ The registry stores Key-Value pair formats as

g_file_attribute_info_list_new ()

-
GFileAttributeInfoList * g_file_attribute_info_list_new (void);
+
GFileAttributeInfoList * g_file_attribute_info_list_new (void);

-Creates a new file attribute info list.

+Creates a new file attribute info list. +

GFileAttributeInfo *infos;

an array of GFileAttributeInfos. +an array of GFileAttributeInfos.

int n_infos;

the number of values in the array. +the number of values in the array.
@@ -808,20 +785,21 @@ Creates a new file attribute info list.


g_file_attribute_info_list_ref ()

-
GFileAttributeInfoList * g_file_attribute_info_list_ref (GFileAttributeInfoList *list);
+
GFileAttributeInfoList * g_file_attribute_info_list_ref (GFileAttributeInfoList *list);

-References a file attribute info list.

+References a file attribute info list. +

- - @@ -830,15 +808,16 @@ References a file attribute info list.


g_file_attribute_info_list_unref ()

-
void                g_file_attribute_info_list_unref    (GFileAttributeInfoList *list);
+
void                g_file_attribute_info_list_unref    (GFileAttributeInfoList *list);

Removes a reference from the given list. If the reference count -falls to zero, the list is deleted.

+falls to zero, the list is deleted. +

list :

a GFileAttributeInfoList to reference. +a GFileAttributeInfoList to reference.

Returns :

GFileAttributeInfoList or NULL on error. + GFileAttributeInfoList or NULL on error.
-

list :

The GFileAttributeInfoList to unreference. +The GFileAttributeInfoList to unreference.
@@ -846,15 +825,16 @@ falls to zero, the list is deleted.


g_file_attribute_info_list_dup ()

-
GFileAttributeInfoList * g_file_attribute_info_list_dup (GFileAttributeInfoList *list);
+
GFileAttributeInfoList * g_file_attribute_info_list_dup (GFileAttributeInfoList *list);

-Makes a duplicate of a file attribute info list.

+Makes a duplicate of a file attribute info list. +

- @@ -869,26 +849,27 @@ Makes a duplicate of a file attribute info list.

g_file_attribute_info_list_lookup ()

const GFileAttributeInfo * g_file_attribute_info_list_lookup
-                                                        (GFileAttributeInfoList *list,
-                                                         const char *name);
+ (GFileAttributeInfoList *list, + const char *name);

-Gets the file attribute with the name name from list.

+Gets the file attribute with the name name from list. +

list :

a GFileAttributeInfoList to duplicate. +a GFileAttributeInfoList to duplicate.
- - - @@ -898,34 +879,36 @@ attribute isn't found.

g_file_attribute_info_list_add ()

-
void                g_file_attribute_info_list_add      (GFileAttributeInfoList *list,
-                                                         const char *name,
-                                                         GFileAttributeType type,
-                                                         GFileAttributeInfoFlags flags);
+
void                g_file_attribute_info_list_add      (GFileAttributeInfoList *list,
+                                                         const char *name,
+                                                         GFileAttributeType type,
+                                                         GFileAttributeInfoFlags flags);

Adds a new attribute with name to the list, setting -its type and flags.

+its type and flags. +

list :

a GFileAttributeInfoList. +a GFileAttributeInfoList.

name :

the name of the attribute to lookup. +the name of the attribute to lookup.

Returns :

a GFileAttributeInfo for the name, or NULL if an + a GFileAttributeInfo for the name, or NULL if an attribute isn't found.
- - - - @@ -939,6 +922,6 @@ its type and + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GIOError.html b/docs/reference/gio/html/gio-GIOError.html index 4828e94..f9eb211 100644 --- a/docs/reference/gio/html/gio-GIOError.html +++ b/docs/reference/gio/html/gio-GIOError.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

list :

a GFileAttributeInfoList. +a GFileAttributeInfoList.

name :

the name of the attribute to add. +the name of the attribute to add.

type :

the GFileAttributeType for the attribute. +the GFileAttributeType for the attribute.

flags :

GFileAttributeInfoFlags for the attribute. + +GFileAttributeInfoFlags for the attribute.
@@ -72,13 +42,14 @@ #define G_IO_ERROR enum GIOErrorEnum; -GIOErrorEnum g_io_error_from_errno (gint err_no); +GIOErrorEnum g_io_error_from_errno (gint err_no);

Description

-Contains helper functions for reporting errors to the user.

+Contains helper functions for reporting errors to the user. +

Details

@@ -88,7 +59,8 @@ Contains helper functions for reporting errors to the user.

Error domain for GIO. Errors in this domain will be from the GIOErrorEnum enumeration. -See GError for more information on error domains.

+See GError for more information on error domains. +


@@ -133,191 +105,192 @@ See
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -326,15 +299,16 @@ Error codes returned by GIO functions.


g_io_error_from_errno ()

-
GIOErrorEnum        g_io_error_from_errno               (gint err_no);
+
GIOErrorEnum        g_io_error_from_errno               (gint err_no);

-Converts errno.h error codes into GIO error codes.

+Converts errno.h error codes into GIO error codes. +

G_IO_ERROR_FAILED

Generic error condition for when any operation fails. +Generic error condition for when any operation fails.

G_IO_ERROR_NOT_FOUND

File not found error. +File not found error.

G_IO_ERROR_EXISTS

File already exists error. +File already exists error.

G_IO_ERROR_IS_DIRECTORY

File is a directory error. +File is a directory error.

G_IO_ERROR_NOT_DIRECTORY

File is not a directory. +File is not a directory.

G_IO_ERROR_NOT_EMPTY

File is a directory that isn't empty. +File is a directory that isn't empty.

G_IO_ERROR_NOT_REGULAR_FILE

File is not a regular file. +File is not a regular file.

G_IO_ERROR_NOT_SYMBOLIC_LINK

File is not a symbolic link. +File is not a symbolic link.

G_IO_ERROR_NOT_MOUNTABLE_FILE

File cannot be mounted. +File cannot be mounted.

G_IO_ERROR_FILENAME_TOO_LONG

Filename is too many characters. +Filename is too many characters.

G_IO_ERROR_INVALID_FILENAME

Filename is invalid or contains invalid characters. +Filename is invalid or contains invalid characters.

G_IO_ERROR_TOO_MANY_LINKS

File contains too many symbolic links. +File contains too many symbolic links.

G_IO_ERROR_NO_SPACE

No space left on drive. +No space left on drive.

G_IO_ERROR_INVALID_ARGUMENT

Invalid argument. +Invalid argument.

G_IO_ERROR_PERMISSION_DENIED

Permission denied. +Permission denied.

G_IO_ERROR_NOT_SUPPORTED

Operation not supported for the current backend. +Operation not supported for the current backend.

G_IO_ERROR_NOT_MOUNTED

File isn't mounted. +File isn't mounted.

G_IO_ERROR_ALREADY_MOUNTED

File is already mounted. +File is already mounted.

G_IO_ERROR_CLOSED

File was closed. +File was closed.

G_IO_ERROR_CANCELLED

Operation was cancelled. See GCancellable. +Operation was cancelled. See GCancellable.

G_IO_ERROR_PENDING

Operations are still pending. +Operations are still pending.

G_IO_ERROR_READ_ONLY

File is read only. +File is read only.

G_IO_ERROR_CANT_CREATE_BACKUP

Backup couldn't be created. +Backup couldn't be created.

G_IO_ERROR_WRONG_ETAG

File's Entity Tag was incorrect. +File's Entity Tag was incorrect.

G_IO_ERROR_TIMED_OUT

Operation timed out. +Operation timed out.

G_IO_ERROR_WOULD_RECURSE

Operation would be recursive. +Operation would be recursive.

G_IO_ERROR_BUSY

File is busy. +File is busy.

G_IO_ERROR_WOULD_BLOCK

Operation would block. +Operation would block.

G_IO_ERROR_HOST_NOT_FOUND

Host couldn't be found (remote operations). +Host couldn't be found (remote operations).

G_IO_ERROR_WOULD_MERGE

Operation would merge files. +Operation would merge files.

G_IO_ERROR_FAILED_HANDLED

Operation failed and a helper program has +Operation failed and a helper program has already interacted with the user. Do not display any error dialog.

G_IO_ERROR_TOO_MANY_OPEN_FILES

The current process has too many files +The current process has too many files open and can't open any more. Duplicate descriptors do count toward this limit. Since 2.20

G_IO_ERROR_NOT_INITIALIZED

The object has not been initialized. Since 2.22 +The object has not been initialized. Since 2.22

G_IO_ERROR_ADDRESS_IN_USE

The requested address is already in use. Since 2.22 +The requested address is already in use. Since 2.22

G_IO_ERROR_PARTIAL_INPUT

Need more input to finish operation. Since 2.24 +Need more input to finish operation. Since 2.24

G_IO_ERROR_INVALID_DATA

There input data was invalid. Since 2.24 +There input data was invalid. Since 2.24
- @@ -349,6 +323,6 @@ Converts errno.h error codes into GIO error codes.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GIOScheduler.html b/docs/reference/gio/html/gio-GIOScheduler.html index 2d59a87..49256e5 100644 --- a/docs/reference/gio/html/gio-GIOScheduler.html +++ b/docs/reference/gio/html/gio-GIOScheduler.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

err_no :

Error number as defined in errno.h. +Error number as defined in errno.h.
@@ -71,31 +41,31 @@ #include <gio/gio.h> GIOSchedulerJob; -gboolean (*GIOSchedulerJobFunc) (GIOSchedulerJob *job, - GCancellable *cancellable, - gpointer user_data); -void g_io_scheduler_push_job (GIOSchedulerJobFunc job_func, - gpointer user_data, - GDestroyNotify notify, - gint io_priority, - GCancellable *cancellable); -void g_io_scheduler_cancel_all_jobs (void); -gboolean g_io_scheduler_job_send_to_mainloop (GIOSchedulerJob *job, - GSourceFunc func, - gpointer user_data, - GDestroyNotify notify); +gboolean (*GIOSchedulerJobFunc) (GIOSchedulerJob *job, + GCancellable *cancellable, + gpointer user_data); +void g_io_scheduler_push_job (GIOSchedulerJobFunc job_func, + gpointer user_data, + GDestroyNotify notify, + gint io_priority, + GCancellable *cancellable); +void g_io_scheduler_cancel_all_jobs (void); +gboolean g_io_scheduler_job_send_to_mainloop (GIOSchedulerJob *job, + GSourceFunc func, + gpointer user_data, + GDestroyNotify notify); void g_io_scheduler_job_send_to_mainloop_async - (GIOSchedulerJob *job, - GSourceFunc func, - gpointer user_data, - GDestroyNotify notify); + (GIOSchedulerJob *job, + GSourceFunc func, + gpointer user_data, + GDestroyNotify notify);

Description

Schedules asynchronous I/O operations. GIOScheduler integrates -into the main event loop (GMainLoop) and may use threads if they +into the main event loop (GMainLoop) and may use threads if they are available.

@@ -105,8 +75,10 @@ Each I/O operation has a priority, and the scheduler uses the priorities to determine the order in which operations are executed. They are not used to determine system-wide I/O scheduling. Priorities are integers, with lower numbers indicating higher priority. -It is recommended to choose priorities between G_PRIORITY_LOW and -G_PRIORITY_HIGH, with G_PRIORITY_DEFAULT as a default. +It is recommended to choose priorities between G_PRIORITY_LOW and +G_PRIORITY_HIGH, with G_PRIORITY_DEFAULT as a default. +

+

@@ -115,14 +87,15 @@ It is recommended to choose priorities between

GIOSchedulerJob

typedef struct _GIOSchedulerJob GIOSchedulerJob;

-Opaque class for definining and scheduling IO jobs.

+Opaque class for definining and scheduling IO jobs. +


GIOSchedulerJobFunc ()

-
gboolean            (*GIOSchedulerJobFunc)              (GIOSchedulerJob *job,
-                                                         GCancellable *cancellable,
-                                                         gpointer user_data);
+
gboolean            (*GIOSchedulerJobFunc)              (GIOSchedulerJob *job,
+                                                         GCancellable *cancellable,
+                                                         gpointer user_data);

I/O Job function.

@@ -133,29 +106,30 @@ in the mainloop.

Long-running jobs should periodically check the cancellable -to see if they have been cancelled.

+to see if they have been cancelled. +

- - - - @@ -164,11 +138,11 @@ to see if they have been cancelled.


g_io_scheduler_push_job ()

-
void                g_io_scheduler_push_job             (GIOSchedulerJobFunc job_func,
-                                                         gpointer user_data,
-                                                         GDestroyNotify notify,
-                                                         gint io_priority,
-                                                         GCancellable *cancellable);
+
void                g_io_scheduler_push_job             (GIOSchedulerJobFunc job_func,
+                                                         gpointer user_data,
+                                                         GDestroyNotify notify,
+                                                         gint io_priority,
+                                                         GCancellable *cancellable);

Schedules the I/O job to run.

@@ -177,36 +151,37 @@ Schedules the I/O job to run. regardless whether the job was cancelled or has run to completion.

-If cancellable is not NULL, it can be used to cancel the I/O job +If cancellable is not NULL, it can be used to cancel the I/O job by calling g_cancellable_cancel() or by calling -g_io_scheduler_cancel_all_jobs().

+g_io_scheduler_cancel_all_jobs(). +

job :

a GIOSchedulerJob. +a GIOSchedulerJob.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.

user_data :

the data to pass to callback function +the data to pass to callback function

Returns :

TRUE if this function should be called again to - complete the job, FALSE if the job is complete (or cancelled) + TRUE if this function should be called again to + complete the job, FALSE if the job is complete (or cancelled)
- - - - - @@ -215,46 +190,48 @@ of the request.

g_io_scheduler_cancel_all_jobs ()

-
void                g_io_scheduler_cancel_all_jobs      (void);
+
void                g_io_scheduler_cancel_all_jobs      (void);

Cancels all cancellable I/O jobs.

A job is cancellable if a GCancellable was passed into -g_io_scheduler_push_job().

+g_io_scheduler_push_job(). +


g_io_scheduler_job_send_to_mainloop ()

-
gboolean            g_io_scheduler_job_send_to_mainloop (GIOSchedulerJob *job,
-                                                         GSourceFunc func,
-                                                         gpointer user_data,
-                                                         GDestroyNotify notify);
+
gboolean            g_io_scheduler_job_send_to_mainloop (GIOSchedulerJob *job,
+                                                         GSourceFunc func,
+                                                         gpointer user_data,
+                                                         GDestroyNotify notify);

Used from an I/O job to send a callback to be run in the thread that the job was started from, waiting for the result (and thus -blocking the I/O job).

+blocking the I/O job). +

job_func :

a GIOSchedulerJobFunc. +a GIOSchedulerJobFunc.

user_data :

data to pass to job_func +data to pass to job_func

notify :

a GDestroyNotify for user_data, or NULL +a GDestroyNotify for user_data, or NULL

io_priority :

the I/O priority +the I/O priority of the request.

cancellable :

optional GCancellable object, NULL to ignore. +optional GCancellable object, NULL to ignore.
- - - - @@ -269,10 +246,10 @@ blocking the I/O job).

g_io_scheduler_job_send_to_mainloop_async ()

void                g_io_scheduler_job_send_to_mainloop_async
-                                                        (GIOSchedulerJob *job,
-                                                         GSourceFunc func,
-                                                         gpointer user_data,
-                                                         GDestroyNotify notify);
+ (GIOSchedulerJob *job, + GSourceFunc func, + gpointer user_data, + GDestroyNotify notify);

Used from an I/O job to send a callback to be run asynchronously in the thread that the job was started from. The callback will be run @@ -282,29 +259,30 @@ have finished. The return value from the callback is ignored.

Note that if you are passing the user_data from g_io_scheduler_push_job() on to this function you have to ensure that it is not freed before -func is called, either by passing NULL as notify to -g_io_scheduler_push_job() or by using refcounting for user_data.

+func is called, either by passing NULL as notify to +g_io_scheduler_push_job() or by using refcounting for user_data. +

job :

a GIOSchedulerJob +a GIOSchedulerJob

func :

a GSourceFunc callback that will be called in the original thread +a GSourceFunc callback that will be called in the original thread

user_data :

data to pass to func +data to pass to func

notify :

a GDestroyNotify for user_data, or NULL +a GDestroyNotify for user_data, or NULL
- - - - @@ -314,6 +292,6 @@ on to this function you have to ensure that it is not freed before + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-GSrvTarget.html b/docs/reference/gio/html/gio-GSrvTarget.html index f44bf04..16ffc8f 100644 --- a/docs/reference/gio/html/gio-GSrvTarget.html +++ b/docs/reference/gio/html/gio-GSrvTarget.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

job :

a GIOSchedulerJob +a GIOSchedulerJob

func :

a GSourceFunc callback that will be called in the original thread +a GSourceFunc callback that will be called in the original thread

user_data :

data to pass to func +data to pass to func

notify :

a GDestroyNotify for user_data, or NULL +a GDestroyNotify for user_data, or NULL
@@ -71,17 +41,17 @@ #include <gio/gio.h> GSrvTarget; -GSrvTarget * g_srv_target_new (const gchar *hostname, - guint16 port, - guint16 priority, - guint16 weight); -GSrvTarget * g_srv_target_copy (GSrvTarget *target); -void g_srv_target_free (GSrvTarget *target); -const gchar * g_srv_target_get_hostname (GSrvTarget *target); -guint16 g_srv_target_get_port (GSrvTarget *target); -guint16 g_srv_target_get_priority (GSrvTarget *target); -guint16 g_srv_target_get_weight (GSrvTarget *target); -GList * g_srv_target_list_sort (GList *targets); +GSrvTarget * g_srv_target_new (const gchar *hostname, + guint16 port, + guint16 priority, + guint16 weight); +GSrvTarget * g_srv_target_copy (GSrvTarget *target); +void g_srv_target_free (GSrvTarget *target); +const gchar * g_srv_target_get_hostname (GSrvTarget *target); +guint16 g_srv_target_get_port (GSrvTarget *target); +guint16 g_srv_target_get_priority (GSrvTarget *target); +guint16 g_srv_target_get_weight (GSrvTarget *target); +GList * g_srv_target_list_sort (GList *targets);
@@ -101,7 +71,8 @@ You can use GNetworkService's GSocketConnectable interface and not need to worry about -GSrvTarget at all.

+GSrvTarget at all. +

Details

@@ -109,42 +80,44 @@ to the remote service, you can use

GSrvTarget

typedef struct _GSrvTarget GSrvTarget;

-A single target host/port that a network service is running on.

+A single target host/port that a network service is running on. +


g_srv_target_new ()

-
GSrvTarget *        g_srv_target_new                    (const gchar *hostname,
-                                                         guint16 port,
-                                                         guint16 priority,
-                                                         guint16 weight);
+
GSrvTarget *        g_srv_target_new                    (const gchar *hostname,
+                                                         guint16 port,
+                                                         guint16 priority,
+                                                         guint16 weight);

Creates a new GSrvTarget with the given parameters.

You should not need to use this; normally GSrvTargets are -created by GResolver.

+created by GResolver. +

- - - - @@ -160,15 +133,16 @@ created by

g_srv_target_copy ()

-
GSrvTarget *        g_srv_target_copy                   (GSrvTarget *target);
+
GSrvTarget *        g_srv_target_copy                   (GSrvTarget *target);

-Copies target

+Copies target +

hostname :

the host that the service is running on +the host that the service is running on

port :

the port that the service is running on +the port that the service is running on

priority :

the target's priority +the target's priority

weight :

the target's weight +the target's weight
- @@ -184,14 +158,15 @@ Copies target


g_srv_target_free ()

-
void                g_srv_target_free                   (GSrvTarget *target);
+
void                g_srv_target_free                   (GSrvTarget *target);

-Frees target

+Frees target +

target :

a GSrvTarget +a GSrvTarget
-

target :

a GSrvTarget +a GSrvTarget
@@ -200,18 +175,19 @@ Frees target


g_srv_target_get_hostname ()

-
const gchar *       g_srv_target_get_hostname           (GSrvTarget *target);
+
const gchar *       g_srv_target_get_hostname           (GSrvTarget *target);

Gets target's hostname (in ASCII form; if you are going to present -this to the user, you should use g_hostname_is_ascii_encoded() to +this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use -g_hostname_to_unicode() to convert it if it does.)

+g_hostname_to_unicode() to convert it if it does.) +

- @@ -227,15 +203,16 @@ check if it contains encoded Unicode segments, and use

g_srv_target_get_port ()

-
guint16             g_srv_target_get_port               (GSrvTarget *target);
+
guint16             g_srv_target_get_port               (GSrvTarget *target);

-Gets target's port

+Gets target's port +

target :

a GSrvTarget +a GSrvTarget
- @@ -251,17 +228,18 @@ Gets target's port


g_srv_target_get_priority ()

-
guint16             g_srv_target_get_priority           (GSrvTarget *target);
+
guint16             g_srv_target_get_priority           (GSrvTarget *target);

Gets target's priority. You should not need to look at this; GResolver already sorts the targets according to the algorithm in -RFC 2782.

+RFC 2782. +

target :

a GSrvTarget +a GSrvTarget
- @@ -277,17 +255,18 @@ RFC 2782.


g_srv_target_get_weight ()

-
guint16             g_srv_target_get_weight             (GSrvTarget *target);
+
guint16             g_srv_target_get_weight             (GSrvTarget *target);

Gets target's weight. You should not need to look at this; GResolver already sorts the targets according to the algorithm in -RFC 2782.

+RFC 2782. +

target :

a GSrvTarget +a GSrvTarget
- @@ -303,15 +282,16 @@ RFC 2782.


g_srv_target_list_sort ()

-
GList *             g_srv_target_list_sort              (GList *targets);
+
GList *             g_srv_target_list_sort              (GList *targets);

-Sorts targets in place according to the algorithm in RFC 2782.

+Sorts targets in place according to the algorithm in RFC 2782. +

target :

a GSrvTarget +a GSrvTarget
- @@ -328,6 +308,6 @@ Sorts targets in place according to the + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-Unix-Mounts.html b/docs/reference/gio/html/gio-Unix-Mounts.html index eb59f38..3bcffea 100644 --- a/docs/reference/gio/html/gio-Unix-Mounts.html +++ b/docs/reference/gio/html/gio-Unix-Mounts.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

targets :

a GList of GSrvTarget +a GList of GSrvTarget
@@ -78,48 +48,48 @@ GUnixMountPoint; GUnixMountEntry; GUnixMountMonitor; -voidg_unix_mount_free (GUnixMountEntry *mount_entry); -gintg_unix_mount_compare (GUnixMountEntry *mount1, - GUnixMountEntry *mount2); -const char * g_unix_mount_get_mount_path (GUnixMountEntry *mount_entry); -const char * g_unix_mount_get_device_path (GUnixMountEntry *mount_entry); -const char * g_unix_mount_get_fs_type (GUnixMountEntry *mount_entry); -gbooleang_unix_mount_is_readonly (GUnixMountEntry *mount_entry); -gbooleang_unix_mount_is_system_internal (GUnixMountEntry *mount_entry); -GIcon * g_unix_mount_guess_icon (GUnixMountEntry *mount_entry); -char * g_unix_mount_guess_name (GUnixMountEntry *mount_entry); -gbooleang_unix_mount_guess_can_eject (GUnixMountEntry *mount_entry); -gbooleang_unix_mount_guess_should_display (GUnixMountEntry *mount_entry); -voidg_unix_mount_point_free (GUnixMountPoint *mount_point); -gintg_unix_mount_point_compare (GUnixMountPoint *mount1, - GUnixMountPoint *mount2); -const char * g_unix_mount_point_get_mount_path (GUnixMountPoint *mount_point); -const char * g_unix_mount_point_get_device_path (GUnixMountPoint *mount_point); -const char * g_unix_mount_point_get_fs_type (GUnixMountPoint *mount_point); -gbooleang_unix_mount_point_is_readonly (GUnixMountPoint *mount_point); -gbooleang_unix_mount_point_is_user_mountable - (GUnixMountPoint *mount_point); -gbooleang_unix_mount_point_is_loopback (GUnixMountPoint *mount_point); -GIcon * g_unix_mount_point_guess_icon (GUnixMountPoint *mount_point); -char * g_unix_mount_point_guess_name (GUnixMountPoint *mount_point); -gbooleang_unix_mount_point_guess_can_eject (GUnixMountPoint *mount_point); -GList * g_unix_mount_points_get (guint64 *time_read); -GList * g_unix_mounts_get (guint64 *time_read); -GUnixMountEntry * g_unix_mount_at (const char *mount_path, - guint64 *time_read); -gbooleang_unix_mounts_changed_since (guint64 time); -gbooleang_unix_mount_points_changed_since (guint64 time); -GUnixMountMonitor * g_unix_mount_monitor_new (void); -voidg_unix_mount_monitor_set_rate_limit (GUnixMountMonitor *mount_monitor, - int limit_msec); -gbooleang_unix_is_mount_path_system_internal - (const char *mount_path); +voidg_unix_mount_free (GUnixMountEntry *mount_entry); +gintg_unix_mount_compare (GUnixMountEntry *mount1, + GUnixMountEntry *mount2); +const char * g_unix_mount_get_mount_path (GUnixMountEntry *mount_entry); +const char * g_unix_mount_get_device_path (GUnixMountEntry *mount_entry); +const char * g_unix_mount_get_fs_type (GUnixMountEntry *mount_entry); +gbooleang_unix_mount_is_readonly (GUnixMountEntry *mount_entry); +gbooleang_unix_mount_is_system_internal (GUnixMountEntry *mount_entry); +GIcon * g_unix_mount_guess_icon (GUnixMountEntry *mount_entry); +char * g_unix_mount_guess_name (GUnixMountEntry *mount_entry); +gbooleang_unix_mount_guess_can_eject (GUnixMountEntry *mount_entry); +gbooleang_unix_mount_guess_should_display (GUnixMountEntry *mount_entry); +voidg_unix_mount_point_free (GUnixMountPoint *mount_point); +gintg_unix_mount_point_compare (GUnixMountPoint *mount1, + GUnixMountPoint *mount2); +const char * g_unix_mount_point_get_mount_path (GUnixMountPoint *mount_point); +const char * g_unix_mount_point_get_device_path (GUnixMountPoint *mount_point); +const char * g_unix_mount_point_get_fs_type (GUnixMountPoint *mount_point); +gbooleang_unix_mount_point_is_readonly (GUnixMountPoint *mount_point); +gbooleang_unix_mount_point_is_user_mountable + (GUnixMountPoint *mount_point); +gbooleang_unix_mount_point_is_loopback (GUnixMountPoint *mount_point); +GIcon * g_unix_mount_point_guess_icon (GUnixMountPoint *mount_point); +char * g_unix_mount_point_guess_name (GUnixMountPoint *mount_point); +gbooleang_unix_mount_point_guess_can_eject (GUnixMountPoint *mount_point); +GList * g_unix_mount_points_get (guint64 *time_read); +GList * g_unix_mounts_get (guint64 *time_read); +GUnixMountEntry * g_unix_mount_at (const char *mount_path, + guint64 *time_read); +gbooleang_unix_mounts_changed_since (guint64 time); +gbooleang_unix_mount_points_changed_since (guint64 time); +GUnixMountMonitor * g_unix_mount_monitor_new (void); +voidg_unix_mount_monitor_set_rate_limit (GUnixMountMonitor *mount_monitor, + int limit_msec); +gbooleang_unix_is_mount_path_system_internal + (const char *mount_path);

Object Hierarchy

-  GObject
+  GObject
    +----GUnixMountMonitor
 
@@ -138,7 +108,8 @@ Routines for managing mounted UNIX mount points and paths.

Note that <gio/gunixmounts.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the -gio-unix-2.0.pc pkg-config file when using it.

+gio-unix-2.0.pc pkg-config file when using it. +

Details

@@ -146,7 +117,8 @@ UNIX-specific GIO interfaces, thus you have to use the

GUnixMount

typedef struct _GUnixMount GUnixMount;

-Implementation of the GMount interface for Unix systems.

+Implementation of the GMount interface for Unix systems. +




GUnixMountMonitor

typedef struct _GUnixMountMonitor GUnixMountMonitor;

-Watches GUnixMounts for changes.

+Watches GUnixMounts for changes. +


g_unix_mount_free ()

-
void                g_unix_mount_free                   (GUnixMountEntry *mount_entry);
+
void                g_unix_mount_free                   (GUnixMountEntry *mount_entry);

-Frees a unix mount.

+Frees a unix mount. +

-

mount_entry :

a GUnixMount. +a GUnixMount.
@@ -189,21 +165,22 @@ Frees a unix mount.


g_unix_mount_compare ()

-
gint                g_unix_mount_compare                (GUnixMountEntry *mount1,
-                                                         GUnixMountEntry *mount2);
+
gint                g_unix_mount_compare                (GUnixMountEntry *mount1,
+                                                         GUnixMountEntry *mount2);

-Compares two unix mounts.

+Compares two unix mounts. +

- - @@ -218,15 +195,16 @@ or less than mount2, respectively.

g_unix_mount_get_mount_path ()

-
const char *        g_unix_mount_get_mount_path         (GUnixMountEntry *mount_entry);
+
const char *        g_unix_mount_get_mount_path         (GUnixMountEntry *mount_entry);

-Gets the mount path for a unix mount.

+Gets the mount path for a unix mount. +

mount1 :

first GUnixMountEntry to compare. +first GUnixMountEntry to compare.

mount2 :

second GUnixMountEntry to compare. +second GUnixMountEntry to compare.
- @@ -240,15 +218,16 @@ Gets the mount path for a unix mount.


g_unix_mount_get_device_path ()

-
const char *        g_unix_mount_get_device_path        (GUnixMountEntry *mount_entry);
+
const char *        g_unix_mount_get_device_path        (GUnixMountEntry *mount_entry);

-Gets the device path for a unix mount.

+Gets the device path for a unix mount. +

mount_entry :

input GUnixMountEntry to get the mount path for. +input GUnixMountEntry to get the mount path for.
- @@ -262,15 +241,16 @@ Gets the device path for a unix mount.


g_unix_mount_get_fs_type ()

-
const char *        g_unix_mount_get_fs_type            (GUnixMountEntry *mount_entry);
+
const char *        g_unix_mount_get_fs_type            (GUnixMountEntry *mount_entry);

-Gets the filesystem type for the unix mount.

+Gets the filesystem type for the unix mount. +

mount_entry :

a GUnixMount. +a GUnixMount.
- @@ -284,20 +264,21 @@ Gets the filesystem type for the unix mount.


g_unix_mount_is_readonly ()

-
gboolean            g_unix_mount_is_readonly            (GUnixMountEntry *mount_entry);
+
gboolean            g_unix_mount_is_readonly            (GUnixMountEntry *mount_entry);

-Checks if a unix mount is mounted read only.

+Checks if a unix mount is mounted read only. +

mount_entry :

a GUnixMount. +a GUnixMount.
- - @@ -306,20 +287,21 @@ Checks if a unix mount is mounted read only.


g_unix_mount_is_system_internal ()

-
gboolean            g_unix_mount_is_system_internal     (GUnixMountEntry *mount_entry);
+
gboolean            g_unix_mount_is_system_internal     (GUnixMountEntry *mount_entry);

-Checks if a unix mount is a system path.

+Checks if a unix mount is a system path. +

mount_entry :

a GUnixMount. +a GUnixMount.

Returns :

TRUE if mount_entry is read only. + TRUE if mount_entry is read only.
- - @@ -328,15 +310,16 @@ Checks if a unix mount is a system path.


g_unix_mount_guess_icon ()

-
GIcon *             g_unix_mount_guess_icon             (GUnixMountEntry *mount_entry);
+
GIcon *             g_unix_mount_guess_icon             (GUnixMountEntry *mount_entry);

-Guesses the icon of a Unix mount.

+Guesses the icon of a Unix mount. +

mount_entry :

a GUnixMount. +a GUnixMount.

Returns :

TRUE if the unix mount is for a system path. + TRUE if the unix mount is for a system path.
- @@ -350,22 +333,23 @@ Guesses the icon of a Unix mount.


g_unix_mount_guess_name ()

-
char *              g_unix_mount_guess_name             (GUnixMountEntry *mount_entry);
+
char *              g_unix_mount_guess_name             (GUnixMountEntry *mount_entry);

Guesses the name of a Unix mount. -The result is a translated string.

+The result is a translated string. +

mount_entry :

a GUnixMountEntry +a GUnixMountEntry
- @@ -374,20 +358,21 @@ The result is a translated string.


g_unix_mount_guess_can_eject ()

-
gboolean            g_unix_mount_guess_can_eject        (GUnixMountEntry *mount_entry);
+
gboolean            g_unix_mount_guess_can_eject        (GUnixMountEntry *mount_entry);

-Guesses whether a Unix mount can be ejected.

+Guesses whether a Unix mount can be ejected. +

mount_entry :

a GUnixMountEntry +a GUnixMountEntry

Returns :

A newly allocated string that must - be freed with g_free() + be freed with g_free()
- - @@ -396,20 +381,21 @@ Guesses whether a Unix mount can be ejected.


g_unix_mount_guess_should_display ()

-
gboolean            g_unix_mount_guess_should_display   (GUnixMountEntry *mount_entry);
+
gboolean            g_unix_mount_guess_should_display   (GUnixMountEntry *mount_entry);

-Guesses whether a Unix mount should be displayed in the UI.

+Guesses whether a Unix mount should be displayed in the UI. +

mount_entry :

a GUnixMountEntry +a GUnixMountEntry

Returns :

TRUE if mount_entry is deemed to be ejectable. + TRUE if mount_entry is deemed to be ejectable.
- - @@ -418,14 +404,15 @@ Guesses whether a Unix mount should be displayed in the UI.


g_unix_mount_point_free ()

-
void                g_unix_mount_point_free             (GUnixMountPoint *mount_point);
+
void                g_unix_mount_point_free             (GUnixMountPoint *mount_point);

-Frees a unix mount point.

+Frees a unix mount point. +

mount_entry :

a GUnixMountEntry +a GUnixMountEntry

Returns :

TRUE if mount_entry is deemed to be displayable. + TRUE if mount_entry is deemed to be displayable.
-

mount_point :

unix mount point to free. +unix mount point to free.
@@ -433,21 +420,22 @@ Frees a unix mount point.


g_unix_mount_point_compare ()

-
gint                g_unix_mount_point_compare          (GUnixMountPoint *mount1,
-                                                         GUnixMountPoint *mount2);
+
gint                g_unix_mount_point_compare          (GUnixMountPoint *mount1,
+                                                         GUnixMountPoint *mount2);

-Compares two unix mount points.

+Compares two unix mount points. +

- - @@ -462,15 +450,16 @@ or less than mount2, respectively.

g_unix_mount_point_get_mount_path ()

-
const char *        g_unix_mount_point_get_mount_path   (GUnixMountPoint *mount_point);
+
const char *        g_unix_mount_point_get_mount_path   (GUnixMountPoint *mount_point);

-Gets the mount path for a unix mount point.

+Gets the mount path for a unix mount point. +

mount1 :

a GUnixMount. +a GUnixMount.

mount2 :

a GUnixMount. +a GUnixMount.
- @@ -484,15 +473,16 @@ Gets the mount path for a unix mount point.


g_unix_mount_point_get_device_path ()

-
const char *        g_unix_mount_point_get_device_path  (GUnixMountPoint *mount_point);
+
const char *        g_unix_mount_point_get_device_path  (GUnixMountPoint *mount_point);

-Gets the device path for a unix mount point.

+Gets the device path for a unix mount point. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.
- @@ -506,15 +496,16 @@ Gets the device path for a unix mount point.


g_unix_mount_point_get_fs_type ()

-
const char *        g_unix_mount_point_get_fs_type      (GUnixMountPoint *mount_point);
+
const char *        g_unix_mount_point_get_fs_type      (GUnixMountPoint *mount_point);

-Gets the file system type for the mount point.

+Gets the file system type for the mount point. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.
- @@ -528,20 +519,21 @@ Gets the file system type for the mount point.


g_unix_mount_point_is_readonly ()

-
gboolean            g_unix_mount_point_is_readonly      (GUnixMountPoint *mount_point);
+
gboolean            g_unix_mount_point_is_readonly      (GUnixMountPoint *mount_point);

-Checks if a unix mount point is read only.

+Checks if a unix mount point is read only. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.
- - @@ -550,21 +542,22 @@ Checks if a unix mount point is read only.


g_unix_mount_point_is_user_mountable ()

-
gboolean            g_unix_mount_point_is_user_mountable
-                                                        (GUnixMountPoint *mount_point);
+
gboolean            g_unix_mount_point_is_user_mountable
+                                                        (GUnixMountPoint *mount_point);

-Checks if a unix mount point is mountable by the user.

+Checks if a unix mount point is mountable by the user. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.

Returns :

TRUE if a mount point is read only. + TRUE if a mount point is read only.
- - @@ -573,20 +566,21 @@ Checks if a unix mount point is mountable by the user.


g_unix_mount_point_is_loopback ()

-
gboolean            g_unix_mount_point_is_loopback      (GUnixMountPoint *mount_point);
+
gboolean            g_unix_mount_point_is_loopback      (GUnixMountPoint *mount_point);

-Checks if a unix mount point is a loopback device.

+Checks if a unix mount point is a loopback device. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.

Returns :

TRUE if the mount point is user mountable. + TRUE if the mount point is user mountable.
- - @@ -595,15 +589,16 @@ Checks if a unix mount point is a loopback device.


g_unix_mount_point_guess_icon ()

-
GIcon *             g_unix_mount_point_guess_icon       (GUnixMountPoint *mount_point);
+
GIcon *             g_unix_mount_point_guess_icon       (GUnixMountPoint *mount_point);

-Guesses the icon of a Unix mount point.

+Guesses the icon of a Unix mount point. +

mount_point :

a GUnixMountPoint. +a GUnixMountPoint.

Returns :

TRUE if the mount point is a loopback. FALSE otherwise. + TRUE if the mount point is a loopback. FALSE otherwise.
- @@ -617,22 +612,23 @@ Guesses the icon of a Unix mount point.


g_unix_mount_point_guess_name ()

-
char *              g_unix_mount_point_guess_name       (GUnixMountPoint *mount_point);
+
char *              g_unix_mount_point_guess_name       (GUnixMountPoint *mount_point);

Guesses the name of a Unix mount point. -The result is a translated string.

+The result is a translated string. +

mount_point :

a GUnixMountPoint +a GUnixMountPoint
- @@ -641,20 +637,21 @@ The result is a translated string.


g_unix_mount_point_guess_can_eject ()

-
gboolean            g_unix_mount_point_guess_can_eject  (GUnixMountPoint *mount_point);
+
gboolean            g_unix_mount_point_guess_can_eject  (GUnixMountPoint *mount_point);

-Guesses whether a Unix mount point can be ejected.

+Guesses whether a Unix mount point can be ejected. +

mount_point :

a GUnixMountPoint +a GUnixMountPoint

Returns :

A newly allocated string that must - be freed with g_free() + be freed with g_free()
- - @@ -663,23 +660,24 @@ Guesses whether a Unix mount point can be ejected.


g_unix_mount_points_get ()

-
GList *             g_unix_mount_points_get             (guint64 *time_read);
+
GList *             g_unix_mount_points_get             (guint64 *time_read);

-Gets a GList of strings containing the unix mount points. +Gets a GList of strings containing the unix mount points. If time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with -g_unix_mounts_points_changed_since().

+g_unix_mounts_points_changed_since(). +

mount_point :

a GUnixMountPoint +a GUnixMountPoint

Returns :

TRUE if mount_point is deemed to be ejectable. + TRUE if mount_point is deemed to be ejectable.
- - @@ -688,23 +686,24 @@ allowing for checking if the mounts have changed with

g_unix_mounts_get ()

-
GList *             g_unix_mounts_get                   (guint64 *time_read);
+
GList *             g_unix_mounts_get                   (guint64 *time_read);

-Gets a GList of strings containing the unix mounts. +Gets a GList of strings containing the unix mounts. If time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed -with g_unix_mounts_changed_since().

+with g_unix_mounts_changed_since(). +

time_read :

guint64 to contain a timestamp. +guint64 to contain a timestamp.

Returns :

a GList of the UNIX mountpoints. + a GList of the UNIX mountpoints.
- - @@ -713,23 +712,24 @@ with

g_unix_mount_at ()

-
GUnixMountEntry *   g_unix_mount_at                     (const char *mount_path,
-                                                         guint64 *time_read);
+
GUnixMountEntry *   g_unix_mount_at                     (const char *mount_path,
+                                                         guint64 *time_read);

Gets a GUnixMountEntry for a given mount path. If time_read is set, it will be filled with a unix timestamp for checking -if the mounts have changed since with g_unix_mounts_changed_since().

+if the mounts have changed since with g_unix_mounts_changed_since(). +

time_read :

guint64 to contain a timestamp. +guint64 to contain a timestamp.

Returns :

a GList of the UNIX mounts. + a GList of the UNIX mounts.
- - @@ -743,20 +743,21 @@ if the mounts have changed since with

g_unix_mounts_changed_since ()

-
gboolean            g_unix_mounts_changed_since         (guint64 time);
+
gboolean            g_unix_mounts_changed_since         (guint64 time);

-Checks if the unix mounts have changed since a given unix time.

+Checks if the unix mounts have changed since a given unix time. +

mount_path :

path for a possible unix mount. +path for a possible unix mount.

time_read :

guint64 to contain a timestamp. +guint64 to contain a timestamp.
- - @@ -765,20 +766,21 @@ Checks if the unix mounts have changed since a given unix time.


g_unix_mount_points_changed_since ()

-
gboolean            g_unix_mount_points_changed_since   (guint64 time);
+
gboolean            g_unix_mount_points_changed_since   (guint64 time);

-Checks if the unix mount points have changed since a given unix time.

+Checks if the unix mount points have changed since a given unix time. +

time :

guint64 to contain a timestamp. +guint64 to contain a timestamp.

Returns :

TRUE if the mounts have changed since time. + TRUE if the mounts have changed since time.
- - @@ -787,12 +789,13 @@ Checks if the unix mount points have changed since a given unix time.


g_unix_mount_monitor_new ()

-
GUnixMountMonitor * g_unix_mount_monitor_new            (void);
+
GUnixMountMonitor * g_unix_mount_monitor_new            (void);

Gets a new GUnixMountMonitor. The default rate limit for which the monitor will report consecutive changes for the mount and mount point entry files is the default for a GFileMonitor. Use -g_unix_mount_monitor_set_rate_limit() to change this.

+g_unix_mount_monitor_set_rate_limit() to change this. +

time :

guint64 to contain a timestamp. +guint64 to contain a timestamp.

Returns :

TRUE if the mount points have changed since time. + TRUE if the mount points have changed since time.
@@ -805,22 +808,23 @@ point entry files is the default for a

g_unix_mount_monitor_set_rate_limit ()

-
void                g_unix_mount_monitor_set_rate_limit (GUnixMountMonitor *mount_monitor,
-                                                         int limit_msec);
+
void                g_unix_mount_monitor_set_rate_limit (GUnixMountMonitor *mount_monitor,
+                                                         int limit_msec);

Sets the rate limit to which the mount_monitor will report -consecutive change events to the mount and mount point entry files.

+consecutive change events to the mount and mount point entry files. +

- - @@ -831,25 +835,26 @@ consecutive change events to the mount and mount point entry files.


g_unix_is_mount_path_system_internal ()

-
gboolean            g_unix_is_mount_path_system_internal
-                                                        (const char *mount_path);
+
gboolean            g_unix_is_mount_path_system_internal
+                                                        (const char *mount_path);

Determines if mount_path is considered an implementation of the OS. This is primarily used for hiding mountable and mounted volumes that only are used in the OS and has little to no relevance to the -casual user.

+casual user. +

mount_monitor :

a GUnixMountMonitor +a GUnixMountMonitor

limit_msec :

a integer with the limit in milliseconds to +a integer with the limit in milliseconds to poll for changes.
- - @@ -862,15 +867,16 @@ casual user.

The "mountpoints-changed" signal

void                user_function                      (GUnixMountMonitor *monitor,
-                                                        gpointer           user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the unix mount points have changed.

+Emitted when the unix mount points have changed. +

mount_path :

a mount path, e.g. /media/disk +a mount path, e.g. /media/disk or /usr

Returns :

TRUE if mount_path is considered an implementation detail + TRUE if mount_path is considered an implementation detail of the OS.
- @@ -884,15 +890,16 @@ Emitted when the unix mount points have changed.

The "mounts-changed" signal

void                user_function                      (GUnixMountMonitor *monitor,
-                                                        gpointer           user_data)      : Run Last
+ gpointer user_data) : Run Last

-Emitted when the unix mounts have changed.

+Emitted when the unix mounts have changed. +

monitor :

the object on which the signal is emitted +the object on which the signal is emitted
- @@ -906,6 +913,6 @@ Emitted when the unix mounts have changed.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/gio-hierarchy.html b/docs/reference/gio/html/gio-hierarchy.html index 503f433..de2bfc0 100644 --- a/docs/reference/gio/html/gio-hierarchy.html +++ b/docs/reference/gio/html/gio-hierarchy.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

monitor :

the object on which the signal is emitted +the object on which the signal is emitted
@@ -53,7 +23,7 @@

Object Hierarchy

-    GObject
+    GObject
         GAppLaunchContext
         GInputStream
             GFilterInputStream
@@ -90,7 +60,7 @@
         GSocketAddress
             GInetSocketAddress
             GUnixSocketAddress
-        GTypeModule
+        GTypeModule
             GIOModule
         GMountOperation
         GVolumeMonitor
@@ -132,6 +102,6 @@
 
 
+          Generated by GTK-Doc V1.14
 
 
\ No newline at end of file
diff --git a/docs/reference/gio/html/gio.devhelp b/docs/reference/gio/html/gio.devhelp
index 6ad0373..a3dff97 100644
--- a/docs/reference/gio/html/gio.devhelp
+++ b/docs/reference/gio/html/gio.devhelp
@@ -114,7 +114,7 @@
     
       
       
-        
+        
         
         
       
diff --git a/docs/reference/gio/html/gio.devhelp2 b/docs/reference/gio/html/gio.devhelp2
index 08e7230..ac1978d 100644
--- a/docs/reference/gio/html/gio.devhelp2
+++ b/docs/reference/gio/html/gio.devhelp2
@@ -114,7 +114,7 @@
     
       
       
-        
+        
         
         
       
diff --git a/docs/reference/gio/html/highlevel-socket.html b/docs/reference/gio/html/highlevel-socket.html
index a742f13..6a320e8 100644
--- a/docs/reference/gio/html/highlevel-socket.html
+++ b/docs/reference/gio/html/highlevel-socket.html
@@ -8,38 +8,8 @@
 
 
 
-
+
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 
 
 
@@ -72,6 +42,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/icons.html b/docs/reference/gio/html/icons.html index 34c99c3..2cff8e7 100644 --- a/docs/reference/gio/html/icons.html +++ b/docs/reference/gio/html/icons.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -75,6 +45,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/index.html b/docs/reference/gio/html/index.html index f666d0d..8ab937a 100644 --- a/docs/reference/gio/html/index.html +++ b/docs/reference/gio/html/index.html @@ -6,38 +6,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@@ -45,7 +15,7 @@

- for GIO 2.24.0 + for GIO 2.24.2 The latest version of this documentation can be found on-line at http://library.gnome.org/devel/gio/unstable/. @@ -327,7 +297,7 @@ socket communication

Migrating from POSIX to GIO
Migrating from GnomeVFS to GIO
-
Trash handling
+
Trash handling
Operations on multiple files
Mime monitoring
@@ -343,6 +313,6 @@ socket communication
+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/index.sgml b/docs/reference/gio/html/index.sgml index ddba613..675513f 100644 --- a/docs/reference/gio/html/index.sgml +++ b/docs/reference/gio/html/index.sgml @@ -1,4 +1,3 @@ - diff --git a/docs/reference/gio/html/migrating.html b/docs/reference/gio/html/migrating.html index e3c2447..9249b0d 100644 --- a/docs/reference/gio/html/migrating.html +++ b/docs/reference/gio/html/migrating.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -58,7 +28,7 @@
Migrating from POSIX to GIO
Migrating from GnomeVFS to GIO
-
Trash handling
+
Trash handling
Operations on multiple files
Mime monitoring
@@ -67,6 +37,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/networking.html b/docs/reference/gio/html/networking.html index e82ae19..bdc4591 100644 --- a/docs/reference/gio/html/networking.html +++ b/docs/reference/gio/html/networking.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -82,6 +52,6 @@ socket communication + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/pt01.html b/docs/reference/gio/html/pt01.html index f3b574a..4e2985a 100644 --- a/docs/reference/gio/html/pt01.html +++ b/docs/reference/gio/html/pt01.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Part I. GIO Overview

+Part I. GIO Overview

Table of Contents

@@ -64,6 +34,6 @@
+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/gio/html/pt02.html b/docs/reference/gio/html/pt02.html index 4e604a9..e738913 100644 --- a/docs/reference/gio/html/pt02.html +++ b/docs/reference/gio/html/pt02.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

-Part II. API Reference

+Part II. API Reference

Table of Contents

@@ -318,6 +288,6 @@ socket communication
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/resolver.html b/docs/reference/gio/html/resolver.html index c10a844..9746d4f 100644 --- a/docs/reference/gio/html/resolver.html +++ b/docs/reference/gio/html/resolver.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -72,6 +42,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/streaming.html b/docs/reference/gio/html/streaming.html index 5301796..1fc0978 100644 --- a/docs/reference/gio/html/streaming.html +++ b/docs/reference/gio/html/streaming.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -117,6 +87,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/style.css b/docs/reference/gio/html/style.css index e31596b..82115eb 100644 --- a/docs/reference/gio/html/style.css +++ b/docs/reference/gio/html/style.css @@ -211,19 +211,19 @@ h2 .extralinks, h3 .extralinks /* code listings */ -.programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.programlisting .function { color: #000000; font-weight: bold; } -.programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ -.programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.programlisting .normal { color: #000000; } -.programlisting .number { color: #75507b; } /* tango: plum 2 */ -.programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.programlisting .type { color: #000000; } -.programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ +.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ +.listing_code .programlisting .function { color: #000000; font-weight: bold; } +.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ +.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ +.listing_code .programlisting .normal { color: #000000; } +.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ +.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ +.listing_code .programlisting .type { color: #000000; } +.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ +.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ .listing_frame { /* tango:sky blue 1 */ diff --git a/docs/reference/gio/html/types.html b/docs/reference/gio/html/types.html index 7c2b2bc..073e2a0 100644 --- a/docs/reference/gio/html/types.html +++ b/docs/reference/gio/html/types.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -66,6 +36,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/utils.html b/docs/reference/gio/html/utils.html index a1a13ea..31b86c4 100644 --- a/docs/reference/gio/html/utils.html +++ b/docs/reference/gio/html/utils.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -58,6 +28,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/html/volume_mon.html b/docs/reference/gio/html/volume_mon.html index 5e8e876..81fa5a0 100644 --- a/docs/reference/gio/html/volume_mon.html +++ b/docs/reference/gio/html/volume_mon.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -72,6 +42,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gio/tmpl/extensionpoints.sgml b/docs/reference/gio/tmpl/extensionpoints.sgml index ce36a90..3d2abec 100644 --- a/docs/reference/gio/tmpl/extensionpoints.sgml +++ b/docs/reference/gio/tmpl/extensionpoints.sgml @@ -9,14 +9,19 @@ Extension Points + + + + + diff --git a/docs/reference/gio/tmpl/gappinfo.sgml b/docs/reference/gio/tmpl/gappinfo.sgml index 00a042e..b7334d9 100644 --- a/docs/reference/gio/tmpl/gappinfo.sgml +++ b/docs/reference/gio/tmpl/gappinfo.sgml @@ -9,14 +9,19 @@ GAppInfo + + + + + @@ -295,6 +300,7 @@ GAppInfo +@void: @Returns: @@ -373,6 +379,7 @@ GAppInfo +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gasyncinitable.sgml b/docs/reference/gio/tmpl/gasyncinitable.sgml index f8fbba2..d167694 100644 --- a/docs/reference/gio/tmpl/gasyncinitable.sgml +++ b/docs/reference/gio/tmpl/gasyncinitable.sgml @@ -9,14 +9,19 @@ GAsyncInitable + + + + + diff --git a/docs/reference/gio/tmpl/gasyncresult.sgml b/docs/reference/gio/tmpl/gasyncresult.sgml index d47e81d..973af41 100644 --- a/docs/reference/gio/tmpl/gasyncresult.sgml +++ b/docs/reference/gio/tmpl/gasyncresult.sgml @@ -9,14 +9,19 @@ GAsyncResult + + + + + diff --git a/docs/reference/gio/tmpl/gbufferedinputstream.sgml b/docs/reference/gio/tmpl/gbufferedinputstream.sgml index 651bfde..a2366e2 100644 --- a/docs/reference/gio/tmpl/gbufferedinputstream.sgml +++ b/docs/reference/gio/tmpl/gbufferedinputstream.sgml @@ -9,14 +9,19 @@ GBufferedInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gbufferedoutputstream.sgml b/docs/reference/gio/tmpl/gbufferedoutputstream.sgml index 728c8a2..1446601 100644 --- a/docs/reference/gio/tmpl/gbufferedoutputstream.sgml +++ b/docs/reference/gio/tmpl/gbufferedoutputstream.sgml @@ -9,14 +9,19 @@ GBufferedOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gcancellable.sgml b/docs/reference/gio/tmpl/gcancellable.sgml index eb48ac3..af55605 100644 --- a/docs/reference/gio/tmpl/gcancellable.sgml +++ b/docs/reference/gio/tmpl/gcancellable.sgml @@ -9,14 +9,19 @@ GCancellable + + + + + @@ -35,6 +40,7 @@ GCancellable +@void: @Returns: @@ -89,6 +95,7 @@ GCancellable +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gcharsetconverter.sgml b/docs/reference/gio/tmpl/gcharsetconverter.sgml index d48c76a..fd3687b 100644 --- a/docs/reference/gio/tmpl/gcharsetconverter.sgml +++ b/docs/reference/gio/tmpl/gcharsetconverter.sgml @@ -9,14 +9,19 @@ GCharsetConverter + + + + + diff --git a/docs/reference/gio/tmpl/gcontenttype.sgml b/docs/reference/gio/tmpl/gcontenttype.sgml index 52be46f..70f942b 100644 --- a/docs/reference/gio/tmpl/gcontenttype.sgml +++ b/docs/reference/gio/tmpl/gcontenttype.sgml @@ -9,14 +9,19 @@ GContentType + + + + + @@ -117,6 +122,7 @@ GContentType +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gconverter.sgml b/docs/reference/gio/tmpl/gconverter.sgml index 791946c..648544f 100644 --- a/docs/reference/gio/tmpl/gconverter.sgml +++ b/docs/reference/gio/tmpl/gconverter.sgml @@ -9,14 +9,19 @@ GConverter + + + + + diff --git a/docs/reference/gio/tmpl/gconverterinputstream.sgml b/docs/reference/gio/tmpl/gconverterinputstream.sgml index a4bf9e3..c305795 100644 --- a/docs/reference/gio/tmpl/gconverterinputstream.sgml +++ b/docs/reference/gio/tmpl/gconverterinputstream.sgml @@ -9,14 +9,19 @@ GConverterInputstream + + + + + diff --git a/docs/reference/gio/tmpl/gconverteroutputstream.sgml b/docs/reference/gio/tmpl/gconverteroutputstream.sgml index 8665b5a..eb1bb2f 100644 --- a/docs/reference/gio/tmpl/gconverteroutputstream.sgml +++ b/docs/reference/gio/tmpl/gconverteroutputstream.sgml @@ -9,14 +9,19 @@ GConverterOutputstream + + + + + diff --git a/docs/reference/gio/tmpl/gdatainputstream.sgml b/docs/reference/gio/tmpl/gdatainputstream.sgml index cc17fb7..c16a8aa 100644 --- a/docs/reference/gio/tmpl/gdatainputstream.sgml +++ b/docs/reference/gio/tmpl/gdatainputstream.sgml @@ -9,14 +9,19 @@ GDataInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gdataoutputstream.sgml b/docs/reference/gio/tmpl/gdataoutputstream.sgml index e935967..7f99599 100644 --- a/docs/reference/gio/tmpl/gdataoutputstream.sgml +++ b/docs/reference/gio/tmpl/gdataoutputstream.sgml @@ -9,14 +9,19 @@ GDataOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gdesktopappinfo.sgml b/docs/reference/gio/tmpl/gdesktopappinfo.sgml index 636f226..2e3f7ae 100644 --- a/docs/reference/gio/tmpl/gdesktopappinfo.sgml +++ b/docs/reference/gio/tmpl/gdesktopappinfo.sgml @@ -9,14 +9,19 @@ Desktop file based GAppInfo + + + + + diff --git a/docs/reference/gio/tmpl/gdrive.sgml b/docs/reference/gio/tmpl/gdrive.sgml index 7ce01b1..d90dbdc 100644 --- a/docs/reference/gio/tmpl/gdrive.sgml +++ b/docs/reference/gio/tmpl/gdrive.sgml @@ -9,14 +9,19 @@ GDrive + + + + + diff --git a/docs/reference/gio/tmpl/gemblem.sgml b/docs/reference/gio/tmpl/gemblem.sgml index 25f634b..e60397f 100644 --- a/docs/reference/gio/tmpl/gemblem.sgml +++ b/docs/reference/gio/tmpl/gemblem.sgml @@ -9,14 +9,19 @@ GEmblem + + + + + diff --git a/docs/reference/gio/tmpl/gemblemedicon.sgml b/docs/reference/gio/tmpl/gemblemedicon.sgml index 482e0e2..754b8d7 100644 --- a/docs/reference/gio/tmpl/gemblemedicon.sgml +++ b/docs/reference/gio/tmpl/gemblemedicon.sgml @@ -9,14 +9,19 @@ GEmblemedIcon + + + + + diff --git a/docs/reference/gio/tmpl/gfile.sgml b/docs/reference/gio/tmpl/gfile.sgml index 48f2ac6..2f1c125 100644 --- a/docs/reference/gio/tmpl/gfile.sgml +++ b/docs/reference/gio/tmpl/gfile.sgml @@ -9,14 +9,19 @@ GFile + + + + + diff --git a/docs/reference/gio/tmpl/gfileattribute.sgml b/docs/reference/gio/tmpl/gfileattribute.sgml index 5046176..c8f0792 100644 --- a/docs/reference/gio/tmpl/gfileattribute.sgml +++ b/docs/reference/gio/tmpl/gfileattribute.sgml @@ -9,14 +9,19 @@ GFileAttribute + + + + + @@ -73,6 +78,7 @@ GFileAttribute +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gfiledescriptorbased.sgml b/docs/reference/gio/tmpl/gfiledescriptorbased.sgml index b400236..65d28d0 100644 --- a/docs/reference/gio/tmpl/gfiledescriptorbased.sgml +++ b/docs/reference/gio/tmpl/gfiledescriptorbased.sgml @@ -9,14 +9,19 @@ GFileDescriptorBased + + + + + diff --git a/docs/reference/gio/tmpl/gfileenumerator.sgml b/docs/reference/gio/tmpl/gfileenumerator.sgml index db64ae9..545b5dd 100644 --- a/docs/reference/gio/tmpl/gfileenumerator.sgml +++ b/docs/reference/gio/tmpl/gfileenumerator.sgml @@ -9,14 +9,19 @@ GFileEnumerator + + + + + diff --git a/docs/reference/gio/tmpl/gfileicon.sgml b/docs/reference/gio/tmpl/gfileicon.sgml index c95d515..7913876 100644 --- a/docs/reference/gio/tmpl/gfileicon.sgml +++ b/docs/reference/gio/tmpl/gfileicon.sgml @@ -9,14 +9,19 @@ GFileIcon + + + + + diff --git a/docs/reference/gio/tmpl/gfileinfo.sgml b/docs/reference/gio/tmpl/gfileinfo.sgml index 34cdbaf..4217d19 100644 --- a/docs/reference/gio/tmpl/gfileinfo.sgml +++ b/docs/reference/gio/tmpl/gfileinfo.sgml @@ -9,14 +9,19 @@ GFileInfo + + + + + @@ -558,6 +563,7 @@ GFileInfo +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gfileinputstream.sgml b/docs/reference/gio/tmpl/gfileinputstream.sgml index 063c5e1..cc5b655 100644 --- a/docs/reference/gio/tmpl/gfileinputstream.sgml +++ b/docs/reference/gio/tmpl/gfileinputstream.sgml @@ -9,14 +9,19 @@ GFileInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gfileiostream.sgml b/docs/reference/gio/tmpl/gfileiostream.sgml index cbade18..92311b2 100644 --- a/docs/reference/gio/tmpl/gfileiostream.sgml +++ b/docs/reference/gio/tmpl/gfileiostream.sgml @@ -9,14 +9,19 @@ GFileIOStream + + + + + diff --git a/docs/reference/gio/tmpl/gfilemonitor.sgml b/docs/reference/gio/tmpl/gfilemonitor.sgml index 8447221..e2f08f9 100644 --- a/docs/reference/gio/tmpl/gfilemonitor.sgml +++ b/docs/reference/gio/tmpl/gfilemonitor.sgml @@ -9,14 +9,19 @@ GFileMonitor + + + + + diff --git a/docs/reference/gio/tmpl/gfilenamecompleter.sgml b/docs/reference/gio/tmpl/gfilenamecompleter.sgml index 5c3e79d..68bc0d6 100644 --- a/docs/reference/gio/tmpl/gfilenamecompleter.sgml +++ b/docs/reference/gio/tmpl/gfilenamecompleter.sgml @@ -9,14 +9,19 @@ GFilenameCompleter + + + + + @@ -35,6 +40,7 @@ GFilenameCompleter +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gfileoutputstream.sgml b/docs/reference/gio/tmpl/gfileoutputstream.sgml index 419af7f..8d86a84 100644 --- a/docs/reference/gio/tmpl/gfileoutputstream.sgml +++ b/docs/reference/gio/tmpl/gfileoutputstream.sgml @@ -9,14 +9,19 @@ GFileOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gfilterinputstream.sgml b/docs/reference/gio/tmpl/gfilterinputstream.sgml index 0f32997..79dc65d 100644 --- a/docs/reference/gio/tmpl/gfilterinputstream.sgml +++ b/docs/reference/gio/tmpl/gfilterinputstream.sgml @@ -9,14 +9,19 @@ GFilterInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gfilteroutputstream.sgml b/docs/reference/gio/tmpl/gfilteroutputstream.sgml index 788b561..40dc44b 100644 --- a/docs/reference/gio/tmpl/gfilteroutputstream.sgml +++ b/docs/reference/gio/tmpl/gfilteroutputstream.sgml @@ -9,14 +9,19 @@ GFilterOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gicon.sgml b/docs/reference/gio/tmpl/gicon.sgml index fbcb3fd..2852ecb 100644 --- a/docs/reference/gio/tmpl/gicon.sgml +++ b/docs/reference/gio/tmpl/gicon.sgml @@ -9,14 +9,19 @@ GIcon + + + + + diff --git a/docs/reference/gio/tmpl/ginetaddress.sgml b/docs/reference/gio/tmpl/ginetaddress.sgml index 4f3e368..5b5283f 100644 --- a/docs/reference/gio/tmpl/ginetaddress.sgml +++ b/docs/reference/gio/tmpl/ginetaddress.sgml @@ -9,14 +9,19 @@ GInetAddress + + + + + diff --git a/docs/reference/gio/tmpl/ginetsocketaddress.sgml b/docs/reference/gio/tmpl/ginetsocketaddress.sgml index 5ef20dd..5a84445 100644 --- a/docs/reference/gio/tmpl/ginetsocketaddress.sgml +++ b/docs/reference/gio/tmpl/ginetsocketaddress.sgml @@ -9,14 +9,19 @@ GInetSocketAddress + + + + + diff --git a/docs/reference/gio/tmpl/ginitable.sgml b/docs/reference/gio/tmpl/ginitable.sgml index f0504b3..595596f 100644 --- a/docs/reference/gio/tmpl/ginitable.sgml +++ b/docs/reference/gio/tmpl/ginitable.sgml @@ -9,14 +9,19 @@ GInitable + + + + + diff --git a/docs/reference/gio/tmpl/ginputstream.sgml b/docs/reference/gio/tmpl/ginputstream.sgml index d7496f0..7a55e4f 100644 --- a/docs/reference/gio/tmpl/ginputstream.sgml +++ b/docs/reference/gio/tmpl/ginputstream.sgml @@ -9,14 +9,19 @@ GInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gioerror.sgml b/docs/reference/gio/tmpl/gioerror.sgml index 6c6ade2..cd9b2f5 100644 --- a/docs/reference/gio/tmpl/gioerror.sgml +++ b/docs/reference/gio/tmpl/gioerror.sgml @@ -9,14 +9,19 @@ GIOError + + + + + diff --git a/docs/reference/gio/tmpl/giomodule.sgml b/docs/reference/gio/tmpl/giomodule.sgml index c501424..84606a1 100644 --- a/docs/reference/gio/tmpl/giomodule.sgml +++ b/docs/reference/gio/tmpl/giomodule.sgml @@ -9,14 +9,19 @@ GIOModule + + + + + @@ -70,6 +75,7 @@ GIOModule +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gioscheduler.sgml b/docs/reference/gio/tmpl/gioscheduler.sgml index 77af9cf..485b3a2 100644 --- a/docs/reference/gio/tmpl/gioscheduler.sgml +++ b/docs/reference/gio/tmpl/gioscheduler.sgml @@ -9,14 +9,19 @@ GIOScheduler + + + + + @@ -51,6 +56,7 @@ GIOScheduler +@void: diff --git a/docs/reference/gio/tmpl/giostream.sgml b/docs/reference/gio/tmpl/giostream.sgml index ebd80b6..fe6e884 100644 --- a/docs/reference/gio/tmpl/giostream.sgml +++ b/docs/reference/gio/tmpl/giostream.sgml @@ -9,14 +9,19 @@ GIOStream + + + + + diff --git a/docs/reference/gio/tmpl/gloadableicon.sgml b/docs/reference/gio/tmpl/gloadableicon.sgml index 7093f1f..36919b2 100644 --- a/docs/reference/gio/tmpl/gloadableicon.sgml +++ b/docs/reference/gio/tmpl/gloadableicon.sgml @@ -9,14 +9,19 @@ GLoadableIcon + + + + + diff --git a/docs/reference/gio/tmpl/gmemoryinputstream.sgml b/docs/reference/gio/tmpl/gmemoryinputstream.sgml index 6e4cc88..9fd949f 100644 --- a/docs/reference/gio/tmpl/gmemoryinputstream.sgml +++ b/docs/reference/gio/tmpl/gmemoryinputstream.sgml @@ -9,14 +9,19 @@ GMemoryInputStream + + + + + @@ -28,6 +33,7 @@ GMemoryInputStream +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gmemoryoutputstream.sgml b/docs/reference/gio/tmpl/gmemoryoutputstream.sgml index b22faae..8acb7b6 100644 --- a/docs/reference/gio/tmpl/gmemoryoutputstream.sgml +++ b/docs/reference/gio/tmpl/gmemoryoutputstream.sgml @@ -9,14 +9,19 @@ GMemoryOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gmount.sgml b/docs/reference/gio/tmpl/gmount.sgml index 31301e1..647d4e0 100644 --- a/docs/reference/gio/tmpl/gmount.sgml +++ b/docs/reference/gio/tmpl/gmount.sgml @@ -9,14 +9,19 @@ GMount + + + + + diff --git a/docs/reference/gio/tmpl/gmountoperation.sgml b/docs/reference/gio/tmpl/gmountoperation.sgml index ac6311c..ae3b2e9 100644 --- a/docs/reference/gio/tmpl/gmountoperation.sgml +++ b/docs/reference/gio/tmpl/gmountoperation.sgml @@ -9,14 +9,19 @@ GMountOperation + + + + + @@ -132,6 +137,7 @@ GMountOperation +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gnetworkaddress.sgml b/docs/reference/gio/tmpl/gnetworkaddress.sgml index b2a055c..4dd33c6 100644 --- a/docs/reference/gio/tmpl/gnetworkaddress.sgml +++ b/docs/reference/gio/tmpl/gnetworkaddress.sgml @@ -9,14 +9,19 @@ GNetworkAddress + + + + + diff --git a/docs/reference/gio/tmpl/gnetworkservice.sgml b/docs/reference/gio/tmpl/gnetworkservice.sgml index 6857396..9f13312 100644 --- a/docs/reference/gio/tmpl/gnetworkservice.sgml +++ b/docs/reference/gio/tmpl/gnetworkservice.sgml @@ -9,14 +9,19 @@ GNetworkService + + + + + diff --git a/docs/reference/gio/tmpl/goutputstream.sgml b/docs/reference/gio/tmpl/goutputstream.sgml index f6156f0..567151a 100644 --- a/docs/reference/gio/tmpl/goutputstream.sgml +++ b/docs/reference/gio/tmpl/goutputstream.sgml @@ -9,14 +9,19 @@ GOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gresolver.sgml b/docs/reference/gio/tmpl/gresolver.sgml index cb2208d..235a53a 100644 --- a/docs/reference/gio/tmpl/gresolver.sgml +++ b/docs/reference/gio/tmpl/gresolver.sgml @@ -9,14 +9,19 @@ GResolver + + + + + @@ -35,6 +40,7 @@ GResolver +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gseekable.sgml b/docs/reference/gio/tmpl/gseekable.sgml index b74f185..d918aeb 100644 --- a/docs/reference/gio/tmpl/gseekable.sgml +++ b/docs/reference/gio/tmpl/gseekable.sgml @@ -9,14 +9,19 @@ GSeekable + + + + + diff --git a/docs/reference/gio/tmpl/gsimpleasyncresult.sgml b/docs/reference/gio/tmpl/gsimpleasyncresult.sgml index ca13aa0..ce116fa 100644 --- a/docs/reference/gio/tmpl/gsimpleasyncresult.sgml +++ b/docs/reference/gio/tmpl/gsimpleasyncresult.sgml @@ -9,14 +9,19 @@ GSimpleAsyncResult + + + + + diff --git a/docs/reference/gio/tmpl/gsocket.sgml b/docs/reference/gio/tmpl/gsocket.sgml index d0943e3..daa6050 100644 --- a/docs/reference/gio/tmpl/gsocket.sgml +++ b/docs/reference/gio/tmpl/gsocket.sgml @@ -9,14 +9,19 @@ GSocket + + + + + diff --git a/docs/reference/gio/tmpl/gsocketaddress.sgml b/docs/reference/gio/tmpl/gsocketaddress.sgml index 7db4c30..ec60606 100644 --- a/docs/reference/gio/tmpl/gsocketaddress.sgml +++ b/docs/reference/gio/tmpl/gsocketaddress.sgml @@ -9,14 +9,19 @@ GSocketAddress + + + + + diff --git a/docs/reference/gio/tmpl/gsocketclient.sgml b/docs/reference/gio/tmpl/gsocketclient.sgml index 3c0eec3..1b7a2e7 100644 --- a/docs/reference/gio/tmpl/gsocketclient.sgml +++ b/docs/reference/gio/tmpl/gsocketclient.sgml @@ -9,14 +9,19 @@ GSocketClient + + + + + @@ -48,6 +53,7 @@ GSocketClient +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gsocketconnectable.sgml b/docs/reference/gio/tmpl/gsocketconnectable.sgml index 9c3ee3b..769d4a6 100644 --- a/docs/reference/gio/tmpl/gsocketconnectable.sgml +++ b/docs/reference/gio/tmpl/gsocketconnectable.sgml @@ -9,14 +9,19 @@ GSocketConnectable + + + + + diff --git a/docs/reference/gio/tmpl/gsocketconnection.sgml b/docs/reference/gio/tmpl/gsocketconnection.sgml index c6e573d..a2ed560 100644 --- a/docs/reference/gio/tmpl/gsocketconnection.sgml +++ b/docs/reference/gio/tmpl/gsocketconnection.sgml @@ -9,14 +9,19 @@ GSocketConnection + + + + + diff --git a/docs/reference/gio/tmpl/gsocketcontrolmessage.sgml b/docs/reference/gio/tmpl/gsocketcontrolmessage.sgml index 3d93883..f1a83d8 100644 --- a/docs/reference/gio/tmpl/gsocketcontrolmessage.sgml +++ b/docs/reference/gio/tmpl/gsocketcontrolmessage.sgml @@ -9,14 +9,19 @@ GSocketControlMessage + + + + + diff --git a/docs/reference/gio/tmpl/gsocketlistener.sgml b/docs/reference/gio/tmpl/gsocketlistener.sgml index efd06f4..85249f6 100644 --- a/docs/reference/gio/tmpl/gsocketlistener.sgml +++ b/docs/reference/gio/tmpl/gsocketlistener.sgml @@ -9,14 +9,19 @@ GSocketListener + + + + + @@ -33,6 +38,7 @@ GSocketListener +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gsocketservice.sgml b/docs/reference/gio/tmpl/gsocketservice.sgml index 24603bd..347c172 100644 --- a/docs/reference/gio/tmpl/gsocketservice.sgml +++ b/docs/reference/gio/tmpl/gsocketservice.sgml @@ -9,14 +9,19 @@ GSocketService + + + + + @@ -38,6 +43,7 @@ GSocketService +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gsrvtarget.sgml b/docs/reference/gio/tmpl/gsrvtarget.sgml index 8ecb9e2..fcd6807 100644 --- a/docs/reference/gio/tmpl/gsrvtarget.sgml +++ b/docs/reference/gio/tmpl/gsrvtarget.sgml @@ -9,14 +9,19 @@ GSrvTarget + + + + + diff --git a/docs/reference/gio/tmpl/gthemedicon.sgml b/docs/reference/gio/tmpl/gthemedicon.sgml index ac37f88..3324a03 100644 --- a/docs/reference/gio/tmpl/gthemedicon.sgml +++ b/docs/reference/gio/tmpl/gthemedicon.sgml @@ -9,14 +9,19 @@ GThemedIcon + + + + + diff --git a/docs/reference/gio/tmpl/gthreadedsocketservice.sgml b/docs/reference/gio/tmpl/gthreadedsocketservice.sgml index a8df8d9..a780a14 100644 --- a/docs/reference/gio/tmpl/gthreadedsocketservice.sgml +++ b/docs/reference/gio/tmpl/gthreadedsocketservice.sgml @@ -9,14 +9,19 @@ GThreadedSocketService + + + + + diff --git a/docs/reference/gio/tmpl/gunixfdlist.sgml b/docs/reference/gio/tmpl/gunixfdlist.sgml index 4018a0d..54613d1 100644 --- a/docs/reference/gio/tmpl/gunixfdlist.sgml +++ b/docs/reference/gio/tmpl/gunixfdlist.sgml @@ -9,14 +9,19 @@ GUnixFDList + + + + + @@ -38,6 +43,7 @@ GUnixFDList +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gunixfdmessage.sgml b/docs/reference/gio/tmpl/gunixfdmessage.sgml index 69a48ca..ab5bab0 100644 --- a/docs/reference/gio/tmpl/gunixfdmessage.sgml +++ b/docs/reference/gio/tmpl/gunixfdmessage.sgml @@ -9,14 +9,19 @@ GUnixFDMessage + + + + + @@ -42,6 +47,7 @@ GUnixFDMessage +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gunixinputstream.sgml b/docs/reference/gio/tmpl/gunixinputstream.sgml index a4b9eda..4dcdd92 100644 --- a/docs/reference/gio/tmpl/gunixinputstream.sgml +++ b/docs/reference/gio/tmpl/gunixinputstream.sgml @@ -9,14 +9,19 @@ GUnixInputStream + + + + + diff --git a/docs/reference/gio/tmpl/gunixmounts.sgml b/docs/reference/gio/tmpl/gunixmounts.sgml index 93086a7..10de671 100644 --- a/docs/reference/gio/tmpl/gunixmounts.sgml +++ b/docs/reference/gio/tmpl/gunixmounts.sgml @@ -9,14 +9,19 @@ Unix Mounts + + + + + @@ -304,6 +309,7 @@ Unix Mounts +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gunixoutputstream.sgml b/docs/reference/gio/tmpl/gunixoutputstream.sgml index d5d5460..5442bd4 100644 --- a/docs/reference/gio/tmpl/gunixoutputstream.sgml +++ b/docs/reference/gio/tmpl/gunixoutputstream.sgml @@ -9,14 +9,19 @@ GUnixOutputStream + + + + + diff --git a/docs/reference/gio/tmpl/gunixsocketaddress.sgml b/docs/reference/gio/tmpl/gunixsocketaddress.sgml index fffba80..0bbefd0 100644 --- a/docs/reference/gio/tmpl/gunixsocketaddress.sgml +++ b/docs/reference/gio/tmpl/gunixsocketaddress.sgml @@ -9,14 +9,19 @@ GUnixSocketAddress + + + + + @@ -89,6 +94,7 @@ GUnixSocketAddress +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gvfs.sgml b/docs/reference/gio/tmpl/gvfs.sgml index 8672015..b98f97c 100644 --- a/docs/reference/gio/tmpl/gvfs.sgml +++ b/docs/reference/gio/tmpl/gvfs.sgml @@ -9,14 +9,19 @@ GVfs + + + + + @@ -65,6 +70,7 @@ GVfs +@void: @Returns: @@ -73,6 +79,7 @@ GVfs +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gvolume.sgml b/docs/reference/gio/tmpl/gvolume.sgml index ff3c2ed..8a759e2 100644 --- a/docs/reference/gio/tmpl/gvolume.sgml +++ b/docs/reference/gio/tmpl/gvolume.sgml @@ -9,14 +9,19 @@ GVolume + + + + + diff --git a/docs/reference/gio/tmpl/gvolumemonitor.sgml b/docs/reference/gio/tmpl/gvolumemonitor.sgml index 3320420..ecd4128 100644 --- a/docs/reference/gio/tmpl/gvolumemonitor.sgml +++ b/docs/reference/gio/tmpl/gvolumemonitor.sgml @@ -9,14 +9,19 @@ GVolumeMonitor + + + + + @@ -131,6 +136,7 @@ GVolumeMonitor +@void: @Returns: diff --git a/docs/reference/gio/tmpl/gzcompressor.sgml b/docs/reference/gio/tmpl/gzcompressor.sgml index b7bc7a4..765ce79 100644 --- a/docs/reference/gio/tmpl/gzcompressor.sgml +++ b/docs/reference/gio/tmpl/gzcompressor.sgml @@ -9,14 +9,19 @@ GZlibCompressor + + + + + diff --git a/docs/reference/gio/tmpl/gzdecompressor.sgml b/docs/reference/gio/tmpl/gzdecompressor.sgml index 788e7e7..69cf3bf 100644 --- a/docs/reference/gio/tmpl/gzdecompressor.sgml +++ b/docs/reference/gio/tmpl/gzdecompressor.sgml @@ -9,14 +9,19 @@ GZlibDecompressor + + + + + diff --git a/docs/reference/gio/version.xml b/docs/reference/gio/version.xml new file mode 100644 index 0000000..5827d9b --- /dev/null +++ b/docs/reference/gio/version.xml @@ -0,0 +1 @@ +2.24.2 diff --git a/docs/reference/glib/gtester-report.1 b/docs/reference/glib/gtester-report.1 index 49b8484..fa3fe18 100644 --- a/docs/reference/glib/gtester-report.1 +++ b/docs/reference/glib/gtester-report.1 @@ -1,13 +1,13 @@ '\" t .\" Title: gtester-report .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.74.2 -.\" Date: 03/13/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 05/02/2010 .\" Manual: [FIXME: manual] .\" Source: [FIXME: source] .\" Language: English .\" -.TH "GTESTER\-REPORT" "1" "03/13/2009" "[FIXME: source]" "[FIXME: manual]" +.TH "GTESTER\-REPORT" "1" "05/02/2010" "[FIXME: source]" "[FIXME: manual]" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- diff --git a/docs/reference/glib/html/api-index-2-10.html b/docs/reference/glib/html/api-index-2-10.html index b1f87f1..b3ef830 100644 --- a/docs/reference/glib/html/api-index-2-10.html +++ b/docs/reference/glib/html/api-index-2-10.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -64,77 +44,137 @@

Index of new symbols in 2.10

A

-
g_async_queue_push_sorted
+
+g_async_queue_push_sorted, function in Asynchronous Queues +
-
g_async_queue_push_sorted_unlocked
+
+g_async_queue_push_sorted_unlocked, function in Asynchronous Queues +
-
g_async_queue_sort
+
+g_async_queue_sort, function in Asynchronous Queues +
-
g_async_queue_sort_unlocked
+
+g_async_queue_sort_unlocked, function in Asynchronous Queues +
-
g_atomic_int_set
+
+g_atomic_int_set, function in Atomic Operations +
-
g_atomic_pointer_set
+
+g_atomic_pointer_set, function in Atomic Operations +

D

-
g_date_set_time_t
+
+g_date_set_time_t, function in Date and Time Functions +
-
g_date_set_time_val
+
+g_date_set_time_val, function in Date and Time Functions +

G

-
G_GNUC_WARN_UNUSED_RESULT
+
+G_GNUC_WARN_UNUSED_RESULT, macro in Miscellaneous Macros +
-
G_GUINT64_CONSTANT
+
+G_GUINT64_CONSTANT, macro in Basic Types +

H

-
g_hash_table_ref
+
+g_hash_table_ref, function in Hash Tables +
-
g_hash_table_unref
+
+g_hash_table_unref, function in Hash Tables +

I

-
g_intern_static_string
+
+g_intern_static_string, function in Quarks +
-
g_intern_string
+
+g_intern_string, function in Quarks +

L

-
g_list_insert_sorted_with_data
+
+g_list_insert_sorted_with_data, function in Doubly-Linked Lists +

M

-
g_main_context_is_owner
+
+g_main_context_is_owner, function in The Main Event Loop +

S

-
g_slice_alloc
+
+g_slice_alloc, function in Memory Slices +
-
g_slice_alloc0
+
+g_slice_alloc0, function in Memory Slices +
-
g_slice_free
+
+g_slice_free, macro in Memory Slices +
-
g_slice_free1
+
+g_slice_free1, function in Memory Slices +
-
g_slice_free_chain
+
+g_slice_free_chain, macro in Memory Slices +
-
g_slice_free_chain_with_offset
+
+g_slice_free_chain_with_offset, function in Memory Slices +
-
g_slice_new
+
+g_slice_new, macro in Memory Slices +
-
g_slice_new0
+
+g_slice_new0, macro in Memory Slices +
-
g_slist_free1
+
+g_slist_free1, macro in Singly-Linked Lists +
-
g_slist_insert_sorted_with_data
+
+g_slist_insert_sorted_with_data, function in Singly-Linked Lists +

T

-
g_thread_foreach
+
+g_thread_foreach, function in Threads +
-
g_thread_pool_get_max_idle_time
+
+g_thread_pool_get_max_idle_time, function in Thread Pools +
-
g_thread_pool_set_max_idle_time
+
+g_thread_pool_set_max_idle_time, function in Thread Pools +
-
g_thread_pool_set_sort_function
+
+g_thread_pool_set_sort_function, function in Thread Pools +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-12.html b/docs/reference/glib/html/api-index-2-12.html index 9f231cd..c2d410f 100644 --- a/docs/reference/glib/html/api-index-2-12.html +++ b/docs/reference/glib/html/api-index-2-12.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -64,143 +44,269 @@

Index of new symbols in 2.12

A

-
g_ascii_strtoll
+
+g_ascii_strtoll, function in String Utility Functions +

B

-
g_base64_decode
+
+g_base64_decode, function in Base64 Encoding +
-
g_base64_decode_step
+
+g_base64_decode_step, function in Base64 Encoding +
-
g_base64_encode
+
+g_base64_encode, function in Base64 Encoding +
-
g_base64_encode_close
+
+g_base64_encode_close, function in Base64 Encoding +
-
g_base64_encode_step
+
+g_base64_encode_step, function in Base64 Encoding +
-
g_bookmark_file_add_application
+
+g_bookmark_file_add_application, function in Bookmark file parser +
-
g_bookmark_file_add_group
+
+g_bookmark_file_add_group, function in Bookmark file parser +
-
g_bookmark_file_free
+
+g_bookmark_file_free, function in Bookmark file parser +
-
g_bookmark_file_get_added
+
+g_bookmark_file_get_added, function in Bookmark file parser +
-
g_bookmark_file_get_applications
+
+g_bookmark_file_get_applications, function in Bookmark file parser +
-
g_bookmark_file_get_app_info
+
+g_bookmark_file_get_app_info, function in Bookmark file parser +
-
g_bookmark_file_get_description
+
+g_bookmark_file_get_description, function in Bookmark file parser +
-
g_bookmark_file_get_groups
+
+g_bookmark_file_get_groups, function in Bookmark file parser +
-
g_bookmark_file_get_icon
+
+g_bookmark_file_get_icon, function in Bookmark file parser +
-
g_bookmark_file_get_is_private
+
+g_bookmark_file_get_is_private, function in Bookmark file parser +
-
g_bookmark_file_get_mime_type
+
+g_bookmark_file_get_mime_type, function in Bookmark file parser +
-
g_bookmark_file_get_modified
+
+g_bookmark_file_get_modified, function in Bookmark file parser +
-
g_bookmark_file_get_size
+
+g_bookmark_file_get_size, function in Bookmark file parser +
-
g_bookmark_file_get_title
+
+g_bookmark_file_get_title, function in Bookmark file parser +
-
g_bookmark_file_get_uris
+
+g_bookmark_file_get_uris, function in Bookmark file parser +
-
g_bookmark_file_get_visited
+
+g_bookmark_file_get_visited, function in Bookmark file parser +
-
g_bookmark_file_has_application
+
+g_bookmark_file_has_application, function in Bookmark file parser +
-
g_bookmark_file_has_group
+
+g_bookmark_file_has_group, function in Bookmark file parser +
-
g_bookmark_file_has_item
+
+g_bookmark_file_has_item, function in Bookmark file parser +
-
g_bookmark_file_load_from_data
+
+g_bookmark_file_load_from_data, function in Bookmark file parser +
-
g_bookmark_file_load_from_data_dirs
+
+g_bookmark_file_load_from_data_dirs, function in Bookmark file parser +
-
g_bookmark_file_load_from_file
+
+g_bookmark_file_load_from_file, function in Bookmark file parser +
-
g_bookmark_file_move_item
+
+g_bookmark_file_move_item, function in Bookmark file parser +
-
g_bookmark_file_new
+
+g_bookmark_file_new, function in Bookmark file parser +
-
g_bookmark_file_remove_application
+
+g_bookmark_file_remove_application, function in Bookmark file parser +
-
g_bookmark_file_remove_group
+
+g_bookmark_file_remove_group, function in Bookmark file parser +
-
g_bookmark_file_remove_item
+
+g_bookmark_file_remove_item, function in Bookmark file parser +
-
g_bookmark_file_set_added
+
+g_bookmark_file_set_added, function in Bookmark file parser +
-
g_bookmark_file_set_app_info
+
+g_bookmark_file_set_app_info, function in Bookmark file parser +
-
g_bookmark_file_set_description
+
+g_bookmark_file_set_description, function in Bookmark file parser +
-
g_bookmark_file_set_groups
+
+g_bookmark_file_set_groups, function in Bookmark file parser +
-
g_bookmark_file_set_icon
+
+g_bookmark_file_set_icon, function in Bookmark file parser +
-
g_bookmark_file_set_is_private
+
+g_bookmark_file_set_is_private, function in Bookmark file parser +
-
g_bookmark_file_set_mime_type
+
+g_bookmark_file_set_mime_type, function in Bookmark file parser +
-
g_bookmark_file_set_modified
+
+g_bookmark_file_set_modified, function in Bookmark file parser +
-
g_bookmark_file_set_title
+
+g_bookmark_file_set_title, function in Bookmark file parser +
-
g_bookmark_file_set_visited
+
+g_bookmark_file_set_visited, function in Bookmark file parser +
-
g_bookmark_file_to_data
+
+g_bookmark_file_to_data, function in Bookmark file parser +
-
g_bookmark_file_to_file
+
+g_bookmark_file_to_file, function in Bookmark file parser +

H

-
g_hash_table_remove_all
+
+g_hash_table_remove_all, function in Hash Tables +
-
g_hash_table_steal_all
+
+g_hash_table_steal_all, function in Hash Tables +

K

-
g_key_file_get_double
+
+g_key_file_get_double, function in Key-value file parser +
-
g_key_file_get_double_list
+
+g_key_file_get_double_list, function in Key-value file parser +
-
g_key_file_set_double
+
+g_key_file_set_double, function in Key-value file parser +
-
g_key_file_set_double_list
+
+g_key_file_set_double_list, function in Key-value file parser +

M

-
g_main_current_source
+
+g_main_current_source, function in The Main Event Loop +

O

-
g_option_context_get_description
+
+g_option_context_get_description, function in Commandline option parser +
-
g_option_context_get_summary
+
+g_option_context_get_summary, function in Commandline option parser +
-
g_option_context_set_description
+
+g_option_context_set_description, function in Commandline option parser +
-
g_option_context_set_summary
+
+g_option_context_set_summary, function in Commandline option parser +
-
g_option_context_set_translate_func
+
+g_option_context_set_translate_func, function in Commandline option parser +
-
g_option_context_set_translation_domain
+
+g_option_context_set_translation_domain, function in Commandline option parser +

S

-
g_source_is_destroyed
+
+g_source_is_destroyed, function in The Main Event Loop +
-
g_source_set_funcs
+
+g_source_set_funcs, function in The Main Event Loop +

T

-
g_time_val_from_iso8601
+
+g_time_val_from_iso8601, function in Date and Time Functions +
-
g_time_val_to_iso8601
+
+g_time_val_to_iso8601, function in Date and Time Functions +

U

-
g_unichar_iswide_cjk
+
+g_unichar_iswide_cjk, function in Unicode Manipulation +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-14.html b/docs/reference/glib/html/api-index-2-14.html index af0645a..2e591cd 100644 --- a/docs/reference/glib/html/api-index-2-14.html +++ b/docs/reference/glib/html/api-index-2-14.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -66,268 +46,518 @@

Index of new symbols in 2.14

G

-
g_get_user_special_dir
+
+g_get_user_special_dir, function in Miscellaneous Utility Functions +

H

-
g_hash_table_get_keys
+
+g_hash_table_get_keys, function in Hash Tables +
-
g_hash_table_get_values
+
+g_hash_table_get_values, function in Hash Tables +

K

-
G_KEY_FILE_DESKTOP_GROUP
+
+G_KEY_FILE_DESKTOP_GROUP, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_CATEGORIES
+
+G_KEY_FILE_DESKTOP_KEY_CATEGORIES, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_COMMENT
+
+G_KEY_FILE_DESKTOP_KEY_COMMENT, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_EXEC
+
+G_KEY_FILE_DESKTOP_KEY_EXEC, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME
+
+G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_HIDDEN
+
+G_KEY_FILE_DESKTOP_KEY_HIDDEN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_ICON
+
+G_KEY_FILE_DESKTOP_KEY_ICON, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_MIME_TYPE
+
+G_KEY_FILE_DESKTOP_KEY_MIME_TYPE, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NAME
+
+G_KEY_FILE_DESKTOP_KEY_NAME, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN
+
+G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY
+
+G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN
+
+G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_PATH
+
+G_KEY_FILE_DESKTOP_KEY_PATH, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY
+
+G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS
+
+G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TERMINAL
+
+G_KEY_FILE_DESKTOP_KEY_TERMINAL, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TRY_EXEC
+
+G_KEY_FILE_DESKTOP_KEY_TRY_EXEC, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TYPE
+
+G_KEY_FILE_DESKTOP_KEY_TYPE, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_URL
+
+G_KEY_FILE_DESKTOP_KEY_URL, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_VERSION
+
+G_KEY_FILE_DESKTOP_KEY_VERSION, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_APPLICATION
+
+G_KEY_FILE_DESKTOP_TYPE_APPLICATION, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_DIRECTORY
+
+G_KEY_FILE_DESKTOP_TYPE_DIRECTORY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_LINK
+
+G_KEY_FILE_DESKTOP_TYPE_LINK, macro in Key-value file parser +
-
g_key_file_load_from_dirs
+
+g_key_file_load_from_dirs, function in Key-value file parser +

M

-
GMatchInfo
+
+GMatchInfo, struct in Perl-compatible regular expressions +
-
g_match_info_expand_references
+
+g_match_info_expand_references, function in Perl-compatible regular expressions +
-
g_match_info_fetch
+
+g_match_info_fetch, function in Perl-compatible regular expressions +
-
g_match_info_fetch_all
+
+g_match_info_fetch_all, function in Perl-compatible regular expressions +
-
g_match_info_fetch_named
+
+g_match_info_fetch_named, function in Perl-compatible regular expressions +
-
g_match_info_fetch_named_pos
+
+g_match_info_fetch_named_pos, function in Perl-compatible regular expressions +
-
g_match_info_fetch_pos
+
+g_match_info_fetch_pos, function in Perl-compatible regular expressions +
-
g_match_info_free
+
+g_match_info_free, function in Perl-compatible regular expressions +
-
g_match_info_get_match_count
+
+g_match_info_get_match_count, function in Perl-compatible regular expressions +
-
g_match_info_get_regex
+
+g_match_info_get_regex, function in Perl-compatible regular expressions +
-
g_match_info_get_string
+
+g_match_info_get_string, function in Perl-compatible regular expressions +
-
g_match_info_is_partial_match
+
+g_match_info_is_partial_match, function in Perl-compatible regular expressions +
-
g_match_info_matches
+
+g_match_info_matches, function in Perl-compatible regular expressions +
-
g_match_info_next
+
+g_match_info_next, function in Perl-compatible regular expressions +
-
G_MAXSSIZE
+
+G_MAXSSIZE, macro in Limits of Basic Types +
-
G_MINSSIZE
+
+G_MINSSIZE, macro in Limits of Basic Types +

O

-
g_once_init_enter
+
+g_once_init_enter, function in Threads +
-
g_once_init_leave
+
+g_once_init_leave, function in Threads +
-
g_option_context_get_help
+
+g_option_context_get_help, function in Commandline option parser +

Q

-
g_queue_clear
+
+g_queue_clear, function in Double-ended Queues +
-
g_queue_init
+
+g_queue_init, function in Double-ended Queues +
-
G_QUEUE_INIT
+
+G_QUEUE_INIT, macro in Double-ended Queues +

R

-
GRegex
+
+GRegex, struct in Perl-compatible regular expressions +
-
GRegexCompileFlags
+
+GRegexCompileFlags, enum in Perl-compatible regular expressions +
-
GRegexError
+
+GRegexError, enum in Perl-compatible regular expressions +
-
GRegexEvalCallback
+
+GRegexEvalCallback, user_function in Perl-compatible regular expressions +
-
GRegexMatchFlags
+
+GRegexMatchFlags, enum in Perl-compatible regular expressions +
-
g_regex_check_replacement
+
+g_regex_check_replacement, function in Perl-compatible regular expressions +
-
G_REGEX_ERROR
+
+G_REGEX_ERROR, macro in Perl-compatible regular expressions +
-
g_regex_escape_string
+
+g_regex_escape_string, function in Perl-compatible regular expressions +
-
g_regex_get_capture_count
+
+g_regex_get_capture_count, function in Perl-compatible regular expressions +
-
g_regex_get_max_backref
+
+g_regex_get_max_backref, function in Perl-compatible regular expressions +
-
g_regex_get_pattern
+
+g_regex_get_pattern, function in Perl-compatible regular expressions +
-
g_regex_get_string_number
+
+g_regex_get_string_number, function in Perl-compatible regular expressions +
-
g_regex_match
+
+g_regex_match, function in Perl-compatible regular expressions +
-
g_regex_match_all
+
+g_regex_match_all, function in Perl-compatible regular expressions +
-
g_regex_match_all_full
+
+g_regex_match_all_full, function in Perl-compatible regular expressions +
-
g_regex_match_full
+
+g_regex_match_full, function in Perl-compatible regular expressions +
-
g_regex_match_simple
+
+g_regex_match_simple, function in Perl-compatible regular expressions +
-
g_regex_new
+
+g_regex_new, function in Perl-compatible regular expressions +
-
g_regex_ref
+
+g_regex_ref, function in Perl-compatible regular expressions +
-
g_regex_replace
+
+g_regex_replace, function in Perl-compatible regular expressions +
-
g_regex_replace_eval
+
+g_regex_replace_eval, function in Perl-compatible regular expressions +
-
g_regex_replace_literal
+
+g_regex_replace_literal, function in Perl-compatible regular expressions +
-
g_regex_split
+
+g_regex_split, function in Perl-compatible regular expressions +
-
g_regex_split_full
+
+g_regex_split_full, function in Perl-compatible regular expressions +
-
g_regex_split_simple
+
+g_regex_split_simple, function in Perl-compatible regular expressions +
-
g_regex_unref
+
+g_regex_unref, function in Perl-compatible regular expressions +

S

-
g_sequence_append
+
+g_sequence_append, function in Sequences +
-
g_sequence_foreach
+
+g_sequence_foreach, function in Sequences +
-
g_sequence_foreach_range
+
+g_sequence_foreach_range, function in Sequences +
-
g_sequence_free
+
+g_sequence_free, function in Sequences +
-
g_sequence_get
+
+g_sequence_get, function in Sequences +
-
g_sequence_get_begin_iter
+
+g_sequence_get_begin_iter, function in Sequences +
-
g_sequence_get_end_iter
+
+g_sequence_get_end_iter, function in Sequences +
-
g_sequence_get_iter_at_pos
+
+g_sequence_get_iter_at_pos, function in Sequences +
-
g_sequence_get_length
+
+g_sequence_get_length, function in Sequences +
-
g_sequence_insert_before
+
+g_sequence_insert_before, function in Sequences +
-
g_sequence_insert_sorted
+
+g_sequence_insert_sorted, function in Sequences +
-
g_sequence_insert_sorted_iter
+
+g_sequence_insert_sorted_iter, function in Sequences +
-
g_sequence_iter_compare
+
+g_sequence_iter_compare, function in Sequences +
-
g_sequence_iter_get_position
+
+g_sequence_iter_get_position, function in Sequences +
-
g_sequence_iter_get_sequence
+
+g_sequence_iter_get_sequence, function in Sequences +
-
g_sequence_iter_is_begin
+
+g_sequence_iter_is_begin, function in Sequences +
-
g_sequence_iter_is_end
+
+g_sequence_iter_is_end, function in Sequences +
-
g_sequence_iter_move
+
+g_sequence_iter_move, function in Sequences +
-
g_sequence_iter_next
+
+g_sequence_iter_next, function in Sequences +
-
g_sequence_iter_prev
+
+g_sequence_iter_prev, function in Sequences +
-
g_sequence_move
+
+g_sequence_move, function in Sequences +
-
g_sequence_move_range
+
+g_sequence_move_range, function in Sequences +
-
g_sequence_new
+
+g_sequence_new, function in Sequences +
-
g_sequence_prepend
+
+g_sequence_prepend, function in Sequences +
-
g_sequence_range_get_midpoint
+
+g_sequence_range_get_midpoint, function in Sequences +
-
g_sequence_remove
+
+g_sequence_remove, function in Sequences +
-
g_sequence_remove_range
+
+g_sequence_remove_range, function in Sequences +
-
g_sequence_search
+
+g_sequence_search, function in Sequences +
-
g_sequence_search_iter
+
+g_sequence_search_iter, function in Sequences +
-
g_sequence_set
+
+g_sequence_set, function in Sequences +
-
g_sequence_sort
+
+g_sequence_sort, function in Sequences +
-
g_sequence_sort_changed
+
+g_sequence_sort_changed, function in Sequences +
-
g_sequence_sort_changed_iter
+
+g_sequence_sort_changed_iter, function in Sequences +
-
g_sequence_sort_iter
+
+g_sequence_sort_iter, function in Sequences +
-
g_sequence_swap
+
+g_sequence_swap, function in Sequences +
-
g_slice_copy
+
+g_slice_copy, function in Memory Slices +
-
g_slice_dup
+
+g_slice_dup, macro in Memory Slices +
-
g_string_append_vprintf
+
+g_string_append_vprintf, function in Strings +
-
g_string_chunk_clear
+
+g_string_chunk_clear, function in String Chunks +
-
g_string_overwrite
+
+g_string_overwrite, function in Strings +
-
g_string_overwrite_len
+
+g_string_overwrite_len, function in Strings +
-
g_string_vprintf
+
+g_string_vprintf, function in Strings +

T

-
g_timeout_add_seconds
+
+g_timeout_add_seconds, function in The Main Event Loop +
-
g_timeout_add_seconds_full
+
+g_timeout_add_seconds_full, function in The Main Event Loop +
-
g_timeout_source_new_seconds
+
+g_timeout_source_new_seconds, function in The Main Event Loop +

U

-
g_unichar_combining_class
+
+g_unichar_combining_class, function in Unicode Manipulation +
-
g_unichar_get_script
+
+g_unichar_get_script, function in Unicode Manipulation +
-
g_unichar_ismark
+
+g_unichar_ismark, function in Unicode Manipulation +
-
g_unichar_iszerowidth
+
+g_unichar_iszerowidth, function in Unicode Manipulation +
-
GUserDirectory
+
+GUserDirectory, enum in Miscellaneous Utility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-16.html b/docs/reference/glib/html/api-index-2-16.html index 9760a76..e466f63 100644 --- a/docs/reference/glib/html/api-index-2-16.html +++ b/docs/reference/glib/html/api-index-2-16.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -68,167 +48,315 @@

Index of new symbols in 2.16

A

-
g_assert_cmpfloat
+
+g_assert_cmpfloat, macro in Testing +
-
g_assert_cmphex
+
+g_assert_cmphex, macro in Testing +
-
g_assert_cmpint
+
+g_assert_cmpint, macro in Testing +
-
g_assert_cmpstr
+
+g_assert_cmpstr, macro in Testing +
-
g_assert_cmpuint
+
+g_assert_cmpuint, macro in Testing +
-
g_async_queue_new_full
+
+g_async_queue_new_full, function in Asynchronous Queues +

C

-
GChecksum
+
+GChecksum, struct in Data Checksums +
-
GChecksumType
+
+GChecksumType, enum in Data Checksums +
-
g_checksum_copy
+
+g_checksum_copy, function in Data Checksums +
-
g_checksum_free
+
+g_checksum_free, function in Data Checksums +
-
g_checksum_get_digest
+
+g_checksum_get_digest, function in Data Checksums +
-
g_checksum_get_string
+
+g_checksum_get_string, function in Data Checksums +
-
g_checksum_new
+
+g_checksum_new, function in Data Checksums +
-
g_checksum_type_get_length
+
+g_checksum_type_get_length, function in Data Checksums +
-
g_checksum_update
+
+g_checksum_update, function in Data Checksums +
-
g_compute_checksum_for_data
+
+g_compute_checksum_for_data, function in Data Checksums +
-
g_compute_checksum_for_string
+
+g_compute_checksum_for_string, function in Data Checksums +
-
C_
+
+C_, macro in I18N +

D

-
g_dpgettext
+
+g_dpgettext, function in I18N +

F

-
g_format_size_for_display
+
+g_format_size_for_display, function in Miscellaneous Utility Functions +

H

-
g_hash_table_iter_get_hash_table
+
+g_hash_table_iter_get_hash_table, function in Hash Tables +
-
g_hash_table_iter_init
+
+g_hash_table_iter_init, function in Hash Tables +
-
g_hash_table_iter_next
+
+g_hash_table_iter_next, function in Hash Tables +
-
g_hash_table_iter_remove
+
+g_hash_table_iter_remove, function in Hash Tables +
-
g_hash_table_iter_steal
+
+g_hash_table_iter_steal, function in Hash Tables +

M

-
g_markup_collect_attributes
+
+g_markup_collect_attributes, function in Simple XML Subset Parser +
-
g_markup_parse_context_get_element_stack
+
+g_markup_parse_context_get_element_stack, function in Simple XML Subset Parser +

P

-
g_prefix_error
+
+g_prefix_error, function in Error Reporting +
-
g_propagate_prefixed_error
+
+g_propagate_prefixed_error, function in Error Reporting +

S

-
g_strcmp0
+
+g_strcmp0, function in String Utility Functions +
-
g_string_append_uri_escaped
+
+g_string_append_uri_escaped, function in Strings +

T

-
g_test_add
+
+g_test_add, macro in Testing +
-
g_test_add_data_func
+
+g_test_add_data_func, function in Testing +
-
g_test_add_func
+
+g_test_add_func, function in Testing +
-
g_test_bug
+
+g_test_bug, function in Testing +
-
g_test_bug_base
+
+g_test_bug_base, function in Testing +
-
g_test_create_case
+
+g_test_create_case, function in Testing +
-
g_test_create_suite
+
+g_test_create_suite, function in Testing +
-
g_test_get_root
+
+g_test_get_root, function in Testing +
-
g_test_init
+
+g_test_init, function in Testing +
-
g_test_maximized_result
+
+g_test_maximized_result, function in Testing +
-
g_test_message
+
+g_test_message, function in Testing +
-
g_test_minimized_result
+
+g_test_minimized_result, function in Testing +
-
g_test_queue_destroy
+
+g_test_queue_destroy, function in Testing +
-
g_test_queue_free
+
+g_test_queue_free, function in Testing +
-
g_test_queue_unref
+
+g_test_queue_unref, macro in Testing +
-
g_test_rand_bit
+
+g_test_rand_bit, macro in Testing +
-
g_test_rand_double
+
+g_test_rand_double, function in Testing +
-
g_test_rand_double_range
+
+g_test_rand_double_range, function in Testing +
-
g_test_rand_int
+
+g_test_rand_int, function in Testing +
-
g_test_rand_int_range
+
+g_test_rand_int_range, function in Testing +
-
g_test_run
+
+g_test_run, function in Testing +
-
g_test_run_suite
+
+g_test_run_suite, function in Testing +
-
g_test_suite_add
+
+g_test_suite_add, function in Testing +
-
g_test_suite_add_suite
+
+g_test_suite_add_suite, function in Testing +
-
g_test_timer_elapsed
+
+g_test_timer_elapsed, function in Testing +
-
g_test_timer_last
+
+g_test_timer_last, function in Testing +
-
g_test_timer_start
+
+g_test_timer_start, function in Testing +
-
g_test_trap_assert_failed
+
+g_test_trap_assert_failed, macro in Testing +
-
g_test_trap_assert_passed
+
+g_test_trap_assert_passed, macro in Testing +
-
g_test_trap_assert_stderr
+
+g_test_trap_assert_stderr, macro in Testing +
-
g_test_trap_assert_stderr_unmatched
+
+g_test_trap_assert_stderr_unmatched, macro in Testing +
-
g_test_trap_assert_stdout
+
+g_test_trap_assert_stdout, macro in Testing +
-
g_test_trap_assert_stdout_unmatched
+
+g_test_trap_assert_stdout_unmatched, macro in Testing +
-
g_test_trap_fork
+
+g_test_trap_fork, function in Testing +
-
g_test_trap_has_passed
+
+g_test_trap_has_passed, function in Testing +
-
g_test_trap_reached_timeout
+
+g_test_trap_reached_timeout, function in Testing +

U

-
g_uri_escape_string
+
+g_uri_escape_string, function in URI Functions +
-
g_uri_parse_scheme
+
+g_uri_parse_scheme, function in URI Functions +
-
g_uri_unescape_segment
+
+g_uri_unescape_segment, function in URI Functions +
-
g_uri_unescape_string
+
+g_uri_unescape_string, function in URI Functions +

W

-
g_warn_if_fail
+
+g_warn_if_fail, macro in Warnings and Assertions +
-
g_warn_if_reached
+
+g_warn_if_reached, macro in Warnings and Assertions +
-
g_win32_get_package_installation_directory_of_module
+
+g_win32_get_package_installation_directory_of_module, function in Windows Compatibility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-18.html b/docs/reference/glib/html/api-index-2-18.html index 325e40d..6f3cc9c 100644 --- a/docs/reference/glib/html/api-index-2-18.html +++ b/docs/reference/glib/html/api-index-2-18.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -60,39 +40,63 @@

Index of new symbols in 2.18

C

-
g_checksum_reset
+
+g_checksum_reset, function in Data Checksums +

D

-
g_dgettext
+
+g_dgettext, function in I18N +
-
g_dngettext
+
+g_dngettext, function in I18N +
-
g_dpgettext2
+
+g_dpgettext2, function in I18N +

G

-
G_GNUC_ALLOC_SIZE
+
+G_GNUC_ALLOC_SIZE, macro in Miscellaneous Macros +
-
G_GNUC_ALLOC_SIZE2
+
+G_GNUC_ALLOC_SIZE2, macro in Miscellaneous Macros +

M

-
g_markup_parse_context_get_user_data
+
+g_markup_parse_context_get_user_data, function in Simple XML Subset Parser +
-
g_markup_parse_context_pop
+
+g_markup_parse_context_pop, function in Simple XML Subset Parser +
-
g_markup_parse_context_push
+
+g_markup_parse_context_push, function in Simple XML Subset Parser +

N

-
NC_
+
+NC_, macro in I18N +

S

-
g_set_error_literal
+
+g_set_error_literal, function in Error Reporting +

U

-
g_utime
+
+g_utime, function in File Utilities +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-2.html b/docs/reference/glib/html/api-index-2-2.html index dcef9d0..ef25221 100644 --- a/docs/reference/glib/html/api-index-2-2.html +++ b/docs/reference/glib/html/api-index-2-2.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -64,49 +44,81 @@

Index of new symbols in 2.2

A

-
g_ascii_strtoull
+
+g_ascii_strtoull, function in String Utility Functions +

F

-
g_fprintf
+
+g_fprintf, function in String Utility Functions +

G

-
g_get_application_name
+
+g_get_application_name, function in Miscellaneous Utility Functions +
-
G_GNUC_DEPRECATED
+
+G_GNUC_DEPRECATED, macro in Miscellaneous Macros +

L

-
G_LIKELY
+
+G_LIKELY, macro in Miscellaneous Macros +

M

-
g_markup_parse_context_get_element
+
+g_markup_parse_context_get_element, function in Simple XML Subset Parser +

P

-
g_printf
+
+g_printf, function in String Utility Functions +

S

-
g_set_application_name
+
+g_set_application_name, function in Miscellaneous Utility Functions +
-
g_sprintf
+
+g_sprintf, function in String Utility Functions +
-
g_str_has_prefix
+
+g_str_has_prefix, function in String Utility Functions +
-
g_str_has_suffix
+
+g_str_has_suffix, function in String Utility Functions +

U

-
G_UNLIKELY
+
+G_UNLIKELY, macro in Miscellaneous Macros +
-
g_utf8_strreverse
+
+g_utf8_strreverse, function in Unicode Manipulation +

V

-
g_vfprintf
+
+g_vfprintf, function in String Utility Functions +
-
g_vprintf
+
+g_vprintf, function in String Utility Functions +
-
g_vsprintf
+
+g_vsprintf, function in String Utility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-20.html b/docs/reference/glib/html/api-index-2-20.html index a6842df..b16a7c0 100644 --- a/docs/reference/glib/html/api-index-2-20.html +++ b/docs/reference/glib/html/api-index-2-20.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -58,30 +38,46 @@

Index of new symbols in 2.20

A

-
g_assert_error
+
+g_assert_error, macro in Testing +
-
g_assert_no_error
+
+g_assert_no_error, macro in Testing +

B

-
g_base64_decode_inplace
+
+g_base64_decode_inplace, function in Base64 Encoding +

G

-
G_GOFFSET_MODIFIER
+
+G_GOFFSET_MODIFIER, macro in Miscellaneous Macros +

P

-
G_PASTE
+
+G_PASTE, macro in Miscellaneous Macros +
-
g_poll
+
+g_poll, function in The Main Event Loop +

S

-
G_STATIC_ASSERT
+
+G_STATIC_ASSERT, macro in Miscellaneous Macros +

T

-
g_thread_get_initialized
+
+g_thread_get_initialized, function in Threads +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-22.html b/docs/reference/glib/html/api-index-2-22.html index 248d10d..42624e3 100644 --- a/docs/reference/glib/html/api-index-2-22.html +++ b/docs/reference/glib/html/api-index-2-22.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -68,83 +48,147 @@

Index of new symbols in 2.22

A

-
g_array_get_element_size
+
+g_array_get_element_size, function in Arrays +
-
g_array_ref
+
+g_array_ref, function in Arrays +
-
g_array_unref
+
+g_array_unref, function in Arrays +

B

-
g_byte_array_ref
+
+g_byte_array_ref, function in Byte Arrays +
-
g_byte_array_unref
+
+g_byte_array_unref, function in Byte Arrays +

D

-
g_double_equal
+
+g_double_equal, function in Hash Tables +
-
g_double_hash
+
+g_double_hash, function in Hash Tables +

E

-
g_error_new_valist
+
+g_error_new_valist, function in Error Reporting +

G

-
G_GINTPTR_FORMAT
+
+G_GINTPTR_FORMAT, macro in Miscellaneous Macros +
-
G_GINTPTR_MODIFIER
+
+G_GINTPTR_MODIFIER, macro in Miscellaneous Macros +
-
G_GUINTPTR_FORMAT
+
+G_GUINTPTR_FORMAT, macro in Miscellaneous Macros +

H

-
g_hostname_is_ascii_encoded
+
+g_hostname_is_ascii_encoded, function in Hostname Utilities +
-
g_hostname_is_ip_address
+
+g_hostname_is_ip_address, function in Hostname Utilities +
-
g_hostname_is_non_ascii
+
+g_hostname_is_non_ascii, function in Hostname Utilities +
-
g_hostname_to_ascii
+
+g_hostname_to_ascii, function in Hostname Utilities +
-
g_hostname_to_unicode
+
+g_hostname_to_unicode, function in Hostname Utilities +

I

-
g_int64_equal
+
+g_int64_equal, function in Hash Tables +
-
g_int64_hash
+
+g_int64_hash, function in Hash Tables +

M

-
g_main_context_get_thread_default
+
+g_main_context_get_thread_default, function in The Main Event Loop +
-
g_main_context_pop_thread_default
+
+g_main_context_pop_thread_default, function in The Main Event Loop +
-
g_main_context_push_thread_default
+
+g_main_context_push_thread_default, function in The Main Event Loop +
-
g_mapped_file_ref
+
+g_mapped_file_ref, function in File Utilities +
-
g_mkstemp_full
+
+g_mkstemp_full, function in File Utilities +

P

-
g_ptr_array_new_with_free_func
+
+g_ptr_array_new_with_free_func, function in Pointer Arrays +
-
g_ptr_array_ref
+
+g_ptr_array_ref, function in Pointer Arrays +
-
g_ptr_array_set_free_func
+
+g_ptr_array_set_free_func, function in Pointer Arrays +
-
g_ptr_array_unref
+
+g_ptr_array_unref, function in Pointer Arrays +

R

-
g_reload_user_special_dirs_cache
+
+g_reload_user_special_dirs_cache, function in Miscellaneous Utility Functions +

T

-
GTestLogFatalFunc
+
+GTestLogFatalFunc, user_function in Testing +
-
g_test_log_set_fatal_handler
+
+g_test_log_set_fatal_handler, function in Testing +
-
g_tree_ref
+
+g_tree_ref, function in Balanced Binary Trees +
-
g_tree_unref
+
+g_tree_unref, function in Balanced Binary Trees +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-24.html b/docs/reference/glib/html/api-index-2-24.html index a97910a..d4e8cc6 100644 --- a/docs/reference/glib/html/api-index-2-24.html +++ b/docs/reference/glib/html/api-index-2-24.html @@ -7,28 +7,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -55,199 +35,385 @@

Index of new symbols in 2.24

B

-
g_bit_lock
+
+g_bit_lock, function in Threads +
-
g_bit_trylock
+
+g_bit_trylock, function in Threads +
-
g_bit_unlock
+
+g_bit_unlock, function in Threads +

M

-
g_malloc0_n
+
+g_malloc0_n, function in Memory Allocation +
-
g_malloc_n
+
+g_malloc_n, function in Memory Allocation +

R

-
g_realloc_n
+
+g_realloc_n, function in Memory Allocation +

T

-
g_try_malloc0_n
+
+g_try_malloc0_n, function in Memory Allocation +
-
g_try_malloc_n
+
+g_try_malloc_n, function in Memory Allocation +
-
g_try_realloc_n
+
+g_try_realloc_n, function in Memory Allocation +

V

-
GVariant
+
+GVariant, struct in GVariant +
-
GVariantClass
+
+GVariantClass, enum in GVariant +
-
g_variant_builder_add
+
+g_variant_builder_add, function in GVariant +
-
g_variant_builder_add_value
+
+g_variant_builder_add_value, function in GVariant +
-
g_variant_builder_clear
+
+g_variant_builder_clear, function in GVariant +
-
g_variant_builder_close
+
+g_variant_builder_close, function in GVariant +
-
g_variant_builder_end
+
+g_variant_builder_end, function in GVariant +
-
g_variant_builder_init
+
+g_variant_builder_init, function in GVariant +
-
g_variant_builder_new
+
+g_variant_builder_new, function in GVariant +
-
g_variant_builder_open
+
+g_variant_builder_open, function in GVariant +
-
g_variant_builder_ref
+
+g_variant_builder_ref, function in GVariant +
-
g_variant_builder_unref
+
+g_variant_builder_unref, function in GVariant +
-
g_variant_byteswap
+
+g_variant_byteswap, function in GVariant +
-
g_variant_classify
+
+g_variant_classify, function in GVariant +
-
g_variant_dup_string
+
+g_variant_dup_string, function in GVariant +
-
g_variant_dup_strv
+
+g_variant_dup_strv, function in GVariant +
-
g_variant_equal
+
+g_variant_equal, function in GVariant +
-
g_variant_get
+
+g_variant_get, function in GVariant +
-
g_variant_get_boolean
+
+g_variant_get_boolean, function in GVariant +
-
g_variant_get_byte
+
+g_variant_get_byte, function in GVariant +
-
g_variant_get_child
+
+g_variant_get_child, function in GVariant +
-
g_variant_get_child_value
+
+g_variant_get_child_value, function in GVariant +
-
g_variant_get_data
+
+g_variant_get_data, function in GVariant +
-
g_variant_get_double
+
+g_variant_get_double, function in GVariant +
-
g_variant_get_fixed_array
+
+g_variant_get_fixed_array, function in GVariant +
-
g_variant_get_handle
+
+g_variant_get_handle, function in GVariant +
-
g_variant_get_int16
+
+g_variant_get_int16, function in GVariant +
-
g_variant_get_int32
+
+g_variant_get_int32, function in GVariant +
-
g_variant_get_int64
+
+g_variant_get_int64, function in GVariant +
-
g_variant_get_maybe
+
+g_variant_get_maybe, function in GVariant +
-
g_variant_get_normal_form
+
+g_variant_get_normal_form, function in GVariant +
-
g_variant_get_size
+
+g_variant_get_size, function in GVariant +
-
g_variant_get_string
+
+g_variant_get_string, function in GVariant +
-
g_variant_get_strv
+
+g_variant_get_strv, function in GVariant +
-
g_variant_get_type
+
+g_variant_get_type, function in GVariant +
-
g_variant_get_type_string
+
+g_variant_get_type_string, function in GVariant +
-
g_variant_get_uint16
+
+g_variant_get_uint16, function in GVariant +
-
g_variant_get_uint32
+
+g_variant_get_uint32, function in GVariant +
-
g_variant_get_uint64
+
+g_variant_get_uint64, function in GVariant +
-
g_variant_get_va
+
+g_variant_get_va, function in GVariant +
-
g_variant_get_variant
+
+g_variant_get_variant, function in GVariant +
-
g_variant_hash
+
+g_variant_hash, function in GVariant +
-
g_variant_is_normal_form
+
+g_variant_is_normal_form, function in GVariant +
-
g_variant_is_object_path
+
+g_variant_is_object_path, function in GVariant +
-
g_variant_is_of_type
+
+g_variant_is_of_type, function in GVariant +
-
g_variant_is_signature
+
+g_variant_is_signature, function in GVariant +
-
g_variant_iter_copy
+
+g_variant_iter_copy, function in GVariant +
-
g_variant_iter_free
+
+g_variant_iter_free, function in GVariant +
-
g_variant_iter_init
+
+g_variant_iter_init, function in GVariant +
-
g_variant_iter_loop
+
+g_variant_iter_loop, function in GVariant +
-
g_variant_iter_new
+
+g_variant_iter_new, function in GVariant +
-
g_variant_iter_next
+
+g_variant_iter_next, function in GVariant +
-
g_variant_iter_next_value
+
+g_variant_iter_next_value, function in GVariant +
-
g_variant_iter_n_children
+
+g_variant_iter_n_children, function in GVariant +
-
g_variant_new
+
+g_variant_new, function in GVariant +
-
g_variant_new_array
+
+g_variant_new_array, function in GVariant +
-
g_variant_new_boolean
+
+g_variant_new_boolean, function in GVariant +
-
g_variant_new_byte
+
+g_variant_new_byte, function in GVariant +
-
g_variant_new_dict_entry
+
+g_variant_new_dict_entry, function in GVariant +
-
g_variant_new_double
+
+g_variant_new_double, function in GVariant +
-
g_variant_new_from_data
+
+g_variant_new_from_data, function in GVariant +
-
g_variant_new_handle
+
+g_variant_new_handle, function in GVariant +
-
g_variant_new_int16
+
+g_variant_new_int16, function in GVariant +
-
g_variant_new_int32
+
+g_variant_new_int32, function in GVariant +
-
g_variant_new_int64
+
+g_variant_new_int64, function in GVariant +
-
g_variant_new_maybe
+
+g_variant_new_maybe, function in GVariant +
-
g_variant_new_object_path
+
+g_variant_new_object_path, function in GVariant +
-
g_variant_new_signature
+
+g_variant_new_signature, function in GVariant +
-
g_variant_new_string
+
+g_variant_new_string, function in GVariant +
-
g_variant_new_strv
+
+g_variant_new_strv, function in GVariant +
-
g_variant_new_tuple
+
+g_variant_new_tuple, function in GVariant +
-
g_variant_new_uint16
+
+g_variant_new_uint16, function in GVariant +
-
g_variant_new_uint32
+
+g_variant_new_uint32, function in GVariant +
-
g_variant_new_uint64
+
+g_variant_new_uint64, function in GVariant +
-
g_variant_new_va
+
+g_variant_new_va, function in GVariant +
-
g_variant_new_variant
+
+g_variant_new_variant, function in GVariant +
-
g_variant_n_children
+
+g_variant_n_children, function in GVariant +
-
g_variant_print_string
+
+g_variant_print_string, function in GVariant +
-
g_variant_ref
+
+g_variant_ref, function in GVariant +
-
g_variant_ref_sink
+
+g_variant_ref_sink, function in GVariant +
-
g_variant_store
+
+g_variant_store, function in GVariant +
-
g_variant_type_new
+
+g_variant_type_new, function in GVariantType +
-
g_variant_type_string_scan
+
+g_variant_type_string_scan, function in GVariantType +
-
g_variant_unref
+
+g_variant_unref, function in GVariant +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-4.html b/docs/reference/glib/html/api-index-2-4.html index 3a4e80f..3e16631 100644 --- a/docs/reference/glib/html/api-index-2-4.html +++ b/docs/reference/glib/html/api-index-2-4.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -78,178 +58,332 @@

Index of new symbols in 2.4

A

-
g_array_remove_range
+
+g_array_remove_range, function in Arrays +
-
g_atomic_int_add
+
+g_atomic_int_add, function in Atomic Operations +
-
g_atomic_int_compare_and_exchange
+
+g_atomic_int_compare_and_exchange, function in Atomic Operations +
-
g_atomic_int_dec_and_test
+
+g_atomic_int_dec_and_test, function in Atomic Operations +
-
g_atomic_int_exchange_and_add
+
+g_atomic_int_exchange_and_add, function in Atomic Operations +
-
g_atomic_int_get
+
+g_atomic_int_get, function in Atomic Operations +
-
g_atomic_int_inc
+
+g_atomic_int_inc, function in Atomic Operations +
-
g_atomic_pointer_compare_and_exchange
+
+g_atomic_pointer_compare_and_exchange, function in Atomic Operations +
-
g_atomic_pointer_get
+
+g_atomic_pointer_get, function in Atomic Operations +

B

-
g_byte_array_remove_range
+
+g_byte_array_remove_range, function in Byte Arrays +

C

-
g_child_watch_add
+
+g_child_watch_add, function in The Main Event Loop +
-
g_child_watch_add_full
+
+g_child_watch_add_full, function in The Main Event Loop +
-
g_child_watch_source_new
+
+g_child_watch_source_new, function in The Main Event Loop +
-
g_completion_complete_utf8
+
+g_completion_complete_utf8, function in Automatic String Completion +
-
GCopyFunc
+
+GCopyFunc, user_function in N-ary Trees +

F

-
g_file_read_link
+
+g_file_read_link, function in File Utilities +

G

-
G_GINT16_MODIFIER
+
+G_GINT16_MODIFIER, macro in Miscellaneous Macros +
-
G_GINT32_MODIFIER
+
+G_GINT32_MODIFIER, macro in Miscellaneous Macros +
-
G_GINT64_MODIFIER
+
+G_GINT64_MODIFIER, macro in Miscellaneous Macros +

H

-
g_hash_table_find
+
+g_hash_table_find, function in Hash Tables +

M

-
g_markup_printf_escaped
+
+g_markup_printf_escaped, function in Simple XML Subset Parser +
-
g_markup_vprintf_escaped
+
+g_markup_vprintf_escaped, function in Simple XML Subset Parser +
-
G_MAXINT16
+
+G_MAXINT16, macro in Limits of Basic Types +
-
G_MAXINT32
+
+G_MAXINT32, macro in Limits of Basic Types +
-
G_MAXINT8
+
+G_MAXINT8, macro in Limits of Basic Types +
-
G_MAXSIZE
+
+G_MAXSIZE, macro in Limits of Basic Types +
-
G_MAXUINT16
+
+G_MAXUINT16, macro in Limits of Basic Types +
-
G_MAXUINT32
+
+G_MAXUINT32, macro in Limits of Basic Types +
-
G_MAXUINT8
+
+G_MAXUINT8, macro in Limits of Basic Types +
-
G_MININT16
+
+G_MININT16, macro in Limits of Basic Types +
-
G_MININT32
+
+G_MININT32, macro in Limits of Basic Types +
-
G_MININT8
+
+G_MININT8, macro in Limits of Basic Types +

N

-
g_node_copy_deep
+
+g_node_copy_deep, function in N-ary Trees +
-
N_
+
+N_, macro in I18N +

O

-
GOnce
+
+GOnce, struct in Threads +
-
g_once
+
+g_once, macro in Threads +
-
GOnceStatus
+
+GOnceStatus, enum in Threads +
-
G_ONCE_INIT
+
+G_ONCE_INIT, macro in Threads +

P

-
g_ptr_array_foreach
+
+g_ptr_array_foreach, function in Pointer Arrays +
-
g_ptr_array_remove_range
+
+g_ptr_array_remove_range, function in Pointer Arrays +

Q

-
g_queue_copy
+
+g_queue_copy, function in Double-ended Queues +
-
g_queue_delete_link
+
+g_queue_delete_link, function in Double-ended Queues +
-
g_queue_find
+
+g_queue_find, function in Double-ended Queues +
-
g_queue_find_custom
+
+g_queue_find_custom, function in Double-ended Queues +
-
g_queue_foreach
+
+g_queue_foreach, function in Double-ended Queues +
-
g_queue_get_length
+
+g_queue_get_length, function in Double-ended Queues +
-
g_queue_index
+
+g_queue_index, function in Double-ended Queues +
-
g_queue_insert_after
+
+g_queue_insert_after, function in Double-ended Queues +
-
g_queue_insert_before
+
+g_queue_insert_before, function in Double-ended Queues +
-
g_queue_insert_sorted
+
+g_queue_insert_sorted, function in Double-ended Queues +
-
g_queue_link_index
+
+g_queue_link_index, function in Double-ended Queues +
-
g_queue_peek_head_link
+
+g_queue_peek_head_link, function in Double-ended Queues +
-
g_queue_peek_nth
+
+g_queue_peek_nth, function in Double-ended Queues +
-
g_queue_peek_nth_link
+
+g_queue_peek_nth_link, function in Double-ended Queues +
-
g_queue_peek_tail_link
+
+g_queue_peek_tail_link, function in Double-ended Queues +
-
g_queue_pop_nth
+
+g_queue_pop_nth, function in Double-ended Queues +
-
g_queue_pop_nth_link
+
+g_queue_pop_nth_link, function in Double-ended Queues +
-
g_queue_push_nth
+
+g_queue_push_nth, function in Double-ended Queues +
-
g_queue_push_nth_link
+
+g_queue_push_nth_link, function in Double-ended Queues +
-
g_queue_remove
+
+g_queue_remove, function in Double-ended Queues +
-
g_queue_remove_all
+
+g_queue_remove_all, function in Double-ended Queues +
-
g_queue_reverse
+
+g_queue_reverse, function in Double-ended Queues +
-
g_queue_sort
+
+g_queue_sort, function in Double-ended Queues +
-
g_queue_unlink
+
+g_queue_unlink, function in Double-ended Queues +
-
Q_
+
+Q_, macro in I18N +

R

-
g_rand_copy
+
+g_rand_copy, function in Random Numbers +
-
g_rand_new_with_seed_array
+
+g_rand_new_with_seed_array, function in Random Numbers +
-
g_rand_set_seed_array
+
+g_rand_set_seed_array, function in Random Numbers +

S

-
g_setenv
+
+g_setenv, function in Miscellaneous Utility Functions +
-
G_STRFUNC
+
+G_STRFUNC, macro in Miscellaneous Macros +
-
g_string_chunk_insert_len
+
+g_string_chunk_insert_len, function in String Chunks +
-
g_strip_context
+
+g_strip_context, function in I18N +
-
g_strsplit_set
+
+g_strsplit_set, function in String Utility Functions +

T

-
g_timer_continue
+
+g_timer_continue, function in Timers +

U

-
g_unichar_get_mirror_char
+
+g_unichar_get_mirror_char, function in Unicode Manipulation +
-
g_unsetenv
+
+g_unsetenv, function in Miscellaneous Utility Functions +

V

-
g_vasprintf
+
+g_vasprintf, function in String Utility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-6.html b/docs/reference/glib/html/api-index-2-6.html index 26f88cb..bd338cd 100644 --- a/docs/reference/glib/html/api-index-2-6.html +++ b/docs/reference/glib/html/api-index-2-6.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -70,192 +50,364 @@

Index of new symbols in 2.6

D

-
g_date_get_iso8601_week_of_year
+
+g_date_get_iso8601_week_of_year, function in Date and Time Functions +
-
g_debug
+
+g_debug, macro in Message Logging +

F

-
g_filename_display_basename
+
+g_filename_display_basename, function in Character Set Conversion +
-
g_filename_display_name
+
+g_filename_display_name, function in Character Set Conversion +
-
g_fopen
+
+g_fopen, function in File Utilities +
-
g_freopen
+
+g_freopen, function in File Utilities +

G

-
g_get_filename_charsets
+
+g_get_filename_charsets, function in Character Set Conversion +
-
g_get_language_names
+
+g_get_language_names, function in I18N +
-
g_get_system_config_dirs
+
+g_get_system_config_dirs, function in Miscellaneous Utility Functions +
-
g_get_system_data_dirs
+
+g_get_system_data_dirs, function in Miscellaneous Utility Functions +
-
g_get_user_cache_dir
+
+g_get_user_cache_dir, function in Miscellaneous Utility Functions +
-
g_get_user_config_dir
+
+g_get_user_config_dir, function in Miscellaneous Utility Functions +
-
g_get_user_data_dir
+
+g_get_user_data_dir, function in Miscellaneous Utility Functions +
-
G_GNUC_MALLOC
+
+G_GNUC_MALLOC, macro in Miscellaneous Macros +
-
G_GSIZE_FORMAT
+
+G_GSIZE_FORMAT, macro in Miscellaneous Macros +
-
G_GSIZE_MODIFIER
+
+G_GSIZE_MODIFIER, macro in Miscellaneous Macros +
-
G_GSSIZE_FORMAT
+
+G_GSSIZE_FORMAT, macro in Miscellaneous Macros +

I

-
G_IS_DIR_SEPARATOR
+
+G_IS_DIR_SEPARATOR, macro in Standard Macros +

K

-
g_key_file_free
+
+g_key_file_free, function in Key-value file parser +
-
g_key_file_get_boolean
+
+g_key_file_get_boolean, function in Key-value file parser +
-
g_key_file_get_boolean_list
+
+g_key_file_get_boolean_list, function in Key-value file parser +
-
g_key_file_get_comment
+
+g_key_file_get_comment, function in Key-value file parser +
-
g_key_file_get_groups
+
+g_key_file_get_groups, function in Key-value file parser +
-
g_key_file_get_integer
+
+g_key_file_get_integer, function in Key-value file parser +
-
g_key_file_get_integer_list
+
+g_key_file_get_integer_list, function in Key-value file parser +
-
g_key_file_get_keys
+
+g_key_file_get_keys, function in Key-value file parser +
-
g_key_file_get_locale_string
+
+g_key_file_get_locale_string, function in Key-value file parser +
-
g_key_file_get_locale_string_list
+
+g_key_file_get_locale_string_list, function in Key-value file parser +
-
g_key_file_get_start_group
+
+g_key_file_get_start_group, function in Key-value file parser +
-
g_key_file_get_string
+
+g_key_file_get_string, function in Key-value file parser +
-
g_key_file_get_string_list
+
+g_key_file_get_string_list, function in Key-value file parser +
-
g_key_file_get_value
+
+g_key_file_get_value, function in Key-value file parser +
-
g_key_file_has_group
+
+g_key_file_has_group, function in Key-value file parser +
-
g_key_file_has_key
+
+g_key_file_has_key, function in Key-value file parser +
-
g_key_file_load_from_data
+
+g_key_file_load_from_data, function in Key-value file parser +
-
g_key_file_load_from_data_dirs
+
+g_key_file_load_from_data_dirs, function in Key-value file parser +
-
g_key_file_load_from_file
+
+g_key_file_load_from_file, function in Key-value file parser +
-
g_key_file_new
+
+g_key_file_new, function in Key-value file parser +
-
g_key_file_remove_comment
+
+g_key_file_remove_comment, function in Key-value file parser +
-
g_key_file_remove_group
+
+g_key_file_remove_group, function in Key-value file parser +
-
g_key_file_remove_key
+
+g_key_file_remove_key, function in Key-value file parser +
-
g_key_file_set_boolean
+
+g_key_file_set_boolean, function in Key-value file parser +
-
g_key_file_set_boolean_list
+
+g_key_file_set_boolean_list, function in Key-value file parser +
-
g_key_file_set_comment
+
+g_key_file_set_comment, function in Key-value file parser +
-
g_key_file_set_integer
+
+g_key_file_set_integer, function in Key-value file parser +
-
g_key_file_set_integer_list
+
+g_key_file_set_integer_list, function in Key-value file parser +
-
g_key_file_set_list_separator
+
+g_key_file_set_list_separator, function in Key-value file parser +
-
g_key_file_set_locale_string
+
+g_key_file_set_locale_string, function in Key-value file parser +
-
g_key_file_set_locale_string_list
+
+g_key_file_set_locale_string_list, function in Key-value file parser +
-
g_key_file_set_string
+
+g_key_file_set_string, function in Key-value file parser +
-
g_key_file_set_string_list
+
+g_key_file_set_string_list, function in Key-value file parser +
-
g_key_file_set_value
+
+g_key_file_set_value, function in Key-value file parser +
-
g_key_file_to_data
+
+g_key_file_to_data, function in Key-value file parser +

L

-
g_log_set_default_handler
+
+g_log_set_default_handler, function in Message Logging +
-
g_lstat
+
+g_lstat, function in File Utilities +

M

-
g_mkdir
+
+g_mkdir, function in File Utilities +

O

-
g_open
+
+g_open, function in File Utilities +
-
g_option_context_add_group
+
+g_option_context_add_group, function in Commandline option parser +
-
g_option_context_add_main_entries
+
+g_option_context_add_main_entries, function in Commandline option parser +
-
g_option_context_free
+
+g_option_context_free, function in Commandline option parser +
-
g_option_context_get_help_enabled
+
+g_option_context_get_help_enabled, function in Commandline option parser +
-
g_option_context_get_ignore_unknown_options
+
+g_option_context_get_ignore_unknown_options, function in Commandline option parser +
-
g_option_context_get_main_group
+
+g_option_context_get_main_group, function in Commandline option parser +
-
g_option_context_new
+
+g_option_context_new, function in Commandline option parser +
-
g_option_context_parse
+
+g_option_context_parse, function in Commandline option parser +
-
g_option_context_set_help_enabled
+
+g_option_context_set_help_enabled, function in Commandline option parser +
-
g_option_context_set_ignore_unknown_options
+
+g_option_context_set_ignore_unknown_options, function in Commandline option parser +
-
g_option_context_set_main_group
+
+g_option_context_set_main_group, function in Commandline option parser +
-
g_option_group_add_entries
+
+g_option_group_add_entries, function in Commandline option parser +
-
g_option_group_free
+
+g_option_group_free, function in Commandline option parser +
-
g_option_group_new
+
+g_option_group_new, function in Commandline option parser +
-
g_option_group_set_error_hook
+
+g_option_group_set_error_hook, function in Commandline option parser +
-
g_option_group_set_parse_hooks
+
+g_option_group_set_parse_hooks, function in Commandline option parser +
-
g_option_group_set_translate_func
+
+g_option_group_set_translate_func, function in Commandline option parser +
-
g_option_group_set_translation_domain
+
+g_option_group_set_translation_domain, function in Commandline option parser +
-
G_OPTION_REMAINING
+
+G_OPTION_REMAINING, macro in Commandline option parser +

R

-
g_remove
+
+g_remove, function in File Utilities +
-
g_rename
+
+g_rename, function in File Utilities +
-
g_rmdir
+
+g_rmdir, function in File Utilities +

S

-
g_stat
+
+g_stat, function in File Utilities +
-
g_strv_length
+
+g_strv_length, function in String Utility Functions +

U

-
g_unlink
+
+g_unlink, function in File Utilities +
-
g_uri_list_extract_uris
+
+g_uri_list_extract_uris, function in URI Functions +

W

-
g_win32_get_windows_version
+
+g_win32_get_windows_version, function in Windows Compatibility Functions +
-
G_WIN32_HAVE_WIDECHAR_API
+
+G_WIN32_HAVE_WIDECHAR_API, macro in Windows Compatibility Functions +
-
G_WIN32_IS_NT_BASED
+
+G_WIN32_IS_NT_BASED, macro in Windows Compatibility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-2-8.html b/docs/reference/glib/html/api-index-2-8.html index f2ab30e..f101568 100644 --- a/docs/reference/glib/html/api-index-2-8.html +++ b/docs/reference/glib/html/api-index-2-8.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -68,65 +48,111 @@

Index of new symbols in 2.8

A

-
g_access
+
+g_access, function in File Utilities +

B

-
g_build_filenamev
+
+g_build_filenamev, function in Miscellaneous Utility Functions +
-
g_build_pathv
+
+g_build_pathv, function in Miscellaneous Utility Functions +

C

-
g_chdir
+
+g_chdir, function in File Utilities +
-
g_chmod
+
+g_chmod, function in File Utilities +
-
g_creat
+
+g_creat, function in File Utilities +

D

-
g_datalist_get_flags
+
+g_datalist_get_flags, function in Keyed Data Lists +
-
g_datalist_set_flags
+
+g_datalist_set_flags, function in Keyed Data Lists +
-
g_datalist_unset_flags
+
+g_datalist_unset_flags, function in Keyed Data Lists +

F

-
g_file_set_contents
+
+g_file_set_contents, function in File Utilities +

G

-
g_get_host_name
+
+g_get_host_name, function in Miscellaneous Utility Functions +

L

-
g_listenv
+
+g_listenv, function in Miscellaneous Utility Functions +

M

-
g_mapped_file_free
+
+g_mapped_file_free, function in File Utilities +
-
g_mapped_file_get_contents
+
+g_mapped_file_get_contents, function in File Utilities +
-
g_mapped_file_get_length
+
+g_mapped_file_get_length, function in File Utilities +
-
g_mapped_file_new
+
+g_mapped_file_new, function in File Utilities +
-
g_mkdir_with_parents
+
+g_mkdir_with_parents, function in File Utilities +

T

-
g_try_malloc0
+
+g_try_malloc0, function in Memory Allocation +
-
g_try_new
+
+g_try_new, macro in Memory Allocation +
-
g_try_new0
+
+g_try_new0, macro in Memory Allocation +
-
g_try_renew
+
+g_try_renew, macro in Memory Allocation +

U

-
g_utf8_collate_key_for_filename
+
+g_utf8_collate_key_for_filename, function in Unicode Manipulation +

W

-
g_win32_locale_filename_from_utf8
+
+g_win32_locale_filename_from_utf8, function in Windows Compatibility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-deprecated.html b/docs/reference/glib/html/api-index-deprecated.html index 851725e..17a5ea7 100644 --- a/docs/reference/glib/html/api-index-deprecated.html +++ b/docs/reference/glib/html/api-index-deprecated.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -72,155 +52,289 @@

Index of deprecated symbols

A

-
GAllocator
+
+GAllocator, struct in Memory Allocators +
-
g_allocator_free
+
+g_allocator_free, function in Memory Allocators +
-
g_allocator_new
+
+g_allocator_new, function in Memory Allocators +
-
G_ALLOC_AND_FREE
+
+G_ALLOC_AND_FREE, macro in Memory Chunks +
-
G_ALLOC_ONLY
+
+G_ALLOC_ONLY, macro in Memory Chunks +
-
g_async_queue_ref_unlocked
+
+g_async_queue_ref_unlocked, function in Asynchronous Queues +
-
g_async_queue_unref_and_unlock
+
+g_async_queue_unref_and_unlock, function in Asynchronous Queues +

B

-
g_basename
+
+g_basename, function in Miscellaneous Utility Functions +
-
g_blow_chunks
+
+g_blow_chunks, function in Memory Chunks +

C

-
g_cache_value_foreach
+
+g_cache_value_foreach, function in Caches +
-
g_chunk_free
+
+g_chunk_free, macro in Memory Chunks +
-
g_chunk_new
+
+g_chunk_new, macro in Memory Chunks +
-
g_chunk_new0
+
+g_chunk_new0, macro in Memory Chunks +

D

-
g_date_set_time
+
+g_date_set_time, function in Date and Time Functions +
-
g_dirname
+
+g_dirname, macro in Miscellaneous Utility Functions +

G

-
G_GNUC_FUNCTION
+
+G_GNUC_FUNCTION, macro in Miscellaneous Macros +
-
G_GNUC_PRETTY_FUNCTION
+
+G_GNUC_PRETTY_FUNCTION, macro in Miscellaneous Macros +

H

-
g_hash_table_freeze
+
+g_hash_table_freeze, macro in Hash Tables +
-
g_hash_table_thaw
+
+g_hash_table_thaw, macro in Hash Tables +
-
G_HAVE_GINT64
+
+G_HAVE_GINT64, macro in Basic Types +

I

-
g_io_channel_close
+
+g_io_channel_close, function in IO Channels +
-
g_io_channel_read
+
+g_io_channel_read, function in IO Channels +
-
g_io_channel_seek
+
+g_io_channel_seek, function in IO Channels +
-
g_io_channel_write
+
+g_io_channel_write, function in IO Channels +

L

-
g_list_pop_allocator
+
+g_list_pop_allocator, function in Doubly-Linked Lists +
-
g_list_push_allocator
+
+g_list_push_allocator, function in Doubly-Linked Lists +

M

-
g_main_destroy
+
+g_main_destroy, macro in The Main Event Loop +
-
g_main_is_running
+
+g_main_is_running, macro in The Main Event Loop +
-
g_main_iteration
+
+g_main_iteration, macro in The Main Event Loop +
-
g_main_new
+
+g_main_new, macro in The Main Event Loop +
-
g_main_pending
+
+g_main_pending, macro in The Main Event Loop +
-
g_main_quit
+
+g_main_quit, macro in The Main Event Loop +
-
g_main_run
+
+g_main_run, macro in The Main Event Loop +
-
g_main_set_poll_func
+
+g_main_set_poll_func, macro in The Main Event Loop +
-
g_mapped_file_free
+
+g_mapped_file_free, function in File Utilities +
-
GMemChunk
+
+GMemChunk, struct in Memory Chunks +
-
g_mem_chunk_alloc
+
+g_mem_chunk_alloc, function in Memory Chunks +
-
g_mem_chunk_alloc0
+
+g_mem_chunk_alloc0, function in Memory Chunks +
-
g_mem_chunk_clean
+
+g_mem_chunk_clean, function in Memory Chunks +
-
g_mem_chunk_create
+
+g_mem_chunk_create, macro in Memory Chunks +
-
g_mem_chunk_destroy
+
+g_mem_chunk_destroy, function in Memory Chunks +
-
g_mem_chunk_free
+
+g_mem_chunk_free, function in Memory Chunks +
-
g_mem_chunk_info
+
+g_mem_chunk_info, function in Memory Chunks +
-
g_mem_chunk_new
+
+g_mem_chunk_new, function in Memory Chunks +
-
g_mem_chunk_print
+
+g_mem_chunk_print, function in Memory Chunks +
-
g_mem_chunk_reset
+
+g_mem_chunk_reset, function in Memory Chunks +

N

-
g_node_pop_allocator
+
+g_node_pop_allocator, function in N-ary Trees +
-
g_node_push_allocator
+
+g_node_push_allocator, function in N-ary Trees +

S

-
g_scanner_add_symbol
+
+g_scanner_add_symbol, macro in Lexical Scanner +
-
g_scanner_foreach_symbol
+
+g_scanner_foreach_symbol, macro in Lexical Scanner +
-
g_scanner_freeze_symbol_table
+
+g_scanner_freeze_symbol_table, macro in Lexical Scanner +
-
g_scanner_remove_symbol
+
+g_scanner_remove_symbol, macro in Lexical Scanner +
-
g_scanner_thaw_symbol_table
+
+g_scanner_thaw_symbol_table, macro in Lexical Scanner +
-
g_slist_pop_allocator
+
+g_slist_pop_allocator, function in Singly-Linked Lists +
-
g_slist_push_allocator
+
+g_slist_push_allocator, function in Singly-Linked Lists +
-
g_strcasecmp
+
+g_strcasecmp, function in String Utility Functions +
-
g_strdown
+
+g_strdown, function in String Utility Functions +
-
g_string_down
+
+g_string_down, function in Strings +
-
g_string_sprintf
+
+g_string_sprintf, macro in Strings +
-
g_string_sprintfa
+
+g_string_sprintfa, macro in Strings +
-
g_string_up
+
+g_string_up, function in Strings +
-
g_strncasecmp
+
+g_strncasecmp, function in String Utility Functions +
-
g_strup
+
+g_strup, function in String Utility Functions +

T

-
g_tree_traverse
+
+g_tree_traverse, function in Balanced Binary Trees +

W

-
G_WIN32_DLLMAIN_FOR_DLL_NAME
+
+G_WIN32_DLLMAIN_FOR_DLL_NAME, macro in Windows Compatibility Functions +
-
g_win32_get_package_installation_directory
+
+g_win32_get_package_installation_directory, function in Windows Compatibility Functions +
-
g_win32_get_package_installation_subdirectory
+
+g_win32_get_package_installation_subdirectory, function in Windows Compatibility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/api-index-full.html b/docs/reference/glib/html/api-index-full.html index 5250eb8..2eb07ca 100644 --- a/docs/reference/glib/html/api-index-full.html +++ b/docs/reference/glib/html/api-index-full.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -90,3898 +70,7766 @@

Index

A

-
ABS
+
+ABS, macro in Standard Macros +
-
g_access
+
+g_access, function in File Utilities +
-
g_alloca
+
+g_alloca, macro in Memory Allocation +
-
GAllocator
+
+GAllocator, struct in Memory Allocators +
-
g_allocator_free
+
+g_allocator_free, function in Memory Allocators +
-
g_allocator_new
+
+g_allocator_new, function in Memory Allocators +
-
G_ALLOC_AND_FREE
+
+G_ALLOC_AND_FREE, macro in Memory Chunks +
-
G_ALLOC_ONLY
+
+G_ALLOC_ONLY, macro in Memory Chunks +
-
GArray
+
+GArray, struct in Arrays +
-
g_array_append_val
+
+g_array_append_val, macro in Arrays +
-
g_array_append_vals
+
+g_array_append_vals, function in Arrays +
-
g_array_free
+
+g_array_free, function in Arrays +
-
g_array_get_element_size
+
+g_array_get_element_size, function in Arrays +
-
g_array_index
+
+g_array_index, macro in Arrays +
-
g_array_insert_val
+
+g_array_insert_val, macro in Arrays +
-
g_array_insert_vals
+
+g_array_insert_vals, function in Arrays +
-
g_array_new
+
+g_array_new, function in Arrays +
-
g_array_prepend_val
+
+g_array_prepend_val, macro in Arrays +
-
g_array_prepend_vals
+
+g_array_prepend_vals, function in Arrays +
-
g_array_ref
+
+g_array_ref, function in Arrays +
-
g_array_remove_index
+
+g_array_remove_index, function in Arrays +
-
g_array_remove_index_fast
+
+g_array_remove_index_fast, function in Arrays +
-
g_array_remove_range
+
+g_array_remove_range, function in Arrays +
-
g_array_set_size
+
+g_array_set_size, function in Arrays +
-
g_array_sized_new
+
+g_array_sized_new, function in Arrays +
-
g_array_sort
+
+g_array_sort, function in Arrays +
-
g_array_sort_with_data
+
+g_array_sort_with_data, function in Arrays +
-
g_array_unref
+
+g_array_unref, function in Arrays +
-
g_ascii_digit_value
+
+g_ascii_digit_value, function in String Utility Functions +
-
g_ascii_dtostr
+
+g_ascii_dtostr, function in String Utility Functions +
-
G_ASCII_DTOSTR_BUF_SIZE
+
+G_ASCII_DTOSTR_BUF_SIZE, macro in String Utility Functions +
-
g_ascii_formatd
+
+g_ascii_formatd, function in String Utility Functions +
-
g_ascii_isalnum
+
+g_ascii_isalnum, function in String Utility Functions +
-
g_ascii_isalpha
+
+g_ascii_isalpha, function in String Utility Functions +
-
g_ascii_iscntrl
+
+g_ascii_iscntrl, function in String Utility Functions +
-
g_ascii_isdigit
+
+g_ascii_isdigit, function in String Utility Functions +
-
g_ascii_isgraph
+
+g_ascii_isgraph, function in String Utility Functions +
-
g_ascii_islower
+
+g_ascii_islower, function in String Utility Functions +
-
g_ascii_isprint
+
+g_ascii_isprint, function in String Utility Functions +
-
g_ascii_ispunct
+
+g_ascii_ispunct, function in String Utility Functions +
-
g_ascii_isspace
+
+g_ascii_isspace, function in String Utility Functions +
-
g_ascii_isupper
+
+g_ascii_isupper, function in String Utility Functions +
-
g_ascii_isxdigit
+
+g_ascii_isxdigit, function in String Utility Functions +
-
g_ascii_strcasecmp
+
+g_ascii_strcasecmp, function in String Utility Functions +
-
g_ascii_strdown
+
+g_ascii_strdown, function in String Utility Functions +
-
g_ascii_strncasecmp
+
+g_ascii_strncasecmp, function in String Utility Functions +
-
g_ascii_strtod
+
+g_ascii_strtod, function in String Utility Functions +
-
g_ascii_strtoll
+
+g_ascii_strtoll, function in String Utility Functions +
-
g_ascii_strtoull
+
+g_ascii_strtoull, function in String Utility Functions +
-
g_ascii_strup
+
+g_ascii_strup, function in String Utility Functions +
-
g_ascii_tolower
+
+g_ascii_tolower, function in String Utility Functions +
-
g_ascii_toupper
+
+g_ascii_toupper, function in String Utility Functions +
-
g_ascii_xdigit_value
+
+g_ascii_xdigit_value, function in String Utility Functions +
-
g_assert
+
+g_assert, macro in Testing +
-
g_assert_cmpfloat
+
+g_assert_cmpfloat, macro in Testing +
-
g_assert_cmphex
+
+g_assert_cmphex, macro in Testing +
-
g_assert_cmpint
+
+g_assert_cmpint, macro in Testing +
-
g_assert_cmpstr
+
+g_assert_cmpstr, macro in Testing +
-
g_assert_cmpuint
+
+g_assert_cmpuint, macro in Testing +
-
g_assert_error
+
+g_assert_error, macro in Testing +
-
g_assert_not_reached
+
+g_assert_not_reached, macro in Testing +
-
g_assert_no_error
+
+g_assert_no_error, macro in Testing +
-
GAsyncQueue
+
+GAsyncQueue, struct in Asynchronous Queues +
-
g_async_queue_length
+
+g_async_queue_length, function in Asynchronous Queues +
-
g_async_queue_length_unlocked
+
+g_async_queue_length_unlocked, function in Asynchronous Queues +
-
g_async_queue_lock
+
+g_async_queue_lock, function in Asynchronous Queues +
-
g_async_queue_new
+
+g_async_queue_new, function in Asynchronous Queues +
-
g_async_queue_new_full
+
+g_async_queue_new_full, function in Asynchronous Queues +
-
g_async_queue_pop
+
+g_async_queue_pop, function in Asynchronous Queues +
-
g_async_queue_pop_unlocked
+
+g_async_queue_pop_unlocked, function in Asynchronous Queues +
-
g_async_queue_push
+
+g_async_queue_push, function in Asynchronous Queues +
-
g_async_queue_push_sorted
+
+g_async_queue_push_sorted, function in Asynchronous Queues +
-
g_async_queue_push_sorted_unlocked
+
+g_async_queue_push_sorted_unlocked, function in Asynchronous Queues +
-
g_async_queue_push_unlocked
+
+g_async_queue_push_unlocked, function in Asynchronous Queues +
-
g_async_queue_ref
+
+g_async_queue_ref, function in Asynchronous Queues +
-
g_async_queue_ref_unlocked
+
+g_async_queue_ref_unlocked, function in Asynchronous Queues +
-
g_async_queue_sort
+
+g_async_queue_sort, function in Asynchronous Queues +
-
g_async_queue_sort_unlocked
+
+g_async_queue_sort_unlocked, function in Asynchronous Queues +
-
g_async_queue_timed_pop
+
+g_async_queue_timed_pop, function in Asynchronous Queues +
-
g_async_queue_timed_pop_unlocked
+
+g_async_queue_timed_pop_unlocked, function in Asynchronous Queues +
-
g_async_queue_try_pop
+
+g_async_queue_try_pop, function in Asynchronous Queues +
-
g_async_queue_try_pop_unlocked
+
+g_async_queue_try_pop_unlocked, function in Asynchronous Queues +
-
g_async_queue_unlock
+
+g_async_queue_unlock, function in Asynchronous Queues +
-
g_async_queue_unref
+
+g_async_queue_unref, function in Asynchronous Queues +
-
g_async_queue_unref_and_unlock
+
+g_async_queue_unref_and_unlock, function in Asynchronous Queues +
-
g_atexit
+
+g_atexit, function in Miscellaneous Utility Functions +
-
g_atomic_int_add
+
+g_atomic_int_add, function in Atomic Operations +
-
g_atomic_int_compare_and_exchange
+
+g_atomic_int_compare_and_exchange, function in Atomic Operations +
-
g_atomic_int_dec_and_test
+
+g_atomic_int_dec_and_test, function in Atomic Operations +
-
g_atomic_int_exchange_and_add
+
+g_atomic_int_exchange_and_add, function in Atomic Operations +
-
g_atomic_int_get
+
+g_atomic_int_get, function in Atomic Operations +
-
g_atomic_int_inc
+
+g_atomic_int_inc, function in Atomic Operations +
-
g_atomic_int_set
+
+g_atomic_int_set, function in Atomic Operations +
-
g_atomic_pointer_compare_and_exchange
+
+g_atomic_pointer_compare_and_exchange, function in Atomic Operations +
-
g_atomic_pointer_get
+
+g_atomic_pointer_get, function in Atomic Operations +
-
g_atomic_pointer_set
+
+g_atomic_pointer_set, function in Atomic Operations +

B

-
g_base64_decode
+
+g_base64_decode, function in Base64 Encoding +
-
g_base64_decode_inplace
+
+g_base64_decode_inplace, function in Base64 Encoding +
-
g_base64_decode_step
+
+g_base64_decode_step, function in Base64 Encoding +
-
g_base64_encode
+
+g_base64_encode, function in Base64 Encoding +
-
g_base64_encode_close
+
+g_base64_encode_close, function in Base64 Encoding +
-
g_base64_encode_step
+
+g_base64_encode_step, function in Base64 Encoding +
-
g_basename
+
+g_basename, function in Miscellaneous Utility Functions +
-
G_BEGIN_DECLS
+
+G_BEGIN_DECLS, macro in Miscellaneous Macros +
-
G_BIG_ENDIAN
+
+G_BIG_ENDIAN, macro in Byte Order Macros +
-
g_bit_lock
+
+g_bit_lock, function in Threads +
-
g_bit_nth_lsf
+
+g_bit_nth_lsf, function in Miscellaneous Utility Functions +
-
g_bit_nth_msf
+
+g_bit_nth_msf, function in Miscellaneous Utility Functions +
-
g_bit_storage
+
+g_bit_storage, function in Miscellaneous Utility Functions +
-
g_bit_trylock
+
+g_bit_trylock, function in Threads +
-
g_bit_unlock
+
+g_bit_unlock, function in Threads +
-
g_blow_chunks
+
+g_blow_chunks, function in Memory Chunks +
-
GBookmarkFile
+
+GBookmarkFile, struct in Bookmark file parser +
-
GBookmarkFileError
+
+GBookmarkFileError, enum in Bookmark file parser +
-
g_bookmark_file_add_application
+
+g_bookmark_file_add_application, function in Bookmark file parser +
-
g_bookmark_file_add_group
+
+g_bookmark_file_add_group, function in Bookmark file parser +
-
G_BOOKMARK_FILE_ERROR
+
+G_BOOKMARK_FILE_ERROR, macro in Bookmark file parser +
-
g_bookmark_file_free
+
+g_bookmark_file_free, function in Bookmark file parser +
-
g_bookmark_file_get_added
+
+g_bookmark_file_get_added, function in Bookmark file parser +
-
g_bookmark_file_get_applications
+
+g_bookmark_file_get_applications, function in Bookmark file parser +
-
g_bookmark_file_get_app_info
+
+g_bookmark_file_get_app_info, function in Bookmark file parser +
-
g_bookmark_file_get_description
+
+g_bookmark_file_get_description, function in Bookmark file parser +
-
g_bookmark_file_get_groups
+
+g_bookmark_file_get_groups, function in Bookmark file parser +
-
g_bookmark_file_get_icon
+
+g_bookmark_file_get_icon, function in Bookmark file parser +
-
g_bookmark_file_get_is_private
+
+g_bookmark_file_get_is_private, function in Bookmark file parser +
-
g_bookmark_file_get_mime_type
+
+g_bookmark_file_get_mime_type, function in Bookmark file parser +
-
g_bookmark_file_get_modified
+
+g_bookmark_file_get_modified, function in Bookmark file parser +
-
g_bookmark_file_get_size
+
+g_bookmark_file_get_size, function in Bookmark file parser +
-
g_bookmark_file_get_title
+
+g_bookmark_file_get_title, function in Bookmark file parser +
-
g_bookmark_file_get_uris
+
+g_bookmark_file_get_uris, function in Bookmark file parser +
-
g_bookmark_file_get_visited
+
+g_bookmark_file_get_visited, function in Bookmark file parser +
-
g_bookmark_file_has_application
+
+g_bookmark_file_has_application, function in Bookmark file parser +
-
g_bookmark_file_has_group
+
+g_bookmark_file_has_group, function in Bookmark file parser +
-
g_bookmark_file_has_item
+
+g_bookmark_file_has_item, function in Bookmark file parser +
-
g_bookmark_file_load_from_data
+
+g_bookmark_file_load_from_data, function in Bookmark file parser +
-
g_bookmark_file_load_from_data_dirs
+
+g_bookmark_file_load_from_data_dirs, function in Bookmark file parser +
-
g_bookmark_file_load_from_file
+
+g_bookmark_file_load_from_file, function in Bookmark file parser +
-
g_bookmark_file_move_item
+
+g_bookmark_file_move_item, function in Bookmark file parser +
-
g_bookmark_file_new
+
+g_bookmark_file_new, function in Bookmark file parser +
-
g_bookmark_file_remove_application
+
+g_bookmark_file_remove_application, function in Bookmark file parser +
-
g_bookmark_file_remove_group
+
+g_bookmark_file_remove_group, function in Bookmark file parser +
-
g_bookmark_file_remove_item
+
+g_bookmark_file_remove_item, function in Bookmark file parser +
-
g_bookmark_file_set_added
+
+g_bookmark_file_set_added, function in Bookmark file parser +
-
g_bookmark_file_set_app_info
+
+g_bookmark_file_set_app_info, function in Bookmark file parser +
-
g_bookmark_file_set_description
+
+g_bookmark_file_set_description, function in Bookmark file parser +
-
g_bookmark_file_set_groups
+
+g_bookmark_file_set_groups, function in Bookmark file parser +
-
g_bookmark_file_set_icon
+
+g_bookmark_file_set_icon, function in Bookmark file parser +
-
g_bookmark_file_set_is_private
+
+g_bookmark_file_set_is_private, function in Bookmark file parser +
-
g_bookmark_file_set_mime_type
+
+g_bookmark_file_set_mime_type, function in Bookmark file parser +
-
g_bookmark_file_set_modified
+
+g_bookmark_file_set_modified, function in Bookmark file parser +
-
g_bookmark_file_set_title
+
+g_bookmark_file_set_title, function in Bookmark file parser +
-
g_bookmark_file_set_visited
+
+g_bookmark_file_set_visited, function in Bookmark file parser +
-
g_bookmark_file_to_data
+
+g_bookmark_file_to_data, function in Bookmark file parser +
-
g_bookmark_file_to_file
+
+g_bookmark_file_to_file, function in Bookmark file parser +
-
gboolean
+
+gboolean, typedef in Basic Types +
-
G_BREAKPOINT
+
+G_BREAKPOINT, macro in Warnings and Assertions +
-
g_build_filename
+
+g_build_filename, function in Miscellaneous Utility Functions +
-
g_build_filenamev
+
+g_build_filenamev, function in Miscellaneous Utility Functions +
-
g_build_path
+
+g_build_path, function in Miscellaneous Utility Functions +
-
g_build_pathv
+
+g_build_pathv, function in Miscellaneous Utility Functions +
-
GByteArray
+
+GByteArray, struct in Byte Arrays +
-
g_byte_array_append
+
+g_byte_array_append, function in Byte Arrays +
-
g_byte_array_free
+
+g_byte_array_free, function in Byte Arrays +
-
g_byte_array_new
+
+g_byte_array_new, function in Byte Arrays +
-
g_byte_array_prepend
+
+g_byte_array_prepend, function in Byte Arrays +
-
g_byte_array_ref
+
+g_byte_array_ref, function in Byte Arrays +
-
g_byte_array_remove_index
+
+g_byte_array_remove_index, function in Byte Arrays +
-
g_byte_array_remove_index_fast
+
+g_byte_array_remove_index_fast, function in Byte Arrays +
-
g_byte_array_remove_range
+
+g_byte_array_remove_range, function in Byte Arrays +
-
g_byte_array_set_size
+
+g_byte_array_set_size, function in Byte Arrays +
-
g_byte_array_sized_new
+
+g_byte_array_sized_new, function in Byte Arrays +
-
g_byte_array_sort
+
+g_byte_array_sort, function in Byte Arrays +
-
g_byte_array_sort_with_data
+
+g_byte_array_sort_with_data, function in Byte Arrays +
-
g_byte_array_unref
+
+g_byte_array_unref, function in Byte Arrays +
-
G_BYTE_ORDER
+
+G_BYTE_ORDER, macro in Byte Order Macros +

C

-
GCache
+
+GCache, struct in Caches +
-
GCacheDestroyFunc
+
+GCacheDestroyFunc, user_function in Caches +
-
GCacheDupFunc
+
+GCacheDupFunc, user_function in Caches +
-
GCacheNewFunc
+
+GCacheNewFunc, user_function in Caches +
-
g_cache_destroy
+
+g_cache_destroy, function in Caches +
-
g_cache_insert
+
+g_cache_insert, function in Caches +
-
g_cache_key_foreach
+
+g_cache_key_foreach, function in Caches +
-
g_cache_new
+
+g_cache_new, function in Caches +
-
g_cache_remove
+
+g_cache_remove, function in Caches +
-
g_cache_value_foreach
+
+g_cache_value_foreach, function in Caches +
-
gchar
+
+gchar, typedef in Basic Types +
-
g_chdir
+
+g_chdir, function in File Utilities +
-
GChecksum
+
+GChecksum, struct in Data Checksums +
-
GChecksumType
+
+GChecksumType, enum in Data Checksums +
-
g_checksum_copy
+
+g_checksum_copy, function in Data Checksums +
-
g_checksum_free
+
+g_checksum_free, function in Data Checksums +
-
g_checksum_get_digest
+
+g_checksum_get_digest, function in Data Checksums +
-
g_checksum_get_string
+
+g_checksum_get_string, function in Data Checksums +
-
g_checksum_new
+
+g_checksum_new, function in Data Checksums +
-
g_checksum_reset
+
+g_checksum_reset, function in Data Checksums +
-
g_checksum_type_get_length
+
+g_checksum_type_get_length, function in Data Checksums +
-
g_checksum_update
+
+g_checksum_update, function in Data Checksums +
-
GChildWatchFunc
+
+GChildWatchFunc, user_function in The Main Event Loop +
-
g_child_watch_add
+
+g_child_watch_add, function in The Main Event Loop +
-
g_child_watch_add_full
+
+g_child_watch_add_full, function in The Main Event Loop +
-
g_child_watch_source_new
+
+g_child_watch_source_new, function in The Main Event Loop +
-
g_chmod
+
+g_chmod, function in File Utilities +
-
g_chunk_free
+
+g_chunk_free, macro in Memory Chunks +
-
g_chunk_new
+
+g_chunk_new, macro in Memory Chunks +
-
g_chunk_new0
+
+g_chunk_new0, macro in Memory Chunks +
-
CLAMP
+
+CLAMP, macro in Standard Macros +
-
g_clear_error
+
+g_clear_error, function in Error Reporting +
-
GCompareDataFunc
+
+GCompareDataFunc, user_function in Doubly-Linked Lists +
-
GCompareFunc
+
+GCompareFunc, user_function in Doubly-Linked Lists +
-
GCompletion
+
+GCompletion, struct in Automatic String Completion +
-
GCompletionFunc
+
+GCompletionFunc, user_function in Automatic String Completion +
-
GCompletionStrncmpFunc
+
+GCompletionStrncmpFunc, user_function in Automatic String Completion +
-
g_completion_add_items
+
+g_completion_add_items, function in Automatic String Completion +
-
g_completion_clear_items
+
+g_completion_clear_items, function in Automatic String Completion +
-
g_completion_complete
+
+g_completion_complete, function in Automatic String Completion +
-
g_completion_complete_utf8
+
+g_completion_complete_utf8, function in Automatic String Completion +
-
g_completion_free
+
+g_completion_free, function in Automatic String Completion +
-
g_completion_new
+
+g_completion_new, function in Automatic String Completion +
-
g_completion_remove_items
+
+g_completion_remove_items, function in Automatic String Completion +
-
g_completion_set_compare
+
+g_completion_set_compare, function in Automatic String Completion +
-
g_compute_checksum_for_data
+
+g_compute_checksum_for_data, function in Data Checksums +
-
g_compute_checksum_for_string
+
+g_compute_checksum_for_string, function in Data Checksums +
-
GCond
+
+GCond, struct in Threads +
-
g_cond_broadcast
+
+g_cond_broadcast, function in Threads +
-
g_cond_free
+
+g_cond_free, function in Threads +
-
g_cond_new
+
+g_cond_new, function in Threads +
-
g_cond_signal
+
+g_cond_signal, function in Threads +
-
g_cond_timed_wait
+
+g_cond_timed_wait, function in Threads +
-
g_cond_wait
+
+g_cond_wait, function in Threads +
-
gconstpointer
+
+gconstpointer, typedef in Basic Types +
-
G_CONST_RETURN
+
+G_CONST_RETURN, macro in Standard Macros +
-
g_convert
+
+g_convert, function in Character Set Conversion +
-
GConvertError
+
+GConvertError, enum in Character Set Conversion +
-
G_CONVERT_ERROR
+
+G_CONVERT_ERROR, macro in Character Set Conversion +
-
g_convert_with_fallback
+
+g_convert_with_fallback, function in Character Set Conversion +
-
g_convert_with_iconv
+
+g_convert_with_iconv, function in Character Set Conversion +
-
GCopyFunc
+
+GCopyFunc, user_function in N-ary Trees +
-
g_creat
+
+g_creat, function in File Utilities +
-
g_critical
+
+g_critical, macro in Message Logging +
-
G_CSET_a_2_z
+
+G_CSET_a_2_z, macro in Lexical Scanner +
-
G_CSET_A_2_Z
+
+G_CSET_A_2_Z, macro in Lexical Scanner +
-
G_CSET_DIGITS
+
+G_CSET_DIGITS, macro in Lexical Scanner +
-
G_CSET_LATINC
+
+G_CSET_LATINC, macro in Lexical Scanner +
-
G_CSET_LATINS
+
+G_CSET_LATINS, macro in Lexical Scanner +
-
C_
+
+C_, macro in I18N +

D

-
GData
+
+GData, struct in Keyed Data Lists +
-
GDataForeachFunc
+
+GDataForeachFunc, user_function in Datasets +
-
g_datalist_clear
+
+g_datalist_clear, function in Keyed Data Lists +
-
G_DATALIST_FLAGS_MASK
+
+G_DATALIST_FLAGS_MASK, macro in Keyed Data Lists +
-
g_datalist_foreach
+
+g_datalist_foreach, function in Keyed Data Lists +
-
g_datalist_get_data
+
+g_datalist_get_data, macro in Keyed Data Lists +
-
g_datalist_get_flags
+
+g_datalist_get_flags, function in Keyed Data Lists +
-
g_datalist_id_get_data
+
+g_datalist_id_get_data, function in Keyed Data Lists +
-
g_datalist_id_remove_data
+
+g_datalist_id_remove_data, macro in Keyed Data Lists +
-
g_datalist_id_remove_no_notify
+
+g_datalist_id_remove_no_notify, function in Keyed Data Lists +
-
g_datalist_id_set_data
+
+g_datalist_id_set_data, macro in Keyed Data Lists +
-
g_datalist_id_set_data_full
+
+g_datalist_id_set_data_full, function in Keyed Data Lists +
-
g_datalist_init
+
+g_datalist_init, function in Keyed Data Lists +
-
g_datalist_remove_data
+
+g_datalist_remove_data, macro in Keyed Data Lists +
-
g_datalist_remove_no_notify
+
+g_datalist_remove_no_notify, macro in Keyed Data Lists +
-
g_datalist_set_data
+
+g_datalist_set_data, macro in Keyed Data Lists +
-
g_datalist_set_data_full
+
+g_datalist_set_data_full, macro in Keyed Data Lists +
-
g_datalist_set_flags
+
+g_datalist_set_flags, function in Keyed Data Lists +
-
g_datalist_unset_flags
+
+g_datalist_unset_flags, function in Keyed Data Lists +
-
g_dataset_destroy
+
+g_dataset_destroy, function in Datasets +
-
g_dataset_foreach
+
+g_dataset_foreach, function in Datasets +
-
g_dataset_get_data
+
+g_dataset_get_data, macro in Datasets +
-
g_dataset_id_get_data
+
+g_dataset_id_get_data, function in Datasets +
-
g_dataset_id_remove_data
+
+g_dataset_id_remove_data, macro in Datasets +
-
g_dataset_id_remove_no_notify
+
+g_dataset_id_remove_no_notify, function in Datasets +
-
g_dataset_id_set_data
+
+g_dataset_id_set_data, macro in Datasets +
-
g_dataset_id_set_data_full
+
+g_dataset_id_set_data_full, function in Datasets +
-
g_dataset_remove_data
+
+g_dataset_remove_data, macro in Datasets +
-
g_dataset_remove_no_notify
+
+g_dataset_remove_no_notify, macro in Datasets +
-
g_dataset_set_data
+
+g_dataset_set_data, macro in Datasets +
-
g_dataset_set_data_full
+
+g_dataset_set_data_full, macro in Datasets +
-
GDate
+
+GDate, struct in Date and Time Functions +
-
GDateDay
+
+GDateDay, typedef in Date and Time Functions +
-
GDateDMY
+
+GDateDMY, enum in Date and Time Functions +
-
GDateMonth
+
+GDateMonth, enum in Date and Time Functions +
-
GDateWeekday
+
+GDateWeekday, enum in Date and Time Functions +
-
GDateYear
+
+GDateYear, typedef in Date and Time Functions +
-
g_date_add_days
+
+g_date_add_days, function in Date and Time Functions +
-
g_date_add_months
+
+g_date_add_months, function in Date and Time Functions +
-
g_date_add_years
+
+g_date_add_years, function in Date and Time Functions +
-
G_DATE_BAD_DAY
+
+G_DATE_BAD_DAY, macro in Date and Time Functions +
-
G_DATE_BAD_JULIAN
+
+G_DATE_BAD_JULIAN, macro in Date and Time Functions +
-
G_DATE_BAD_YEAR
+
+G_DATE_BAD_YEAR, macro in Date and Time Functions +
-
g_date_clamp
+
+g_date_clamp, function in Date and Time Functions +
-
g_date_clear
+
+g_date_clear, function in Date and Time Functions +
-
g_date_compare
+
+g_date_compare, function in Date and Time Functions +
-
g_date_days_between
+
+g_date_days_between, function in Date and Time Functions +
-
g_date_free
+
+g_date_free, function in Date and Time Functions +
-
g_date_get_day
+
+g_date_get_day, function in Date and Time Functions +
-
g_date_get_days_in_month
+
+g_date_get_days_in_month, function in Date and Time Functions +
-
g_date_get_day_of_year
+
+g_date_get_day_of_year, function in Date and Time Functions +
-
g_date_get_iso8601_week_of_year
+
+g_date_get_iso8601_week_of_year, function in Date and Time Functions +
-
g_date_get_julian
+
+g_date_get_julian, function in Date and Time Functions +
-
g_date_get_monday_weeks_in_year
+
+g_date_get_monday_weeks_in_year, function in Date and Time Functions +
-
g_date_get_monday_week_of_year
+
+g_date_get_monday_week_of_year, function in Date and Time Functions +
-
g_date_get_month
+
+g_date_get_month, function in Date and Time Functions +
-
g_date_get_sunday_weeks_in_year
+
+g_date_get_sunday_weeks_in_year, function in Date and Time Functions +
-
g_date_get_sunday_week_of_year
+
+g_date_get_sunday_week_of_year, function in Date and Time Functions +
-
g_date_get_weekday
+
+g_date_get_weekday, function in Date and Time Functions +
-
g_date_get_year
+
+g_date_get_year, function in Date and Time Functions +
-
g_date_is_first_of_month
+
+g_date_is_first_of_month, function in Date and Time Functions +
-
g_date_is_last_of_month
+
+g_date_is_last_of_month, function in Date and Time Functions +
-
g_date_is_leap_year
+
+g_date_is_leap_year, function in Date and Time Functions +
-
g_date_new
+
+g_date_new, function in Date and Time Functions +
-
g_date_new_dmy
+
+g_date_new_dmy, function in Date and Time Functions +
-
g_date_new_julian
+
+g_date_new_julian, function in Date and Time Functions +
-
g_date_order
+
+g_date_order, function in Date and Time Functions +
-
g_date_set_day
+
+g_date_set_day, function in Date and Time Functions +
-
g_date_set_dmy
+
+g_date_set_dmy, function in Date and Time Functions +
-
g_date_set_julian
+
+g_date_set_julian, function in Date and Time Functions +
-
g_date_set_month
+
+g_date_set_month, function in Date and Time Functions +
-
g_date_set_parse
+
+g_date_set_parse, function in Date and Time Functions +
-
g_date_set_time
+
+g_date_set_time, function in Date and Time Functions +
-
g_date_set_time_t
+
+g_date_set_time_t, function in Date and Time Functions +
-
g_date_set_time_val
+
+g_date_set_time_val, function in Date and Time Functions +
-
g_date_set_year
+
+g_date_set_year, function in Date and Time Functions +
-
g_date_strftime
+
+g_date_strftime, function in Date and Time Functions +
-
g_date_subtract_days
+
+g_date_subtract_days, function in Date and Time Functions +
-
g_date_subtract_months
+
+g_date_subtract_months, function in Date and Time Functions +
-
g_date_subtract_years
+
+g_date_subtract_years, function in Date and Time Functions +
-
g_date_to_struct_tm
+
+g_date_to_struct_tm, function in Date and Time Functions +
-
g_date_valid
+
+g_date_valid, function in Date and Time Functions +
-
g_date_valid_day
+
+g_date_valid_day, function in Date and Time Functions +
-
g_date_valid_dmy
+
+g_date_valid_dmy, function in Date and Time Functions +
-
g_date_valid_julian
+
+g_date_valid_julian, function in Date and Time Functions +
-
g_date_valid_month
+
+g_date_valid_month, function in Date and Time Functions +
-
g_date_valid_weekday
+
+g_date_valid_weekday, function in Date and Time Functions +
-
g_date_valid_year
+
+g_date_valid_year, function in Date and Time Functions +
-
g_debug
+
+g_debug, macro in Message Logging +
-
GDebugKey
+
+GDebugKey, struct in Miscellaneous Utility Functions +
-
GDestroyNotify
+
+GDestroyNotify, user_function in Datasets +
-
g_dgettext
+
+g_dgettext, function in I18N +
-
GDir
+
+GDir, struct in File Utilities +
-
g_direct_equal
+
+g_direct_equal, function in Hash Tables +
-
g_direct_hash
+
+g_direct_hash, function in Hash Tables +
-
g_dirname
+
+g_dirname, macro in Miscellaneous Utility Functions +
-
g_dir_close
+
+g_dir_close, function in File Utilities +
-
g_dir_open
+
+g_dir_open, function in File Utilities +
-
g_dir_read_name
+
+g_dir_read_name, function in File Utilities +
-
g_dir_rewind
+
+g_dir_rewind, function in File Utilities +
-
G_DIR_SEPARATOR
+
+G_DIR_SEPARATOR, macro in Standard Macros +
-
G_DIR_SEPARATOR_S
+
+G_DIR_SEPARATOR_S, macro in Standard Macros +
-
g_dngettext
+
+g_dngettext, function in I18N +
-
gdouble
+
+gdouble, typedef in Basic Types +
-
GDoubleIEEE754
+
+GDoubleIEEE754, union in Numerical Definitions +
-
g_double_equal
+
+g_double_equal, function in Hash Tables +
-
g_double_hash
+
+g_double_hash, function in Hash Tables +
-
g_dpgettext
+
+g_dpgettext, function in I18N +
-
g_dpgettext2
+
+g_dpgettext2, function in I18N +

E

-
G_E
+
+G_E, macro in Numerical Definitions +
-
G_END_DECLS
+
+G_END_DECLS, macro in Miscellaneous Macros +
-
GEqualFunc
+
+GEqualFunc, user_function in Hash Tables +
-
g_error
+
+g_error, macro in Message Logging +
-
GError
+
+GError, struct in Error Reporting +
-
GErrorType
+
+GErrorType, enum in Lexical Scanner +
-
g_error_copy
+
+g_error_copy, function in Error Reporting +
-
g_error_free
+
+g_error_free, function in Error Reporting +
-
g_error_matches
+
+g_error_matches, function in Error Reporting +
-
g_error_new
+
+g_error_new, function in Error Reporting +
-
g_error_new_literal
+
+g_error_new_literal, function in Error Reporting +
-
g_error_new_valist
+
+g_error_new_valist, function in Error Reporting +

F

-
FALSE
+
+FALSE, macro in Standard Macros +
-
GFileError
+
+GFileError, enum in File Utilities +
-
g_filename_display_basename
+
+g_filename_display_basename, function in Character Set Conversion +
-
g_filename_display_name
+
+g_filename_display_name, function in Character Set Conversion +
-
g_filename_from_uri
+
+g_filename_from_uri, function in Character Set Conversion +
-
g_filename_from_utf8
+
+g_filename_from_utf8, function in Character Set Conversion +
-
g_filename_to_uri
+
+g_filename_to_uri, function in Character Set Conversion +
-
g_filename_to_utf8
+
+g_filename_to_utf8, function in Character Set Conversion +
-
GFileTest
+
+GFileTest, enum in File Utilities +
-
G_FILE_ERROR
+
+G_FILE_ERROR, macro in File Utilities +
-
g_file_error_from_errno
+
+g_file_error_from_errno, function in File Utilities +
-
g_file_get_contents
+
+g_file_get_contents, function in File Utilities +
-
g_file_open_tmp
+
+g_file_open_tmp, function in File Utilities +
-
g_file_read_link
+
+g_file_read_link, function in File Utilities +
-
g_file_set_contents
+
+g_file_set_contents, function in File Utilities +
-
g_file_test
+
+g_file_test, function in File Utilities +
-
g_find_program_in_path
+
+g_find_program_in_path, function in Miscellaneous Utility Functions +
-
gfloat
+
+gfloat, typedef in Basic Types +
-
GFloatIEEE754
+
+GFloatIEEE754, union in Numerical Definitions +
-
g_fopen
+
+g_fopen, function in File Utilities +
-
g_format_size_for_display
+
+g_format_size_for_display, function in Miscellaneous Utility Functions +
-
g_fprintf
+
+g_fprintf, function in String Utility Functions +
-
g_free
+
+g_free, function in Memory Allocation +
-
GFreeFunc
+
+GFreeFunc, user_function in Miscellaneous Utility Functions +
-
g_freopen
+
+g_freopen, function in File Utilities +
-
GFunc
+
+GFunc, user_function in Doubly-Linked Lists +

G

-
g_getenv
+
+g_getenv, function in Miscellaneous Utility Functions +
-
g_get_application_name
+
+g_get_application_name, function in Miscellaneous Utility Functions +
-
g_get_charset
+
+g_get_charset, function in Character Set Conversion +
-
g_get_current_dir
+
+g_get_current_dir, function in Miscellaneous Utility Functions +
-
g_get_current_time
+
+g_get_current_time, function in Date and Time Functions +
-
g_get_filename_charsets
+
+g_get_filename_charsets, function in Character Set Conversion +
-
g_get_home_dir
+
+g_get_home_dir, function in Miscellaneous Utility Functions +
-
g_get_host_name
+
+g_get_host_name, function in Miscellaneous Utility Functions +
-
g_get_language_names
+
+g_get_language_names, function in I18N +
-
g_get_prgname
+
+g_get_prgname, function in Miscellaneous Utility Functions +
-
g_get_real_name
+
+g_get_real_name, function in Miscellaneous Utility Functions +
-
g_get_system_config_dirs
+
+g_get_system_config_dirs, function in Miscellaneous Utility Functions +
-
g_get_system_data_dirs
+
+g_get_system_data_dirs, function in Miscellaneous Utility Functions +
-
g_get_tmp_dir
+
+g_get_tmp_dir, function in Miscellaneous Utility Functions +
-
g_get_user_cache_dir
+
+g_get_user_cache_dir, function in Miscellaneous Utility Functions +
-
g_get_user_config_dir
+
+g_get_user_config_dir, function in Miscellaneous Utility Functions +
-
g_get_user_data_dir
+
+g_get_user_data_dir, function in Miscellaneous Utility Functions +
-
g_get_user_name
+
+g_get_user_name, function in Miscellaneous Utility Functions +
-
g_get_user_special_dir
+
+g_get_user_special_dir, function in Miscellaneous Utility Functions +
-
G_GINT16_FORMAT
+
+G_GINT16_FORMAT, macro in Miscellaneous Macros +
-
G_GINT16_MODIFIER
+
+G_GINT16_MODIFIER, macro in Miscellaneous Macros +
-
G_GINT32_FORMAT
+
+G_GINT32_FORMAT, macro in Miscellaneous Macros +
-
G_GINT32_MODIFIER
+
+G_GINT32_MODIFIER, macro in Miscellaneous Macros +
-
G_GINT64_CONSTANT
+
+G_GINT64_CONSTANT, macro in Basic Types +
-
G_GINT64_FORMAT
+
+G_GINT64_FORMAT, macro in Miscellaneous Macros +
-
G_GINT64_MODIFIER
+
+G_GINT64_MODIFIER, macro in Miscellaneous Macros +
-
G_GINTPTR_FORMAT
+
+G_GINTPTR_FORMAT, macro in Miscellaneous Macros +
-
G_GINTPTR_MODIFIER
+
+G_GINTPTR_MODIFIER, macro in Miscellaneous Macros +
-
G_GNUC_ALLOC_SIZE
+
+G_GNUC_ALLOC_SIZE, macro in Miscellaneous Macros +
-
G_GNUC_ALLOC_SIZE2
+
+G_GNUC_ALLOC_SIZE2, macro in Miscellaneous Macros +
-
G_GNUC_CONST
+
+G_GNUC_CONST, macro in Miscellaneous Macros +
-
G_GNUC_DEPRECATED
+
+G_GNUC_DEPRECATED, macro in Miscellaneous Macros +
-
G_GNUC_EXTENSION
+
+G_GNUC_EXTENSION, macro in Miscellaneous Macros +
-
G_GNUC_FORMAT
+
+G_GNUC_FORMAT, macro in Miscellaneous Macros +
-
G_GNUC_FUNCTION
+
+G_GNUC_FUNCTION, macro in Miscellaneous Macros +
-
G_GNUC_INTERNAL
+
+G_GNUC_INTERNAL, macro in Miscellaneous Macros +
-
G_GNUC_MALLOC
+
+G_GNUC_MALLOC, macro in Miscellaneous Macros +
-
G_GNUC_MAY_ALIAS
+
+G_GNUC_MAY_ALIAS, macro in Miscellaneous Macros +
-
G_GNUC_NORETURN
+
+G_GNUC_NORETURN, macro in Miscellaneous Macros +
-
G_GNUC_NO_INSTRUMENT
+
+G_GNUC_NO_INSTRUMENT, macro in Miscellaneous Macros +
-
G_GNUC_NULL_TERMINATED
+
+G_GNUC_NULL_TERMINATED, macro in Miscellaneous Macros +
-
G_GNUC_PRETTY_FUNCTION
+
+G_GNUC_PRETTY_FUNCTION, macro in Miscellaneous Macros +
-
G_GNUC_PRINTF
+
+G_GNUC_PRINTF, macro in Miscellaneous Macros +
-
G_GNUC_PURE
+
+G_GNUC_PURE, macro in Miscellaneous Macros +
-
G_GNUC_SCANF
+
+G_GNUC_SCANF, macro in Miscellaneous Macros +
-
G_GNUC_UNUSED
+
+G_GNUC_UNUSED, macro in Miscellaneous Macros +
-
G_GNUC_WARN_UNUSED_RESULT
+
+G_GNUC_WARN_UNUSED_RESULT, macro in Miscellaneous Macros +
-
G_GOFFSET_CONSTANT
+
+G_GOFFSET_CONSTANT, macro in Basic Types +
-
G_GOFFSET_FORMAT
+
+G_GOFFSET_FORMAT, macro in Miscellaneous Macros +
-
G_GOFFSET_MODIFIER
+
+G_GOFFSET_MODIFIER, macro in Miscellaneous Macros +
-
G_GSIZE_FORMAT
+
+G_GSIZE_FORMAT, macro in Miscellaneous Macros +
-
G_GSIZE_MODIFIER
+
+G_GSIZE_MODIFIER, macro in Miscellaneous Macros +
-
G_GSSIZE_FORMAT
+
+G_GSSIZE_FORMAT, macro in Miscellaneous Macros +
-
G_GUINT16_FORMAT
+
+G_GUINT16_FORMAT, macro in Miscellaneous Macros +
-
G_GUINT32_FORMAT
+
+G_GUINT32_FORMAT, macro in Miscellaneous Macros +
-
G_GUINT64_CONSTANT
+
+G_GUINT64_CONSTANT, macro in Basic Types +
-
G_GUINT64_FORMAT
+
+G_GUINT64_FORMAT, macro in Miscellaneous Macros +
-
G_GUINTPTR_FORMAT
+
+G_GUINTPTR_FORMAT, macro in Miscellaneous Macros +

H

-
GHashFunc
+
+GHashFunc, user_function in Hash Tables +
-
GHashTable
+
+GHashTable, struct in Hash Tables +
-
GHashTableIter
+
+GHashTableIter, struct in Hash Tables +
-
g_hash_table_destroy
+
+g_hash_table_destroy, function in Hash Tables +
-
g_hash_table_find
+
+g_hash_table_find, function in Hash Tables +
-
g_hash_table_foreach
+
+g_hash_table_foreach, function in Hash Tables +
-
g_hash_table_foreach_remove
+
+g_hash_table_foreach_remove, function in Hash Tables +
-
g_hash_table_foreach_steal
+
+g_hash_table_foreach_steal, function in Hash Tables +
-
g_hash_table_freeze
+
+g_hash_table_freeze, macro in Hash Tables +
-
g_hash_table_get_keys
+
+g_hash_table_get_keys, function in Hash Tables +
-
g_hash_table_get_values
+
+g_hash_table_get_values, function in Hash Tables +
-
g_hash_table_insert
+
+g_hash_table_insert, function in Hash Tables +
-
g_hash_table_iter_get_hash_table
+
+g_hash_table_iter_get_hash_table, function in Hash Tables +
-
g_hash_table_iter_init
+
+g_hash_table_iter_init, function in Hash Tables +
-
g_hash_table_iter_next
+
+g_hash_table_iter_next, function in Hash Tables +
-
g_hash_table_iter_remove
+
+g_hash_table_iter_remove, function in Hash Tables +
-
g_hash_table_iter_steal
+
+g_hash_table_iter_steal, function in Hash Tables +
-
g_hash_table_lookup
+
+g_hash_table_lookup, function in Hash Tables +
-
g_hash_table_lookup_extended
+
+g_hash_table_lookup_extended, function in Hash Tables +
-
g_hash_table_new
+
+g_hash_table_new, function in Hash Tables +
-
g_hash_table_new_full
+
+g_hash_table_new_full, function in Hash Tables +
-
g_hash_table_ref
+
+g_hash_table_ref, function in Hash Tables +
-
g_hash_table_remove
+
+g_hash_table_remove, function in Hash Tables +
-
g_hash_table_remove_all
+
+g_hash_table_remove_all, function in Hash Tables +
-
g_hash_table_replace
+
+g_hash_table_replace, function in Hash Tables +
-
g_hash_table_size
+
+g_hash_table_size, function in Hash Tables +
-
g_hash_table_steal
+
+g_hash_table_steal, function in Hash Tables +
-
g_hash_table_steal_all
+
+g_hash_table_steal_all, function in Hash Tables +
-
g_hash_table_thaw
+
+g_hash_table_thaw, macro in Hash Tables +
-
g_hash_table_unref
+
+g_hash_table_unref, function in Hash Tables +
-
G_HAVE_GINT64
+
+G_HAVE_GINT64, macro in Basic Types +
-
G_HAVE_GNUC_VISIBILITY
+
+G_HAVE_GNUC_VISIBILITY, macro in Miscellaneous Macros +
-
GHFunc
+
+GHFunc, user_function in Hash Tables +
-
G_HOOK
+
+G_HOOK, macro in Hook Functions +
-
GHook
+
+GHook, struct in Hook Functions +
-
GHookCheckFunc
+
+GHookCheckFunc, user_function in Hook Functions +
-
GHookCheckMarshaller
+
+GHookCheckMarshaller, user_function in Hook Functions +
-
GHookCompareFunc
+
+GHookCompareFunc, user_function in Hook Functions +
-
GHookFinalizeFunc
+
+GHookFinalizeFunc, user_function in Hook Functions +
-
GHookFindFunc
+
+GHookFindFunc, user_function in Hook Functions +
-
GHookFlagMask
+
+GHookFlagMask, enum in Hook Functions +
-
GHookFunc
+
+GHookFunc, user_function in Hook Functions +
-
GHookList
+
+GHookList, struct in Hook Functions +
-
GHookMarshaller
+
+GHookMarshaller, user_function in Hook Functions +
-
G_HOOK_ACTIVE
+
+G_HOOK_ACTIVE, macro in Hook Functions +
-
g_hook_alloc
+
+g_hook_alloc, function in Hook Functions +
-
g_hook_append
+
+g_hook_append, macro in Hook Functions +
-
g_hook_compare_ids
+
+g_hook_compare_ids, function in Hook Functions +
-
g_hook_destroy
+
+g_hook_destroy, function in Hook Functions +
-
g_hook_destroy_link
+
+g_hook_destroy_link, function in Hook Functions +
-
g_hook_find
+
+g_hook_find, function in Hook Functions +
-
g_hook_find_data
+
+g_hook_find_data, function in Hook Functions +
-
g_hook_find_func
+
+g_hook_find_func, function in Hook Functions +
-
g_hook_find_func_data
+
+g_hook_find_func_data, function in Hook Functions +
-
g_hook_first_valid
+
+g_hook_first_valid, function in Hook Functions +
-
G_HOOK_FLAGS
+
+G_HOOK_FLAGS, macro in Hook Functions +
-
G_HOOK_FLAG_USER_SHIFT
+
+G_HOOK_FLAG_USER_SHIFT, macro in Hook Functions +
-
g_hook_free
+
+g_hook_free, function in Hook Functions +
-
g_hook_get
+
+g_hook_get, function in Hook Functions +
-
g_hook_insert_before
+
+g_hook_insert_before, function in Hook Functions +
-
g_hook_insert_sorted
+
+g_hook_insert_sorted, function in Hook Functions +
-
G_HOOK_IN_CALL
+
+G_HOOK_IN_CALL, macro in Hook Functions +
-
G_HOOK_IS_UNLINKED
+
+G_HOOK_IS_UNLINKED, macro in Hook Functions +
-
G_HOOK_IS_VALID
+
+G_HOOK_IS_VALID, macro in Hook Functions +
-
g_hook_list_clear
+
+g_hook_list_clear, function in Hook Functions +
-
g_hook_list_init
+
+g_hook_list_init, function in Hook Functions +
-
g_hook_list_invoke
+
+g_hook_list_invoke, function in Hook Functions +
-
g_hook_list_invoke_check
+
+g_hook_list_invoke_check, function in Hook Functions +
-
g_hook_list_marshal
+
+g_hook_list_marshal, function in Hook Functions +
-
g_hook_list_marshal_check
+
+g_hook_list_marshal_check, function in Hook Functions +
-
g_hook_next_valid
+
+g_hook_next_valid, function in Hook Functions +
-
g_hook_prepend
+
+g_hook_prepend, function in Hook Functions +
-
g_hook_ref
+
+g_hook_ref, function in Hook Functions +
-
g_hook_unref
+
+g_hook_unref, function in Hook Functions +
-
g_hostname_is_ascii_encoded
+
+g_hostname_is_ascii_encoded, function in Hostname Utilities +
-
g_hostname_is_ip_address
+
+g_hostname_is_ip_address, function in Hostname Utilities +
-
g_hostname_is_non_ascii
+
+g_hostname_is_non_ascii, function in Hostname Utilities +
-
g_hostname_to_ascii
+
+g_hostname_to_ascii, function in Hostname Utilities +
-
g_hostname_to_unicode
+
+g_hostname_to_unicode, function in Hostname Utilities +
-
GHRFunc
+
+GHRFunc, user_function in Hash Tables +
-
g_htonl
+
+g_htonl, macro in Byte Order Macros +
-
g_htons
+
+g_htons, macro in Byte Order Macros +

I

-
GIConv
+
+GIConv, struct in Character Set Conversion +
-
g_iconv
+
+g_iconv, function in Character Set Conversion +
-
g_iconv_close
+
+g_iconv_close, function in Character Set Conversion +
-
g_iconv_open
+
+g_iconv_open, function in Character Set Conversion +
-
g_idle_add
+
+g_idle_add, function in The Main Event Loop +
-
g_idle_add_full
+
+g_idle_add_full, function in The Main Event Loop +
-
g_idle_remove_by_data
+
+g_idle_remove_by_data, function in The Main Event Loop +
-
g_idle_source_new
+
+g_idle_source_new, function in The Main Event Loop +
-
G_IEEE754_DOUBLE_BIAS
+
+G_IEEE754_DOUBLE_BIAS, macro in Numerical Definitions +
-
G_IEEE754_FLOAT_BIAS
+
+G_IEEE754_FLOAT_BIAS, macro in Numerical Definitions +
-
G_INLINE_FUNC
+
+G_INLINE_FUNC, macro in Miscellaneous Macros +
-
gint
+
+gint, typedef in Basic Types +
-
gint16
+
+gint16, typedef in Basic Types +
-
GINT16_FROM_BE
+
+GINT16_FROM_BE, macro in Byte Order Macros +
-
GINT16_FROM_LE
+
+GINT16_FROM_LE, macro in Byte Order Macros +
-
GINT16_TO_BE
+
+GINT16_TO_BE, macro in Byte Order Macros +
-
GINT16_TO_LE
+
+GINT16_TO_LE, macro in Byte Order Macros +
-
gint32
+
+gint32, typedef in Basic Types +
-
GINT32_FROM_BE
+
+GINT32_FROM_BE, macro in Byte Order Macros +
-
GINT32_FROM_LE
+
+GINT32_FROM_LE, macro in Byte Order Macros +
-
GINT32_TO_BE
+
+GINT32_TO_BE, macro in Byte Order Macros +
-
GINT32_TO_LE
+
+GINT32_TO_LE, macro in Byte Order Macros +
-
gint64
+
+gint64, typedef in Basic Types +
-
g_int64_equal
+
+g_int64_equal, function in Hash Tables +
-
GINT64_FROM_BE
+
+GINT64_FROM_BE, macro in Byte Order Macros +
-
GINT64_FROM_LE
+
+GINT64_FROM_LE, macro in Byte Order Macros +
-
g_int64_hash
+
+g_int64_hash, function in Hash Tables +
-
GINT64_TO_BE
+
+GINT64_TO_BE, macro in Byte Order Macros +
-
GINT64_TO_LE
+
+GINT64_TO_LE, macro in Byte Order Macros +
-
gint8
+
+gint8, typedef in Basic Types +
-
g_intern_static_string
+
+g_intern_static_string, function in Quarks +
-
g_intern_string
+
+g_intern_string, function in Quarks +
-
gintptr
+
+gintptr, typedef in Basic Types +
-
g_int_equal
+
+g_int_equal, function in Hash Tables +
-
GINT_FROM_BE
+
+GINT_FROM_BE, macro in Byte Order Macros +
-
GINT_FROM_LE
+
+GINT_FROM_LE, macro in Byte Order Macros +
-
g_int_hash
+
+g_int_hash, function in Hash Tables +
-
GINT_TO_BE
+
+GINT_TO_BE, macro in Byte Order Macros +
-
GINT_TO_LE
+
+GINT_TO_LE, macro in Byte Order Macros +
-
GINT_TO_POINTER
+
+GINT_TO_POINTER, macro in Type Conversion Macros +
-
GIOChannel
+
+GIOChannel, struct in IO Channels +
-
GIOChannelError
+
+GIOChannelError, enum in IO Channels +
-
GIOCondition
+
+GIOCondition, enum in IO Channels +
-
GIOError
+
+GIOError, enum in IO Channels +
-
GIOFlags
+
+GIOFlags, enum in IO Channels +
-
GIOFunc
+
+GIOFunc, user_function in IO Channels +
-
GIOFuncs
+
+GIOFuncs, struct in IO Channels +
-
GIOStatus
+
+GIOStatus, enum in IO Channels +
-
g_io_add_watch
+
+g_io_add_watch, function in IO Channels +
-
g_io_add_watch_full
+
+g_io_add_watch_full, function in IO Channels +
-
g_io_channel_close
+
+g_io_channel_close, function in IO Channels +
-
G_IO_CHANNEL_ERROR
+
+G_IO_CHANNEL_ERROR, macro in IO Channels +
-
g_io_channel_error_from_errno
+
+g_io_channel_error_from_errno, function in IO Channels +
-
g_io_channel_flush
+
+g_io_channel_flush, function in IO Channels +
-
g_io_channel_get_buffered
+
+g_io_channel_get_buffered, function in IO Channels +
-
g_io_channel_get_buffer_condition
+
+g_io_channel_get_buffer_condition, function in IO Channels +
-
g_io_channel_get_buffer_size
+
+g_io_channel_get_buffer_size, function in IO Channels +
-
g_io_channel_get_close_on_unref
+
+g_io_channel_get_close_on_unref, function in IO Channels +
-
g_io_channel_get_encoding
+
+g_io_channel_get_encoding, function in IO Channels +
-
g_io_channel_get_flags
+
+g_io_channel_get_flags, function in IO Channels +
-
g_io_channel_get_line_term
+
+g_io_channel_get_line_term, function in IO Channels +
-
g_io_channel_init
+
+g_io_channel_init, function in IO Channels +
-
g_io_channel_new_file
+
+g_io_channel_new_file, function in IO Channels +
-
g_io_channel_read
+
+g_io_channel_read, function in IO Channels +
-
g_io_channel_read_chars
+
+g_io_channel_read_chars, function in IO Channels +
-
g_io_channel_read_line
+
+g_io_channel_read_line, function in IO Channels +
-
g_io_channel_read_line_string
+
+g_io_channel_read_line_string, function in IO Channels +
-
g_io_channel_read_to_end
+
+g_io_channel_read_to_end, function in IO Channels +
-
g_io_channel_read_unichar
+
+g_io_channel_read_unichar, function in IO Channels +
-
g_io_channel_ref
+
+g_io_channel_ref, function in IO Channels +
-
g_io_channel_seek
+
+g_io_channel_seek, function in IO Channels +
-
g_io_channel_seek_position
+
+g_io_channel_seek_position, function in IO Channels +
-
g_io_channel_set_buffered
+
+g_io_channel_set_buffered, function in IO Channels +
-
g_io_channel_set_buffer_size
+
+g_io_channel_set_buffer_size, function in IO Channels +
-
g_io_channel_set_close_on_unref
+
+g_io_channel_set_close_on_unref, function in IO Channels +
-
g_io_channel_set_encoding
+
+g_io_channel_set_encoding, function in IO Channels +
-
g_io_channel_set_flags
+
+g_io_channel_set_flags, function in IO Channels +
-
g_io_channel_set_line_term
+
+g_io_channel_set_line_term, function in IO Channels +
-
g_io_channel_shutdown
+
+g_io_channel_shutdown, function in IO Channels +
-
g_io_channel_unix_get_fd
+
+g_io_channel_unix_get_fd, function in IO Channels +
-
g_io_channel_unix_new
+
+g_io_channel_unix_new, function in IO Channels +
-
g_io_channel_unref
+
+g_io_channel_unref, function in IO Channels +
-
g_io_channel_win32_new_fd
+
+g_io_channel_win32_new_fd, function in IO Channels +
-
g_io_channel_win32_new_messages
+
+g_io_channel_win32_new_messages, function in IO Channels +
-
g_io_channel_win32_new_socket
+
+g_io_channel_win32_new_socket, function in IO Channels +
-
g_io_channel_write
+
+g_io_channel_write, function in IO Channels +
-
g_io_channel_write_chars
+
+g_io_channel_write_chars, function in IO Channels +
-
g_io_channel_write_unichar
+
+g_io_channel_write_unichar, function in IO Channels +
-
g_io_create_watch
+
+g_io_create_watch, function in IO Channels +
-
G_IS_DIR_SEPARATOR
+
+G_IS_DIR_SEPARATOR, macro in Standard Macros +

K

-
GKeyFile
+
+GKeyFile, struct in Key-value file parser +
-
GKeyFileError
+
+GKeyFileError, enum in Key-value file parser +
-
GKeyFileFlags
+
+GKeyFileFlags, enum in Key-value file parser +
-
G_KEY_FILE_DESKTOP_GROUP
+
+G_KEY_FILE_DESKTOP_GROUP, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_CATEGORIES
+
+G_KEY_FILE_DESKTOP_KEY_CATEGORIES, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_COMMENT
+
+G_KEY_FILE_DESKTOP_KEY_COMMENT, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_EXEC
+
+G_KEY_FILE_DESKTOP_KEY_EXEC, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME
+
+G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_HIDDEN
+
+G_KEY_FILE_DESKTOP_KEY_HIDDEN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_ICON
+
+G_KEY_FILE_DESKTOP_KEY_ICON, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_MIME_TYPE
+
+G_KEY_FILE_DESKTOP_KEY_MIME_TYPE, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NAME
+
+G_KEY_FILE_DESKTOP_KEY_NAME, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN
+
+G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY
+
+G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN
+
+G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_PATH
+
+G_KEY_FILE_DESKTOP_KEY_PATH, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY
+
+G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS
+
+G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TERMINAL
+
+G_KEY_FILE_DESKTOP_KEY_TERMINAL, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TRY_EXEC
+
+G_KEY_FILE_DESKTOP_KEY_TRY_EXEC, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_TYPE
+
+G_KEY_FILE_DESKTOP_KEY_TYPE, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_URL
+
+G_KEY_FILE_DESKTOP_KEY_URL, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_KEY_VERSION
+
+G_KEY_FILE_DESKTOP_KEY_VERSION, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_APPLICATION
+
+G_KEY_FILE_DESKTOP_TYPE_APPLICATION, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_DIRECTORY
+
+G_KEY_FILE_DESKTOP_TYPE_DIRECTORY, macro in Key-value file parser +
-
G_KEY_FILE_DESKTOP_TYPE_LINK
+
+G_KEY_FILE_DESKTOP_TYPE_LINK, macro in Key-value file parser +
-
G_KEY_FILE_ERROR
+
+G_KEY_FILE_ERROR, macro in Key-value file parser +
-
g_key_file_free
+
+g_key_file_free, function in Key-value file parser +
-
g_key_file_get_boolean
+
+g_key_file_get_boolean, function in Key-value file parser +
-
g_key_file_get_boolean_list
+
+g_key_file_get_boolean_list, function in Key-value file parser +
-
g_key_file_get_comment
+
+g_key_file_get_comment, function in Key-value file parser +
-
g_key_file_get_double
+
+g_key_file_get_double, function in Key-value file parser +
-
g_key_file_get_double_list
+
+g_key_file_get_double_list, function in Key-value file parser +
-
g_key_file_get_groups
+
+g_key_file_get_groups, function in Key-value file parser +
-
g_key_file_get_integer
+
+g_key_file_get_integer, function in Key-value file parser +
-
g_key_file_get_integer_list
+
+g_key_file_get_integer_list, function in Key-value file parser +
-
g_key_file_get_keys
+
+g_key_file_get_keys, function in Key-value file parser +
-
g_key_file_get_locale_string
+
+g_key_file_get_locale_string, function in Key-value file parser +
-
g_key_file_get_locale_string_list
+
+g_key_file_get_locale_string_list, function in Key-value file parser +
-
g_key_file_get_start_group
+
+g_key_file_get_start_group, function in Key-value file parser +
-
g_key_file_get_string
+
+g_key_file_get_string, function in Key-value file parser +
-
g_key_file_get_string_list
+
+g_key_file_get_string_list, function in Key-value file parser +
-
g_key_file_get_value
+
+g_key_file_get_value, function in Key-value file parser +
-
g_key_file_has_group
+
+g_key_file_has_group, function in Key-value file parser +
-
g_key_file_has_key
+
+g_key_file_has_key, function in Key-value file parser +
-
g_key_file_load_from_data
+
+g_key_file_load_from_data, function in Key-value file parser +
-
g_key_file_load_from_data_dirs
+
+g_key_file_load_from_data_dirs, function in Key-value file parser +
-
g_key_file_load_from_dirs
+
+g_key_file_load_from_dirs, function in Key-value file parser +
-
g_key_file_load_from_file
+
+g_key_file_load_from_file, function in Key-value file parser +
-
g_key_file_new
+
+g_key_file_new, function in Key-value file parser +
-
g_key_file_remove_comment
+
+g_key_file_remove_comment, function in Key-value file parser +
-
g_key_file_remove_group
+
+g_key_file_remove_group, function in Key-value file parser +
-
g_key_file_remove_key
+
+g_key_file_remove_key, function in Key-value file parser +
-
g_key_file_set_boolean
+
+g_key_file_set_boolean, function in Key-value file parser +
-
g_key_file_set_boolean_list
+
+g_key_file_set_boolean_list, function in Key-value file parser +
-
g_key_file_set_comment
+
+g_key_file_set_comment, function in Key-value file parser +
-
g_key_file_set_double
+
+g_key_file_set_double, function in Key-value file parser +
-
g_key_file_set_double_list
+
+g_key_file_set_double_list, function in Key-value file parser +
-
g_key_file_set_integer
+
+g_key_file_set_integer, function in Key-value file parser +
-
g_key_file_set_integer_list
+
+g_key_file_set_integer_list, function in Key-value file parser +
-
g_key_file_set_list_separator
+
+g_key_file_set_list_separator, function in Key-value file parser +
-
g_key_file_set_locale_string
+
+g_key_file_set_locale_string, function in Key-value file parser +
-
g_key_file_set_locale_string_list
+
+g_key_file_set_locale_string_list, function in Key-value file parser +
-
g_key_file_set_string
+
+g_key_file_set_string, function in Key-value file parser +
-
g_key_file_set_string_list
+
+g_key_file_set_string_list, function in Key-value file parser +
-
g_key_file_set_value
+
+g_key_file_set_value, function in Key-value file parser +
-
g_key_file_to_data
+
+g_key_file_to_data, function in Key-value file parser +

L

-
GLIB_CHECK_VERSION
+
+GLIB_CHECK_VERSION, macro in Version Information +
-
GLIB_MAJOR_VERSION
+
+GLIB_MAJOR_VERSION, macro in Version Information +
-
glib_mem_profiler_table
+
+glib_mem_profiler_table, variable in Memory Allocation +
-
GLIB_MICRO_VERSION
+
+GLIB_MICRO_VERSION, macro in Version Information +
-
GLIB_MINOR_VERSION
+
+GLIB_MINOR_VERSION, macro in Version Information +
-
G_LIKELY
+
+G_LIKELY, macro in Miscellaneous Macros +
-
GList
+
+GList, struct in Doubly-Linked Lists +
-
g_listenv
+
+g_listenv, function in Miscellaneous Utility Functions +
-
g_list_alloc
+
+g_list_alloc, function in Doubly-Linked Lists +
-
g_list_append
+
+g_list_append, function in Doubly-Linked Lists +
-
g_list_concat
+
+g_list_concat, function in Doubly-Linked Lists +
-
g_list_copy
+
+g_list_copy, function in Doubly-Linked Lists +
-
g_list_delete_link
+
+g_list_delete_link, function in Doubly-Linked Lists +
-
g_list_find
+
+g_list_find, function in Doubly-Linked Lists +
-
g_list_find_custom
+
+g_list_find_custom, function in Doubly-Linked Lists +
-
g_list_first
+
+g_list_first, function in Doubly-Linked Lists +
-
g_list_foreach
+
+g_list_foreach, function in Doubly-Linked Lists +
-
g_list_free
+
+g_list_free, function in Doubly-Linked Lists +
-
g_list_free1
+
+g_list_free1, macro in Doubly-Linked Lists +
-
g_list_free_1
+
+g_list_free_1, function in Doubly-Linked Lists +
-
g_list_index
+
+g_list_index, function in Doubly-Linked Lists +
-
g_list_insert
+
+g_list_insert, function in Doubly-Linked Lists +
-
g_list_insert_before
+
+g_list_insert_before, function in Doubly-Linked Lists +
-
g_list_insert_sorted
+
+g_list_insert_sorted, function in Doubly-Linked Lists +
-
g_list_insert_sorted_with_data
+
+g_list_insert_sorted_with_data, function in Doubly-Linked Lists +
-
g_list_last
+
+g_list_last, function in Doubly-Linked Lists +
-
g_list_length
+
+g_list_length, function in Doubly-Linked Lists +
-
g_list_next
+
+g_list_next, macro in Doubly-Linked Lists +
-
g_list_nth
+
+g_list_nth, function in Doubly-Linked Lists +
-
g_list_nth_data
+
+g_list_nth_data, function in Doubly-Linked Lists +
-
g_list_nth_prev
+
+g_list_nth_prev, function in Doubly-Linked Lists +
-
g_list_pop_allocator
+
+g_list_pop_allocator, function in Doubly-Linked Lists +
-
g_list_position
+
+g_list_position, function in Doubly-Linked Lists +
-
g_list_prepend
+
+g_list_prepend, function in Doubly-Linked Lists +
-
g_list_previous
+
+g_list_previous, macro in Doubly-Linked Lists +
-
g_list_push_allocator
+
+g_list_push_allocator, function in Doubly-Linked Lists +
-
g_list_remove
+
+g_list_remove, function in Doubly-Linked Lists +
-
g_list_remove_all
+
+g_list_remove_all, function in Doubly-Linked Lists +
-
g_list_remove_link
+
+g_list_remove_link, function in Doubly-Linked Lists +
-
g_list_reverse
+
+g_list_reverse, function in Doubly-Linked Lists +
-
g_list_sort
+
+g_list_sort, function in Doubly-Linked Lists +
-
g_list_sort_with_data
+
+g_list_sort_with_data, function in Doubly-Linked Lists +
-
G_LITTLE_ENDIAN
+
+G_LITTLE_ENDIAN, macro in Byte Order Macros +
-
G_LN10
+
+G_LN10, macro in Numerical Definitions +
-
G_LN2
+
+G_LN2, macro in Numerical Definitions +
-
g_locale_from_utf8
+
+g_locale_from_utf8, function in Character Set Conversion +
-
g_locale_to_utf8
+
+g_locale_to_utf8, function in Character Set Conversion +
-
G_LOCK
+
+G_LOCK, macro in Threads +
-
G_LOCK_DEFINE
+
+G_LOCK_DEFINE, macro in Threads +
-
G_LOCK_DEFINE_STATIC
+
+G_LOCK_DEFINE_STATIC, macro in Threads +
-
G_LOCK_EXTERN
+
+G_LOCK_EXTERN, macro in Threads +
-
g_log
+
+g_log, function in Message Logging +
-
GLogFunc
+
+GLogFunc, user_function in Message Logging +
-
GLogLevelFlags
+
+GLogLevelFlags, enum in Message Logging +
-
g_logv
+
+g_logv, function in Message Logging +
-
G_LOG_2_BASE_10
+
+G_LOG_2_BASE_10, macro in Numerical Definitions +
-
g_log_default_handler
+
+g_log_default_handler, function in Message Logging +
-
G_LOG_DOMAIN
+
+G_LOG_DOMAIN, macro in Message Logging +
-
G_LOG_FATAL_MASK
+
+G_LOG_FATAL_MASK, macro in Message Logging +
-
G_LOG_LEVEL_USER_SHIFT
+
+G_LOG_LEVEL_USER_SHIFT, macro in Message Logging +
-
g_log_remove_handler
+
+g_log_remove_handler, function in Message Logging +
-
g_log_set_always_fatal
+
+g_log_set_always_fatal, function in Message Logging +
-
g_log_set_default_handler
+
+g_log_set_default_handler, function in Message Logging +
-
g_log_set_fatal_mask
+
+g_log_set_fatal_mask, function in Message Logging +
-
g_log_set_handler
+
+g_log_set_handler, function in Message Logging +
-
glong
+
+glong, typedef in Basic Types +
-
GLONG_FROM_BE
+
+GLONG_FROM_BE, macro in Byte Order Macros +
-
GLONG_FROM_LE
+
+GLONG_FROM_LE, macro in Byte Order Macros +
-
GLONG_TO_BE
+
+GLONG_TO_BE, macro in Byte Order Macros +
-
GLONG_TO_LE
+
+GLONG_TO_LE, macro in Byte Order Macros +
-
g_lstat
+
+g_lstat, function in File Utilities +

M

-
GMainContext
+
+GMainContext, struct in The Main Event Loop +
-
GMainLoop
+
+GMainLoop, struct in The Main Event Loop +
-
g_main_context_acquire
+
+g_main_context_acquire, function in The Main Event Loop +
-
g_main_context_add_poll
+
+g_main_context_add_poll, function in The Main Event Loop +
-
g_main_context_check
+
+g_main_context_check, function in The Main Event Loop +
-
g_main_context_default
+
+g_main_context_default, function in The Main Event Loop +
-
g_main_context_dispatch
+
+g_main_context_dispatch, function in The Main Event Loop +
-
g_main_context_find_source_by_funcs_user_data
+
+g_main_context_find_source_by_funcs_user_data, function in The Main Event Loop +
-
g_main_context_find_source_by_id
+
+g_main_context_find_source_by_id, function in The Main Event Loop +
-
g_main_context_find_source_by_user_data
+
+g_main_context_find_source_by_user_data, function in The Main Event Loop +
-
g_main_context_get_poll_func
+
+g_main_context_get_poll_func, function in The Main Event Loop +
-
g_main_context_get_thread_default
+
+g_main_context_get_thread_default, function in The Main Event Loop +
-
g_main_context_is_owner
+
+g_main_context_is_owner, function in The Main Event Loop +
-
g_main_context_iteration
+
+g_main_context_iteration, function in The Main Event Loop +
-
g_main_context_new
+
+g_main_context_new, function in The Main Event Loop +
-
g_main_context_pending
+
+g_main_context_pending, function in The Main Event Loop +
-
g_main_context_pop_thread_default
+
+g_main_context_pop_thread_default, function in The Main Event Loop +
-
g_main_context_prepare
+
+g_main_context_prepare, function in The Main Event Loop +
-
g_main_context_push_thread_default
+
+g_main_context_push_thread_default, function in The Main Event Loop +
-
g_main_context_query
+
+g_main_context_query, function in The Main Event Loop +
-
g_main_context_ref
+
+g_main_context_ref, function in The Main Event Loop +
-
g_main_context_release
+
+g_main_context_release, function in The Main Event Loop +
-
g_main_context_remove_poll
+
+g_main_context_remove_poll, function in The Main Event Loop +
-
g_main_context_set_poll_func
+
+g_main_context_set_poll_func, function in The Main Event Loop +
-
g_main_context_unref
+
+g_main_context_unref, function in The Main Event Loop +
-
g_main_context_wait
+
+g_main_context_wait, function in The Main Event Loop +
-
g_main_context_wakeup
+
+g_main_context_wakeup, function in The Main Event Loop +
-
g_main_current_source
+
+g_main_current_source, function in The Main Event Loop +
-
g_main_depth
+
+g_main_depth, function in The Main Event Loop +
-
g_main_destroy
+
+g_main_destroy, macro in The Main Event Loop +
-
g_main_is_running
+
+g_main_is_running, macro in The Main Event Loop +
-
g_main_iteration
+
+g_main_iteration, macro in The Main Event Loop +
-
g_main_loop_get_context
+
+g_main_loop_get_context, function in The Main Event Loop +
-
g_main_loop_is_running
+
+g_main_loop_is_running, function in The Main Event Loop +
-
g_main_loop_new
+
+g_main_loop_new, function in The Main Event Loop +
-
g_main_loop_quit
+
+g_main_loop_quit, function in The Main Event Loop +
-
g_main_loop_ref
+
+g_main_loop_ref, function in The Main Event Loop +
-
g_main_loop_run
+
+g_main_loop_run, function in The Main Event Loop +
-
g_main_loop_unref
+
+g_main_loop_unref, function in The Main Event Loop +
-
g_main_new
+
+g_main_new, macro in The Main Event Loop +
-
g_main_pending
+
+g_main_pending, macro in The Main Event Loop +
-
g_main_quit
+
+g_main_quit, macro in The Main Event Loop +
-
g_main_run
+
+g_main_run, macro in The Main Event Loop +
-
g_main_set_poll_func
+
+g_main_set_poll_func, macro in The Main Event Loop +
-
g_malloc
+
+g_malloc, function in Memory Allocation +
-
g_malloc0
+
+g_malloc0, function in Memory Allocation +
-
g_malloc0_n
+
+g_malloc0_n, function in Memory Allocation +
-
g_malloc_n
+
+g_malloc_n, function in Memory Allocation +
-
GMappedFile
+
+GMappedFile, struct in File Utilities +
-
g_mapped_file_free
+
+g_mapped_file_free, function in File Utilities +
-
g_mapped_file_get_contents
+
+g_mapped_file_get_contents, function in File Utilities +
-
g_mapped_file_get_length
+
+g_mapped_file_get_length, function in File Utilities +
-
g_mapped_file_new
+
+g_mapped_file_new, function in File Utilities +
-
g_mapped_file_ref
+
+g_mapped_file_ref, function in File Utilities +
-
g_mapped_file_unref
+
+g_mapped_file_unref, function in File Utilities +
-
GMarkupCollectType
+
+GMarkupCollectType, enum in Simple XML Subset Parser +
-
GMarkupError
+
+GMarkupError, enum in Simple XML Subset Parser +
-
GMarkupParseContext
+
+GMarkupParseContext, struct in Simple XML Subset Parser +
-
GMarkupParseFlags
+
+GMarkupParseFlags, enum in Simple XML Subset Parser +
-
GMarkupParser
+
+GMarkupParser, struct in Simple XML Subset Parser +
-
g_markup_collect_attributes
+
+g_markup_collect_attributes, function in Simple XML Subset Parser +
-
G_MARKUP_ERROR
+
+G_MARKUP_ERROR, macro in Simple XML Subset Parser +
-
g_markup_escape_text
+
+g_markup_escape_text, function in Simple XML Subset Parser +
-
g_markup_parse_context_end_parse
+
+g_markup_parse_context_end_parse, function in Simple XML Subset Parser +
-
g_markup_parse_context_free
+
+g_markup_parse_context_free, function in Simple XML Subset Parser +
-
g_markup_parse_context_get_element
+
+g_markup_parse_context_get_element, function in Simple XML Subset Parser +
-
g_markup_parse_context_get_element_stack
+
+g_markup_parse_context_get_element_stack, function in Simple XML Subset Parser +
-
g_markup_parse_context_get_position
+
+g_markup_parse_context_get_position, function in Simple XML Subset Parser +
-
g_markup_parse_context_get_user_data
+
+g_markup_parse_context_get_user_data, function in Simple XML Subset Parser +
-
g_markup_parse_context_new
+
+g_markup_parse_context_new, function in Simple XML Subset Parser +
-
g_markup_parse_context_parse
+
+g_markup_parse_context_parse, function in Simple XML Subset Parser +
-
g_markup_parse_context_pop
+
+g_markup_parse_context_pop, function in Simple XML Subset Parser +
-
g_markup_parse_context_push
+
+g_markup_parse_context_push, function in Simple XML Subset Parser +
-
g_markup_printf_escaped
+
+g_markup_printf_escaped, function in Simple XML Subset Parser +
-
g_markup_vprintf_escaped
+
+g_markup_vprintf_escaped, function in Simple XML Subset Parser +
-
GMatchInfo
+
+GMatchInfo, struct in Perl-compatible regular expressions +
-
g_match_info_expand_references
+
+g_match_info_expand_references, function in Perl-compatible regular expressions +
-
g_match_info_fetch
+
+g_match_info_fetch, function in Perl-compatible regular expressions +
-
g_match_info_fetch_all
+
+g_match_info_fetch_all, function in Perl-compatible regular expressions +
-
g_match_info_fetch_named
+
+g_match_info_fetch_named, function in Perl-compatible regular expressions +
-
g_match_info_fetch_named_pos
+
+g_match_info_fetch_named_pos, function in Perl-compatible regular expressions +
-
g_match_info_fetch_pos
+
+g_match_info_fetch_pos, function in Perl-compatible regular expressions +
-
g_match_info_free
+
+g_match_info_free, function in Perl-compatible regular expressions +
-
g_match_info_get_match_count
+
+g_match_info_get_match_count, function in Perl-compatible regular expressions +
-
g_match_info_get_regex
+
+g_match_info_get_regex, function in Perl-compatible regular expressions +
-
g_match_info_get_string
+
+g_match_info_get_string, function in Perl-compatible regular expressions +
-
g_match_info_is_partial_match
+
+g_match_info_is_partial_match, function in Perl-compatible regular expressions +
-
g_match_info_matches
+
+g_match_info_matches, function in Perl-compatible regular expressions +
-
g_match_info_next
+
+g_match_info_next, function in Perl-compatible regular expressions +
-
MAX
+
+MAX, macro in Standard Macros +
-
G_MAXDOUBLE
+
+G_MAXDOUBLE, macro in Limits of Basic Types +
-
G_MAXFLOAT
+
+G_MAXFLOAT, macro in Limits of Basic Types +
-
G_MAXINT
+
+G_MAXINT, macro in Limits of Basic Types +
-
G_MAXINT16
+
+G_MAXINT16, macro in Limits of Basic Types +
-
G_MAXINT32
+
+G_MAXINT32, macro in Limits of Basic Types +
-
G_MAXINT64
+
+G_MAXINT64, macro in Limits of Basic Types +
-
G_MAXINT8
+
+G_MAXINT8, macro in Limits of Basic Types +
-
G_MAXLONG
+
+G_MAXLONG, macro in Limits of Basic Types +
-
G_MAXOFFSET
+
+G_MAXOFFSET, macro in Limits of Basic Types +
-
MAXPATHLEN
+
+MAXPATHLEN, macro in Windows Compatibility Functions +
-
G_MAXSHORT
+
+G_MAXSHORT, macro in Limits of Basic Types +
-
G_MAXSIZE
+
+G_MAXSIZE, macro in Limits of Basic Types +
-
G_MAXSSIZE
+
+G_MAXSSIZE, macro in Limits of Basic Types +
-
G_MAXUINT
+
+G_MAXUINT, macro in Limits of Basic Types +
-
G_MAXUINT16
+
+G_MAXUINT16, macro in Limits of Basic Types +
-
G_MAXUINT32
+
+G_MAXUINT32, macro in Limits of Basic Types +
-
G_MAXUINT64
+
+G_MAXUINT64, macro in Limits of Basic Types +
-
G_MAXUINT8
+
+G_MAXUINT8, macro in Limits of Basic Types +
-
G_MAXULONG
+
+G_MAXULONG, macro in Limits of Basic Types +
-
G_MAXUSHORT
+
+G_MAXUSHORT, macro in Limits of Basic Types +
-
GMemChunk
+
+GMemChunk, struct in Memory Chunks +
-
g_memdup
+
+g_memdup, function in Memory Allocation +
-
g_memmove
+
+g_memmove, macro in Memory Allocation +
-
GMemVTable
+
+GMemVTable, struct in Memory Allocation +
-
G_MEM_ALIGN
+
+G_MEM_ALIGN, macro in Standard Macros +
-
g_mem_chunk_alloc
+
+g_mem_chunk_alloc, function in Memory Chunks +
-
g_mem_chunk_alloc0
+
+g_mem_chunk_alloc0, function in Memory Chunks +
-
g_mem_chunk_clean
+
+g_mem_chunk_clean, function in Memory Chunks +
-
g_mem_chunk_create
+
+g_mem_chunk_create, macro in Memory Chunks +
-
g_mem_chunk_destroy
+
+g_mem_chunk_destroy, function in Memory Chunks +
-
g_mem_chunk_free
+
+g_mem_chunk_free, function in Memory Chunks +
-
g_mem_chunk_info
+
+g_mem_chunk_info, function in Memory Chunks +
-
g_mem_chunk_new
+
+g_mem_chunk_new, function in Memory Chunks +
-
g_mem_chunk_print
+
+g_mem_chunk_print, function in Memory Chunks +
-
g_mem_chunk_reset
+
+g_mem_chunk_reset, function in Memory Chunks +
-
g_mem_gc_friendly
+
+g_mem_gc_friendly, variable in Memory Allocation +
-
g_mem_is_system_malloc
+
+g_mem_is_system_malloc, function in Memory Allocation +
-
g_mem_profile
+
+g_mem_profile, function in Memory Allocation +
-
g_mem_set_vtable
+
+g_mem_set_vtable, function in Memory Allocation +
-
g_message
+
+g_message, macro in Message Logging +
-
MIN
+
+MIN, macro in Standard Macros +
-
G_MINDOUBLE
+
+G_MINDOUBLE, macro in Limits of Basic Types +
-
G_MINFLOAT
+
+G_MINFLOAT, macro in Limits of Basic Types +
-
G_MININT
+
+G_MININT, macro in Limits of Basic Types +
-
G_MININT16
+
+G_MININT16, macro in Limits of Basic Types +
-
G_MININT32
+
+G_MININT32, macro in Limits of Basic Types +
-
G_MININT64
+
+G_MININT64, macro in Limits of Basic Types +
-
G_MININT8
+
+G_MININT8, macro in Limits of Basic Types +
-
G_MINLONG
+
+G_MINLONG, macro in Limits of Basic Types +
-
G_MINOFFSET
+
+G_MINOFFSET, macro in Limits of Basic Types +
-
G_MINSHORT
+
+G_MINSHORT, macro in Limits of Basic Types +
-
G_MINSSIZE
+
+G_MINSSIZE, macro in Limits of Basic Types +
-
g_mkdir
+
+g_mkdir, function in File Utilities +
-
g_mkdir_with_parents
+
+g_mkdir_with_parents, function in File Utilities +
-
g_mkstemp
+
+g_mkstemp, function in File Utilities +
-
g_mkstemp_full
+
+g_mkstemp_full, function in File Utilities +
-
GModule
+
+GModule, struct in Dynamic Loading of Modules +
-
GModuleCheckInit
+
+GModuleCheckInit, user_function in Dynamic Loading of Modules +
-
GModuleFlags
+
+GModuleFlags, enum in Dynamic Loading of Modules +
-
GModuleUnload
+
+GModuleUnload, user_function in Dynamic Loading of Modules +
-
g_module_build_path
+
+g_module_build_path, function in Dynamic Loading of Modules +
-
g_module_close
+
+g_module_close, function in Dynamic Loading of Modules +
-
g_module_error
+
+g_module_error, function in Dynamic Loading of Modules +
-
G_MODULE_EXPORT
+
+G_MODULE_EXPORT, macro in Dynamic Loading of Modules +
-
G_MODULE_IMPORT
+
+G_MODULE_IMPORT, macro in Dynamic Loading of Modules +
-
g_module_make_resident
+
+g_module_make_resident, function in Dynamic Loading of Modules +
-
g_module_name
+
+g_module_name, function in Dynamic Loading of Modules +
-
g_module_open
+
+g_module_open, function in Dynamic Loading of Modules +
-
G_MODULE_SUFFIX
+
+G_MODULE_SUFFIX, macro in Dynamic Loading of Modules +
-
g_module_supported
+
+g_module_supported, function in Dynamic Loading of Modules +
-
g_module_symbol
+
+g_module_symbol, function in Dynamic Loading of Modules +
-
GMutex
+
+GMutex, struct in Threads +
-
g_mutex_free
+
+g_mutex_free, function in Threads +
-
g_mutex_lock
+
+g_mutex_lock, function in Threads +
-
g_mutex_new
+
+g_mutex_new, function in Threads +
-
g_mutex_trylock
+
+g_mutex_trylock, function in Threads +
-
g_mutex_unlock
+
+g_mutex_unlock, function in Threads +

N

-
NC_
+
+NC_, macro in I18N +
-
g_new
+
+g_new, macro in Memory Allocation +
-
g_new0
+
+g_new0, macro in Memory Allocation +
-
g_newa
+
+g_newa, macro in Memory Allocation +
-
GNode
+
+GNode, struct in N-ary Trees +
-
GNodeForeachFunc
+
+GNodeForeachFunc, user_function in N-ary Trees +
-
GNodeTraverseFunc
+
+GNodeTraverseFunc, user_function in N-ary Trees +
-
g_node_append
+
+g_node_append, macro in N-ary Trees +
-
g_node_append_data
+
+g_node_append_data, macro in N-ary Trees +
-
g_node_children_foreach
+
+g_node_children_foreach, function in N-ary Trees +
-
g_node_child_index
+
+g_node_child_index, function in N-ary Trees +
-
g_node_child_position
+
+g_node_child_position, function in N-ary Trees +
-
g_node_copy
+
+g_node_copy, function in N-ary Trees +
-
g_node_copy_deep
+
+g_node_copy_deep, function in N-ary Trees +
-
g_node_depth
+
+g_node_depth, function in N-ary Trees +
-
g_node_destroy
+
+g_node_destroy, function in N-ary Trees +
-
g_node_find
+
+g_node_find, function in N-ary Trees +
-
g_node_find_child
+
+g_node_find_child, function in N-ary Trees +
-
g_node_first_child
+
+g_node_first_child, macro in N-ary Trees +
-
g_node_first_sibling
+
+g_node_first_sibling, function in N-ary Trees +
-
g_node_get_root
+
+g_node_get_root, function in N-ary Trees +
-
g_node_insert
+
+g_node_insert, function in N-ary Trees +
-
g_node_insert_after
+
+g_node_insert_after, function in N-ary Trees +
-
g_node_insert_before
+
+g_node_insert_before, function in N-ary Trees +
-
g_node_insert_data
+
+g_node_insert_data, macro in N-ary Trees +
-
g_node_insert_data_before
+
+g_node_insert_data_before, macro in N-ary Trees +
-
g_node_is_ancestor
+
+g_node_is_ancestor, function in N-ary Trees +
-
G_NODE_IS_LEAF
+
+G_NODE_IS_LEAF, macro in N-ary Trees +
-
G_NODE_IS_ROOT
+
+G_NODE_IS_ROOT, macro in N-ary Trees +
-
g_node_last_child
+
+g_node_last_child, function in N-ary Trees +
-
g_node_last_sibling
+
+g_node_last_sibling, function in N-ary Trees +
-
g_node_max_height
+
+g_node_max_height, function in N-ary Trees +
-
g_node_new
+
+g_node_new, function in N-ary Trees +
-
g_node_next_sibling
+
+g_node_next_sibling, macro in N-ary Trees +
-
g_node_nth_child
+
+g_node_nth_child, function in N-ary Trees +
-
g_node_n_children
+
+g_node_n_children, function in N-ary Trees +
-
g_node_n_nodes
+
+g_node_n_nodes, function in N-ary Trees +
-
g_node_pop_allocator
+
+g_node_pop_allocator, function in N-ary Trees +
-
g_node_prepend
+
+g_node_prepend, function in N-ary Trees +
-
g_node_prepend_data
+
+g_node_prepend_data, macro in N-ary Trees +
-
g_node_prev_sibling
+
+g_node_prev_sibling, macro in N-ary Trees +
-
g_node_push_allocator
+
+g_node_push_allocator, function in N-ary Trees +
-
g_node_reverse_children
+
+g_node_reverse_children, function in N-ary Trees +
-
g_node_traverse
+
+g_node_traverse, function in N-ary Trees +
-
g_node_unlink
+
+g_node_unlink, function in N-ary Trees +
-
GNormalizeMode
+
+GNormalizeMode, enum in Unicode Manipulation +
-
g_ntohl
+
+g_ntohl, macro in Byte Order Macros +
-
g_ntohs
+
+g_ntohs, macro in Byte Order Macros +
-
NULL
+
+NULL, macro in Standard Macros +
-
g_nullify_pointer
+
+g_nullify_pointer, function in Miscellaneous Utility Functions +
-
N_
+
+N_, macro in I18N +
-
G_N_ELEMENTS
+
+G_N_ELEMENTS, macro in Miscellaneous Macros +

O

-
goffset
+
+goffset, typedef in Basic Types +
-
GOnce
+
+GOnce, struct in Threads +
-
g_once
+
+g_once, macro in Threads +
-
GOnceStatus
+
+GOnceStatus, enum in Threads +
-
G_ONCE_INIT
+
+G_ONCE_INIT, macro in Threads +
-
g_once_init_enter
+
+g_once_init_enter, function in Threads +
-
g_once_init_leave
+
+g_once_init_leave, function in Threads +
-
g_on_error_query
+
+g_on_error_query, function in Warnings and Assertions +
-
g_on_error_stack_trace
+
+g_on_error_stack_trace, function in Warnings and Assertions +
-
g_open
+
+g_open, function in File Utilities +
-
GOptionArg
+
+GOptionArg, enum in Commandline option parser +
-
GOptionArgFunc
+
+GOptionArgFunc, user_function in Commandline option parser +
-
GOptionContext
+
+GOptionContext, struct in Commandline option parser +
-
GOptionEntry
+
+GOptionEntry, struct in Commandline option parser +
-
GOptionError
+
+GOptionError, enum in Commandline option parser +
-
GOptionErrorFunc
+
+GOptionErrorFunc, user_function in Commandline option parser +
-
GOptionFlags
+
+GOptionFlags, enum in Commandline option parser +
-
GOptionGroup
+
+GOptionGroup, struct in Commandline option parser +
-
GOptionParseFunc
+
+GOptionParseFunc, user_function in Commandline option parser +
-
g_option_context_add_group
+
+g_option_context_add_group, function in Commandline option parser +
-
g_option_context_add_main_entries
+
+g_option_context_add_main_entries, function in Commandline option parser +
-
g_option_context_free
+
+g_option_context_free, function in Commandline option parser +
-
g_option_context_get_description
+
+g_option_context_get_description, function in Commandline option parser +
-
g_option_context_get_help
+
+g_option_context_get_help, function in Commandline option parser +
-
g_option_context_get_help_enabled
+
+g_option_context_get_help_enabled, function in Commandline option parser +
-
g_option_context_get_ignore_unknown_options
+
+g_option_context_get_ignore_unknown_options, function in Commandline option parser +
-
g_option_context_get_main_group
+
+g_option_context_get_main_group, function in Commandline option parser +
-
g_option_context_get_summary
+
+g_option_context_get_summary, function in Commandline option parser +
-
g_option_context_new
+
+g_option_context_new, function in Commandline option parser +
-
g_option_context_parse
+
+g_option_context_parse, function in Commandline option parser +
-
g_option_context_set_description
+
+g_option_context_set_description, function in Commandline option parser +
-
g_option_context_set_help_enabled
+
+g_option_context_set_help_enabled, function in Commandline option parser +
-
g_option_context_set_ignore_unknown_options
+
+g_option_context_set_ignore_unknown_options, function in Commandline option parser +
-
g_option_context_set_main_group
+
+g_option_context_set_main_group, function in Commandline option parser +
-
g_option_context_set_summary
+
+g_option_context_set_summary, function in Commandline option parser +
-
g_option_context_set_translate_func
+
+g_option_context_set_translate_func, function in Commandline option parser +
-
g_option_context_set_translation_domain
+
+g_option_context_set_translation_domain, function in Commandline option parser +
-
G_OPTION_ERROR
+
+G_OPTION_ERROR, macro in Commandline option parser +
-
g_option_group_add_entries
+
+g_option_group_add_entries, function in Commandline option parser +
-
g_option_group_free
+
+g_option_group_free, function in Commandline option parser +
-
g_option_group_new
+
+g_option_group_new, function in Commandline option parser +
-
g_option_group_set_error_hook
+
+g_option_group_set_error_hook, function in Commandline option parser +
-
g_option_group_set_parse_hooks
+
+g_option_group_set_parse_hooks, function in Commandline option parser +
-
g_option_group_set_translate_func
+
+g_option_group_set_translate_func, function in Commandline option parser +
-
g_option_group_set_translation_domain
+
+g_option_group_set_translation_domain, function in Commandline option parser +
-
G_OPTION_REMAINING
+
+G_OPTION_REMAINING, macro in Commandline option parser +
-
G_OS_BEOS
+
+G_OS_BEOS, macro in Standard Macros +
-
G_OS_UNIX
+
+G_OS_UNIX, macro in Standard Macros +
-
G_OS_WIN32
+
+G_OS_WIN32, macro in Standard Macros +

P

-
g_parse_debug_string
+
+g_parse_debug_string, function in Miscellaneous Utility Functions +
-
G_PASTE
+
+G_PASTE, macro in Miscellaneous Macros +
-
G_PASTE_ARGS
+
+G_PASTE_ARGS, macro in Miscellaneous Macros +
-
g_path_get_basename
+
+g_path_get_basename, function in Miscellaneous Utility Functions +
-
g_path_get_dirname
+
+g_path_get_dirname, function in Miscellaneous Utility Functions +
-
g_path_is_absolute
+
+g_path_is_absolute, function in Miscellaneous Utility Functions +
-
g_path_skip_root
+
+g_path_skip_root, function in Miscellaneous Utility Functions +
-
GPatternSpec
+
+GPatternSpec, struct in Glob-style pattern matching +
-
g_pattern_match
+
+g_pattern_match, function in Glob-style pattern matching +
-
g_pattern_match_simple
+
+g_pattern_match_simple, function in Glob-style pattern matching +
-
g_pattern_match_string
+
+g_pattern_match_string, function in Glob-style pattern matching +
-
g_pattern_spec_equal
+
+g_pattern_spec_equal, function in Glob-style pattern matching +
-
g_pattern_spec_free
+
+g_pattern_spec_free, function in Glob-style pattern matching +
-
g_pattern_spec_new
+
+g_pattern_spec_new, function in Glob-style pattern matching +
-
G_PDP_ENDIAN
+
+G_PDP_ENDIAN, macro in Byte Order Macros +
-
G_PI
+
+G_PI, macro in Numerical Definitions +
-
GPid
+
+GPid, typedef in The Main Event Loop +
-
G_PI_2
+
+G_PI_2, macro in Numerical Definitions +
-
G_PI_4
+
+G_PI_4, macro in Numerical Definitions +
-
gpointer
+
+gpointer, typedef in Basic Types +
-
GPOINTER_TO_INT
+
+GPOINTER_TO_INT, macro in Type Conversion Macros +
-
GPOINTER_TO_SIZE
+
+GPOINTER_TO_SIZE, macro in Type Conversion Macros +
-
GPOINTER_TO_UINT
+
+GPOINTER_TO_UINT, macro in Type Conversion Macros +
-
g_poll
+
+g_poll, function in The Main Event Loop +
-
GPollFD
+
+GPollFD, struct in The Main Event Loop +
-
G_POLLFD_FORMAT
+
+G_POLLFD_FORMAT, macro in The Main Event Loop +
-
GPollFunc
+
+GPollFunc, user_function in The Main Event Loop +
-
g_prefix_error
+
+g_prefix_error, function in Error Reporting +
-
g_print
+
+g_print, function in Warnings and Assertions +
-
g_printerr
+
+g_printerr, function in Warnings and Assertions +
-
g_printf
+
+g_printf, function in String Utility Functions +
-
GPrintFunc
+
+GPrintFunc, user_function in Warnings and Assertions +
-
g_printf_string_upper_bound
+
+g_printf_string_upper_bound, function in String Utility Functions +
-
G_PRIORITY_DEFAULT
+
+G_PRIORITY_DEFAULT, macro in The Main Event Loop +
-
G_PRIORITY_DEFAULT_IDLE
+
+G_PRIORITY_DEFAULT_IDLE, macro in The Main Event Loop +
-
G_PRIORITY_HIGH
+
+G_PRIORITY_HIGH, macro in The Main Event Loop +
-
G_PRIORITY_HIGH_IDLE
+
+G_PRIORITY_HIGH_IDLE, macro in The Main Event Loop +
-
G_PRIORITY_LOW
+
+G_PRIORITY_LOW, macro in The Main Event Loop +
-
GPrivate
+
+GPrivate, struct in Threads +
-
g_private_get
+
+g_private_get, function in Threads +
-
g_private_new
+
+g_private_new, function in Threads +
-
g_private_set
+
+g_private_set, function in Threads +
-
g_propagate_error
+
+g_propagate_error, function in Error Reporting +
-
g_propagate_prefixed_error
+
+g_propagate_prefixed_error, function in Error Reporting +
-
GPtrArray
+
+GPtrArray, struct in Pointer Arrays +
-
g_ptr_array_add
+
+g_ptr_array_add, function in Pointer Arrays +
-
g_ptr_array_foreach
+
+g_ptr_array_foreach, function in Pointer Arrays +
-
g_ptr_array_free
+
+g_ptr_array_free, function in Pointer Arrays +
-
g_ptr_array_index
+
+g_ptr_array_index, macro in Pointer Arrays +
-
g_ptr_array_new
+
+g_ptr_array_new, function in Pointer Arrays +
-
g_ptr_array_new_with_free_func
+
+g_ptr_array_new_with_free_func, function in Pointer Arrays +
-
g_ptr_array_ref
+
+g_ptr_array_ref, function in Pointer Arrays +
-
g_ptr_array_remove
+
+g_ptr_array_remove, function in Pointer Arrays +
-
g_ptr_array_remove_fast
+
+g_ptr_array_remove_fast, function in Pointer Arrays +
-
g_ptr_array_remove_index
+
+g_ptr_array_remove_index, function in Pointer Arrays +
-
g_ptr_array_remove_index_fast
+
+g_ptr_array_remove_index_fast, function in Pointer Arrays +
-
g_ptr_array_remove_range
+
+g_ptr_array_remove_range, function in Pointer Arrays +
-
g_ptr_array_set_free_func
+
+g_ptr_array_set_free_func, function in Pointer Arrays +
-
g_ptr_array_set_size
+
+g_ptr_array_set_size, function in Pointer Arrays +
-
g_ptr_array_sized_new
+
+g_ptr_array_sized_new, function in Pointer Arrays +
-
g_ptr_array_sort
+
+g_ptr_array_sort, function in Pointer Arrays +
-
g_ptr_array_sort_with_data
+
+g_ptr_array_sort_with_data, function in Pointer Arrays +
-
g_ptr_array_unref
+
+g_ptr_array_unref, function in Pointer Arrays +

Q

-
g_qsort_with_data
+
+g_qsort_with_data, function in Miscellaneous Utility Functions +
-
GQuark
+
+GQuark, typedef in Quarks +
-
g_quark_from_static_string
+
+g_quark_from_static_string, function in Quarks +
-
g_quark_from_string
+
+g_quark_from_string, function in Quarks +
-
g_quark_to_string
+
+g_quark_to_string, function in Quarks +
-
g_quark_try_string
+
+g_quark_try_string, function in Quarks +
-
GQueue
+
+GQueue, struct in Double-ended Queues +
-
g_queue_clear
+
+g_queue_clear, function in Double-ended Queues +
-
g_queue_copy
+
+g_queue_copy, function in Double-ended Queues +
-
g_queue_delete_link
+
+g_queue_delete_link, function in Double-ended Queues +
-
g_queue_find
+
+g_queue_find, function in Double-ended Queues +
-
g_queue_find_custom
+
+g_queue_find_custom, function in Double-ended Queues +
-
g_queue_foreach
+
+g_queue_foreach, function in Double-ended Queues +
-
g_queue_free
+
+g_queue_free, function in Double-ended Queues +
-
g_queue_get_length
+
+g_queue_get_length, function in Double-ended Queues +
-
g_queue_index
+
+g_queue_index, function in Double-ended Queues +
-
g_queue_init
+
+g_queue_init, function in Double-ended Queues +
-
G_QUEUE_INIT
+
+G_QUEUE_INIT, macro in Double-ended Queues +
-
g_queue_insert_after
+
+g_queue_insert_after, function in Double-ended Queues +
-
g_queue_insert_before
+
+g_queue_insert_before, function in Double-ended Queues +
-
g_queue_insert_sorted
+
+g_queue_insert_sorted, function in Double-ended Queues +
-
g_queue_is_empty
+
+g_queue_is_empty, function in Double-ended Queues +
-
g_queue_link_index
+
+g_queue_link_index, function in Double-ended Queues +
-
g_queue_new
+
+g_queue_new, function in Double-ended Queues +
-
g_queue_peek_head
+
+g_queue_peek_head, function in Double-ended Queues +
-
g_queue_peek_head_link
+
+g_queue_peek_head_link, function in Double-ended Queues +
-
g_queue_peek_nth
+
+g_queue_peek_nth, function in Double-ended Queues +
-
g_queue_peek_nth_link
+
+g_queue_peek_nth_link, function in Double-ended Queues +
-
g_queue_peek_tail
+
+g_queue_peek_tail, function in Double-ended Queues +
-
g_queue_peek_tail_link
+
+g_queue_peek_tail_link, function in Double-ended Queues +
-
g_queue_pop_head
+
+g_queue_pop_head, function in Double-ended Queues +
-
g_queue_pop_head_link
+
+g_queue_pop_head_link, function in Double-ended Queues +
-
g_queue_pop_nth
+
+g_queue_pop_nth, function in Double-ended Queues +
-
g_queue_pop_nth_link
+
+g_queue_pop_nth_link, function in Double-ended Queues +
-
g_queue_pop_tail
+
+g_queue_pop_tail, function in Double-ended Queues +
-
g_queue_pop_tail_link
+
+g_queue_pop_tail_link, function in Double-ended Queues +
-
g_queue_push_head
+
+g_queue_push_head, function in Double-ended Queues +
-
g_queue_push_head_link
+
+g_queue_push_head_link, function in Double-ended Queues +
-
g_queue_push_nth
+
+g_queue_push_nth, function in Double-ended Queues +
-
g_queue_push_nth_link
+
+g_queue_push_nth_link, function in Double-ended Queues +
-
g_queue_push_tail
+
+g_queue_push_tail, function in Double-ended Queues +
-
g_queue_push_tail_link
+
+g_queue_push_tail_link, function in Double-ended Queues +
-
g_queue_remove
+
+g_queue_remove, function in Double-ended Queues +
-
g_queue_remove_all
+
+g_queue_remove_all, function in Double-ended Queues +
-
g_queue_reverse
+
+g_queue_reverse, function in Double-ended Queues +
-
g_queue_sort
+
+g_queue_sort, function in Double-ended Queues +
-
g_queue_unlink
+
+g_queue_unlink, function in Double-ended Queues +
-
Q_
+
+Q_, macro in I18N +

R

-
GRand
+
+GRand, struct in Random Numbers +
-
g_random_boolean
+
+g_random_boolean, macro in Random Numbers +
-
g_random_double
+
+g_random_double, function in Random Numbers +
-
g_random_double_range
+
+g_random_double_range, function in Random Numbers +
-
g_random_int
+
+g_random_int, function in Random Numbers +
-
g_random_int_range
+
+g_random_int_range, function in Random Numbers +
-
g_random_set_seed
+
+g_random_set_seed, function in Random Numbers +
-
g_rand_boolean
+
+g_rand_boolean, macro in Random Numbers +
-
g_rand_copy
+
+g_rand_copy, function in Random Numbers +
-
g_rand_double
+
+g_rand_double, function in Random Numbers +
-
g_rand_double_range
+
+g_rand_double_range, function in Random Numbers +
-
g_rand_free
+
+g_rand_free, function in Random Numbers +
-
g_rand_int
+
+g_rand_int, function in Random Numbers +
-
g_rand_int_range
+
+g_rand_int_range, function in Random Numbers +
-
g_rand_new
+
+g_rand_new, function in Random Numbers +
-
g_rand_new_with_seed
+
+g_rand_new_with_seed, function in Random Numbers +
-
g_rand_new_with_seed_array
+
+g_rand_new_with_seed_array, function in Random Numbers +
-
g_rand_set_seed
+
+g_rand_set_seed, function in Random Numbers +
-
g_rand_set_seed_array
+
+g_rand_set_seed_array, function in Random Numbers +
-
g_realloc
+
+g_realloc, function in Memory Allocation +
-
g_realloc_n
+
+g_realloc_n, function in Memory Allocation +
-
GRegex
+
+GRegex, struct in Perl-compatible regular expressions +
-
GRegexCompileFlags
+
+GRegexCompileFlags, enum in Perl-compatible regular expressions +
-
GRegexError
+
+GRegexError, enum in Perl-compatible regular expressions +
-
GRegexEvalCallback
+
+GRegexEvalCallback, user_function in Perl-compatible regular expressions +
-
GRegexMatchFlags
+
+GRegexMatchFlags, enum in Perl-compatible regular expressions +
-
g_regex_check_replacement
+
+g_regex_check_replacement, function in Perl-compatible regular expressions +
-
G_REGEX_ERROR
+
+G_REGEX_ERROR, macro in Perl-compatible regular expressions +
-
g_regex_escape_string
+
+g_regex_escape_string, function in Perl-compatible regular expressions +
-
g_regex_get_capture_count
+
+g_regex_get_capture_count, function in Perl-compatible regular expressions +
-
g_regex_get_max_backref
+
+g_regex_get_max_backref, function in Perl-compatible regular expressions +
-
g_regex_get_pattern
+
+g_regex_get_pattern, function in Perl-compatible regular expressions +
-
g_regex_get_string_number
+
+g_regex_get_string_number, function in Perl-compatible regular expressions +
-
g_regex_match
+
+g_regex_match, function in Perl-compatible regular expressions +
-
g_regex_match_all
+
+g_regex_match_all, function in Perl-compatible regular expressions +
-
g_regex_match_all_full
+
+g_regex_match_all_full, function in Perl-compatible regular expressions +
-
g_regex_match_full
+
+g_regex_match_full, function in Perl-compatible regular expressions +
-
g_regex_match_simple
+
+g_regex_match_simple, function in Perl-compatible regular expressions +
-
g_regex_new
+
+g_regex_new, function in Perl-compatible regular expressions +
-
g_regex_ref
+
+g_regex_ref, function in Perl-compatible regular expressions +
-
g_regex_replace
+
+g_regex_replace, function in Perl-compatible regular expressions +
-
g_regex_replace_eval
+
+g_regex_replace_eval, function in Perl-compatible regular expressions +
-
g_regex_replace_literal
+
+g_regex_replace_literal, function in Perl-compatible regular expressions +
-
g_regex_split
+
+g_regex_split, function in Perl-compatible regular expressions +
-
g_regex_split_full
+
+g_regex_split_full, function in Perl-compatible regular expressions +
-
g_regex_split_simple
+
+g_regex_split_simple, function in Perl-compatible regular expressions +
-
g_regex_unref
+
+g_regex_unref, function in Perl-compatible regular expressions +
-
GRelation
+
+GRelation, struct in Relations and Tuples +
-
g_relation_count
+
+g_relation_count, function in Relations and Tuples +
-
g_relation_delete
+
+g_relation_delete, function in Relations and Tuples +
-
g_relation_destroy
+
+g_relation_destroy, function in Relations and Tuples +
-
g_relation_exists
+
+g_relation_exists, function in Relations and Tuples +
-
g_relation_index
+
+g_relation_index, function in Relations and Tuples +
-
g_relation_insert
+
+g_relation_insert, function in Relations and Tuples +
-
g_relation_new
+
+g_relation_new, function in Relations and Tuples +
-
g_relation_print
+
+g_relation_print, function in Relations and Tuples +
-
g_relation_select
+
+g_relation_select, function in Relations and Tuples +
-
g_reload_user_special_dirs_cache
+
+g_reload_user_special_dirs_cache, function in Miscellaneous Utility Functions +
-
g_remove
+
+g_remove, function in File Utilities +
-
g_rename
+
+g_rename, function in File Utilities +
-
g_renew
+
+g_renew, macro in Memory Allocation +
-
g_return_if_fail
+
+g_return_if_fail, macro in Warnings and Assertions +
-
g_return_if_reached
+
+g_return_if_reached, macro in Warnings and Assertions +
-
g_return_val_if_fail
+
+g_return_val_if_fail, macro in Warnings and Assertions +
-
g_return_val_if_reached
+
+g_return_val_if_reached, macro in Warnings and Assertions +
-
g_rmdir
+
+g_rmdir, function in File Utilities +

S

-
GScanner
+
+GScanner, struct in Lexical Scanner +
-
GScannerConfig
+
+GScannerConfig, struct in Lexical Scanner +
-
GScannerMsgFunc
+
+GScannerMsgFunc, user_function in Lexical Scanner +
-
g_scanner_add_symbol
+
+g_scanner_add_symbol, macro in Lexical Scanner +
-
g_scanner_cur_line
+
+g_scanner_cur_line, function in Lexical Scanner +
-
g_scanner_cur_position
+
+g_scanner_cur_position, function in Lexical Scanner +
-
g_scanner_cur_token
+
+g_scanner_cur_token, function in Lexical Scanner +
-
g_scanner_cur_value
+
+g_scanner_cur_value, function in Lexical Scanner +
-
g_scanner_destroy
+
+g_scanner_destroy, function in Lexical Scanner +
-
g_scanner_eof
+
+g_scanner_eof, function in Lexical Scanner +
-
g_scanner_error
+
+g_scanner_error, function in Lexical Scanner +
-
g_scanner_foreach_symbol
+
+g_scanner_foreach_symbol, macro in Lexical Scanner +
-
g_scanner_freeze_symbol_table
+
+g_scanner_freeze_symbol_table, macro in Lexical Scanner +
-
g_scanner_get_next_token
+
+g_scanner_get_next_token, function in Lexical Scanner +
-
g_scanner_input_file
+
+g_scanner_input_file, function in Lexical Scanner +
-
g_scanner_input_text
+
+g_scanner_input_text, function in Lexical Scanner +
-
g_scanner_lookup_symbol
+
+g_scanner_lookup_symbol, function in Lexical Scanner +
-
g_scanner_new
+
+g_scanner_new, function in Lexical Scanner +
-
g_scanner_peek_next_token
+
+g_scanner_peek_next_token, function in Lexical Scanner +
-
g_scanner_remove_symbol
+
+g_scanner_remove_symbol, macro in Lexical Scanner +
-
g_scanner_scope_add_symbol
+
+g_scanner_scope_add_symbol, function in Lexical Scanner +
-
g_scanner_scope_foreach_symbol
+
+g_scanner_scope_foreach_symbol, function in Lexical Scanner +
-
g_scanner_scope_lookup_symbol
+
+g_scanner_scope_lookup_symbol, function in Lexical Scanner +
-
g_scanner_scope_remove_symbol
+
+g_scanner_scope_remove_symbol, function in Lexical Scanner +
-
g_scanner_set_scope
+
+g_scanner_set_scope, function in Lexical Scanner +
-
g_scanner_sync_file_offset
+
+g_scanner_sync_file_offset, function in Lexical Scanner +
-
g_scanner_thaw_symbol_table
+
+g_scanner_thaw_symbol_table, macro in Lexical Scanner +
-
g_scanner_unexp_token
+
+g_scanner_unexp_token, function in Lexical Scanner +
-
g_scanner_warn
+
+g_scanner_warn, function in Lexical Scanner +
-
G_SEARCHPATH_SEPARATOR
+
+G_SEARCHPATH_SEPARATOR, macro in Standard Macros +
-
G_SEARCHPATH_SEPARATOR_S
+
+G_SEARCHPATH_SEPARATOR_S, macro in Standard Macros +
-
GSeekType
+
+GSeekType, enum in IO Channels +
-
GSequence
+
+GSequence, struct in Sequences +
-
GSequenceIter
+
+GSequenceIter, typedef in Sequences +
-
GSequenceIterCompareFunc
+
+GSequenceIterCompareFunc, user_function in Sequences +
-
g_sequence_append
+
+g_sequence_append, function in Sequences +
-
g_sequence_foreach
+
+g_sequence_foreach, function in Sequences +
-
g_sequence_foreach_range
+
+g_sequence_foreach_range, function in Sequences +
-
g_sequence_free
+
+g_sequence_free, function in Sequences +
-
g_sequence_get
+
+g_sequence_get, function in Sequences +
-
g_sequence_get_begin_iter
+
+g_sequence_get_begin_iter, function in Sequences +
-
g_sequence_get_end_iter
+
+g_sequence_get_end_iter, function in Sequences +
-
g_sequence_get_iter_at_pos
+
+g_sequence_get_iter_at_pos, function in Sequences +
-
g_sequence_get_length
+
+g_sequence_get_length, function in Sequences +
-
g_sequence_insert_before
+
+g_sequence_insert_before, function in Sequences +
-
g_sequence_insert_sorted
+
+g_sequence_insert_sorted, function in Sequences +
-
g_sequence_insert_sorted_iter
+
+g_sequence_insert_sorted_iter, function in Sequences +
-
g_sequence_iter_compare
+
+g_sequence_iter_compare, function in Sequences +
-
g_sequence_iter_get_position
+
+g_sequence_iter_get_position, function in Sequences +
-
g_sequence_iter_get_sequence
+
+g_sequence_iter_get_sequence, function in Sequences +
-
g_sequence_iter_is_begin
+
+g_sequence_iter_is_begin, function in Sequences +
-
g_sequence_iter_is_end
+
+g_sequence_iter_is_end, function in Sequences +
-
g_sequence_iter_move
+
+g_sequence_iter_move, function in Sequences +
-
g_sequence_iter_next
+
+g_sequence_iter_next, function in Sequences +
-
g_sequence_iter_prev
+
+g_sequence_iter_prev, function in Sequences +
-
g_sequence_move
+
+g_sequence_move, function in Sequences +
-
g_sequence_move_range
+
+g_sequence_move_range, function in Sequences +
-
g_sequence_new
+
+g_sequence_new, function in Sequences +
-
g_sequence_prepend
+
+g_sequence_prepend, function in Sequences +
-
g_sequence_range_get_midpoint
+
+g_sequence_range_get_midpoint, function in Sequences +
-
g_sequence_remove
+
+g_sequence_remove, function in Sequences +
-
g_sequence_remove_range
+
+g_sequence_remove_range, function in Sequences +
-
g_sequence_search
+
+g_sequence_search, function in Sequences +
-
g_sequence_search_iter
+
+g_sequence_search_iter, function in Sequences +
-
g_sequence_set
+
+g_sequence_set, function in Sequences +
-
g_sequence_sort
+
+g_sequence_sort, function in Sequences +
-
g_sequence_sort_changed
+
+g_sequence_sort_changed, function in Sequences +
-
g_sequence_sort_changed_iter
+
+g_sequence_sort_changed_iter, function in Sequences +
-
g_sequence_sort_iter
+
+g_sequence_sort_iter, function in Sequences +
-
g_sequence_swap
+
+g_sequence_swap, function in Sequences +
-
g_setenv
+
+g_setenv, function in Miscellaneous Utility Functions +
-
g_set_application_name
+
+g_set_application_name, function in Miscellaneous Utility Functions +
-
g_set_error
+
+g_set_error, function in Error Reporting +
-
g_set_error_literal
+
+g_set_error_literal, function in Error Reporting +
-
g_set_prgname
+
+g_set_prgname, function in Miscellaneous Utility Functions +
-
g_set_printerr_handler
+
+g_set_printerr_handler, function in Warnings and Assertions +
-
g_set_print_handler
+
+g_set_print_handler, function in Warnings and Assertions +
-
GShellError
+
+GShellError, enum in Shell-related Utilities +
-
G_SHELL_ERROR
+
+G_SHELL_ERROR, macro in Shell-related Utilities +
-
g_shell_parse_argv
+
+g_shell_parse_argv, function in Shell-related Utilities +
-
g_shell_quote
+
+g_shell_quote, function in Shell-related Utilities +
-
g_shell_unquote
+
+g_shell_unquote, function in Shell-related Utilities +
-
gshort
+
+gshort, typedef in Basic Types +
-
gsize
+
+gsize, typedef in Basic Types +
-
GSIZE_FROM_BE
+
+GSIZE_FROM_BE, macro in Byte Order Macros +
-
GSIZE_FROM_LE
+
+GSIZE_FROM_LE, macro in Byte Order Macros +
-
GSIZE_TO_BE
+
+GSIZE_TO_BE, macro in Byte Order Macros +
-
GSIZE_TO_LE
+
+GSIZE_TO_LE, macro in Byte Order Macros +
-
GSIZE_TO_POINTER
+
+GSIZE_TO_POINTER, macro in Type Conversion Macros +
-
g_slice_alloc
+
+g_slice_alloc, function in Memory Slices +
-
g_slice_alloc0
+
+g_slice_alloc0, function in Memory Slices +
-
g_slice_copy
+
+g_slice_copy, function in Memory Slices +
-
g_slice_dup
+
+g_slice_dup, macro in Memory Slices +
-
g_slice_free
+
+g_slice_free, macro in Memory Slices +
-
g_slice_free1
+
+g_slice_free1, function in Memory Slices +
-
g_slice_free_chain
+
+g_slice_free_chain, macro in Memory Slices +
-
g_slice_free_chain_with_offset
+
+g_slice_free_chain_with_offset, function in Memory Slices +
-
g_slice_new
+
+g_slice_new, macro in Memory Slices +
-
g_slice_new0
+
+g_slice_new0, macro in Memory Slices +
-
GSList
+
+GSList, struct in Singly-Linked Lists +
-
g_slist_alloc
+
+g_slist_alloc, function in Singly-Linked Lists +
-
g_slist_append
+
+g_slist_append, function in Singly-Linked Lists +
-
g_slist_concat
+
+g_slist_concat, function in Singly-Linked Lists +
-
g_slist_copy
+
+g_slist_copy, function in Singly-Linked Lists +
-
g_slist_delete_link
+
+g_slist_delete_link, function in Singly-Linked Lists +
-
g_slist_find
+
+g_slist_find, function in Singly-Linked Lists +
-
g_slist_find_custom
+
+g_slist_find_custom, function in Singly-Linked Lists +
-
g_slist_foreach
+
+g_slist_foreach, function in Singly-Linked Lists +
-
g_slist_free
+
+g_slist_free, function in Singly-Linked Lists +
-
g_slist_free1
+
+g_slist_free1, macro in Singly-Linked Lists +
-
g_slist_free_1
+
+g_slist_free_1, function in Singly-Linked Lists +
-
g_slist_index
+
+g_slist_index, function in Singly-Linked Lists +
-
g_slist_insert
+
+g_slist_insert, function in Singly-Linked Lists +
-
g_slist_insert_before
+
+g_slist_insert_before, function in Singly-Linked Lists +
-
g_slist_insert_sorted
+
+g_slist_insert_sorted, function in Singly-Linked Lists +
-
g_slist_insert_sorted_with_data
+
+g_slist_insert_sorted_with_data, function in Singly-Linked Lists +
-
g_slist_last
+
+g_slist_last, function in Singly-Linked Lists +
-
g_slist_length
+
+g_slist_length, function in Singly-Linked Lists +
-
g_slist_next
+
+g_slist_next, macro in Singly-Linked Lists +
-
g_slist_nth
+
+g_slist_nth, function in Singly-Linked Lists +
-
g_slist_nth_data
+
+g_slist_nth_data, function in Singly-Linked Lists +
-
g_slist_pop_allocator
+
+g_slist_pop_allocator, function in Singly-Linked Lists +
-
g_slist_position
+
+g_slist_position, function in Singly-Linked Lists +
-
g_slist_prepend
+
+g_slist_prepend, function in Singly-Linked Lists +
-
g_slist_push_allocator
+
+g_slist_push_allocator, function in Singly-Linked Lists +
-
g_slist_remove
+
+g_slist_remove, function in Singly-Linked Lists +
-
g_slist_remove_all
+
+g_slist_remove_all, function in Singly-Linked Lists +
-
g_slist_remove_link
+
+g_slist_remove_link, function in Singly-Linked Lists +
-
g_slist_reverse
+
+g_slist_reverse, function in Singly-Linked Lists +
-
g_slist_sort
+
+g_slist_sort, function in Singly-Linked Lists +
-
g_slist_sort_with_data
+
+g_slist_sort_with_data, function in Singly-Linked Lists +
-
g_snprintf
+
+g_snprintf, function in String Utility Functions +
-
GSource
+
+GSource, struct in The Main Event Loop +
-
GSourceCallbackFuncs
+
+GSourceCallbackFuncs, struct in The Main Event Loop +
-
GSourceDummyMarshal
+
+GSourceDummyMarshal, user_function in The Main Event Loop +
-
GSourceFunc
+
+GSourceFunc, user_function in The Main Event Loop +
-
GSourceFuncs
+
+GSourceFuncs, struct in The Main Event Loop +
-
g_source_add_poll
+
+g_source_add_poll, function in The Main Event Loop +
-
g_source_attach
+
+g_source_attach, function in The Main Event Loop +
-
g_source_destroy
+
+g_source_destroy, function in The Main Event Loop +
-
g_source_get_can_recurse
+
+g_source_get_can_recurse, function in The Main Event Loop +
-
g_source_get_context
+
+g_source_get_context, function in The Main Event Loop +
-
g_source_get_current_time
+
+g_source_get_current_time, function in The Main Event Loop +
-
g_source_get_id
+
+g_source_get_id, function in The Main Event Loop +
-
g_source_get_priority
+
+g_source_get_priority, function in The Main Event Loop +
-
g_source_is_destroyed
+
+g_source_is_destroyed, function in The Main Event Loop +
-
g_source_new
+
+g_source_new, function in The Main Event Loop +
-
g_source_ref
+
+g_source_ref, function in The Main Event Loop +
-
g_source_remove
+
+g_source_remove, function in The Main Event Loop +
-
g_source_remove_by_funcs_user_data
+
+g_source_remove_by_funcs_user_data, function in The Main Event Loop +
-
g_source_remove_by_user_data
+
+g_source_remove_by_user_data, function in The Main Event Loop +
-
g_source_remove_poll
+
+g_source_remove_poll, function in The Main Event Loop +
-
g_source_set_callback
+
+g_source_set_callback, function in The Main Event Loop +
-
g_source_set_callback_indirect
+
+g_source_set_callback_indirect, function in The Main Event Loop +
-
g_source_set_can_recurse
+
+g_source_set_can_recurse, function in The Main Event Loop +
-
g_source_set_funcs
+
+g_source_set_funcs, function in The Main Event Loop +
-
g_source_set_priority
+
+g_source_set_priority, function in The Main Event Loop +
-
g_source_unref
+
+g_source_unref, function in The Main Event Loop +
-
g_spaced_primes_closest
+
+g_spaced_primes_closest, function in Miscellaneous Utility Functions +
-
GSpawnChildSetupFunc
+
+GSpawnChildSetupFunc, user_function in Spawning Processes +
-
GSpawnError
+
+GSpawnError, enum in Spawning Processes +
-
GSpawnFlags
+
+GSpawnFlags, enum in Spawning Processes +
-
g_spawn_async
+
+g_spawn_async, function in Spawning Processes +
-
g_spawn_async_with_pipes
+
+g_spawn_async_with_pipes, function in Spawning Processes +
-
g_spawn_close_pid
+
+g_spawn_close_pid, function in Spawning Processes +
-
g_spawn_command_line_async
+
+g_spawn_command_line_async, function in Spawning Processes +
-
g_spawn_command_line_sync
+
+g_spawn_command_line_sync, function in Spawning Processes +
-
G_SPAWN_ERROR
+
+G_SPAWN_ERROR, macro in Spawning Processes +
-
g_spawn_sync
+
+g_spawn_sync, function in Spawning Processes +
-
g_sprintf
+
+g_sprintf, function in String Utility Functions +
-
G_SQRT2
+
+G_SQRT2, macro in Numerical Definitions +
-
gssize
+
+gssize, typedef in Basic Types +
-
GSSIZE_FROM_BE
+
+GSSIZE_FROM_BE, macro in Byte Order Macros +
-
GSSIZE_FROM_LE
+
+GSSIZE_FROM_LE, macro in Byte Order Macros +
-
GSSIZE_TO_BE
+
+GSSIZE_TO_BE, macro in Byte Order Macros +
-
GSSIZE_TO_LE
+
+GSSIZE_TO_LE, macro in Byte Order Macros +
-
g_stat
+
+g_stat, function in File Utilities +
-
GStaticMutex
+
+GStaticMutex, struct in Threads +
-
GStaticPrivate
+
+GStaticPrivate, struct in Threads +
-
GStaticRecMutex
+
+GStaticRecMutex, struct in Threads +
-
GStaticRWLock
+
+GStaticRWLock, struct in Threads +
-
G_STATIC_ASSERT
+
+G_STATIC_ASSERT, macro in Miscellaneous Macros +
-
g_static_mutex_free
+
+g_static_mutex_free, function in Threads +
-
g_static_mutex_get_mutex
+
+g_static_mutex_get_mutex, function in Threads +
-
G_STATIC_MUTEX_INIT
+
+G_STATIC_MUTEX_INIT, macro in Threads +
-
g_static_mutex_init
+
+g_static_mutex_init, function in Threads +
-
g_static_mutex_lock
+
+g_static_mutex_lock, function in Threads +
-
g_static_mutex_trylock
+
+g_static_mutex_trylock, function in Threads +
-
g_static_mutex_unlock
+
+g_static_mutex_unlock, function in Threads +
-
g_static_private_free
+
+g_static_private_free, function in Threads +
-
g_static_private_get
+
+g_static_private_get, function in Threads +
-
G_STATIC_PRIVATE_INIT
+
+G_STATIC_PRIVATE_INIT, macro in Threads +
-
g_static_private_init
+
+g_static_private_init, function in Threads +
-
g_static_private_set
+
+g_static_private_set, function in Threads +
-
g_static_rec_mutex_free
+
+g_static_rec_mutex_free, function in Threads +
-
g_static_rec_mutex_init
+
+g_static_rec_mutex_init, function in Threads +
-
G_STATIC_REC_MUTEX_INIT
+
+G_STATIC_REC_MUTEX_INIT, macro in Threads +
-
g_static_rec_mutex_lock
+
+g_static_rec_mutex_lock, function in Threads +
-
g_static_rec_mutex_lock_full
+
+g_static_rec_mutex_lock_full, function in Threads +
-
g_static_rec_mutex_trylock
+
+g_static_rec_mutex_trylock, function in Threads +
-
g_static_rec_mutex_unlock
+
+g_static_rec_mutex_unlock, function in Threads +
-
g_static_rec_mutex_unlock_full
+
+g_static_rec_mutex_unlock_full, function in Threads +
-
g_static_rw_lock_free
+
+g_static_rw_lock_free, function in Threads +
-
g_static_rw_lock_init
+
+g_static_rw_lock_init, function in Threads +
-
G_STATIC_RW_LOCK_INIT
+
+G_STATIC_RW_LOCK_INIT, macro in Threads +
-
g_static_rw_lock_reader_lock
+
+g_static_rw_lock_reader_lock, function in Threads +
-
g_static_rw_lock_reader_trylock
+
+g_static_rw_lock_reader_trylock, function in Threads +
-
g_static_rw_lock_reader_unlock
+
+g_static_rw_lock_reader_unlock, function in Threads +
-
g_static_rw_lock_writer_lock
+
+g_static_rw_lock_writer_lock, function in Threads +
-
g_static_rw_lock_writer_trylock
+
+g_static_rw_lock_writer_trylock, function in Threads +
-
g_static_rw_lock_writer_unlock
+
+g_static_rw_lock_writer_unlock, function in Threads +
-
G_STMT_END
+
+G_STMT_END, macro in Miscellaneous Macros +
-
G_STMT_START
+
+G_STMT_START, macro in Miscellaneous Macros +
-
g_stpcpy
+
+g_stpcpy, function in String Utility Functions +
-
g_strcanon
+
+g_strcanon, function in String Utility Functions +
-
g_strcasecmp
+
+g_strcasecmp, function in String Utility Functions +
-
g_strchomp
+
+g_strchomp, function in String Utility Functions +
-
g_strchug
+
+g_strchug, function in String Utility Functions +
-
g_strcmp0
+
+g_strcmp0, function in String Utility Functions +
-
g_strcompress
+
+g_strcompress, function in String Utility Functions +
-
g_strconcat
+
+g_strconcat, function in String Utility Functions +
-
g_strdelimit
+
+g_strdelimit, function in String Utility Functions +
-
g_strdown
+
+g_strdown, function in String Utility Functions +
-
g_strdup
+
+g_strdup, function in String Utility Functions +
-
g_strdupv
+
+g_strdupv, function in String Utility Functions +
-
g_strdup_printf
+
+g_strdup_printf, function in String Utility Functions +
-
g_strdup_vprintf
+
+g_strdup_vprintf, function in String Utility Functions +
-
g_strerror
+
+g_strerror, function in String Utility Functions +
-
g_strescape
+
+g_strescape, function in String Utility Functions +
-
g_strfreev
+
+g_strfreev, function in String Utility Functions +
-
G_STRFUNC
+
+G_STRFUNC, macro in Miscellaneous Macros +
-
GString
+
+GString, struct in Strings +
-
GStringChunk
+
+GStringChunk, struct in String Chunks +
-
G_STRINGIFY
+
+G_STRINGIFY, macro in Miscellaneous Macros +
-
g_string_append
+
+g_string_append, function in Strings +
-
g_string_append_c
+
+g_string_append_c, function in Strings +
-
g_string_append_len
+
+g_string_append_len, function in Strings +
-
g_string_append_printf
+
+g_string_append_printf, function in Strings +
-
g_string_append_unichar
+
+g_string_append_unichar, function in Strings +
-
g_string_append_uri_escaped
+
+g_string_append_uri_escaped, function in Strings +
-
g_string_append_vprintf
+
+g_string_append_vprintf, function in Strings +
-
g_string_ascii_down
+
+g_string_ascii_down, function in String Utility Functions +
-
g_string_ascii_up
+
+g_string_ascii_up, function in String Utility Functions +
-
g_string_assign
+
+g_string_assign, function in Strings +
-
g_string_chunk_clear
+
+g_string_chunk_clear, function in String Chunks +
-
g_string_chunk_free
+
+g_string_chunk_free, function in String Chunks +
-
g_string_chunk_insert
+
+g_string_chunk_insert, function in String Chunks +
-
g_string_chunk_insert_const
+
+g_string_chunk_insert_const, function in String Chunks +
-
g_string_chunk_insert_len
+
+g_string_chunk_insert_len, function in String Chunks +
-
g_string_chunk_new
+
+g_string_chunk_new, function in String Chunks +
-
g_string_down
+
+g_string_down, function in Strings +
-
g_string_equal
+
+g_string_equal, function in Strings +
-
g_string_erase
+
+g_string_erase, function in Strings +
-
g_string_free
+
+g_string_free, function in Strings +
-
g_string_hash
+
+g_string_hash, function in Strings +
-
g_string_insert
+
+g_string_insert, function in Strings +
-
g_string_insert_c
+
+g_string_insert_c, function in Strings +
-
g_string_insert_len
+
+g_string_insert_len, function in Strings +
-
g_string_insert_unichar
+
+g_string_insert_unichar, function in Strings +
-
g_string_new
+
+g_string_new, function in Strings +
-
g_string_new_len
+
+g_string_new_len, function in Strings +
-
g_string_overwrite
+
+g_string_overwrite, function in Strings +
-
g_string_overwrite_len
+
+g_string_overwrite_len, function in Strings +
-
g_string_prepend
+
+g_string_prepend, function in Strings +
-
g_string_prepend_c
+
+g_string_prepend_c, function in Strings +
-
g_string_prepend_len
+
+g_string_prepend_len, function in Strings +
-
g_string_prepend_unichar
+
+g_string_prepend_unichar, function in Strings +
-
g_string_printf
+
+g_string_printf, function in Strings +
-
g_string_set_size
+
+g_string_set_size, function in Strings +
-
g_string_sized_new
+
+g_string_sized_new, function in Strings +
-
g_string_sprintf
+
+g_string_sprintf, macro in Strings +
-
g_string_sprintfa
+
+g_string_sprintfa, macro in Strings +
-
g_string_truncate
+
+g_string_truncate, function in Strings +
-
g_string_up
+
+g_string_up, function in Strings +
-
g_string_vprintf
+
+g_string_vprintf, function in Strings +
-
g_strip_context
+
+g_strip_context, function in I18N +
-
g_strjoin
+
+g_strjoin, function in String Utility Functions +
-
g_strjoinv
+
+g_strjoinv, function in String Utility Functions +
-
g_strlcat
+
+g_strlcat, function in String Utility Functions +
-
g_strlcpy
+
+g_strlcpy, function in String Utility Functions +
-
G_STRLOC
+
+G_STRLOC, macro in Miscellaneous Macros +
-
g_strncasecmp
+
+g_strncasecmp, function in String Utility Functions +
-
g_strndup
+
+g_strndup, function in String Utility Functions +
-
g_strnfill
+
+g_strnfill, function in String Utility Functions +
-
g_strreverse
+
+g_strreverse, function in String Utility Functions +
-
g_strrstr
+
+g_strrstr, function in String Utility Functions +
-
g_strrstr_len
+
+g_strrstr_len, function in String Utility Functions +
-
g_strsignal
+
+g_strsignal, function in String Utility Functions +
-
g_strsplit
+
+g_strsplit, function in String Utility Functions +
-
g_strsplit_set
+
+g_strsplit_set, function in String Utility Functions +
-
g_strstrip
+
+g_strstrip, macro in String Utility Functions +
-
g_strstr_len
+
+g_strstr_len, function in String Utility Functions +
-
g_strtod
+
+g_strtod, function in String Utility Functions +
-
G_STRUCT_MEMBER
+
+G_STRUCT_MEMBER, macro in Standard Macros +
-
G_STRUCT_MEMBER_P
+
+G_STRUCT_MEMBER_P, macro in Standard Macros +
-
G_STRUCT_OFFSET
+
+G_STRUCT_OFFSET, macro in Standard Macros +
-
g_strup
+
+g_strup, function in String Utility Functions +
-
g_strv_length
+
+g_strv_length, function in String Utility Functions +
-
G_STR_DELIMITERS
+
+G_STR_DELIMITERS, macro in String Utility Functions +
-
g_str_equal
+
+g_str_equal, function in Hash Tables +
-
g_str_hash
+
+g_str_hash, function in Hash Tables +
-
g_str_has_prefix
+
+g_str_has_prefix, function in String Utility Functions +
-
g_str_has_suffix
+
+g_str_has_suffix, function in String Utility Functions +

T

-
GTestCase
+
+GTestCase, typedef in Testing +
-
GTestLogFatalFunc
+
+GTestLogFatalFunc, user_function in Testing +
-
GTestSuite
+
+GTestSuite, typedef in Testing +
-
GTestTrapFlags
+
+GTestTrapFlags, enum in Testing +
-
g_test_add
+
+g_test_add, macro in Testing +
-
g_test_add_data_func
+
+g_test_add_data_func, function in Testing +
-
g_test_add_func
+
+g_test_add_func, function in Testing +
-
g_test_bug
+
+g_test_bug, function in Testing +
-
g_test_bug_base
+
+g_test_bug_base, function in Testing +
-
g_test_create_case
+
+g_test_create_case, function in Testing +
-
g_test_create_suite
+
+g_test_create_suite, function in Testing +
-
g_test_get_root
+
+g_test_get_root, function in Testing +
-
g_test_init
+
+g_test_init, function in Testing +
-
g_test_log_set_fatal_handler
+
+g_test_log_set_fatal_handler, function in Testing +
-
g_test_maximized_result
+
+g_test_maximized_result, function in Testing +
-
g_test_message
+
+g_test_message, function in Testing +
-
g_test_minimized_result
+
+g_test_minimized_result, function in Testing +
-
g_test_perf
+
+g_test_perf, macro in Testing +
-
g_test_queue_destroy
+
+g_test_queue_destroy, function in Testing +
-
g_test_queue_free
+
+g_test_queue_free, function in Testing +
-
g_test_queue_unref
+
+g_test_queue_unref, macro in Testing +
-
g_test_quick
+
+g_test_quick, macro in Testing +
-
g_test_quiet
+
+g_test_quiet, macro in Testing +
-
g_test_rand_bit
+
+g_test_rand_bit, macro in Testing +
-
g_test_rand_double
+
+g_test_rand_double, function in Testing +
-
g_test_rand_double_range
+
+g_test_rand_double_range, function in Testing +
-
g_test_rand_int
+
+g_test_rand_int, function in Testing +
-
g_test_rand_int_range
+
+g_test_rand_int_range, function in Testing +
-
g_test_run
+
+g_test_run, function in Testing +
-
g_test_run_suite
+
+g_test_run_suite, function in Testing +
-
g_test_slow
+
+g_test_slow, macro in Testing +
-
g_test_suite_add
+
+g_test_suite_add, function in Testing +
-
g_test_suite_add_suite
+
+g_test_suite_add_suite, function in Testing +
-
g_test_thorough
+
+g_test_thorough, macro in Testing +
-
g_test_timer_elapsed
+
+g_test_timer_elapsed, function in Testing +
-
g_test_timer_last
+
+g_test_timer_last, function in Testing +
-
g_test_timer_start
+
+g_test_timer_start, function in Testing +
-
g_test_trap_assert_failed
+
+g_test_trap_assert_failed, macro in Testing +
-
g_test_trap_assert_passed
+
+g_test_trap_assert_passed, macro in Testing +
-
g_test_trap_assert_stderr
+
+g_test_trap_assert_stderr, macro in Testing +
-
g_test_trap_assert_stderr_unmatched
+
+g_test_trap_assert_stderr_unmatched, macro in Testing +
-
g_test_trap_assert_stdout
+
+g_test_trap_assert_stdout, macro in Testing +
-
g_test_trap_assert_stdout_unmatched
+
+g_test_trap_assert_stdout_unmatched, macro in Testing +
-
g_test_trap_fork
+
+g_test_trap_fork, function in Testing +
-
g_test_trap_has_passed
+
+g_test_trap_has_passed, function in Testing +
-
g_test_trap_reached_timeout
+
+g_test_trap_reached_timeout, function in Testing +
-
g_test_verbose
+
+g_test_verbose, macro in Testing +
-
GThread
+
+GThread, struct in Threads +
-
GThreadError
+
+GThreadError, enum in Threads +
-
GThreadFunc
+
+GThreadFunc, user_function in Threads +
-
GThreadFunctions
+
+GThreadFunctions, struct in Threads +
-
GThreadPool
+
+GThreadPool, struct in Thread Pools +
-
GThreadPriority
+
+GThreadPriority, enum in Threads +
-
G_THREADS_ENABLED
+
+G_THREADS_ENABLED, macro in Threads +
-
G_THREADS_IMPL_NONE
+
+G_THREADS_IMPL_NONE, macro in Threads +
-
G_THREADS_IMPL_POSIX
+
+G_THREADS_IMPL_POSIX, macro in Threads +
-
g_thread_create
+
+g_thread_create, function in Threads +
-
g_thread_create_full
+
+g_thread_create_full, function in Threads +
-
G_THREAD_ERROR
+
+G_THREAD_ERROR, macro in Threads +
-
g_thread_exit
+
+g_thread_exit, function in Threads +
-
g_thread_foreach
+
+g_thread_foreach, function in Threads +
-
g_thread_get_initialized
+
+g_thread_get_initialized, function in Threads +
-
g_thread_init
+
+g_thread_init, function in Threads +
-
g_thread_join
+
+g_thread_join, function in Threads +
-
g_thread_pool_free
+
+g_thread_pool_free, function in Thread Pools +
-
g_thread_pool_get_max_idle_time
+
+g_thread_pool_get_max_idle_time, function in Thread Pools +
-
g_thread_pool_get_max_threads
+
+g_thread_pool_get_max_threads, function in Thread Pools +
-
g_thread_pool_get_max_unused_threads
+
+g_thread_pool_get_max_unused_threads, function in Thread Pools +
-
g_thread_pool_get_num_threads
+
+g_thread_pool_get_num_threads, function in Thread Pools +
-
g_thread_pool_get_num_unused_threads
+
+g_thread_pool_get_num_unused_threads, function in Thread Pools +
-
g_thread_pool_new
+
+g_thread_pool_new, function in Thread Pools +
-
g_thread_pool_push
+
+g_thread_pool_push, function in Thread Pools +
-
g_thread_pool_set_max_idle_time
+
+g_thread_pool_set_max_idle_time, function in Thread Pools +
-
g_thread_pool_set_max_threads
+
+g_thread_pool_set_max_threads, function in Thread Pools +
-
g_thread_pool_set_max_unused_threads
+
+g_thread_pool_set_max_unused_threads, function in Thread Pools +
-
g_thread_pool_set_sort_function
+
+g_thread_pool_set_sort_function, function in Thread Pools +
-
g_thread_pool_stop_unused_threads
+
+g_thread_pool_stop_unused_threads, function in Thread Pools +
-
g_thread_pool_unprocessed
+
+g_thread_pool_unprocessed, function in Thread Pools +
-
g_thread_self
+
+g_thread_self, function in Threads +
-
g_thread_set_priority
+
+g_thread_set_priority, function in Threads +
-
g_thread_supported
+
+g_thread_supported, function in Threads +
-
g_thread_yield
+
+g_thread_yield, function in Threads +
-
GTime
+
+GTime, typedef in Date and Time Functions +
-
g_timeout_add
+
+g_timeout_add, function in The Main Event Loop +
-
g_timeout_add_full
+
+g_timeout_add_full, function in The Main Event Loop +
-
g_timeout_add_seconds
+
+g_timeout_add_seconds, function in The Main Event Loop +
-
g_timeout_add_seconds_full
+
+g_timeout_add_seconds_full, function in The Main Event Loop +
-
g_timeout_source_new
+
+g_timeout_source_new, function in The Main Event Loop +
-
g_timeout_source_new_seconds
+
+g_timeout_source_new_seconds, function in The Main Event Loop +
-
GTimer
+
+GTimer, struct in Timers +
-
g_timer_continue
+
+g_timer_continue, function in Timers +
-
g_timer_destroy
+
+g_timer_destroy, function in Timers +
-
g_timer_elapsed
+
+g_timer_elapsed, function in Timers +
-
g_timer_new
+
+g_timer_new, function in Timers +
-
g_timer_reset
+
+g_timer_reset, function in Timers +
-
g_timer_start
+
+g_timer_start, function in Timers +
-
g_timer_stop
+
+g_timer_stop, function in Timers +
-
GTimeVal
+
+GTimeVal, struct in Date and Time Functions +
-
g_time_val_add
+
+g_time_val_add, function in Date and Time Functions +
-
g_time_val_from_iso8601
+
+g_time_val_from_iso8601, function in Date and Time Functions +
-
g_time_val_to_iso8601
+
+g_time_val_to_iso8601, function in Date and Time Functions +
-
GTokenType
+
+GTokenType, enum in Lexical Scanner +
-
GTokenValue
+
+GTokenValue, union in Lexical Scanner +
-
GTranslateFunc
+
+GTranslateFunc, user_function in Commandline option parser +
-
GTrashStack
+
+GTrashStack, struct in Trash Stacks +
-
g_trash_stack_height
+
+g_trash_stack_height, function in Trash Stacks +
-
g_trash_stack_peek
+
+g_trash_stack_peek, function in Trash Stacks +
-
g_trash_stack_pop
+
+g_trash_stack_pop, function in Trash Stacks +
-
g_trash_stack_push
+
+g_trash_stack_push, function in Trash Stacks +
-
GTraverseFlags
+
+GTraverseFlags, enum in N-ary Trees +
-
GTraverseFunc
+
+GTraverseFunc, user_function in Balanced Binary Trees +
-
GTraverseType
+
+GTraverseType, enum in Balanced Binary Trees +
-
GTree
+
+GTree, struct in Balanced Binary Trees +
-
g_tree_destroy
+
+g_tree_destroy, function in Balanced Binary Trees +
-
g_tree_foreach
+
+g_tree_foreach, function in Balanced Binary Trees +
-
g_tree_height
+
+g_tree_height, function in Balanced Binary Trees +
-
g_tree_insert
+
+g_tree_insert, function in Balanced Binary Trees +
-
g_tree_lookup
+
+g_tree_lookup, function in Balanced Binary Trees +
-
g_tree_lookup_extended
+
+g_tree_lookup_extended, function in Balanced Binary Trees +
-
g_tree_new
+
+g_tree_new, function in Balanced Binary Trees +
-
g_tree_new_full
+
+g_tree_new_full, function in Balanced Binary Trees +
-
g_tree_new_with_data
+
+g_tree_new_with_data, function in Balanced Binary Trees +
-
g_tree_nnodes
+
+g_tree_nnodes, function in Balanced Binary Trees +
-
g_tree_ref
+
+g_tree_ref, function in Balanced Binary Trees +
-
g_tree_remove
+
+g_tree_remove, function in Balanced Binary Trees +
-
g_tree_replace
+
+g_tree_replace, function in Balanced Binary Trees +
-
g_tree_search
+
+g_tree_search, function in Balanced Binary Trees +
-
g_tree_steal
+
+g_tree_steal, function in Balanced Binary Trees +
-
g_tree_traverse
+
+g_tree_traverse, function in Balanced Binary Trees +
-
g_tree_unref
+
+g_tree_unref, function in Balanced Binary Trees +
-
TRUE
+
+TRUE, macro in Standard Macros +
-
G_TRYLOCK
+
+G_TRYLOCK, macro in Threads +
-
g_try_malloc
+
+g_try_malloc, function in Memory Allocation +
-
g_try_malloc0
+
+g_try_malloc0, function in Memory Allocation +
-
g_try_malloc0_n
+
+g_try_malloc0_n, function in Memory Allocation +
-
g_try_malloc_n
+
+g_try_malloc_n, function in Memory Allocation +
-
g_try_new
+
+g_try_new, macro in Memory Allocation +
-
g_try_new0
+
+g_try_new0, macro in Memory Allocation +
-
g_try_realloc
+
+g_try_realloc, function in Memory Allocation +
-
g_try_realloc_n
+
+g_try_realloc_n, function in Memory Allocation +
-
g_try_renew
+
+g_try_renew, macro in Memory Allocation +
-
GTuples
+
+GTuples, struct in Relations and Tuples +
-
g_tuples_destroy
+
+g_tuples_destroy, function in Relations and Tuples +
-
g_tuples_index
+
+g_tuples_index, function in Relations and Tuples +

U

-
guchar
+
+guchar, typedef in Basic Types +
-
g_ucs4_to_utf16
+
+g_ucs4_to_utf16, function in Unicode Manipulation +
-
g_ucs4_to_utf8
+
+g_ucs4_to_utf8, function in Unicode Manipulation +
-
guint
+
+guint, typedef in Basic Types +
-
guint16
+
+guint16, typedef in Basic Types +
-
GUINT16_FROM_BE
+
+GUINT16_FROM_BE, macro in Byte Order Macros +
-
GUINT16_FROM_LE
+
+GUINT16_FROM_LE, macro in Byte Order Macros +
-
GUINT16_SWAP_BE_PDP
+
+GUINT16_SWAP_BE_PDP, macro in Byte Order Macros +
-
GUINT16_SWAP_LE_BE
+
+GUINT16_SWAP_LE_BE, macro in Byte Order Macros +
-
GUINT16_SWAP_LE_PDP
+
+GUINT16_SWAP_LE_PDP, macro in Byte Order Macros +
-
GUINT16_TO_BE
+
+GUINT16_TO_BE, macro in Byte Order Macros +
-
GUINT16_TO_LE
+
+GUINT16_TO_LE, macro in Byte Order Macros +
-
guint32
+
+guint32, typedef in Basic Types +
-
GUINT32_FROM_BE
+
+GUINT32_FROM_BE, macro in Byte Order Macros +
-
GUINT32_FROM_LE
+
+GUINT32_FROM_LE, macro in Byte Order Macros +
-
GUINT32_SWAP_BE_PDP
+
+GUINT32_SWAP_BE_PDP, macro in Byte Order Macros +
-
GUINT32_SWAP_LE_BE
+
+GUINT32_SWAP_LE_BE, macro in Byte Order Macros +
-
GUINT32_SWAP_LE_PDP
+
+GUINT32_SWAP_LE_PDP, macro in Byte Order Macros +
-
GUINT32_TO_BE
+
+GUINT32_TO_BE, macro in Byte Order Macros +
-
GUINT32_TO_LE
+
+GUINT32_TO_LE, macro in Byte Order Macros +
-
guint64
+
+guint64, typedef in Basic Types +
-
GUINT64_FROM_BE
+
+GUINT64_FROM_BE, macro in Byte Order Macros +
-
GUINT64_FROM_LE
+
+GUINT64_FROM_LE, macro in Byte Order Macros +
-
GUINT64_SWAP_LE_BE
+
+GUINT64_SWAP_LE_BE, macro in Byte Order Macros +
-
GUINT64_TO_BE
+
+GUINT64_TO_BE, macro in Byte Order Macros +
-
GUINT64_TO_LE
+
+GUINT64_TO_LE, macro in Byte Order Macros +
-
guint8
+
+guint8, typedef in Basic Types +
-
guintptr
+
+guintptr, typedef in Basic Types +
-
GUINT_FROM_BE
+
+GUINT_FROM_BE, macro in Byte Order Macros +
-
GUINT_FROM_LE
+
+GUINT_FROM_LE, macro in Byte Order Macros +
-
GUINT_TO_BE
+
+GUINT_TO_BE, macro in Byte Order Macros +
-
GUINT_TO_LE
+
+GUINT_TO_LE, macro in Byte Order Macros +
-
GUINT_TO_POINTER
+
+GUINT_TO_POINTER, macro in Type Conversion Macros +
-
gulong
+
+gulong, typedef in Basic Types +
-
GULONG_FROM_BE
+
+GULONG_FROM_BE, macro in Byte Order Macros +
-
GULONG_FROM_LE
+
+GULONG_FROM_LE, macro in Byte Order Macros +
-
GULONG_TO_BE
+
+GULONG_TO_BE, macro in Byte Order Macros +
-
GULONG_TO_LE
+
+GULONG_TO_LE, macro in Byte Order Macros +
-
gunichar
+
+gunichar, typedef in Unicode Manipulation +
-
gunichar2
+
+gunichar2, typedef in Unicode Manipulation +
-
g_unichar_break_type
+
+g_unichar_break_type, function in Unicode Manipulation +
-
g_unichar_combining_class
+
+g_unichar_combining_class, function in Unicode Manipulation +
-
g_unichar_digit_value
+
+g_unichar_digit_value, function in Unicode Manipulation +
-
g_unichar_get_mirror_char
+
+g_unichar_get_mirror_char, function in Unicode Manipulation +
-
g_unichar_get_script
+
+g_unichar_get_script, function in Unicode Manipulation +
-
g_unichar_isalnum
+
+g_unichar_isalnum, function in Unicode Manipulation +
-
g_unichar_isalpha
+
+g_unichar_isalpha, function in Unicode Manipulation +
-
g_unichar_iscntrl
+
+g_unichar_iscntrl, function in Unicode Manipulation +
-
g_unichar_isdefined
+
+g_unichar_isdefined, function in Unicode Manipulation +
-
g_unichar_isdigit
+
+g_unichar_isdigit, function in Unicode Manipulation +
-
g_unichar_isgraph
+
+g_unichar_isgraph, function in Unicode Manipulation +
-
g_unichar_islower
+
+g_unichar_islower, function in Unicode Manipulation +
-
g_unichar_ismark
+
+g_unichar_ismark, function in Unicode Manipulation +
-
g_unichar_isprint
+
+g_unichar_isprint, function in Unicode Manipulation +
-
g_unichar_ispunct
+
+g_unichar_ispunct, function in Unicode Manipulation +
-
g_unichar_isspace
+
+g_unichar_isspace, function in Unicode Manipulation +
-
g_unichar_istitle
+
+g_unichar_istitle, function in Unicode Manipulation +
-
g_unichar_isupper
+
+g_unichar_isupper, function in Unicode Manipulation +
-
g_unichar_iswide
+
+g_unichar_iswide, function in Unicode Manipulation +
-
g_unichar_iswide_cjk
+
+g_unichar_iswide_cjk, function in Unicode Manipulation +
-
g_unichar_isxdigit
+
+g_unichar_isxdigit, function in Unicode Manipulation +
-
g_unichar_iszerowidth
+
+g_unichar_iszerowidth, function in Unicode Manipulation +
-
g_unichar_tolower
+
+g_unichar_tolower, function in Unicode Manipulation +
-
g_unichar_totitle
+
+g_unichar_totitle, function in Unicode Manipulation +
-
g_unichar_toupper
+
+g_unichar_toupper, function in Unicode Manipulation +
-
g_unichar_to_utf8
+
+g_unichar_to_utf8, function in Unicode Manipulation +
-
g_unichar_type
+
+g_unichar_type, function in Unicode Manipulation +
-
g_unichar_validate
+
+g_unichar_validate, function in Unicode Manipulation +
-
g_unichar_xdigit_value
+
+g_unichar_xdigit_value, function in Unicode Manipulation +
-
GUnicodeBreakType
+
+GUnicodeBreakType, enum in Unicode Manipulation +
-
GUnicodeScript
+
+GUnicodeScript, enum in Unicode Manipulation +
-
GUnicodeType
+
+GUnicodeType, enum in Unicode Manipulation +
-
g_unicode_canonical_decomposition
+
+g_unicode_canonical_decomposition, function in Unicode Manipulation +
-
g_unicode_canonical_ordering
+
+g_unicode_canonical_ordering, function in Unicode Manipulation +
-
G_UNLIKELY
+
+G_UNLIKELY, macro in Miscellaneous Macros +
-
g_unlink
+
+g_unlink, function in File Utilities +
-
G_UNLOCK
+
+G_UNLOCK, macro in Threads +
-
g_unsetenv
+
+g_unsetenv, function in Miscellaneous Utility Functions +
-
g_uri_escape_string
+
+g_uri_escape_string, function in URI Functions +
-
g_uri_list_extract_uris
+
+g_uri_list_extract_uris, function in URI Functions +
-
g_uri_parse_scheme
+
+g_uri_parse_scheme, function in URI Functions +
-
G_URI_RESERVED_CHARS_ALLOWED_IN_PATH
+
+G_URI_RESERVED_CHARS_ALLOWED_IN_PATH, macro in URI Functions +
-
G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT
+
+G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT, macro in URI Functions +
-
G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO
+
+G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO, macro in URI Functions +
-
G_URI_RESERVED_CHARS_GENERIC_DELIMITERS
+
+G_URI_RESERVED_CHARS_GENERIC_DELIMITERS, macro in URI Functions +
-
G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS
+
+G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS, macro in URI Functions +
-
g_uri_unescape_segment
+
+g_uri_unescape_segment, function in URI Functions +
-
g_uri_unescape_string
+
+g_uri_unescape_string, function in URI Functions +
-
G_USEC_PER_SEC
+
+G_USEC_PER_SEC, macro in Date and Time Functions +
-
GUserDirectory
+
+GUserDirectory, enum in Miscellaneous Utility Functions +
-
gushort
+
+gushort, typedef in Basic Types +
-
g_usleep
+
+g_usleep, function in Date and Time Functions +
-
g_utf16_to_ucs4
+
+g_utf16_to_ucs4, function in Unicode Manipulation +
-
g_utf16_to_utf8
+
+g_utf16_to_utf8, function in Unicode Manipulation +
-
g_utf8_casefold
+
+g_utf8_casefold, function in Unicode Manipulation +
-
g_utf8_collate
+
+g_utf8_collate, function in Unicode Manipulation +
-
g_utf8_collate_key
+
+g_utf8_collate_key, function in Unicode Manipulation +
-
g_utf8_collate_key_for_filename
+
+g_utf8_collate_key_for_filename, function in Unicode Manipulation +
-
g_utf8_find_next_char
+
+g_utf8_find_next_char, function in Unicode Manipulation +
-
g_utf8_find_prev_char
+
+g_utf8_find_prev_char, function in Unicode Manipulation +
-
g_utf8_get_char
+
+g_utf8_get_char, function in Unicode Manipulation +
-
g_utf8_get_char_validated
+
+g_utf8_get_char_validated, function in Unicode Manipulation +
-
g_utf8_next_char
+
+g_utf8_next_char, macro in Unicode Manipulation +
-
g_utf8_normalize
+
+g_utf8_normalize, function in Unicode Manipulation +
-
g_utf8_offset_to_pointer
+
+g_utf8_offset_to_pointer, function in Unicode Manipulation +
-
g_utf8_pointer_to_offset
+
+g_utf8_pointer_to_offset, function in Unicode Manipulation +
-
g_utf8_prev_char
+
+g_utf8_prev_char, function in Unicode Manipulation +
-
g_utf8_strchr
+
+g_utf8_strchr, function in Unicode Manipulation +
-
g_utf8_strdown
+
+g_utf8_strdown, function in Unicode Manipulation +
-
g_utf8_strlen
+
+g_utf8_strlen, function in Unicode Manipulation +
-
g_utf8_strncpy
+
+g_utf8_strncpy, function in Unicode Manipulation +
-
g_utf8_strrchr
+
+g_utf8_strrchr, function in Unicode Manipulation +
-
g_utf8_strreverse
+
+g_utf8_strreverse, function in Unicode Manipulation +
-
g_utf8_strup
+
+g_utf8_strup, function in Unicode Manipulation +
-
g_utf8_to_ucs4
+
+g_utf8_to_ucs4, function in Unicode Manipulation +
-
g_utf8_to_ucs4_fast
+
+g_utf8_to_ucs4_fast, function in Unicode Manipulation +
-
g_utf8_to_utf16
+
+g_utf8_to_utf16, function in Unicode Manipulation +
-
g_utf8_validate
+
+g_utf8_validate, function in Unicode Manipulation +
-
g_utime
+
+g_utime, function in File Utilities +

V

-
GVariant
+
+GVariant, struct in GVariant +
-
GVariantBuilder
+
+GVariantBuilder, struct in GVariant +
-
GVariantClass
+
+GVariantClass, enum in GVariant +
-
GVariantIter
+
+GVariantIter, struct in GVariant +
-
GVariantType
+
+GVariantType, struct in GVariantType +
-
g_variant_builder_add
+
+g_variant_builder_add, function in GVariant +
-
g_variant_builder_add_value
+
+g_variant_builder_add_value, function in GVariant +
-
g_variant_builder_clear
+
+g_variant_builder_clear, function in GVariant +
-
g_variant_builder_close
+
+g_variant_builder_close, function in GVariant +
-
g_variant_builder_end
+
+g_variant_builder_end, function in GVariant +
-
g_variant_builder_init
+
+g_variant_builder_init, function in GVariant +
-
g_variant_builder_new
+
+g_variant_builder_new, function in GVariant +
-
g_variant_builder_open
+
+g_variant_builder_open, function in GVariant +
-
g_variant_builder_ref
+
+g_variant_builder_ref, function in GVariant +
-
g_variant_builder_unref
+
+g_variant_builder_unref, function in GVariant +
-
g_variant_byteswap
+
+g_variant_byteswap, function in GVariant +
-
g_variant_classify
+
+g_variant_classify, function in GVariant +
-
g_variant_dup_string
+
+g_variant_dup_string, function in GVariant +
-
g_variant_dup_strv
+
+g_variant_dup_strv, function in GVariant +
-
g_variant_equal
+
+g_variant_equal, function in GVariant +
-
g_variant_get
+
+g_variant_get, function in GVariant +
-
g_variant_get_boolean
+
+g_variant_get_boolean, function in GVariant +
-
g_variant_get_byte
+
+g_variant_get_byte, function in GVariant +
-
g_variant_get_child
+
+g_variant_get_child, function in GVariant +
-
g_variant_get_child_value
+
+g_variant_get_child_value, function in GVariant +
-
g_variant_get_data
+
+g_variant_get_data, function in GVariant +
-
g_variant_get_double
+
+g_variant_get_double, function in GVariant +
-
g_variant_get_fixed_array
+
+g_variant_get_fixed_array, function in GVariant +
-
g_variant_get_handle
+
+g_variant_get_handle, function in GVariant +
-
g_variant_get_int16
+
+g_variant_get_int16, function in GVariant +
-
g_variant_get_int32
+
+g_variant_get_int32, function in GVariant +
-
g_variant_get_int64
+
+g_variant_get_int64, function in GVariant +
-
g_variant_get_maybe
+
+g_variant_get_maybe, function in GVariant +
-
g_variant_get_normal_form
+
+g_variant_get_normal_form, function in GVariant +
-
g_variant_get_size
+
+g_variant_get_size, function in GVariant +
-
g_variant_get_string
+
+g_variant_get_string, function in GVariant +
-
g_variant_get_strv
+
+g_variant_get_strv, function in GVariant +
-
g_variant_get_type
+
+g_variant_get_type, function in GVariant +
-
g_variant_get_type_string
+
+g_variant_get_type_string, function in GVariant +
-
g_variant_get_uint16
+
+g_variant_get_uint16, function in GVariant +
-
g_variant_get_uint32
+
+g_variant_get_uint32, function in GVariant +
-
g_variant_get_uint64
+
+g_variant_get_uint64, function in GVariant +
-
g_variant_get_va
+
+g_variant_get_va, function in GVariant +
-
g_variant_get_variant
+
+g_variant_get_variant, function in GVariant +
-
g_variant_hash
+
+g_variant_hash, function in GVariant +
-
g_variant_is_container
+
+g_variant_is_container, function in GVariant +
-
g_variant_is_normal_form
+
+g_variant_is_normal_form, function in GVariant +
-
g_variant_is_object_path
+
+g_variant_is_object_path, function in GVariant +
-
g_variant_is_of_type
+
+g_variant_is_of_type, function in GVariant +
-
g_variant_is_signature
+
+g_variant_is_signature, function in GVariant +
-
g_variant_iter_copy
+
+g_variant_iter_copy, function in GVariant +
-
g_variant_iter_free
+
+g_variant_iter_free, function in GVariant +
-
g_variant_iter_init
+
+g_variant_iter_init, function in GVariant +
-
g_variant_iter_loop
+
+g_variant_iter_loop, function in GVariant +
-
g_variant_iter_new
+
+g_variant_iter_new, function in GVariant +
-
g_variant_iter_next
+
+g_variant_iter_next, function in GVariant +
-
g_variant_iter_next_value
+
+g_variant_iter_next_value, function in GVariant +
-
g_variant_iter_n_children
+
+g_variant_iter_n_children, function in GVariant +
-
g_variant_new
+
+g_variant_new, function in GVariant +
-
g_variant_new_array
+
+g_variant_new_array, function in GVariant +
-
g_variant_new_boolean
+
+g_variant_new_boolean, function in GVariant +
-
g_variant_new_byte
+
+g_variant_new_byte, function in GVariant +
-
g_variant_new_dict_entry
+
+g_variant_new_dict_entry, function in GVariant +
-
g_variant_new_double
+
+g_variant_new_double, function in GVariant +
-
g_variant_new_from_data
+
+g_variant_new_from_data, function in GVariant +
-
g_variant_new_handle
+
+g_variant_new_handle, function in GVariant +
-
g_variant_new_int16
+
+g_variant_new_int16, function in GVariant +
-
g_variant_new_int32
+
+g_variant_new_int32, function in GVariant +
-
g_variant_new_int64
+
+g_variant_new_int64, function in GVariant +
-
g_variant_new_maybe
+
+g_variant_new_maybe, function in GVariant +
-
g_variant_new_object_path
+
+g_variant_new_object_path, function in GVariant +
-
g_variant_new_parsed
+
+g_variant_new_parsed, function in GVariant +
-
g_variant_new_parsed_va
+
+g_variant_new_parsed_va, function in GVariant +
-
g_variant_new_signature
+
+g_variant_new_signature, function in GVariant +
-
g_variant_new_string
+
+g_variant_new_string, function in GVariant +
-
g_variant_new_strv
+
+g_variant_new_strv, function in GVariant +
-
g_variant_new_tuple
+
+g_variant_new_tuple, function in GVariant +
-
g_variant_new_uint16
+
+g_variant_new_uint16, function in GVariant +
-
g_variant_new_uint32
+
+g_variant_new_uint32, function in GVariant +
-
g_variant_new_uint64
+
+g_variant_new_uint64, function in GVariant +
-
g_variant_new_va
+
+g_variant_new_va, function in GVariant +
-
g_variant_new_variant
+
+g_variant_new_variant, function in GVariant +
-
g_variant_n_children
+
+g_variant_n_children, function in GVariant +
-
g_variant_parse
+
+g_variant_parse, function in GVariant +
-
G_VARIANT_PARSE_ERROR
+
+G_VARIANT_PARSE_ERROR, macro in GVariant +
-
g_variant_print
+
+g_variant_print, function in GVariant +
-
g_variant_print_string
+
+g_variant_print_string, function in GVariant +
-
g_variant_ref
+
+g_variant_ref, function in GVariant +
-
g_variant_ref_sink
+
+g_variant_ref_sink, function in GVariant +
-
g_variant_store
+
+g_variant_store, function in GVariant +
-
G_VARIANT_TYPE
+
+G_VARIANT_TYPE, macro in GVariantType +
-
G_VARIANT_TYPE_ANY
+
+G_VARIANT_TYPE_ANY, macro in GVariantType +
-
G_VARIANT_TYPE_ARRAY
+
+G_VARIANT_TYPE_ARRAY, macro in GVariantType +
-
G_VARIANT_TYPE_BASIC
+
+G_VARIANT_TYPE_BASIC, macro in GVariantType +
-
G_VARIANT_TYPE_BOOLEAN
+
+G_VARIANT_TYPE_BOOLEAN, macro in GVariantType +
-
G_VARIANT_TYPE_BYTE
+
+G_VARIANT_TYPE_BYTE, macro in GVariantType +
-
g_variant_type_copy
+
+g_variant_type_copy, function in GVariantType +
-
G_VARIANT_TYPE_DICTIONARY
+
+G_VARIANT_TYPE_DICTIONARY, macro in GVariantType +
-
G_VARIANT_TYPE_DICT_ENTRY
+
+G_VARIANT_TYPE_DICT_ENTRY, macro in GVariantType +
-
G_VARIANT_TYPE_DOUBLE
+
+G_VARIANT_TYPE_DOUBLE, macro in GVariantType +
-
g_variant_type_dup_string
+
+g_variant_type_dup_string, function in GVariantType +
-
g_variant_type_element
+
+g_variant_type_element, function in GVariantType +
-
g_variant_type_equal
+
+g_variant_type_equal, function in GVariantType +
-
g_variant_type_first
+
+g_variant_type_first, function in GVariantType +
-
g_variant_type_free
+
+g_variant_type_free, function in GVariantType +
-
g_variant_type_get_string_length
+
+g_variant_type_get_string_length, function in GVariantType +
-
G_VARIANT_TYPE_HANDLE
+
+G_VARIANT_TYPE_HANDLE, macro in GVariantType +
-
g_variant_type_hash
+
+g_variant_type_hash, function in GVariantType +
-
G_VARIANT_TYPE_INT16
+
+G_VARIANT_TYPE_INT16, macro in GVariantType +
-
G_VARIANT_TYPE_INT32
+
+G_VARIANT_TYPE_INT32, macro in GVariantType +
-
G_VARIANT_TYPE_INT64
+
+G_VARIANT_TYPE_INT64, macro in GVariantType +
-
g_variant_type_is_array
+
+g_variant_type_is_array, function in GVariantType +
-
g_variant_type_is_basic
+
+g_variant_type_is_basic, function in GVariantType +
-
g_variant_type_is_container
+
+g_variant_type_is_container, function in GVariantType +
-
g_variant_type_is_definite
+
+g_variant_type_is_definite, function in GVariantType +
-
g_variant_type_is_dict_entry
+
+g_variant_type_is_dict_entry, function in GVariantType +
-
g_variant_type_is_maybe
+
+g_variant_type_is_maybe, function in GVariantType +
-
g_variant_type_is_subtype_of
+
+g_variant_type_is_subtype_of, function in GVariantType +
-
g_variant_type_is_tuple
+
+g_variant_type_is_tuple, function in GVariantType +
-
g_variant_type_is_variant
+
+g_variant_type_is_variant, function in GVariantType +
-
g_variant_type_key
+
+g_variant_type_key, function in GVariantType +
-
G_VARIANT_TYPE_MAYBE
+
+G_VARIANT_TYPE_MAYBE, macro in GVariantType +
-
g_variant_type_new
+
+g_variant_type_new, function in GVariantType +
-
g_variant_type_new_array
+
+g_variant_type_new_array, function in GVariantType +
-
g_variant_type_new_dict_entry
+
+g_variant_type_new_dict_entry, function in GVariantType +
-
g_variant_type_new_maybe
+
+g_variant_type_new_maybe, function in GVariantType +
-
g_variant_type_new_tuple
+
+g_variant_type_new_tuple, function in GVariantType +
-
g_variant_type_next
+
+g_variant_type_next, function in GVariantType +
-
g_variant_type_n_items
+
+g_variant_type_n_items, function in GVariantType +
-
G_VARIANT_TYPE_OBJECT_PATH
+
+G_VARIANT_TYPE_OBJECT_PATH, macro in GVariantType +
-
g_variant_type_peek_string
+
+g_variant_type_peek_string, function in GVariantType +
-
G_VARIANT_TYPE_SIGNATURE
+
+G_VARIANT_TYPE_SIGNATURE, macro in GVariantType +
-
G_VARIANT_TYPE_STRING
+
+G_VARIANT_TYPE_STRING, macro in GVariantType +
-
g_variant_type_string_is_valid
+
+g_variant_type_string_is_valid, function in GVariantType +
-
g_variant_type_string_scan
+
+g_variant_type_string_scan, function in GVariantType +
-
G_VARIANT_TYPE_TUPLE
+
+G_VARIANT_TYPE_TUPLE, macro in GVariantType +
-
G_VARIANT_TYPE_UINT16
+
+G_VARIANT_TYPE_UINT16, macro in GVariantType +
-
G_VARIANT_TYPE_UINT32
+
+G_VARIANT_TYPE_UINT32, macro in GVariantType +
-
G_VARIANT_TYPE_UINT64
+
+G_VARIANT_TYPE_UINT64, macro in GVariantType +
-
G_VARIANT_TYPE_UNIT
+
+G_VARIANT_TYPE_UNIT, macro in GVariantType +
-
g_variant_type_value
+
+g_variant_type_value, function in GVariantType +
-
G_VARIANT_TYPE_VARIANT
+
+G_VARIANT_TYPE_VARIANT, macro in GVariantType +
-
g_variant_unref
+
+g_variant_unref, function in GVariant +
-
g_vasprintf
+
+g_vasprintf, function in String Utility Functions +
-
G_VA_COPY
+
+G_VA_COPY, macro in Miscellaneous Macros +
-
g_vfprintf
+
+g_vfprintf, function in String Utility Functions +
-
GVoidFunc
+
+GVoidFunc, user_function in Miscellaneous Utility Functions +
-
g_vprintf
+
+g_vprintf, function in String Utility Functions +
-
g_vsnprintf
+
+g_vsnprintf, function in String Utility Functions +
-
g_vsprintf
+
+g_vsprintf, function in String Utility Functions +

W

-
g_warning
+
+g_warning, macro in Message Logging +
-
g_warn_if_fail
+
+g_warn_if_fail, macro in Warnings and Assertions +
-
g_warn_if_reached
+
+g_warn_if_reached, macro in Warnings and Assertions +
-
G_WIN32_DLLMAIN_FOR_DLL_NAME
+
+G_WIN32_DLLMAIN_FOR_DLL_NAME, macro in Windows Compatibility Functions +
-
g_win32_error_message
+
+g_win32_error_message, function in Windows Compatibility Functions +
-
g_win32_getlocale
+
+g_win32_getlocale, function in Windows Compatibility Functions +
-
g_win32_get_package_installation_directory
+
+g_win32_get_package_installation_directory, function in Windows Compatibility Functions +
-
g_win32_get_package_installation_directory_of_module
+
+g_win32_get_package_installation_directory_of_module, function in Windows Compatibility Functions +
-
g_win32_get_package_installation_subdirectory
+
+g_win32_get_package_installation_subdirectory, function in Windows Compatibility Functions +
-
g_win32_get_windows_version
+
+g_win32_get_windows_version, function in Windows Compatibility Functions +
-
G_WIN32_HAVE_WIDECHAR_API
+
+G_WIN32_HAVE_WIDECHAR_API, macro in Windows Compatibility Functions +
-
G_WIN32_IS_NT_BASED
+
+G_WIN32_IS_NT_BASED, macro in Windows Compatibility Functions +
-
g_win32_locale_filename_from_utf8
+
+g_win32_locale_filename_from_utf8, function in Windows Compatibility Functions +
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Arrays.html b/docs/reference/glib/html/glib-Arrays.html index 21dc885..924a4da 100644 --- a/docs/reference/glib/html/glib-Arrays.html +++ b/docs/reference/glib/html/glib-Arrays.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -62,46 +42,52 @@ #include <glib.h> GArray; -GArray* g_array_new (gboolean zero_terminated, - gboolean clear_, - guint element_size); -GArray* g_array_sized_new (gboolean zero_terminated, - gboolean clear_, - guint element_size, - guint reserved_size); -GArray * g_array_ref (GArray *array); -voidg_array_unref (GArray *array); -guintg_array_get_element_size (GArray *array); -#define g_array_append_val (a,v) -GArray* g_array_append_vals (GArray *array, - gconstpointer data, - guint len); -#define g_array_prepend_val (a,v) -GArray* g_array_prepend_vals (GArray *array, - gconstpointer data, - guint len); -#define g_array_insert_val (a,i,v) -GArray* g_array_insert_vals (GArray *array, - guint index_, - gconstpointer data, - guint len); -GArray* g_array_remove_index (GArray *array, - guint index_); -GArray* g_array_remove_index_fast (GArray *array, - guint index_); -GArray* g_array_remove_range (GArray *array, - guint index_, - guint length); -voidg_array_sort (GArray *array, - GCompareFunc compare_func); -voidg_array_sort_with_data (GArray *array, - GCompareDataFunc compare_func, - gpointer user_data); -#define g_array_index (a,t,i) -GArray* g_array_set_size (GArray *array, - guint length); -gchar* g_array_free (GArray *array, - gboolean free_segment); +GArray* g_array_new (gboolean zero_terminated, + gboolean clear_, + guint element_size); +GArray* g_array_sized_new (gboolean zero_terminated, + gboolean clear_, + guint element_size, + guint reserved_size); +GArray * g_array_ref (GArray *array); +voidg_array_unref (GArray *array); +guintg_array_get_element_size (GArray *array); +#define g_array_append_val (a, + v) +GArray* g_array_append_vals (GArray *array, + gconstpointer data, + guint len); +#define g_array_prepend_val (a, + v) +GArray* g_array_prepend_vals (GArray *array, + gconstpointer data, + guint len); +#define g_array_insert_val (a, + i, + v) +GArray* g_array_insert_vals (GArray *array, + guint index_, + gconstpointer data, + guint len); +GArray* g_array_remove_index (GArray *array, + guint index_); +GArray* g_array_remove_index_fast (GArray *array, + guint index_); +GArray* g_array_remove_range (GArray *array, + guint index_, + guint length); +voidg_array_sort (GArray *array, + GCompareFunc compare_func); +voidg_array_sort_with_data (GArray *array, + GCompareDataFunc compare_func, + gpointer user_data); +#define g_array_index (a, + t, + i) +GArray* g_array_set_size (GArray *array, + guint length); +gchar* g_array_free (GArray *array, + gboolean free_segment);
@@ -135,23 +121,43 @@ To free an array, use

-

Example 19. Using a GArray to store gint values

-
-  GArray *garray;
-  gint i;
-  /* We create a new array to store gint values.
-     We don't want it zero-terminated or cleared to 0's. */
-  garray = g_array_new (FALSE, FALSE, sizeof (gint));
-  for (i = 0; i < 10000; i++)
-    g_array_append_val (garray, i);
-  for (i = 0; i < 10000; i++)
-    if (g_array_index (garray, gint, i) != i)
-      g_print ("ERROR: got %d instead of %d\n",
-               g_array_index (garray, gint, i), i);
-  g_array_free (garray, TRUE);
- 
-
-


+

Example 19. Using a GArray to store gint values

+
+
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
GArray *garray;
+gint i;
+/* We create a new array to store gint values.
+   We don't want it zero-terminated or cleared to 0's. */
+garray = g_array_new (FALSE, FALSE, sizeof (gint));
+for (i = 0; i < 10000; i++)
+  g_array_append_val (garray, i);
+for (i = 0; i < 10000; i++)
+  if (g_array_index (garray, gint, i) != i)
+    g_print ("ERROR: got %d instead of %d\n",
+             g_array_index (garray, gint, i), i);
+g_array_free (garray, TRUE);
+ + + +


+

Details

@@ -163,19 +169,20 @@ To free an array, use

-Contains the public fields of an Array.

+Contains the public fields of an Array. +

- - @@ -185,34 +192,37 @@ Contains the public fields of an Array.


g_array_new ()

-
GArray*             g_array_new                         (gboolean zero_terminated,
-                                                         gboolean clear_,
-                                                         guint element_size);
+
GArray*             g_array_new                         (gboolean zero_terminated,
+                                                         gboolean clear_,
+                                                         guint element_size);

-Creates a new GArray with a reference count of 1.

+Creates a new GArray with a reference count of 1. +

gchar *data;

a pointer to the element data. The data may be moved as +a pointer to the element data. The data may be moved as elements are added to the GArray.

guint len;

the number of elements in the GArray not including the +the number of elements in the GArray not including the possible terminating zero element.
- - - - @@ -221,43 +231,46 @@ Creates a new

g_array_sized_new ()

-
GArray*             g_array_sized_new                   (gboolean zero_terminated,
-                                                         gboolean clear_,
-                                                         guint element_size,
-                                                         guint reserved_size);
+
GArray*             g_array_sized_new                   (gboolean zero_terminated,
+                                                         gboolean clear_,
+                                                         guint element_size,
+                                                         guint reserved_size);

Creates a new GArray with reserved_size elements preallocated and a reference count of 1. This avoids frequent reallocation, if you are going to add many elements to the array. Note however that the -size of the array is still 0.

+size of the array is still 0. +

zero_terminated :

TRUE if the array should have an extra element at + +TRUE if the array should have an extra element at the end which is set to 0.

clear_ :

TRUE if GArray elements should be automatically cleared + +TRUE if GArray elements should be automatically cleared to 0 when they are allocated.

element_size :

the size of each element in bytes. +the size of each element in bytes.

Returns :

the new GArray. +the new GArray.
- - - - - @@ -266,16 +279,17 @@ size of the array is still 0.


g_array_ref ()

-
GArray *            g_array_ref                         (GArray *array);
+
GArray *            g_array_ref                         (GArray *array);

Atomically increments the reference count of array by one. This -function is MT-safe and may be called from any thread.

+function is MT-safe and may be called from any thread. +

zero_terminated :

TRUE if the array should have an extra element at + +TRUE if the array should have an extra element at the end with all bits cleared.

clear_ :

TRUE if all bits in the array should be cleared to 0 on + +TRUE if all bits in the array should be cleared to 0 on allocation.

element_size :

size of each element in the array. +size of each element in the array.

reserved_size :

number of elements preallocated. +number of elements preallocated.

Returns :

the new GArray. +the new GArray.
- @@ -291,17 +305,18 @@ function is MT-safe and may be called from any thread.


g_array_unref ()

-
void                g_array_unref                       (GArray *array);
+
void                g_array_unref                       (GArray *array);

Atomically decrements the reference count of array by one. If the reference count drops to 0, all memory allocated by the array is released. This function is MT-safe and may be called from any -thread.

+thread. +

array :

A GArray. +A GArray.
-

array :

A GArray. +A GArray.
@@ -310,15 +325,16 @@ thread.


g_array_get_element_size ()

-
guint               g_array_get_element_size            (GArray *array);
+
guint               g_array_get_element_size            (GArray *array);

-Gets the size of the elements in array.

+Gets the size of the elements in array. +

- @@ -347,22 +363,24 @@ size automatically if necessary. to the value parameter v. This means that you cannot use it with literal values such as "27". You must use variables.

+

+

array :

A GArray. +A GArray.
- - - @@ -371,32 +389,33 @@ literal values such as "27". You must use variables.


g_array_append_vals ()

-
GArray*             g_array_append_vals                 (GArray *array,
-                                                         gconstpointer data,
-                                                         guint len);
+
GArray*             g_array_append_vals                 (GArray *array,
+                                                         gconstpointer data,
+                                                         guint len);

-Adds len elements onto the end of the array.

+Adds len elements onto the end of the array. +

a :

a GArray. +a GArray.

v :

the value to append to the GArray. +the value to append to the GArray.

Returns :

the GArray. +the GArray.
- - - - @@ -423,22 +442,24 @@ the new element. to the value parameter v. This means that you cannot use it with literal values such as "27". You must use variables.

+

+

array :

a GArray. +a GArray.

data :

a pointer to the elements to append to the end of the array. +a pointer to the elements to append to the end of the array.

len :

the number of elements to append. +the number of elements to append.

Returns :

the GArray. +the GArray.
- - - @@ -447,38 +468,39 @@ literal values such as "27". You must use variables.


g_array_prepend_vals ()

-
GArray*             g_array_prepend_vals                (GArray *array,
-                                                         gconstpointer data,
-                                                         guint len);
+
GArray*             g_array_prepend_vals                (GArray *array,
+                                                         gconstpointer data,
+                                                         guint len);

Adds len elements onto the start of the array.

This operation is slower than g_array_append_vals() since the existing elements in the array have to be moved to make space for -the new elements.

+the new elements. +

a :

a GArray. +a GArray.

v :

the value to prepend to the GArray. +the value to prepend to the GArray.

Returns :

the GArray. +the GArray.
- - - - @@ -499,27 +521,29 @@ Inserts an element into an array at the given index. to the value parameter v. This means that you cannot use it with literal values such as "27". You must use variables.

+

+

array :

a GArray. +a GArray.

data :

a pointer to the elements to prepend to the start of the +a pointer to the elements to prepend to the start of the array.

len :

the number of elements to prepend. +the number of elements to prepend.

Returns :

the GArray. +the GArray.
- - - - @@ -528,38 +552,39 @@ literal values such as "27". You must use variables.


g_array_insert_vals ()

-
GArray*             g_array_insert_vals                 (GArray *array,
-                                                         guint index_,
-                                                         gconstpointer data,
-                                                         guint len);
+
GArray*             g_array_insert_vals                 (GArray *array,
+                                                         guint index_,
+                                                         gconstpointer data,
+                                                         guint len);

-Inserts len elements into a GArray at the given index.

+Inserts len elements into a GArray at the given index. +

a :

a GArray. +a GArray.

i :

the index to place the element at. +the index to place the element at.

v :

the value to insert into the array. +the value to insert into the array.

Returns :

the GArray. +the GArray.
- - - - - @@ -568,27 +593,28 @@ Inserts len elements into a

g_array_remove_index ()

-
GArray*             g_array_remove_index                (GArray *array,
-                                                         guint index_);
+
GArray*             g_array_remove_index                (GArray *array,
+                                                         guint index_);

Removes the element at the given index from a GArray. The following -elements are moved down one place.

+elements are moved down one place. +

array :

a GArray. +a GArray.

index_ :

the index to place the elements at. +the index to place the elements at.

data :

a pointer to the elements to insert. +a pointer to the elements to insert.

len :

the number of elements to insert. +the number of elements to insert.

Returns :

the GArray. +the GArray.
- - - @@ -597,29 +623,30 @@ elements are moved down one place.


g_array_remove_index_fast ()

-
GArray*             g_array_remove_index_fast           (GArray *array,
-                                                         guint index_);
+
GArray*             g_array_remove_index_fast           (GArray *array,
+                                                         guint index_);

Removes the element at the given index from a GArray. The last element in the array is used to fill in the space, so this function does not preserve the order of the GArray. But it is faster than -g_array_remove_index().

+g_array_remove_index(). +

array :

a GArray. +a GArray.

index_ :

the index of the element to remove. +the index of the element to remove.

Returns :

the GArray. +the GArray.
- - - @@ -628,33 +655,34 @@ does not preserve the order of the

g_array_remove_range ()

-
GArray*             g_array_remove_range                (GArray *array,
-                                                         guint index_,
-                                                         guint length);
+
GArray*             g_array_remove_range                (GArray *array,
+                                                         guint index_,
+                                                         guint length);

Removes the given number of elements starting at the given index -from a GArray. The following elements are moved to close the gap.

+from a GArray. The following elements are moved to close the gap. +

array :

a GArray. +a GArray.

index_ :

the index of the element to remove. +the index of the element to remove.

Returns :

the GArray. +the GArray.
- - - - @@ -664,8 +692,8 @@ from a

g_array_sort ()

-
void                g_array_sort                        (GArray *array,
-                                                         GCompareFunc compare_func);
+
void                g_array_sort                        (GArray *array,
+                                                         GCompareFunc compare_func);

Sorts a GArray using compare_func which should be a qsort()-style comparison function (returns less than zero for first arg is less @@ -674,18 +702,19 @@ greater than second arg).

If two array elements compare equal, their order in the sorted array -is undefined.

+is undefined. +

array :

a GArray. +a GArray.

index_ :

the index of the first element to remove. +the index of the first element to remove.

length :

the number of elements to remove. +the number of elements to remove.

Returns :

the GArray. +the GArray.
- - @@ -694,28 +723,29 @@ is undefined.


g_array_sort_with_data ()

-
void                g_array_sort_with_data              (GArray *array,
-                                                         GCompareDataFunc compare_func,
-                                                         gpointer user_data);
+
void                g_array_sort_with_data              (GArray *array,
+                                                         GCompareDataFunc compare_func,
+                                                         gpointer user_data);

Like g_array_sort(), but the comparison function receives an extra -user data argument.

+user data argument. +

array :

a GArray. +a GArray.

compare_func :

comparison function. +comparison function.
- - - @@ -732,36 +762,48 @@ value is cast to the given type.

-

Example 20. Getting a pointer to an element in a GArray

-
-  EDayViewEvent *event;
-  /* This gets a pointer to the 4th element
-     in the array of EDayViewEvent structs. */
-  event = &g_array_index (events, EDayViewEvent, 3);
- 
-
-


+

Example 20. Getting a pointer to an element in a GArray

+
+

array :

a GArray. +a GArray.

compare_func :

comparison function. +comparison function.

user_data :

data to pass to compare_func. +data to pass to compare_func.
+ + + + + + +
1
+2
+3
+4
EDayViewEvent *event;
+/* This gets a pointer to the 4th element
+   in the array of EDayViewEvent structs. */
+event = &g_array_index (events, EDayViewEvent, 3);
+
+ +
+


+

- - - - @@ -770,27 +812,28 @@ value is cast to the given type.

g_array_set_size ()

-
GArray*             g_array_set_size                    (GArray *array,
-                                                         guint length);
+
GArray*             g_array_set_size                    (GArray *array,
+                                                         guint length);

Sets the size of the array, expanding it if necessary. If the array -was created with clear_ set to TRUE, the new elements are set to 0.

+was created with clear_ set to TRUE, the new elements are set to 0. +

a :

a GArray. +a GArray.

t :

the type of the elements. +the type of the elements.

i :

the index of the element to return. +the index of the element to return.

Returns :

the element of the GArray at the index given by i. +the element of the GArray at the index given by i.
- - - @@ -799,8 +842,8 @@ was created with clear_ set to

g_array_free ()

-
gchar*              g_array_free                        (GArray *array,
-                                                         gboolean free_segment);
+
gchar*              g_array_free                        (GArray *array,
+                                                         gboolean free_segment);

Frees the memory allocated for the GArray. If free_segment is TRUE it frees the memory block holding the elements as well and @@ -817,22 +860,24 @@ of array will be set to zero.

If array elements contain dynamically-allocated memory, they should be freed separately.

+

+

array :

a GArray. +a GArray.

length :

the new size of the GArray. +the new size of the GArray.

Returns :

the GArray. +the GArray.
- - - @@ -843,6 +888,6 @@ they should be freed separately.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Asynchronous-Queues.html b/docs/reference/glib/html/glib-Asynchronous-Queues.html index 6f4bac2..59279a2 100644 --- a/docs/reference/glib/html/glib-Asynchronous-Queues.html +++ b/docs/reference/glib/html/glib-Asynchronous-Queues.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

array :

a GArray. +a GArray.

free_segment :

if TRUE the actual element data is freed as well. +if TRUE the actual element data is freed as well.

Returns :

the element data if free_segment is FALSE, otherwise +the element data if free_segment is FALSE, otherwise NULL. The element data should be freed using g_free().
@@ -61,43 +41,43 @@ #include <glib.h> GAsyncQueue; -GAsyncQueue* g_async_queue_new (void); -GAsyncQueue* g_async_queue_new_full (GDestroyNotify item_free_func); -GAsyncQueue* g_async_queue_ref (GAsyncQueue *queue); -voidg_async_queue_unref (GAsyncQueue *queue); -voidg_async_queue_push (GAsyncQueue *queue, - gpointer data); -voidg_async_queue_push_sorted (GAsyncQueue *queue, - gpointer data, - GCompareDataFunc func, - gpointer user_data); -gpointerg_async_queue_pop (GAsyncQueue *queue); -gpointerg_async_queue_try_pop (GAsyncQueue *queue); -gpointerg_async_queue_timed_pop (GAsyncQueue *queue, - GTimeVal *end_time); -gintg_async_queue_length (GAsyncQueue *queue); -voidg_async_queue_sort (GAsyncQueue *queue, - GCompareDataFunc func, - gpointer user_data); +GAsyncQueue* g_async_queue_new (void); +GAsyncQueue* g_async_queue_new_full (GDestroyNotify item_free_func); +GAsyncQueue* g_async_queue_ref (GAsyncQueue *queue); +voidg_async_queue_unref (GAsyncQueue *queue); +voidg_async_queue_push (GAsyncQueue *queue, + gpointer data); +voidg_async_queue_push_sorted (GAsyncQueue *queue, + gpointer data, + GCompareDataFunc func, + gpointer user_data); +gpointerg_async_queue_pop (GAsyncQueue *queue); +gpointerg_async_queue_try_pop (GAsyncQueue *queue); +gpointerg_async_queue_timed_pop (GAsyncQueue *queue, + GTimeVal *end_time); +gintg_async_queue_length (GAsyncQueue *queue); +voidg_async_queue_sort (GAsyncQueue *queue, + GCompareDataFunc func, + gpointer user_data); -voidg_async_queue_lock (GAsyncQueue *queue); -voidg_async_queue_unlock (GAsyncQueue *queue); -voidg_async_queue_ref_unlocked (GAsyncQueue *queue); -voidg_async_queue_unref_and_unlock (GAsyncQueue *queue); -voidg_async_queue_push_unlocked (GAsyncQueue *queue, - gpointer data); -voidg_async_queue_push_sorted_unlocked (GAsyncQueue *queue, - gpointer data, - GCompareDataFunc func, - gpointer user_data); -gpointerg_async_queue_pop_unlocked (GAsyncQueue *queue); -gpointerg_async_queue_try_pop_unlocked (GAsyncQueue *queue); -gpointerg_async_queue_timed_pop_unlocked (GAsyncQueue *queue, - GTimeVal *end_time); -gintg_async_queue_length_unlocked (GAsyncQueue *queue); -voidg_async_queue_sort_unlocked (GAsyncQueue *queue, - GCompareDataFunc func, - gpointer user_data); +voidg_async_queue_lock (GAsyncQueue *queue); +voidg_async_queue_unlock (GAsyncQueue *queue); +voidg_async_queue_ref_unlocked (GAsyncQueue *queue); +voidg_async_queue_unref_and_unlock (GAsyncQueue *queue); +voidg_async_queue_push_unlocked (GAsyncQueue *queue, + gpointer data); +voidg_async_queue_push_sorted_unlocked (GAsyncQueue *queue, + gpointer data, + GCompareDataFunc func, + gpointer user_data); +gpointerg_async_queue_pop_unlocked (GAsyncQueue *queue); +gpointerg_async_queue_try_pop_unlocked (GAsyncQueue *queue); +gpointerg_async_queue_timed_pop_unlocked (GAsyncQueue *queue, + GTimeVal *end_time); +gintg_async_queue_length_unlocked (GAsyncQueue *queue); +voidg_async_queue_sort_unlocked (GAsyncQueue *queue, + GCompareDataFunc func, + gpointer user_data);
@@ -164,9 +144,10 @@ an asynchronous queue. It should only be accessed through the

g_async_queue_new ()

-
GAsyncQueue*        g_async_queue_new                   (void);
+
GAsyncQueue*        g_async_queue_new                   (void);

-Creates a new asynchronous queue with the initial reference count of 1.

+Creates a new asynchronous queue with the initial reference count of 1. +

@@ -179,17 +160,18 @@ Creates a new asynchronous queue with the initial reference count of 1.


g_async_queue_new_full ()

-
GAsyncQueue*        g_async_queue_new_full              (GDestroyNotify item_free_func);
+
GAsyncQueue*        g_async_queue_new_full              (GDestroyNotify item_free_func);

Creates a new asynchronous queue with an initial reference count of 1 and sets up a destroy notify function that is used to free any remaining -queue items when the queue is destroyed after the final unref.

+queue items when the queue is destroyed after the final unref. +

- @@ -205,16 +187,17 @@ queue items when the queue is destroyed after the final unref.


g_async_queue_ref ()

-
GAsyncQueue*        g_async_queue_ref                   (GAsyncQueue *queue);
+
GAsyncQueue*        g_async_queue_ref                   (GAsyncQueue *queue);

Increases the reference count of the asynchronous queue by 1. You -do not need to hold the lock to call this function.

+do not need to hold the lock to call this function. +

item_free_func :

function to free queue elements +function to free queue elements
- @@ -228,18 +211,19 @@ do not need to hold the lock to call this function.


g_async_queue_unref ()

-
void                g_async_queue_unref                 (GAsyncQueue *queue);
+
void                g_async_queue_unref                 (GAsyncQueue *queue);

Decreases the reference count of the asynchronous queue by 1. If the reference count went to 0, the queue will be destroyed and the memory allocated will be freed. So you are not allowed to use the queue afterwards, as it might have disappeared. You do not need to -hold the lock to call this function.

+hold the lock to call this function. +

queue :

a GAsyncQueue. +a GAsyncQueue.
-

queue :

a GAsyncQueue. +a GAsyncQueue.
@@ -247,21 +231,23 @@ hold the lock to call this function.


g_async_queue_push ()

-
void                g_async_queue_push                  (GAsyncQueue *queue,
-                                                         gpointer data);
+
void                g_async_queue_push                  (GAsyncQueue *queue,
+                                                         gpointer data);

-Pushes the data into the queue. data must not be NULL.

+Pushes the data into the queue. data must not be NULL. +

- - @@ -270,10 +256,10 @@ Pushes the data into the

g_async_queue_push_sorted ()

-
void                g_async_queue_push_sorted           (GAsyncQueue *queue,
-                                                         gpointer data,
-                                                         GCompareDataFunc func,
-                                                         gpointer user_data);
+
void                g_async_queue_push_sorted           (GAsyncQueue *queue,
+                                                         gpointer data,
+                                                         GCompareDataFunc func,
+                                                         gpointer user_data);

Inserts data into queue using func to determine the new position. @@ -287,23 +273,24 @@ This function will lock queue before it it when it is finished.

-For an example of func see g_async_queue_sort().

+For an example of func see g_async_queue_sort(). +

queue :

a GAsyncQueue. +a GAsyncQueue.

data :

data to push into the queue. + +data to push into the queue.
- - - - @@ -322,16 +309,17 @@ For an example of func see

g_async_queue_pop ()

-
gpointer            g_async_queue_pop                   (GAsyncQueue *queue);
+
gpointer            g_async_queue_pop                   (GAsyncQueue *queue);

Pops data from the queue. This function blocks until data become -available.

+available. +

queue :

a GAsyncQueue +a GAsyncQueue

data :

the data to push into the queue +the data to push into the queue

func :

the GCompareDataFunc is used to sort queue. This function +the GCompareDataFunc is used to sort queue. This function is passed two elements of the queue. The function should return 0 if they are equal, a negative value if the first element should be higher in the queue or a positive value if the first @@ -312,7 +299,7 @@ For an example of func see user_data :

user data passed to func. +user data passed to func.
- @@ -345,16 +333,17 @@ available.


g_async_queue_try_pop ()

-
gpointer            g_async_queue_try_pop               (GAsyncQueue *queue);
+
gpointer            g_async_queue_try_pop               (GAsyncQueue *queue);

Tries to pop data from the queue. If no data is available, NULL is -returned.

+returned. +

queue :

a GAsyncQueue. +a GAsyncQueue.
- @@ -369,26 +358,27 @@ available immediately.

g_async_queue_timed_pop ()

-
gpointer            g_async_queue_timed_pop             (GAsyncQueue *queue,
-                                                         GTimeVal *end_time);
+
gpointer            g_async_queue_timed_pop             (GAsyncQueue *queue,
+                                                         GTimeVal *end_time);

Pops data from the queue. If no data is received before end_time, NULL is returned.

To easily calculate end_time a combination of g_get_current_time() -and g_time_val_add() can be used.

+and g_time_val_add() can be used. +

queue :

a GAsyncQueue. +a GAsyncQueue.
- - @@ -403,7 +393,7 @@ received before end_time.

g_async_queue_length ()

-
gint                g_async_queue_length                (GAsyncQueue *queue);
+
gint                g_async_queue_length                (GAsyncQueue *queue);

Returns the length of the queue, negative values mean waiting threads, positive values mean available entries in the @@ -411,13 +401,14 @@ threads, positive values mean available entries in the the queue minus the number of waiting threads. Thus a return value of 0 could mean 'n' entries in the queue and 'n' thread waiting. That can happen due to locking of the queue or due to -scheduling.

+scheduling. +

queue :

a GAsyncQueue. +a GAsyncQueue.

end_time :

a GTimeVal, determining the final time. +a GTimeVal, determining the final time.
- @@ -431,9 +422,9 @@ scheduling.


g_async_queue_sort ()

-
void                g_async_queue_sort                  (GAsyncQueue *queue,
-                                                         GCompareDataFunc func,
-                                                         gpointer user_data);
+
void                g_async_queue_sort                  (GAsyncQueue *queue,
+                                                         GCompareDataFunc func,
+                                                         gpointer user_data);

Sorts queue using func.

@@ -445,26 +436,42 @@ it when it is finished. If you were sorting a list of priority numbers to make sure the lowest priority would be at the top of the queue, you could use:

-
- gint32 id1;
- gint32 id2;
-  
- id1 = GPOINTER_TO_INT (element1);
- id2 = GPOINTER_TO_INT (element2);
-  
- return (id1 > id2 ? +1 : id1 == id2 ? 0 : -1);
-
+
+

queue :

a GAsyncQueue. +a GAsyncQueue.
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
gint32 id1;
+gint32 id2;
+ 
+id1 = GPOINTER_TO_INT (element1);
+id2 = GPOINTER_TO_INT (element2);
+ 
+return (id1 > id2 ? +1 : id1 == id2 ? 0 : -1);
+
+ +

+

- - - @@ -484,16 +491,17 @@ lowest priority would be at the top of the queue, you could use:

g_async_queue_lock ()

-
void                g_async_queue_lock                  (GAsyncQueue *queue);
+
void                g_async_queue_lock                  (GAsyncQueue *queue);

Acquires the queue's lock. After that you can only call the g_async_queue_*_unlocked() function variants on that -queue. Otherwise it will deadlock.

+queue. Otherwise it will deadlock. +

queue :

a GAsyncQueue +a GAsyncQueue

func :

the GCompareDataFunc is used to sort queue. This +the GCompareDataFunc is used to sort queue. This function is passed two elements of the queue. The function should return 0 if they are equal, a negative value if the first element should be higher in the queue or a positive @@ -474,7 +481,7 @@ lowest priority would be at the top of the queue, you could use:

user_data :

user data passed to func +user data passed to func
-

queue :

a GAsyncQueue. +a GAsyncQueue.
@@ -501,14 +509,15 @@ Acquires the queue's lock. After that yo

g_async_queue_unlock ()

-
void                g_async_queue_unlock                (GAsyncQueue *queue);
+
void                g_async_queue_unlock                (GAsyncQueue *queue);

-Releases the queue's lock.

+Releases the queue's lock. +

-

queue :

a GAsyncQueue. +a GAsyncQueue.
@@ -516,7 +525,7 @@ Releases the queue's lock.


g_async_queue_ref_unlocked ()

-
void                g_async_queue_ref_unlocked          (GAsyncQueue *queue);
+
void                g_async_queue_ref_unlocked          (GAsyncQueue *queue);

Warning

g_async_queue_ref_unlocked is deprecated and should not be used in newly-written code.

@@ -527,12 +536,13 @@ Increases the reference count of the asynchronous qu

Deprecated: Since 2.8, reference counting is done atomically so g_async_queue_ref() can be used regardless of the queue's -lock.

+lock. +

-

queue :

a GAsyncQueue. +a GAsyncQueue.
@@ -540,7 +550,7 @@ lock.


g_async_queue_unref_and_unlock ()

-
void                g_async_queue_unref_and_unlock      (GAsyncQueue *queue);
+
void                g_async_queue_unref_and_unlock      (GAsyncQueue *queue);

Warning

g_async_queue_unref_and_unlock is deprecated and should not be used in newly-written code.

@@ -554,12 +564,13 @@ destroyed and the memory allocated will be freed.

Deprecated: Since 2.8, reference counting is done atomically so g_async_queue_unref() can be used regardless of the queue's -lock.

+lock. +

-

queue :

a GAsyncQueue. +a GAsyncQueue.
@@ -567,22 +578,24 @@ lock.


g_async_queue_push_unlocked ()

-
void                g_async_queue_push_unlocked         (GAsyncQueue *queue,
-                                                         gpointer data);
+
void                g_async_queue_push_unlocked         (GAsyncQueue *queue,
+                                                         gpointer data);

Pushes the data into the queue. data must not be NULL. This -function must be called while holding the queue's lock.

+function must be called while holding the queue's lock. +

- - @@ -591,10 +604,10 @@ function must be called while holding the queue

g_async_queue_push_sorted_unlocked ()

-
void                g_async_queue_push_sorted_unlocked  (GAsyncQueue *queue,
-                                                         gpointer data,
-                                                         GCompareDataFunc func,
-                                                         gpointer user_data);
+
void                g_async_queue_push_sorted_unlocked  (GAsyncQueue *queue,
+                                                         gpointer data,
+                                                         GCompareDataFunc func,
+                                                         gpointer user_data);

Inserts data into queue using func to determine the new position. @@ -607,23 +620,24 @@ new elements. This function is called while holding the queue's lock.

-For an example of func see g_async_queue_sort().

+For an example of func see g_async_queue_sort(). +

queue :

a GAsyncQueue. +a GAsyncQueue.

data :

data to push into the queue. + +data to push into the queue.
- - - - @@ -642,17 +656,18 @@ For an example of func see

g_async_queue_pop_unlocked ()

-
gpointer            g_async_queue_pop_unlocked          (GAsyncQueue *queue);
+
gpointer            g_async_queue_pop_unlocked          (GAsyncQueue *queue);

Pops data from the queue. This function blocks until data become available. This function must be called while holding the queue's -lock.

+lock. +

queue :

a GAsyncQueue +a GAsyncQueue

data :

the data to push into the queue +the data to push into the queue

func :

the GCompareDataFunc is used to sort queue. This function +the GCompareDataFunc is used to sort queue. This function is passed two elements of the queue. The function should return 0 if they are equal, a negative value if the first element should be higher in the queue or a positive value if the first @@ -632,7 +646,7 @@ For an example of func see user_data :

user data passed to func. +user data passed to func.
- @@ -666,17 +681,18 @@ lock.


g_async_queue_try_pop_unlocked ()

-
gpointer            g_async_queue_try_pop_unlocked      (GAsyncQueue *queue);
+
gpointer            g_async_queue_try_pop_unlocked      (GAsyncQueue *queue);

Tries to pop data from the queue. If no data is available, NULL is returned. This function must be called while holding the queue's -lock.

+lock. +

queue :

a GAsyncQueue. +a GAsyncQueue.
- @@ -691,8 +707,8 @@ available immediately.

g_async_queue_timed_pop_unlocked ()

-
gpointer            g_async_queue_timed_pop_unlocked    (GAsyncQueue *queue,
-                                                         GTimeVal *end_time);
+
gpointer            g_async_queue_timed_pop_unlocked    (GAsyncQueue *queue,
+                                                         GTimeVal *end_time);

Pops data from the queue. If no data is received before end_time, NULL is returned. This function must be called while holding the @@ -700,18 +716,19 @@ Pops data from the queue. If no data is

To easily calculate end_time a combination of g_get_current_time() -and g_time_val_add() can be used.

+and g_time_val_add() can be used. +

queue :

a GAsyncQueue. +a GAsyncQueue.
- - @@ -726,7 +743,7 @@ received before end_time.

g_async_queue_length_unlocked ()

-
gint                g_async_queue_length_unlocked       (GAsyncQueue *queue);
+
gint                g_async_queue_length_unlocked       (GAsyncQueue *queue);

Returns the length of the queue, negative values mean waiting threads, positive values mean available entries in the @@ -735,13 +752,14 @@ the queue minus the number of waiting threads. Thus a return value of 0 could mean 'n' entries in the queue and 'n' thread waiting. That can happen due to locking of the queue or due to scheduling. This function must be called while holding the queue's -lock.

+lock. +

queue :

a GAsyncQueue. +a GAsyncQueue.

end_time :

a GTimeVal, determining the final time. +a GTimeVal, determining the final time.
- @@ -755,25 +773,26 @@ lock.


g_async_queue_sort_unlocked ()

-
void                g_async_queue_sort_unlocked         (GAsyncQueue *queue,
-                                                         GCompareDataFunc func,
-                                                         gpointer user_data);
+
void                g_async_queue_sort_unlocked         (GAsyncQueue *queue,
+                                                         GCompareDataFunc func,
+                                                         gpointer user_data);

Sorts queue using func.

-This function is called while holding the queue's lock.

+This function is called while holding the queue's lock. +

queue :

a GAsyncQueue. +a GAsyncQueue.
- - - @@ -794,6 +813,6 @@ This function is called while holding the queue + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Atomic-Operations.html b/docs/reference/glib/html/glib-Atomic-Operations.html index 5577506..878f199 100644 --- a/docs/reference/glib/html/glib-Atomic-Operations.html +++ b/docs/reference/glib/html/glib-Atomic-Operations.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

queue :

a GAsyncQueue +a GAsyncQueue

func :

the GCompareDataFunc is used to sort queue. This +the GCompareDataFunc is used to sort queue. This function is passed two elements of the queue. The function should return 0 if they are equal, a negative value if the first element should be higher in the queue or a positive @@ -783,7 +802,7 @@ This function is called while holding the queue

user_data :

user data passed to func +user data passed to func
@@ -60,17 +40,25 @@
 #include <glib.h>
 
-gint                g_atomic_int_get                    ();
-void                g_atomic_int_set                    ();
-void                g_atomic_int_add                    ();
-gint                g_atomic_int_exchange_and_add       ();
-gboolean            g_atomic_int_compare_and_exchange   ();
-gpointer            g_atomic_pointer_get                ();
-void                g_atomic_pointer_set                ();
+gint                g_atomic_int_get                    (volatile gint G_GNUC_MAY_ALIAS *atomic);
+void                g_atomic_int_set                    (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint newval);
+void                g_atomic_int_add                    (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint val);
+gint                g_atomic_int_exchange_and_add       (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint val);
+gboolean            g_atomic_int_compare_and_exchange   (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint oldval,
+                                                         gint newval);
+gpointer            g_atomic_pointer_get                (volatile gpointer G_GNUC_MAY_ALIAS *atomic);
+void                g_atomic_pointer_set                (volatile gpointer G_GNUC_MAY_ALIAS *atomic,
+                                                         gpointer newval);
 gboolean            g_atomic_pointer_compare_and_exchange
-                                                        ();
-void                g_atomic_int_inc                    (gint *atomic);
-gboolean            g_atomic_int_dec_and_test           (gint *atomic);
+                                                        (volatile gpointer G_GNUC_MAY_ALIAS *atomic,
+                                                         gpointer oldval,
+                                                         gpointer newval);
+void                g_atomic_int_inc                    (gint *atomic);
+gboolean            g_atomic_int_dec_and_test           (gint *atomic);
 
@@ -123,45 +111,85 @@ functions. Use

Details

g_atomic_int_get ()

-
gint                g_atomic_int_get                    ();
+
gint                g_atomic_int_get                    (volatile gint G_GNUC_MAY_ALIAS *atomic);

Reads the value of the integer pointed to by atomic. Also acts as a memory barrier.

- + + + + + + - + +

atomic :

a pointer to an integer +

Returns :

the value of *atomic

Since 2.4


g_atomic_int_set ()

-
void                g_atomic_int_set                    ();
+
void                g_atomic_int_set                    (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint newval);

Sets the value of the integer pointed to by atomic. Also acts as a memory barrier.

+
++ + + + + + + + + + +

atomic :

a pointer to an integer +

newval :

the new value +

Since 2.10


g_atomic_int_add ()

-
void                g_atomic_int_add                    ();
+
void                g_atomic_int_add                    (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint val);

Atomically adds val to the integer pointed to by atomic. Also acts as a memory barrier.

+
++ + + + + + + + + + +

atomic :

a pointer to an integer. +

val :

the value to add to *atomic. +

Since 2.4


g_atomic_int_exchange_and_add ()

-
gint                g_atomic_int_exchange_and_add       ();
+
gint                g_atomic_int_exchange_and_add       (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint val);

Atomically adds val to the integer pointed to by atomic. It returns the value of *atomic just before the addition took place. @@ -169,18 +197,32 @@ Also acts as a memory barrier.

- + + + + + + + + + + - + +

atomic :

a pointer to an integer. +

val :

the value to add to *atomic. +

Returns :

the value of *atomic before the addition.

Since 2.4


g_atomic_int_compare_and_exchange ()

-
gboolean            g_atomic_int_compare_and_exchange   ();
+
gboolean            g_atomic_int_compare_and_exchange   (volatile gint G_GNUC_MAY_ALIAS *atomic,
+                                                         gint oldval,
+                                                         gint newval);

Compares oldval with the integer pointed to by atomic and if they are equal, atomically exchanges *atomic with newval. @@ -188,48 +230,90 @@ Also acts as a memory barrier.

- + + + + + + + + + + + + + + - + +

atomic :

a pointer to an integer. +

oldval :

the assumed old value of *atomic. +

newval :

the new value of *atomic. +

Returns :

TRUE, if *atomic was equal oldval. FALSE otherwise.

Since 2.4


g_atomic_pointer_get ()

-
gpointer            g_atomic_pointer_get                ();
+
gpointer            g_atomic_pointer_get                (volatile gpointer G_GNUC_MAY_ALIAS *atomic);

Reads the value of the pointer pointed to by atomic. Also acts as a memory barrier.

- + + + + + + - + +

atomic :

a pointer to a gpointer. +

Returns :

the value to add to *atomic.

Since 2.4


g_atomic_pointer_set ()

-
void                g_atomic_pointer_set                ();
+
void                g_atomic_pointer_set                (volatile gpointer G_GNUC_MAY_ALIAS *atomic,
+                                                         gpointer newval);

Sets the value of the pointer pointed to by atomic. Also acts as a memory barrier.

+
++ + + + + + + + + + +

atomic :

a pointer to a gpointer +

newval :

the new value +

Since 2.10


g_atomic_pointer_compare_and_exchange ()

gboolean            g_atomic_pointer_compare_and_exchange
-                                                        ();
+ (volatile gpointer G_GNUC_MAY_ALIAS *atomic, + gpointer oldval, + gpointer newval);

Compares oldval with the pointer pointed to by atomic and if they are equal, atomically exchanges *atomic with newval. @@ -237,19 +321,36 @@ Also acts as a memory barrier.

- + + + + + + + + + + + + + + - + +

atomic :

a pointer to a gpointer. +

oldval :

the assumed old value of *atomic. +

newval :

the new value of *atomic. +

Returns :

TRUE, if *atomic was equal oldval. FALSE otherwise.

Since 2.4


g_atomic_int_inc ()

-
void                g_atomic_int_inc                    (gint *atomic);
+
void                g_atomic_int_inc                    (gint *atomic);

Atomically increments the integer pointed to by atomic by 1.

@@ -266,7 +367,7 @@ Atomically increments the integer pointed to by atom

g_atomic_int_dec_and_test ()

-
gboolean            g_atomic_int_dec_and_test           (gint *atomic);
+
gboolean            g_atomic_int_dec_and_test           (gint *atomic);

Atomically decrements the integer pointed to by atomic by 1.

@@ -307,6 +408,6 @@ decrementing it.
+ Generated by GTK-Doc V1.14
\ No newline at end of file diff --git a/docs/reference/glib/html/glib-Automatic-String-Completion.html b/docs/reference/glib/html/glib-Automatic-String-Completion.html index 6b7e2f6..c9fa459 100644 --- a/docs/reference/glib/html/glib-Automatic-String-Completion.html +++ b/docs/reference/glib/html/glib-Automatic-String-Completion.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -62,25 +42,25 @@ #include <glib.h> GCompletion; -GCompletion* g_completion_new (GCompletionFunc func); -gchar * (*GCompletionFunc) (gpointer ); -voidg_completion_add_items (GCompletion *cmp, - GList *items); -voidg_completion_remove_items (GCompletion *cmp, - GList *items); -voidg_completion_clear_items (GCompletion *cmp); -GList* g_completion_complete (GCompletion *cmp, - const gchar *prefix, - gchar **new_prefix); -GList* g_completion_complete_utf8 (GCompletion *cmp, - const gchar *prefix, - gchar **new_prefix); -voidg_completion_set_compare (GCompletion *cmp, - GCompletionStrncmpFunc strncmp_func); -gint (*GCompletionStrncmpFunc) (const gchar *s1, - const gchar *s2, - gsize n); -voidg_completion_free (GCompletion *cmp); +GCompletion* g_completion_new (GCompletionFunc func); +gchar * (*GCompletionFunc) (gpointer Param1); +voidg_completion_add_items (GCompletion *cmp, + GList *items); +voidg_completion_remove_items (GCompletion *cmp, + GList *items); +voidg_completion_clear_items (GCompletion *cmp); +GList* g_completion_complete (GCompletion *cmp, + const gchar *prefix, + gchar **new_prefix); +GList* g_completion_complete_utf8 (GCompletion *cmp, + const gchar *prefix, + gchar **new_prefix); +voidg_completion_set_compare (GCompletion *cmp, + GCompletionStrncmpFunc strncmp_func); +gint (*GCompletionStrncmpFunc) (const gchar *s1, + const gchar *s2, + gsize n); +voidg_completion_free (GCompletion *cmp);
@@ -104,7 +84,8 @@ pointers to arbitrary data structures. If data structures are used you must provide a GCompletionFunc in g_completion_new(), which retrieves the item's string from the data structure. You can change the way in which strings are compared by setting a different -GCompletionStrncmpFunc in g_completion_set_compare().

+GCompletionStrncmpFunc in g_completion_set_compare(). +

Details

@@ -120,35 +101,36 @@ the way in which strings are compared by setting a different } GCompletion;

-The data structure used for automatic completion.

+The data structure used for automatic completion. +

- - - - - @@ -158,22 +140,23 @@ The data structure used for automatic completion.


g_completion_new ()

-
GCompletion*        g_completion_new                    (GCompletionFunc func);
+
GCompletion*        g_completion_new                    (GCompletionFunc func);

-Creates a new GCompletion.

+Creates a new GCompletion. +

GList *items;

list of target items (strings or data structures). +list of target items (strings or data structures).

GCompletionFunc func;

function which is called to get the string associated with a +function which is called to get the string associated with a target item. It is NULL if the target items are strings.

gchar *prefix;

the last prefix passed to g_completion_complete() or +the last prefix passed to g_completion_complete() or g_completion_complete_utf8().

GList *cache;

the list of items which begin with prefix. +the list of items which begin with prefix.

GCompletionStrncmpFunc strncmp_func;

The function to use when comparing strings. Use +The function to use when comparing strings. Use g_completion_set_compare() to modify this function.
- - @@ -182,22 +165,23 @@ Creates a new

GCompletionFunc ()

-
gchar *             (*GCompletionFunc)                  (gpointer );
+
gchar *             (*GCompletionFunc)                  (gpointer Param1);

Specifies the type of the function passed to g_completion_new(). It should return the string corresponding to the given target item. -This is used when you use data structures as GCompletion items.

+This is used when you use data structures as GCompletion items. +

func :

the function to be called to return the string representing +the function to be called to return the string representing an item in the GCompletion, or NULL if strings are going to be used as the GCompletion items.

Returns :

the new GCompletion. +the new GCompletion.
- - @@ -206,21 +190,22 @@ This is used when you use data structures as

g_completion_add_items ()

-
void                g_completion_add_items              (GCompletion *cmp,
-                                                         GList *items);
+
void                g_completion_add_items              (GCompletion *cmp,
+                                                         GList *items);

-Adds items to the GCompletion.

+Adds items to the GCompletion. +

Param1 :

the completion item. +the completion item.

Returns :

the string corresponding to the item. +the string corresponding to the item.
- - @@ -229,21 +214,22 @@ Adds items to the

g_completion_remove_items ()

-
void                g_completion_remove_items           (GCompletion *cmp,
-                                                         GList *items);
+
void                g_completion_remove_items           (GCompletion *cmp,
+                                                         GList *items);

-Removes items from a GCompletion.

+Removes items from a GCompletion. +

cmp :

the GCompletion. +the GCompletion.

items :

the list of items to add. +the list of items to add.
- - @@ -252,14 +238,15 @@ Removes items from a

g_completion_clear_items ()

-
void                g_completion_clear_items            (GCompletion *cmp);
+
void                g_completion_clear_items            (GCompletion *cmp);

-Removes all items from the GCompletion.

+Removes all items from the GCompletion. +

cmp :

the GCompletion. +the GCompletion.

items :

the items to remove. +the items to remove.
-

cmp :

the GCompletion. +the GCompletion.
@@ -267,29 +254,30 @@ Removes all items from the

g_completion_complete ()

-
GList*              g_completion_complete               (GCompletion *cmp,
-                                                         const gchar *prefix,
-                                                         gchar **new_prefix);
+
GList*              g_completion_complete               (GCompletion *cmp,
+                                                         const gchar *prefix,
+                                                         gchar **new_prefix);

Attempts to complete the string prefix using the GCompletion -target items.

+target items. +

- - - - @@ -307,9 +295,9 @@ target items.


g_completion_complete_utf8 ()

-
GList*              g_completion_complete_utf8          (GCompletion *cmp,
-                                                         const gchar *prefix,
-                                                         gchar **new_prefix);
+
GList*              g_completion_complete_utf8          (GCompletion *cmp,
+                                                         const gchar *prefix,
+                                                         gchar **new_prefix);

Attempts to complete the string prefix using the GCompletion target items. In contrast to g_completion_complete(), this function returns the largest common @@ -318,24 +306,25 @@ character.

You should use this function instead of g_completion_complete() if your -items are UTF-8 strings.

+items are UTF-8 strings. +

cmp :

the GCompletion. +the GCompletion.

prefix :

the prefix string, typically typed by the user, which is +the prefix string, typically typed by the user, which is compared with each of the items.

new_prefix :

if non-NULL, returns the longest prefix which is +if non-NULL, returns the longest prefix which is common to all items that matched prefix, or NULL if no items matched prefix. This string should be freed when no longer needed. @@ -297,7 +285,7 @@ target items.

Returns :

the list of items whose strings begin with prefix. This +the list of items whose strings begin with prefix. This should not be changed.
- - - @@ -354,22 +343,23 @@ not be changed.

g_completion_set_compare ()

-
void                g_completion_set_compare            (GCompletion *cmp,
-                                                         GCompletionStrncmpFunc strncmp_func);
+
void                g_completion_set_compare            (GCompletion *cmp,
+                                                         GCompletionStrncmpFunc strncmp_func);

Sets the function to use for string comparisons. The default string -comparison function is strncmp().

+comparison function is strncmp(). +

cmp :

the GCompletion +the GCompletion

prefix :

the prefix string, typically used by the user, which is compared +the prefix string, typically used by the user, which is compared with each of the items

new_prefix :

if non-NULL, returns the longest prefix which is common to all +if non-NULL, returns the longest prefix which is common to all items that matched prefix, or NULL if no items matched prefix. This string should be freed when no longer needed.
- - @@ -378,34 +368,35 @@ comparison function is strncmp().


GCompletionStrncmpFunc ()

-
gint                (*GCompletionStrncmpFunc)           (const gchar *s1,
-                                                         const gchar *s2,
-                                                         gsize n);
+
gint                (*GCompletionStrncmpFunc)           (const gchar *s1,
+                                                         const gchar *s2,
+                                                         gsize n);

Specifies the type of the function passed to g_completion_set_compare(). This is used when you use strings as -GCompletion items.

+GCompletion items. +

cmp :

a GCompletion. +a GCompletion.

strncmp_func :

the string comparison function. +the string comparison function.
- - - -

s1 :

string to compare with s2. +string to compare with s2.

s2 :

string to compare with s1. +string to compare with s1.

n :

maximal number of bytes to compare. +maximal number of bytes to compare.

Returns :

an integer less than, equal to, or greater than zero if +an integer less than, equal to, or greater than zero if the first n bytes of s1 is found, respectively, to be less than, to match, or to be greater than the first n bytes of s2. @@ -417,14 +408,15 @@ Specifies the type of the function passed to

g_completion_free ()

-
void                g_completion_free                   (GCompletion *cmp);
+
void                g_completion_free                   (GCompletion *cmp);

-Frees all memory used by the GCompletion.

+Frees all memory used by the GCompletion. +

-

cmp :

the GCompletion. +the GCompletion.
@@ -433,6 +425,6 @@ Frees all memory used by the
- Generated by GTK-Doc V1.13
+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Balanced-Binary-Trees.html b/docs/reference/glib/html/glib-Balanced-Binary-Trees.html index df25234..b877113 100644 --- a/docs/reference/glib/html/glib-Balanced-Binary-Trees.html +++ b/docs/reference/glib/html/glib-Balanced-Binary-Trees.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -62,48 +42,48 @@ #include <glib.h> GTree; -GTree* g_tree_new (GCompareFunc key_compare_func); -GTree* g_tree_ref (GTree *tree); -voidg_tree_unref (GTree *tree); -GTree* g_tree_new_with_data (GCompareDataFunc key_compare_func, - gpointer key_compare_data); -GTree* g_tree_new_full (GCompareDataFunc key_compare_func, - gpointer key_compare_data, - GDestroyNotify key_destroy_func, - GDestroyNotify value_destroy_func); -voidg_tree_insert (GTree *tree, - gpointer key, - gpointer value); -voidg_tree_replace (GTree *tree, - gpointer key, - gpointer value); -gintg_tree_nnodes (GTree *tree); -gintg_tree_height (GTree *tree); -gpointerg_tree_lookup (GTree *tree, - gconstpointer key); -gbooleang_tree_lookup_extended (GTree *tree, - gconstpointer lookup_key, - gpointer *orig_key, - gpointer *value); -voidg_tree_foreach (GTree *tree, - GTraverseFunc func, - gpointer user_data); -voidg_tree_traverse (GTree *tree, - GTraverseFunc traverse_func, - GTraverseType traverse_type, - gpointer user_data); -gboolean (*GTraverseFunc) (gpointer key, - gpointer value, - gpointer data); +GTree* g_tree_new (GCompareFunc key_compare_func); +GTree* g_tree_ref (GTree *tree); +voidg_tree_unref (GTree *tree); +GTree* g_tree_new_with_data (GCompareDataFunc key_compare_func, + gpointer key_compare_data); +GTree* g_tree_new_full (GCompareDataFunc key_compare_func, + gpointer key_compare_data, + GDestroyNotify key_destroy_func, + GDestroyNotify value_destroy_func); +voidg_tree_insert (GTree *tree, + gpointer key, + gpointer value); +voidg_tree_replace (GTree *tree, + gpointer key, + gpointer value); +gintg_tree_nnodes (GTree *tree); +gintg_tree_height (GTree *tree); +gpointerg_tree_lookup (GTree *tree, + gconstpointer key); +gbooleang_tree_lookup_extended (GTree *tree, + gconstpointer lookup_key, + gpointer *orig_key, + gpointer *value); +voidg_tree_foreach (GTree *tree, + GTraverseFunc func, + gpointer user_data); +voidg_tree_traverse (GTree *tree, + GTraverseFunc traverse_func, + GTraverseType traverse_type, + gpointer user_data); +gboolean (*GTraverseFunc) (gpointer key, + gpointer value, + gpointer data); enum GTraverseType; -gpointerg_tree_search (GTree *tree, - GCompareFunc search_func, - gconstpointer user_data); -gbooleang_tree_remove (GTree *tree, - gconstpointer key); -gbooleang_tree_steal (GTree *tree, - gconstpointer key); -voidg_tree_destroy (GTree *tree); +gpointerg_tree_search (GTree *tree, + GCompareFunc search_func, + gconstpointer user_data); +gbooleang_tree_remove (GTree *tree, + gconstpointer key); +gbooleang_tree_steal (GTree *tree, + gconstpointer key); +voidg_tree_destroy (GTree *tree);
@@ -135,7 +115,8 @@ the traversal, use g_tree_remove().

-To destroy a GTree, use g_tree_destroy().

+To destroy a GTree, use g_tree_destroy(). +

Details

@@ -145,20 +126,22 @@ To destroy a The GTree struct is an opaque data structure representing a Balanced Binary Tree. It -should be accessed only by using the following functions.

+should be accessed only by using the following functions. +


g_tree_new ()

-
GTree*              g_tree_new                          (GCompareFunc key_compare_func);
+
GTree*              g_tree_new                          (GCompareFunc key_compare_func);

-Creates a new GTree.

+Creates a new GTree. +

-

key_compare_func :

the function used to order the nodes in the GTree. +the function used to order the nodes in the GTree. It should return values similar to the standard strcmp() function - 0 if the two arguments are equal, a negative value if the first argument comes before the second, or a positive value if the first argument comes @@ -176,16 +159,17 @@ Creates a new

g_tree_ref ()

-
GTree*              g_tree_ref                          (GTree *tree);
+
GTree*              g_tree_ref                          (GTree *tree);

Increments the reference count of tree by one. It is safe to call -this function from any thread.

+this function from any thread. +

- @@ -201,7 +185,7 @@ this function from any thread.


g_tree_unref ()

-
void                g_tree_unref                        (GTree *tree);
+
void                g_tree_unref                        (GTree *tree);

Decrements the reference count of tree by one. If the reference count drops to 0, all keys and values will be destroyed (if destroy @@ -209,12 +193,13 @@ functions were specified) and all memory allocated by

-It is safe to call this function from any thread.

+It is safe to call this function from any thread. +

tree :

a GTree. +a GTree.
-

tree :

a GTree. +a GTree.
@@ -223,22 +208,23 @@ It is safe to call this function from any thread.


g_tree_new_with_data ()

-
GTree*              g_tree_new_with_data                (GCompareDataFunc key_compare_func,
-                                                         gpointer key_compare_data);
+
GTree*              g_tree_new_with_data                (GCompareDataFunc key_compare_func,
+                                                         gpointer key_compare_data);

Creates a new GTree with a comparison function that accepts user data. -See g_tree_new() for more details.

+See g_tree_new() for more details. +

- - @@ -252,37 +238,38 @@ See

g_tree_new_full ()

-
GTree*              g_tree_new_full                     (GCompareDataFunc key_compare_func,
-                                                         gpointer key_compare_data,
-                                                         GDestroyNotify key_destroy_func,
-                                                         GDestroyNotify value_destroy_func);
+
GTree*              g_tree_new_full                     (GCompareDataFunc key_compare_func,
+                                                         gpointer key_compare_data,
+                                                         GDestroyNotify key_destroy_func,
+                                                         GDestroyNotify value_destroy_func);

Creates a new GTree like g_tree_new() and allows to specify functions to free the memory allocated for the key and value that get called when -removing the entry from the GTree.

+removing the entry from the GTree. +

key_compare_func :

qsort()-style comparison function. +qsort()-style comparison function.

key_compare_data :

data to pass to comparison function. +data to pass to comparison function.
- - - - @@ -298,9 +285,9 @@ removing the entry from the

g_tree_insert ()

-
void                g_tree_insert                       (GTree *tree,
-                                                         gpointer key,
-                                                         gpointer value);
+
void                g_tree_insert                       (GTree *tree,
+                                                         gpointer key,
+                                                         gpointer value);

Inserts a key/value pair into a GTree. If the given key already exists in the GTree its corresponding value is set to the new value. If you @@ -310,23 +297,24 @@ creating the

The tree is automatically 'balanced' as new key/value pairs are added, -so that the distance from the root to every leaf is as small as possible.

+so that the distance from the root to every leaf is as small as possible. +

key_compare_func :

qsort()-style comparison function. +qsort()-style comparison function.

key_compare_data :

data to pass to comparison function. +data to pass to comparison function.

key_destroy_func :

a function to free the memory allocated for the key +a function to free the memory allocated for the key used when removing the entry from the GTree or NULL if you don't want to supply such a function.

value_destroy_func :

a function to free the memory allocated for the +a function to free the memory allocated for the value used when removing the entry from the GTree or NULL if you don't want to supply such a function.
- - - @@ -335,9 +323,9 @@ so that the distance from the root to every leaf is as small as possible.


g_tree_replace ()

-
void                g_tree_replace                      (GTree *tree,
-                                                         gpointer key,
-                                                         gpointer value);
+
void                g_tree_replace                      (GTree *tree,
+                                                         gpointer key,
+                                                         gpointer value);

Inserts a new key and value into a GTree similar to g_tree_insert(). The difference is that if the key already exists in the GTree, it gets @@ -348,23 +336,24 @@ freed using that function.

The tree is automatically 'balanced' as new key/value pairs are added, -so that the distance from the root to every leaf is as small as possible.

+so that the distance from the root to every leaf is as small as possible. +

tree :

a GTree. +a GTree.

key :

the key to insert. +the key to insert.

value :

the value corresponding to the key. +the value corresponding to the key.
- - - @@ -373,15 +362,16 @@ so that the distance from the root to every leaf is as small as possible.


g_tree_nnodes ()

-
gint                g_tree_nnodes                       (GTree *tree);
+
gint                g_tree_nnodes                       (GTree *tree);

-Gets the number of nodes in a GTree.

+Gets the number of nodes in a GTree. +

tree :

a GTree. +a GTree.

key :

the key to insert. +the key to insert.

value :

the value corresponding to the key. +the value corresponding to the key.
- @@ -395,20 +385,21 @@ Gets the number of nodes in a

g_tree_height ()

-
gint                g_tree_height                       (GTree *tree);
+
gint                g_tree_height                       (GTree *tree);

Gets the height of a GTree.

If the GTree contains no nodes, the height is 0. If the GTree contains only one root node the height is 1. -If the root node has children the height is 2, etc.

+If the root node has children the height is 2, etc. +

tree :

a GTree. +a GTree.
- @@ -422,23 +413,24 @@ If the root node has children the height is 2, etc.


g_tree_lookup ()

-
gpointer            g_tree_lookup                       (GTree *tree,
-                                                         gconstpointer key);
+
gpointer            g_tree_lookup                       (GTree *tree,
+                                                         gconstpointer key);

Gets the value corresponding to the given key. Since a GTree is automatically balanced as key/value pairs are added, key lookup is very -fast.

+fast. +

tree :

a GTree. +a GTree.
- - @@ -453,36 +445,37 @@ not found.

g_tree_lookup_extended ()

-
gboolean            g_tree_lookup_extended              (GTree *tree,
-                                                         gconstpointer lookup_key,
-                                                         gpointer *orig_key,
-                                                         gpointer *value);
+
gboolean            g_tree_lookup_extended              (GTree *tree,
+                                                         gconstpointer lookup_key,
+                                                         gpointer *orig_key,
+                                                         gpointer *value);

Looks up a key in the GTree, returning the original key and the associated value and a gboolean which is TRUE if the key was found. This is useful if you need to free the memory allocated for the original key, -for example before calling g_tree_remove().

+for example before calling g_tree_remove(). +

tree :

a GTree. +a GTree.

key :

the key to look up. +the key to look up.
- - - - @@ -496,9 +489,9 @@ for example before calling

g_tree_foreach ()

-
void                g_tree_foreach                      (GTree *tree,
-                                                         GTraverseFunc func,
-                                                         gpointer user_data);
+
void                g_tree_foreach                      (GTree *tree,
+                                                         GTraverseFunc func,
+                                                         gpointer user_data);

Calls the given function for each of the key/value pairs in the GTree. The function is passed the key and value of each pair, and the given @@ -508,24 +501,25 @@ The function is passed the key and value of each pair, and the given The tree may not be modified while iterating over it (you can't add/remove items). To remove all items matching a predicate, you need to add each item to a list in your GTraverseFunc as you walk over -the tree, then walk the list and remove each item.

+the tree, then walk the list and remove each item. +

tree :

a GTree. +a GTree.

lookup_key :

the key to look up. +the key to look up.

orig_key :

returns the original key. +returns the original key.

value :

returns the value associated with the key. +returns the value associated with the key.
- - - @@ -534,10 +528,10 @@ the tree, then walk the list and remove each item.


g_tree_traverse ()

-
void                g_tree_traverse                     (GTree *tree,
-                                                         GTraverseFunc traverse_func,
-                                                         GTraverseType traverse_type,
-                                                         gpointer user_data);
+
void                g_tree_traverse                     (GTree *tree,
+                                                         GTraverseFunc traverse_func,
+                                                         GTraverseType traverse_type,
+                                                         gpointer user_data);

Warning

g_tree_traverse has been deprecated since version 2.2 and should not be used in newly-written code. The order of a balanced tree is somewhat arbitrary. If you @@ -546,30 +540,31 @@ instead. If you really need to visit nodes in a different order, consider using an N-ary Tree.

-Calls the given function for each node in the GTree.

+Calls the given function for each node in the GTree. +

tree :

a GTree. +a GTree.

func :

the function to call for each node visited. If this function +the function to call for each node visited. If this function returns TRUE, the traversal is stopped.

user_data :

user data to pass to the function. +user data to pass to the function.
- - - - @@ -578,35 +573,37 @@ Calls the given function for each node in the

GTraverseFunc ()

-
gboolean            (*GTraverseFunc)                    (gpointer key,
-                                                         gpointer value,
-                                                         gpointer data);
+
gboolean            (*GTraverseFunc)                    (gpointer key,
+                                                         gpointer value,
+                                                         gpointer data);

Specifies the type of function passed to g_tree_traverse(). It is passed the key and value of each node, together with the user_data parameter passed to g_tree_traverse(). If the function returns -TRUE, the traversal is stopped.

+TRUE, the traversal is stopped. +

tree :

a GTree. +a GTree.

traverse_func :

the function to call for each node visited. If this +the function to call for each node visited. If this function returns TRUE, the traversal is stopped.

traverse_type :

the order in which nodes are visited, one of G_IN_ORDER, +the order in which nodes are visited, one of G_IN_ORDER, G_PRE_ORDER and G_POST_ORDER.

user_data :

user data to pass to the function. +user data to pass to the function.
- - - - @@ -625,13 +622,14 @@ parameter passed to g_tree_traverse(), -g_node_traverse() and g_node_find().

+g_node_traverse() and g_node_find(). +

key :

a key of a GTree node. +a key of a GTree node.

value :

the value corresponding to the key. +the value corresponding to the key.

data :

user data passed to g_tree_traverse(). +user data passed to g_tree_traverse().

Returns :

TRUE to stop the traversal. + +TRUE to stop the traversal.
- - - -

G_IN_ORDER

vists a node's left child first, then the node itself, +vists a node's left child first, then the node itself, then its right child. This is the one to use if you want the output sorted according to the compare function. @@ -639,17 +637,17 @@ Specifies the type of traveral performed by G_PRE_ORDER

visits a node, then its children. +visits a node, then its children.

G_POST_ORDER

visits the node's children, then the node itself. +visits the node's children, then the node itself.

G_LEVEL_ORDER

is not implemented for Balanced Binary +is not implemented for Balanced Binary Trees. For N-ary Trees, it vists the root node first, then its children, then its grandchildren, and so on. Note that this is less @@ -662,9 +660,9 @@ Specifies the type of traveral performed by

g_tree_search ()

-
gpointer            g_tree_search                       (GTree *tree,
-                                                         GCompareFunc search_func,
-                                                         gconstpointer user_data);
+
gpointer            g_tree_search                       (GTree *tree,
+                                                         GCompareFunc search_func,
+                                                         gconstpointer user_data);

Searches a GTree using search_func.

@@ -674,23 +672,24 @@ the tree, and the passed in user_data. I key/value pair, then g_tree_search_func() will return the value of that pair. If search_func returns -1, searching will proceed among the key/value pairs that have a smaller key; if search_func returns 1, -searching will proceed among the key/value pairs that have a larger key.

+searching will proceed among the key/value pairs that have a larger key. +

- - - @@ -706,8 +705,8 @@ was not found.

g_tree_remove ()

-
gboolean            g_tree_remove                       (GTree *tree,
-                                                         gconstpointer key);
+
gboolean            g_tree_remove                       (GTree *tree,
+                                                         gconstpointer key);

Removes a key/value pair from a GTree.

@@ -715,18 +714,19 @@ Removes a key/value pair from a GTree was created using g_tree_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. -If the key does not exist in the GTree, the function does nothing.

+If the key does not exist in the GTree, the function does nothing. +

tree :

a GTree. +a GTree.

search_func :

a function used to search the GTree. +a function used to search the GTree.

user_data :

the data passed as the second argument to the search_func +the data passed as the second argument to the search_func function.
- - @@ -741,25 +741,26 @@ If the key does not exist in the

g_tree_steal ()

-
gboolean            g_tree_steal                        (GTree *tree,
-                                                         gconstpointer key);
+
gboolean            g_tree_steal                        (GTree *tree,
+                                                         gconstpointer key);

Removes a key and its associated value from a GTree without calling the key and value destroy functions.

-If the key does not exist in the GTree, the function does nothing.

+If the key does not exist in the GTree, the function does nothing. +

tree :

a GTree. +a GTree.

key :

the key to remove. +the key to remove.
- - @@ -774,19 +775,20 @@ If the key does not exist in the

g_tree_destroy ()

-
void                g_tree_destroy                      (GTree *tree);
+
void                g_tree_destroy                      (GTree *tree);

Removes all keys and values from the GTree and decreases its reference count by one. If keys and/or values are dynamically allocated, you should either free them first or create the GTree using g_tree_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values before destroying -the GTree.

+the GTree. +

tree :

a GTree. +a GTree.

key :

the key to remove. +the key to remove.
-

tree :

a GTree. +a GTree.
@@ -795,6 +797,6 @@ the < + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Base64-Encoding.html b/docs/reference/glib/html/glib-Base64-Encoding.html index 884fe80..9616b1b 100644 --- a/docs/reference/glib/html/glib-Base64-Encoding.html +++ b/docs/reference/glib/html/glib-Base64-Encoding.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -60,27 +40,27 @@
 #include <glib.h>
 
-gsize               g_base64_encode_step                (const guchar *in,
-                                                         gsize len,
-                                                         gboolean break_lines,
-                                                         gchar *out,
-                                                         gint *state,
-                                                         gint *save);
-gsize               g_base64_encode_close               (gboolean break_lines,
-                                                         gchar *out,
-                                                         gint *state,
-                                                         gint *save);
-gchar*              g_base64_encode                     (const guchar *data,
-                                                         gsize len);
-gsize               g_base64_decode_step                (const gchar *in,
-                                                         gsize len,
-                                                         guchar *out,
-                                                         gint *state,
-                                                         guint *save);
-guchar *            g_base64_decode                     (const gchar *text,
-                                                         gsize *out_len);
-guchar *            g_base64_decode_inplace             (gchar *text,
-                                                         gsize *out_len);
+gsize               g_base64_encode_step                (const guchar *in,
+                                                         gsize len,
+                                                         gboolean break_lines,
+                                                         gchar *out,
+                                                         gint *state,
+                                                         gint *save);
+gsize               g_base64_encode_close               (gboolean break_lines,
+                                                         gchar *out,
+                                                         gint *state,
+                                                         gint *save);
+gchar*              g_base64_encode                     (const guchar *data,
+                                                         gsize len);
+gsize               g_base64_decode_step                (const gchar *in,
+                                                         gsize len,
+                                                         guchar *out,
+                                                         gint *state,
+                                                         guint *save);
+guchar *            g_base64_decode                     (const gchar *text,
+                                                         gsize *out_len);
+guchar *            g_base64_decode_inplace             (gchar *text,
+                                                         gsize *out_len);
 
@@ -101,18 +81,19 @@ GLib supports incremental encoding using g_base64_decode_inplace().

-Support for Base64 encoding has been added in GLib 2.12.

+Support for Base64 encoding has been added in GLib 2.12. +

Details

g_base64_encode_step ()

-
gsize               g_base64_encode_step                (const guchar *in,
-                                                         gsize len,
-                                                         gboolean break_lines,
-                                                         gchar *out,
-                                                         gint *state,
-                                                         gint *save);
+
gsize               g_base64_encode_step                (const guchar *in,
+                                                         gsize len,
+                                                         gboolean break_lines,
+                                                         gchar *out,
+                                                         gint *state,
+                                                         gint *save);

Incrementally encode a sequence of binary data into its Base-64 stringified representation. By calling this function multiple times you can convert @@ -132,38 +113,39 @@ non-zero state). If you enable line-breaking you will need at least:

break_lines is typically used when putting base64-encoded data in emails. It breaks the lines at 72 columns instead of putting all of the text on -the same line. This avoids problems with long lines in the email system.

+the same line. This avoids problems with long lines in the email system. +

- - - - - - @@ -179,38 +161,39 @@ the same line. This avoids problems with long lines in the email system.


g_base64_encode_close ()

-
gsize               g_base64_encode_close               (gboolean break_lines,
-                                                         gchar *out,
-                                                         gint *state,
-                                                         gint *save);
+
gsize               g_base64_encode_close               (gboolean break_lines,
+                                                         gchar *out,
+                                                         gint *state,
+                                                         gint *save);

Flush the status from a sequence of calls to g_base64_encode_step().

The output buffer must be large enough to fit all the data that will be written to it. It will need up to 4 bytes, or up to 5 bytes if -line-breaking is enabled.

+line-breaking is enabled. +

in :

the binary data to encode +the binary data to encode

len :

the length of in +the length of in

break_lines :

whether to break long lines +whether to break long lines

out :

pointer to destination buffer +pointer to destination buffer

state :

Saved state between steps, initialize to 0 +Saved state between steps, initialize to 0

save :

Saved state between steps, initialize to 0 +Saved state between steps, initialize to 0
- - - - @@ -226,22 +209,23 @@ line-breaking is enabled.


g_base64_encode ()

-
gchar*              g_base64_encode                     (const guchar *data,
-                                                         gsize len);
+
gchar*              g_base64_encode                     (const guchar *data,
+                                                         gsize len);

Encode a sequence of binary data into its Base-64 stringified -representation.

+representation. +

break_lines :

whether to break long lines +whether to break long lines

out :

pointer to destination buffer +pointer to destination buffer

state :

Saved state from g_base64_encode_step() +Saved state from g_base64_encode_step()

save :

Saved state from g_base64_encode_step() +Saved state from g_base64_encode_step()
- - @@ -259,11 +243,11 @@ representation.


g_base64_decode_step ()

-
gsize               g_base64_decode_step                (const gchar *in,
-                                                         gsize len,
-                                                         guchar *out,
-                                                         gint *state,
-                                                         guint *save);
+
gsize               g_base64_decode_step                (const gchar *in,
+                                                         gsize len,
+                                                         guchar *out,
+                                                         gint *state,
+                                                         guint *save);

Incrementally decode a sequence of binary data from its Base-64 stringified representation. By calling this function multiple times you can convert @@ -273,33 +257,34 @@ data in chunks to avoid having to have the full encoded data in memory. The output buffer must be large enough to fit all the data that will be written to it. Since base64 encodes 3 bytes in 4 chars you need at least: (len / 4) * 3 + 3 bytes (+ 3 may be needed in case of non-zero -state).

+state). +

data :

the binary data to encode +the binary data to encode

len :

the length of data +the length of data
- - - - - @@ -315,21 +300,22 @@ state).


g_base64_decode ()

-
guchar *            g_base64_decode                     (const gchar *text,
-                                                         gsize *out_len);
+
guchar *            g_base64_decode                     (const gchar *text,
+                                                         gsize *out_len);

-Decode a sequence of Base-64 encoded text into binary data

+Decode a sequence of Base-64 encoded text into binary data +

in :

binary input data +binary input data

len :

max length of in data to decode +max length of in data to decode

out :

output buffer +output buffer

state :

Saved state between steps, initialize to 0 +Saved state between steps, initialize to 0

save :

Saved state between steps, initialize to 0 +Saved state between steps, initialize to 0
- - @@ -347,22 +333,23 @@ Decode a sequence of Base-64 encoded text into binary data


g_base64_decode_inplace ()

-
guchar *            g_base64_decode_inplace             (gchar *text,
-                                                         gsize *out_len);
+
guchar *            g_base64_decode_inplace             (gchar *text,
+                                                         gsize *out_len);

Decode a sequence of Base-64 encoded text into binary data -by overwriting the input data.

+by overwriting the input data. +

text :

zero-terminated string with base64 text to decode +zero-terminated string with base64 text to decode

out_len :

The length of the decoded data is written here +The length of the decoded data is written here
- - @@ -380,6 +367,6 @@ by overwriting the input data.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Basic-Types.html b/docs/reference/glib/html/glib-Basic-Types.html index 0ef9728..9f06d23 100644 --- a/docs/reference/glib/html/glib-Basic-Types.html +++ b/docs/reference/glib/html/glib-Basic-Types.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

text :

zero-terminated string with base64 text to decode +zero-terminated string with base64 text to decode

out_len :

The length of the decoded data is written here +The length of the decoded data is written here
@@ -515,6 +495,6 @@ Since: 2.18 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Bookmark-file-parser.html b/docs/reference/glib/html/glib-Bookmark-file-parser.html index fdccec7..ea0cbc1 100644 --- a/docs/reference/glib/html/glib-Bookmark-file-parser.html +++ b/docs/reference/glib/html/glib-Bookmark-file-parser.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -63,139 +43,139 @@ GBookmarkFile; #define G_BOOKMARK_FILE_ERROR enum GBookmarkFileError; -GBookmarkFile * g_bookmark_file_new (void); -voidg_bookmark_file_free (GBookmarkFile *bookmark); -gbooleang_bookmark_file_load_from_file (GBookmarkFile *bookmark, - const gchar *filename, - GError **error); -gbooleang_bookmark_file_load_from_data (GBookmarkFile *bookmark, - const gchar *data, - gsize length, - GError **error); -gbooleang_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark, - const gchar *file, - gchar **full_path, - GError **error); -gchar * g_bookmark_file_to_data (GBookmarkFile *bookmark, - gsize *length, - GError **error); -gbooleang_bookmark_file_to_file (GBookmarkFile *bookmark, - const gchar *filename, - GError **error); -gbooleang_bookmark_file_has_item (GBookmarkFile *bookmark, - const gchar *uri); -gbooleang_bookmark_file_has_group (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *group, - GError **error); -gbooleang_bookmark_file_has_application (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *name, - GError **error); -gintg_bookmark_file_get_size (GBookmarkFile *bookmark); -gchar ** g_bookmark_file_get_uris (GBookmarkFile *bookmark, - gsize *length); +GBookmarkFile * g_bookmark_file_new (void); +voidg_bookmark_file_free (GBookmarkFile *bookmark); +gbooleang_bookmark_file_load_from_file (GBookmarkFile *bookmark, + const gchar *filename, + GError **error); +gbooleang_bookmark_file_load_from_data (GBookmarkFile *bookmark, + const gchar *data, + gsize length, + GError **error); +gbooleang_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark, + const gchar *file, + gchar **full_path, + GError **error); +gchar * g_bookmark_file_to_data (GBookmarkFile *bookmark, + gsize *length, + GError **error); +gbooleang_bookmark_file_to_file (GBookmarkFile *bookmark, + const gchar *filename, + GError **error); +gbooleang_bookmark_file_has_item (GBookmarkFile *bookmark, + const gchar *uri); +gbooleang_bookmark_file_has_group (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *group, + GError **error); +gbooleang_bookmark_file_has_application (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *name, + GError **error); +gintg_bookmark_file_get_size (GBookmarkFile *bookmark); +gchar ** g_bookmark_file_get_uris (GBookmarkFile *bookmark, + gsize *length); -gchar * g_bookmark_file_get_title (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gchar * g_bookmark_file_get_description (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gchar * g_bookmark_file_get_mime_type (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gbooleang_bookmark_file_get_is_private (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gbooleang_bookmark_file_get_icon (GBookmarkFile *bookmark, - const gchar *uri, - gchar **href, - gchar **mime_type, - GError **error); -time_tg_bookmark_file_get_added (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -time_tg_bookmark_file_get_modified (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -time_tg_bookmark_file_get_visited (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gchar ** g_bookmark_file_get_groups (GBookmarkFile *bookmark, - const gchar *uri, - gsize *length, - GError **error); -gchar ** g_bookmark_file_get_applications (GBookmarkFile *bookmark, - const gchar *uri, - gsize *length, - GError **error); -gbooleang_bookmark_file_get_app_info (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *name, - gchar **exec, - guint *count, - time_t *stamp, - GError **error); +gchar * g_bookmark_file_get_title (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gchar * g_bookmark_file_get_description (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gchar * g_bookmark_file_get_mime_type (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gbooleang_bookmark_file_get_is_private (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gbooleang_bookmark_file_get_icon (GBookmarkFile *bookmark, + const gchar *uri, + gchar **href, + gchar **mime_type, + GError **error); +time_tg_bookmark_file_get_added (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +time_tg_bookmark_file_get_modified (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +time_tg_bookmark_file_get_visited (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gchar ** g_bookmark_file_get_groups (GBookmarkFile *bookmark, + const gchar *uri, + gsize *length, + GError **error); +gchar ** g_bookmark_file_get_applications (GBookmarkFile *bookmark, + const gchar *uri, + gsize *length, + GError **error); +gbooleang_bookmark_file_get_app_info (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *name, + gchar **exec, + guint *count, + time_t *stamp, + GError **error); -voidg_bookmark_file_set_title (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *title); -voidg_bookmark_file_set_description (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *description); -voidg_bookmark_file_set_mime_type (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *mime_type); -voidg_bookmark_file_set_is_private (GBookmarkFile *bookmark, - const gchar *uri, - gboolean is_private); -voidg_bookmark_file_set_icon (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *href, - const gchar *mime_type); -voidg_bookmark_file_set_added (GBookmarkFile *bookmark, - const gchar *uri, - time_t added); -voidg_bookmark_file_set_groups (GBookmarkFile *bookmark, - const gchar *uri, - const gchar **groups, - gsize length); -voidg_bookmark_file_set_modified (GBookmarkFile *bookmark, - const gchar *uri, - time_t modified); -voidg_bookmark_file_set_visited (GBookmarkFile *bookmark, - const gchar *uri, - time_t visited); -gbooleang_bookmark_file_set_app_info (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *name, - const gchar *exec, - gint count, - time_t stamp, - GError **error); -voidg_bookmark_file_add_group (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *group); -voidg_bookmark_file_add_application (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *name, - const gchar *exec); -gbooleang_bookmark_file_remove_group (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *group, - GError **error); -gbooleang_bookmark_file_remove_application (GBookmarkFile *bookmark, - const gchar *uri, - const gchar *name, - GError **error); -gbooleang_bookmark_file_remove_item (GBookmarkFile *bookmark, - const gchar *uri, - GError **error); -gbooleang_bookmark_file_move_item (GBookmarkFile *bookmark, - const gchar *old_uri, - const gchar *new_uri, - GError **error); +voidg_bookmark_file_set_title (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *title); +voidg_bookmark_file_set_description (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *description); +voidg_bookmark_file_set_mime_type (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *mime_type); +voidg_bookmark_file_set_is_private (GBookmarkFile *bookmark, + const gchar *uri, + gboolean is_private); +voidg_bookmark_file_set_icon (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *href, + const gchar *mime_type); +voidg_bookmark_file_set_added (GBookmarkFile *bookmark, + const gchar *uri, + time_t added); +voidg_bookmark_file_set_groups (GBookmarkFile *bookmark, + const gchar *uri, + const gchar **groups, + gsize length); +voidg_bookmark_file_set_modified (GBookmarkFile *bookmark, + const gchar *uri, + time_t modified); +voidg_bookmark_file_set_visited (GBookmarkFile *bookmark, + const gchar *uri, + time_t visited); +gbooleang_bookmark_file_set_app_info (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *name, + const gchar *exec, + gint count, + time_t stamp, + GError **error); +voidg_bookmark_file_add_group (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *group); +voidg_bookmark_file_add_application (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *name, + const gchar *exec); +gbooleang_bookmark_file_remove_group (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *group, + GError **error); +gbooleang_bookmark_file_remove_application (GBookmarkFile *bookmark, + const gchar *uri, + const gchar *name, + GError **error); +gbooleang_bookmark_file_remove_item (GBookmarkFile *bookmark, + const gchar *uri, + GError **error); +gbooleang_bookmark_file_move_item (GBookmarkFile *bookmark, + const gchar *old_uri, + const gchar *new_uri, + GError **error);
@@ -227,33 +207,61 @@ the bookmark as "private" to the applications and groups that has it registered; the URI and MIME type of an icon, to be used when displaying the bookmark inside a GUI.

-
-
-<?xml version="1.0"?>
-<!DOCTYPE xbel PUBLIC
-  "+//IDN python.org//DTD XML Bookmark Exchange Language 1.0//EN//XML"
-  "http://www.python.org/topics/xml/dtds/xbel-1.0.dtd">
-<xbel version="1.0"
-      xmlns:mime="http://www.freedesktop.org/standards/shared-mime-info"
-      xmlns:bookmark="http://www.freedesktop.org/standards/desktop-bookmarks">
-  <bookmark href="file:///home/ebassi/bookmark-spec/bookmark-spec.xml">
-    <title>Desktop Bookmarks Spec</title>
-    <info>
-      <metadata owner="http://freedesktop.org">
-        <mime:mime-type>text/xml</mime:mime-type>
-	<bookmark:applications>
-          <bookmark:application name="GEdit" count="2" exec="gedit %u" timestamp="1115726763"/>
-          <bookmark:application name="GViM" count="7" exec="gvim %f" timestamp="1115726812"/>
-	</bookmark:applications>
-	<bookmark:groups>
-	  <bookmark:group>Editors</bookmark:group>
-	</bookmark:groups>
-      </metadata>
-    </info>
-  </bookmark>
-</xbel>
+
+
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
<?xml version="1.0"?>
+<!DOCTYPE xbel PUBLIC
+  "+//IDN python.org//DTD XML Bookmark Exchange Language 1.0//EN//XML"
+  "http://www.python.org/topics/xml/dtds/xbel-1.0.dtd">
+<xbel version="1.0"
+      xmlns:mime="http://www.freedesktop.org/standards/shared-mime-info"
+      xmlns:bookmark="http://www.freedesktop.org/standards/desktop-bookmarks">
+  <bookmark href="file:///home/ebassi/bookmark-spec/bookmark-spec.xml">
+    <title>Desktop Bookmarks Spec</title>
+    <info>
+      <metadata owner="http://freedesktop.org">
+        <mime:mime-type>text/xml</mime:mime-type>
+    <bookmark:applications>
+          <bookmark:application name="GEdit" count="2" exec="gedit %u" timestamp="1115726763"/>
+          <bookmark:application name="GViM" count="7" exec="gvim %f" timestamp="1115726812"/>
+    </bookmark:applications>
+    <bookmark:groups>
+      <bookmark:group>Editors</bookmark:group>
+    </bookmark:groups>
+      </metadata>
+    </info>
+  </bookmark>
+</xbel>
+ -

A bookmark file might contain more than one bookmark; each bookmark is accessed through its URI. @@ -360,14 +368,15 @@ unknown encoding


g_bookmark_file_new ()

-
GBookmarkFile *     g_bookmark_file_new                 (void);
+
GBookmarkFile *     g_bookmark_file_new                 (void);

Creates a new empty GBookmarkFile object.

Use g_bookmark_file_load_from_file(), g_bookmark_file_load_from_data() or g_bookmark_file_load_from_data_dirs() to read an existing bookmark -file.

+file. +

@@ -382,14 +391,15 @@ file.


g_bookmark_file_free ()

-
void                g_bookmark_file_free                (GBookmarkFile *bookmark);
+
void                g_bookmark_file_free                (GBookmarkFile *bookmark);

-Frees a GBookmarkFile.

+Frees a GBookmarkFile. +

-

bookmark :

a GBookmarkFile +a GBookmarkFile
@@ -398,29 +408,30 @@ Frees a

g_bookmark_file_load_from_file ()

-
gboolean            g_bookmark_file_load_from_file      (GBookmarkFile *bookmark,
-                                                         const gchar *filename,
-                                                         GError **error);
+
gboolean            g_bookmark_file_load_from_file      (GBookmarkFile *bookmark,
+                                                         const gchar *filename,
+                                                         GError **error);

Loads a desktop bookmark file into an empty GBookmarkFile structure. If the file could not be loaded then error is set to either a GFileError -or GBookmarkFileError.

+or GBookmarkFileError. +

- - - @@ -436,35 +447,36 @@ or

g_bookmark_file_load_from_data ()

-
gboolean            g_bookmark_file_load_from_data      (GBookmarkFile *bookmark,
-                                                         const gchar *data,
-                                                         gsize length,
-                                                         GError **error);
+
gboolean            g_bookmark_file_load_from_data      (GBookmarkFile *bookmark,
+                                                         const gchar *data,
+                                                         gsize length,
+                                                         GError **error);

Loads a bookmark file from memory into an empty GBookmarkFile structure. If the object cannot be created then error is set to a -GBookmarkFileError.

+GBookmarkFileError. +

bookmark :

an empty GBookmarkFile struct +an empty GBookmarkFile struct

filename :

the path of a filename to load, in the GLib file name encoding +the path of a filename to load, in the GLib file name encoding

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -480,38 +492,39 @@ structure. If the object cannot be created then err

g_bookmark_file_load_from_data_dirs ()

-
gboolean            g_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark,
-                                                         const gchar *file,
-                                                         gchar **full_path,
-                                                         GError **error);
+
gboolean            g_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark,
+                                                         const gchar *file,
+                                                         gchar **full_path,
+                                                         GError **error);

This function looks for a desktop bookmark file named file in the paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into bookmark and returns the file's full path in full_path. If the file could not be loaded then an error is -set to either a GFileError or GBookmarkFileError.

+set to either a GFileError or GBookmarkFileError. +

bookmark :

an empty GBookmarkFile struct +an empty GBookmarkFile struct

data :

desktop bookmarks loaded in memory +desktop bookmarks loaded in memory

length :

the length of data in bytes +the length of data in bytes

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -527,27 +540,28 @@ set to either a

g_bookmark_file_to_data ()

-
gchar *             g_bookmark_file_to_data             (GBookmarkFile *bookmark,
-                                                         gsize *length,
-                                                         GError **error);
+
gchar *             g_bookmark_file_to_data             (GBookmarkFile *bookmark,
+                                                         gsize *length,
+                                                         GError **error);

-This function outputs bookmark as a string.

+This function outputs bookmark as a string. +

bookmark :

a GBookmarkFile +a GBookmarkFile

file :

a relative path to a filename to open and parse +a relative path to a filename to open and parse

full_path :

return location for a string containing the full path +return location for a string containing the full path of the file, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -564,28 +578,29 @@ This function outputs bookmark as a stri

g_bookmark_file_to_file ()

-
gboolean            g_bookmark_file_to_file             (GBookmarkFile *bookmark,
-                                                         const gchar *filename,
-                                                         GError **error);
+
gboolean            g_bookmark_file_to_file             (GBookmarkFile *bookmark,
+                                                         const gchar *filename,
+                                                         GError **error);

This function outputs bookmark into a file. The write process is -guaranteed to be atomic by using g_file_set_contents() internally.

+guaranteed to be atomic by using g_file_set_contents() internally. +

bookmark :

a GBookmarkFile +a GBookmarkFile

length :

return location for the length of the returned string, or NULL +return location for the length of the returned string, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -601,21 +616,22 @@ guaranteed to be atomic by using

g_bookmark_file_has_item ()

-
gboolean            g_bookmark_file_has_item            (GBookmarkFile *bookmark,
-                                                         const gchar *uri);
+
gboolean            g_bookmark_file_has_item            (GBookmarkFile *bookmark,
+                                                         const gchar *uri);

-Looks whether the desktop bookmark has an item with its URI set to uri.

+Looks whether the desktop bookmark has an item with its URI set to uri. +

bookmark :

a GBookmarkFile +a GBookmarkFile

filename :

path of the output file +path of the output file

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - @@ -631,38 +647,39 @@ Looks whether the desktop bookmark has an item with its URI set to

g_bookmark_file_has_group ()

-
gboolean            g_bookmark_file_has_group           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *group,
-                                                         GError **error);
+
gboolean            g_bookmark_file_has_group           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *group,
+                                                         GError **error);

Checks whether group appears in the list of groups to which the bookmark for uri belongs to.

In the event the URI cannot be found, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI
- - - - @@ -678,38 +695,39 @@ In the event the URI cannot be found,

g_bookmark_file_has_application ()

-
gboolean            g_bookmark_file_has_application     (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *name,
-                                                         GError **error);
+
gboolean            g_bookmark_file_has_application     (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *name,
+                                                         GError **error);

Checks whether the bookmark for uri inside bookmark has been registered by application name.

In the event the URI cannot be found, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

group :

the group name to be searched +the group name to be searched

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -725,15 +743,16 @@ In the event the URI cannot be found,

g_bookmark_file_get_size ()

-
gint                g_bookmark_file_get_size            (GBookmarkFile *bookmark);
+
gint                g_bookmark_file_get_size            (GBookmarkFile *bookmark);

-Gets the number of bookmarks inside bookmark.

+Gets the number of bookmarks inside bookmark. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

name :

the name of the application +the name of the application

error :

return location for a GError or NULL +return location for a GError or NULL
- @@ -749,23 +768,24 @@ Gets the number of bookmarks inside bookmark<

g_bookmark_file_get_uris ()

-
gchar **            g_bookmark_file_get_uris            (GBookmarkFile *bookmark,
-                                                         gsize *length);
+
gchar **            g_bookmark_file_get_uris            (GBookmarkFile *bookmark,
+                                                         gsize *length);

Returns all URIs of the bookmarks in the bookmark file bookmark. The array of returned URIs will be NULL-terminated, so length may -optionally be NULL.

+optionally be NULL. +

bookmark :

a GBookmarkFile +a GBookmarkFile
- - @@ -782,9 +802,9 @@ optionally be

g_bookmark_file_get_title ()

-
gchar *             g_bookmark_file_get_title           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
gchar *             g_bookmark_file_get_title           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Returns the title of the bookmark for uri.

@@ -793,23 +813,24 @@ If uri is NULL is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

length :

return location for the number of returned URIs, or NULL +return location for the number of returned URIs, or NULL
- - - @@ -826,31 +847,32 @@ In the event the URI cannot be found,

g_bookmark_file_get_description ()

-
gchar *             g_bookmark_file_get_description     (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
gchar *             g_bookmark_file_get_description     (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Retrieves the description of the bookmark for uri.

In the event the URI cannot be found, NULL is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI or NULL +a valid URI or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -867,9 +889,9 @@ In the event the URI cannot be found,

g_bookmark_file_get_mime_type ()

-
gchar *             g_bookmark_file_get_mime_type       (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
gchar *             g_bookmark_file_get_mime_type       (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Retrieves the MIME type of the resource pointed by uri.

@@ -877,23 +899,24 @@ Retrieves the MIME type of the resource pointed by u In the event the URI cannot be found, NULL is returned and error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the MIME type cannot be found, NULL is returned and -error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.

+error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -910,9 +933,9 @@ event that the MIME type cannot be found,

g_bookmark_file_get_is_private ()

-
gboolean            g_bookmark_file_get_is_private      (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
gboolean            g_bookmark_file_get_is_private      (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Gets whether the private flag of the bookmark for uri is set.

@@ -920,23 +943,24 @@ Gets whether the private flag of the bookmark for ur In the event the URI cannot be found, FALSE is returned and error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the private flag cannot be found, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.

+error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -952,43 +976,44 @@ event that the private flag cannot be found,

g_bookmark_file_get_icon ()

-
gboolean            g_bookmark_file_get_icon            (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         gchar **href,
-                                                         gchar **mime_type,
-                                                         GError **error);
+
gboolean            g_bookmark_file_get_icon            (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         gchar **href,
+                                                         gchar **mime_type,
+                                                         GError **error);

Gets the icon of the bookmark for uri.

In the event the URI cannot be found, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - - @@ -1005,31 +1030,32 @@ In the event the URI cannot be found,

g_bookmark_file_get_added ()

-
time_t              g_bookmark_file_get_added           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
time_t              g_bookmark_file_get_added           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Gets the time the bookmark for uri was added to bookmark

In the event the URI cannot be found, -1 is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

href :

return location for the icon's location or NULL +return location for the icon's location or NULL

mime_type :

return location for the icon's MIME type or NULL +return location for the icon's MIME type or NULL

error :

return location for a GError or NULL +return location for a GError or NULL
- - - @@ -1045,31 +1071,32 @@ In the event the URI cannot be found, -1 is returned and

g_bookmark_file_get_modified ()

-
time_t              g_bookmark_file_get_modified        (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
time_t              g_bookmark_file_get_modified        (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Gets the time when the bookmark for uri was last modified.

In the event the URI cannot be found, -1 is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -1085,31 +1112,32 @@ In the event the URI cannot be found, -1 is returned and

g_bookmark_file_get_visited ()

-
time_t              g_bookmark_file_get_visited         (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
time_t              g_bookmark_file_get_visited         (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

Gets the time the bookmark for uri was last visited.

In the event the URI cannot be found, -1 is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -1125,10 +1153,10 @@ In the event the URI cannot be found, -1 is returned and

g_bookmark_file_get_groups ()

-
gchar **            g_bookmark_file_get_groups          (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         gsize *length,
-                                                         GError **error);
+
gchar **            g_bookmark_file_get_groups          (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         gsize *length,
+                                                         GError **error);

Retrieves the list of group names of the bookmark for uri.

@@ -1138,28 +1166,29 @@ In the event the URI cannot be found, NULL terminated, so length may optionally -be NULL.

+be NULL. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -1176,38 +1205,39 @@ be

g_bookmark_file_get_applications ()

-
gchar **            g_bookmark_file_get_applications    (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         gsize *length,
-                                                         GError **error);
+
gchar **            g_bookmark_file_get_applications    (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         gsize *length,
+                                                         GError **error);

Retrieves the names of the applications that have registered the bookmark for uri.

In the event the URI cannot be found, NULL is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

length :

return location for the length of the returned string, or NULL +return location for the length of the returned string, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -1224,13 +1254,13 @@ In the event the URI cannot be found,

g_bookmark_file_get_app_info ()

-
gboolean            g_bookmark_file_get_app_info        (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *name,
-                                                         gchar **exec,
-                                                         guint *count,
-                                                         time_t *stamp,
-                                                         GError **error);
+
gboolean            g_bookmark_file_get_app_info        (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *name,
+                                                         gchar **exec,
+                                                         guint *count,
+                                                         time_t *stamp,
+                                                         GError **error);

Gets the registration informations of app_name for the bookmark for uri. See g_bookmark_file_set_app_info() for more informations about @@ -1246,43 +1276,44 @@ event that no application with name app_name< for uri, FALSE is returned and error is set to G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting the command line fails, an error of the G_SHELL_ERROR domain is -set and FALSE is returned.

+set and FALSE is returned. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

length :

return location of the length of the returned list, or NULL +return location of the length of the returned list, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - - - - @@ -1298,9 +1329,9 @@ set and

g_bookmark_file_set_title ()

-
void                g_bookmark_file_set_title           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *title);
+
void                g_bookmark_file_set_title           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *title);

Sets title as the title of the bookmark for uri inside the bookmark file bookmark. @@ -1309,23 +1340,24 @@ bookmark file bookmark. If uri is NULL, the title of bookmark is set.

-If a bookmark for uri cannot be found then it is created.

+If a bookmark for uri cannot be found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

name :

an application's name +an application's name

exec :

location for the command line of the application, or NULL +location for the command line of the application, or NULL

count :

return location for the registration count, or NULL +return location for the registration count, or NULL

stamp :

return location for the last registration time, or NULL +return location for the last registration time, or NULL

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - @@ -1335,9 +1367,9 @@ If a bookmark for uri cannot be found th

g_bookmark_file_set_description ()

-
void                g_bookmark_file_set_description     (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *description);
+
void                g_bookmark_file_set_description     (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *description);

Sets description as the description of the bookmark for uri.

@@ -1345,23 +1377,24 @@ Sets description as the description of t If uri is NULL, the description of bookmark is set.

-If a bookmark for uri cannot be found then it is created.

+If a bookmark for uri cannot be found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI or NULL +a valid URI or NULL

title :

a UTF-8 encoded string +a UTF-8 encoded string
- - - @@ -1371,30 +1404,31 @@ If a bookmark for uri cannot be found th

g_bookmark_file_set_mime_type ()

-
void                g_bookmark_file_set_mime_type       (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *mime_type);
+
void                g_bookmark_file_set_mime_type       (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *mime_type);

Sets mime_type as the MIME type of the bookmark for uri.

-If a bookmark for uri cannot be found then it is created.

+If a bookmark for uri cannot be found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI or NULL +a valid URI or NULL

description :

a string +a string
- - - @@ -1404,30 +1438,32 @@ If a bookmark for uri cannot be found th

g_bookmark_file_set_is_private ()

-
void                g_bookmark_file_set_is_private      (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         gboolean is_private);
+
void                g_bookmark_file_set_is_private      (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         gboolean is_private);

Sets the private flag of the bookmark for uri.

-If a bookmark for uri cannot be found then it is created.

+If a bookmark for uri cannot be found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

mime_type :

a MIME type +a MIME type
- - - @@ -1437,38 +1473,39 @@ If a bookmark for uri cannot be found th

g_bookmark_file_set_icon ()

-
void                g_bookmark_file_set_icon            (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *href,
-                                                         const gchar *mime_type);
+
void                g_bookmark_file_set_icon            (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *href,
+                                                         const gchar *mime_type);

Sets the icon for the bookmark for uri. If href is NULL, unsets the currently set icon. href can either be a full URL for the icon file or the icon name following the Icon Naming specification.

-If no bookmark for uri is found one is created.

+If no bookmark for uri is found one is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

is_private :

TRUE if the bookmark should be marked as private + +TRUE if the bookmark should be marked as private
- - - - @@ -1478,30 +1515,31 @@ If no bookmark for uri is found one is c

g_bookmark_file_set_added ()

-
void                g_bookmark_file_set_added           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         time_t added);
+
void                g_bookmark_file_set_added           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         time_t added);

Sets the time the bookmark for uri was added into bookmark.

-If no bookmark for uri is found then it is created.

+If no bookmark for uri is found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

href :

the URI of the icon for the bookmark, or NULL +the URI of the icon for the bookmark, or NULL

mime_type :

the MIME type of the icon for the bookmark +the MIME type of the icon for the bookmark
- - - @@ -1511,37 +1549,38 @@ If no bookmark for uri is found then it

g_bookmark_file_set_groups ()

-
void                g_bookmark_file_set_groups          (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar **groups,
-                                                         gsize length);
+
void                g_bookmark_file_set_groups          (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar **groups,
+                                                         gsize length);

Sets a list of group names for the item with URI uri. Each previously set group name list is removed.

-If uri cannot be found then an item for it is created.

+If uri cannot be found then an item for it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

added :

a timestamp or -1 to use the current time +a timestamp or -1 to use the current time
- - - - @@ -1551,9 +1590,9 @@ If uri cannot be found then an item for

g_bookmark_file_set_modified ()

-
void                g_bookmark_file_set_modified        (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         time_t modified);
+
void                g_bookmark_file_set_modified        (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         time_t modified);

Sets the last time the bookmark for uri was last modified.

@@ -1564,23 +1603,24 @@ If no bookmark for uri is found then it The "modified" time should only be set when the bookmark's meta-data was actually changed. Every function of GBookmarkFile that modifies a bookmark also changes the modification time, except for -g_bookmark_file_set_visited().

+g_bookmark_file_set_visited(). +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

an item's URI +an item's URI

groups :

an array of group names, or NULL to remove all groups +an array of group names, or NULL to remove all groups

length :

number of group name values in groups +number of group name values in groups
- - - @@ -1590,9 +1630,9 @@ modifies a bookmark also changes the modification time, except for

g_bookmark_file_set_visited ()

-
void                g_bookmark_file_set_visited         (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         time_t visited);
+
void                g_bookmark_file_set_visited         (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         time_t visited);

Sets the time the bookmark for uri was last visited.

@@ -1604,23 +1644,24 @@ The "visited" time should only be set if the bookmark was launched, either using the command line retrieved by g_bookmark_file_get_app_info() or by the default application for the bookmark's MIME type, retrieved using g_bookmark_file_get_mime_type(). Changing the "visited" time -does not affect the "modified" time.

+does not affect the "modified" time. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

modified :

a timestamp or -1 to use the current time +a timestamp or -1 to use the current time
- - - @@ -1630,13 +1671,13 @@ does not affect the "modified" time.


g_bookmark_file_set_app_info ()

-
gboolean            g_bookmark_file_set_app_info        (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *name,
-                                                         const gchar *exec,
-                                                         gint count,
-                                                         time_t stamp,
-                                                         GError **error);
+
gboolean            g_bookmark_file_set_app_info        (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *name,
+                                                         const gchar *exec,
+                                                         gint count,
+                                                         time_t stamp,
+                                                         GError **error);

Sets the meta-data of application name inside the list of applications that have registered a bookmark for uri inside @@ -1668,43 +1709,44 @@ zero, and no bookmark for uri is found, in the event that no application name has registered a bookmark for uri, FALSE is returned and error is set to G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark -for uri is found, one is created.

+for uri is found, one is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

visited :

a timestamp or -1 to use the current time +a timestamp or -1 to use the current time
- - - - - - - @@ -1721,31 +1763,32 @@ for uri is found, one is created.


g_bookmark_file_add_group ()

-
void                g_bookmark_file_add_group           (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *group);
+
void                g_bookmark_file_add_group           (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *group);

Adds group to the list of groups to which the bookmark for uri belongs to.

-If no bookmark for uri is found then it is created.

+If no bookmark for uri is found then it is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

name :

an application's name +an application's name

exec :

an application's command line +an application's command line

count :

the number of registrations done for this application +the number of registrations done for this application

stamp :

the time of the last registration for this application +the time of the last registration for this application

error :

return location for a GError or NULL +return location for a GError or NULL
- - - @@ -1755,10 +1798,10 @@ If no bookmark for uri is found then it

g_bookmark_file_add_application ()

-
void                g_bookmark_file_add_application     (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *name,
-                                                         const gchar *exec);
+
void                g_bookmark_file_add_application     (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *name,
+                                                         const gchar *exec);

Adds the application with name and exec to the list of applications that have registered a bookmark for uri into @@ -1785,29 +1828,30 @@ with the same name had already registere uri inside bookmark.

-If no bookmark for uri is found, one is created.

+If no bookmark for uri is found, one is created. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

group :

the group name to be added +the group name to be added
- - - - @@ -1817,10 +1861,10 @@ If no bookmark for uri is found, one is

g_bookmark_file_remove_group ()

-
gboolean            g_bookmark_file_remove_group        (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *group,
-                                                         GError **error);
+
gboolean            g_bookmark_file_remove_group        (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *group,
+                                                         GError **error);

Removes group from the list of groups to which the bookmark for uri belongs to. @@ -1829,28 +1873,29 @@ for uri belongs to. In the event the URI cannot be found, FALSE is returned and error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event no group was defined, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.

+error is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

name :

the name of the application registering the bookmark +the name of the application registering the bookmark or NULL

exec :

command line to be used to launch the bookmark or NULL +command line to be used to launch the bookmark or NULL
- - - - @@ -1866,10 +1911,10 @@ In the event no group was defined,

g_bookmark_file_remove_application ()

-
gboolean            g_bookmark_file_remove_application  (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         const gchar *name,
-                                                         GError **error);
+
gboolean            g_bookmark_file_remove_application  (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         const gchar *name,
+                                                         GError **error);

Removes application registered with name from the list of applications that have registered a bookmark for uri inside bookmark. @@ -1879,28 +1924,29 @@ In the event the URI cannot be found, error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that no application with name app_name has registered a bookmark for uri, FALSE is returned and error is set to -G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED.

+G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

group :

the group name to be removed +the group name to be removed

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -1916,27 +1962,28 @@ a bookmark for uri,

g_bookmark_file_remove_item ()

-
gboolean            g_bookmark_file_remove_item         (GBookmarkFile *bookmark,
-                                                         const gchar *uri,
-                                                         GError **error);
+
gboolean            g_bookmark_file_remove_item         (GBookmarkFile *bookmark,
+                                                         const gchar *uri,
+                                                         GError **error);

-Removes the bookmark for uri from the bookmark file bookmark.

+Removes the bookmark for uri from the bookmark file bookmark. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

name :

the name of the application +the name of the application

error :

return location for a GError or NULL +return location for a GError or NULL
- - - @@ -1952,10 +1999,10 @@ Removes the bookmark for uri from the bo

g_bookmark_file_move_item ()

-
gboolean            g_bookmark_file_move_item           (GBookmarkFile *bookmark,
-                                                         const gchar *old_uri,
-                                                         const gchar *new_uri,
-                                                         GError **error);
+
gboolean            g_bookmark_file_move_item           (GBookmarkFile *bookmark,
+                                                         const gchar *old_uri,
+                                                         const gchar *new_uri,
+                                                         GError **error);

Changes the URI of a bookmark item from old_uri to new_uri. Any existing bookmark for new_uri will be overwritten. If new_uri is @@ -1963,28 +2010,29 @@ existing bookmark for new_uri will be ov

In the event the URI cannot be found, FALSE is returned and -error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.

+error is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. +

bookmark :

a GBookmarkFile +a GBookmarkFile

uri :

a valid URI +a valid URI

error :

return location for a GError, or NULL +return location for a GError, or NULL
- - - - @@ -2001,6 +2049,6 @@ In the event the URI cannot be found,
- Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Byte-Arrays.html b/docs/reference/glib/html/glib-Byte-Arrays.html index ebad95a..62ed8a5 100644 --- a/docs/reference/glib/html/glib-Byte-Arrays.html +++ b/docs/reference/glib/html/glib-Byte-Arrays.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

bookmark :

a GBookmarkFile +a GBookmarkFile

old_uri :

a valid URI +a valid URI

new_uri :

a valid URI, or NULL +a valid URI, or NULL

error :

return location for a GError or NULL +return location for a GError or NULL
@@ -62,32 +42,32 @@ #include <glib.h> GByteArray; -GByteArray* g_byte_array_new (void); -GByteArray* g_byte_array_sized_new (guint reserved_size); -GByteArray * g_byte_array_ref (GByteArray *array); -void g_byte_array_unref (GByteArray *array); -GByteArray* g_byte_array_append (GByteArray *array, - const guint8 *data, - guint len); -GByteArray* g_byte_array_prepend (GByteArray *array, - const guint8 *data, - guint len); -GByteArray* g_byte_array_remove_index (GByteArray *array, - guint index_); -GByteArray* g_byte_array_remove_index_fast (GByteArray *array, - guint index_); -GByteArray* g_byte_array_remove_range (GByteArray *array, - guint index_, - guint length); -void g_byte_array_sort (GByteArray *array, - GCompareFunc compare_func); -void g_byte_array_sort_with_data (GByteArray *array, - GCompareDataFunc compare_func, - gpointer user_data); -GByteArray* g_byte_array_set_size (GByteArray *array, - guint length); -guint8* g_byte_array_free (GByteArray *array, - gboolean free_segment); +GByteArray* g_byte_array_new (void); +GByteArray* g_byte_array_sized_new (guint reserved_size); +GByteArray * g_byte_array_ref (GByteArray *array); +void g_byte_array_unref (GByteArray *array); +GByteArray* g_byte_array_append (GByteArray *array, + const guint8 *data, + guint len); +GByteArray* g_byte_array_prepend (GByteArray *array, + const guint8 *data, + guint len); +GByteArray* g_byte_array_remove_index (GByteArray *array, + guint index_); +GByteArray* g_byte_array_remove_index_fast (GByteArray *array, + guint index_); +GByteArray* g_byte_array_remove_range (GByteArray *array, + guint index_, + guint length); +void g_byte_array_sort (GByteArray *array, + GCompareFunc compare_func); +void g_byte_array_sort_with_data (GByteArray *array, + GCompareDataFunc compare_func, + gpointer user_data); +GByteArray* g_byte_array_set_size (GByteArray *array, + guint length); +guint8* g_byte_array_free (GByteArray *array, + gboolean free_segment);
@@ -112,27 +92,51 @@ To free a -

Example 22. Using a GByteArray

-
-  GByteArray *gbarray;
-  gint i;
+

Example 22. Using a GByteArray

+
+
+ + + + + + +
1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
GByteArray *gbarray;
+gint i;
 
-  gbarray = g_byte_array_new ();
-  for (i = 0; i < 10000; i++)
-    g_byte_array_append (gbarray, (guint8*) "abcd", 4);
+gbarray = g_byte_array_new ();
+for (i = 0; i < 10000; i++)
+  g_byte_array_append (gbarray, (guint8*) "abcd", 4);
 
-  for (i = 0; i < 10000; i++)
-    {
-      g_assert (gbarray->data[4*i] == 'a');
-      g_assert (gbarray->data[4*i+1] == 'b');
-      g_assert (gbarray->data[4*i+2] == 'c');
-      g_assert (gbarray->data[4*i+3] == 'd');
-    }
+for (i = 0; i < 10000; i++)
+  {
+    g_assert (gbarray->data[4*i] == 'a');
+    g_assert (gbarray->data[4*i+1] == 'b');
+    g_assert (gbarray->data[4*i+2] == 'c');
+    g_assert (gbarray->data[4*i+3] == 'd');
+  }
 
-  g_byte_array_free (gbarray, TRUE);
- 
+g_byte_array_free (gbarray, TRUE);
-


+ +
+


+

Details

@@ -145,19 +149,20 @@ To free a GByteArray struct allows access to the -public fields of a GByteArray.

+public fields of a GByteArray. +

- - @@ -166,14 +171,15 @@ public fields of a GByteArray.


g_byte_array_new ()

-
GByteArray*         g_byte_array_new                    (void);
+
GByteArray*         g_byte_array_new                    (void);

-Creates a new GByteArray with a reference count of 1.

+Creates a new GByteArray with a reference count of 1. +

guint8 *data;

a pointer to the element data. The data may be moved as +a pointer to the element data. The data may be moved as elements are added to the GByteArray.

guint len;

the number of elements in the GByteArray. +the number of elements in the GByteArray.
-

Returns :

the new GByteArray. +the new GByteArray.
@@ -181,23 +187,24 @@ Creates a new

g_byte_array_sized_new ()

-
GByteArray*         g_byte_array_sized_new              (guint reserved_size);
+
GByteArray*         g_byte_array_sized_new              (guint reserved_size);

Creates a new GByteArray with reserved_size bytes preallocated. This avoids frequent reallocation, if you are going to add many bytes to the array. Note however that the size of the array is still -0.

+0. +

- - @@ -206,16 +213,17 @@ bytes to the array. Note however that the size of the array is still

g_byte_array_ref ()

-
GByteArray *        g_byte_array_ref                    (GByteArray *array);
+
GByteArray *        g_byte_array_ref                    (GByteArray *array);

Atomically increments the reference count of array by one. This -function is MT-safe and may be called from any thread.

+function is MT-safe and may be called from any thread. +

reserved_size :

number of bytes preallocated. +number of bytes preallocated.

Returns :

the new GByteArray. +the new GByteArray.
- @@ -231,17 +239,18 @@ function is MT-safe and may be called from any thread.


g_byte_array_unref ()

-
void                g_byte_array_unref                  (GByteArray *array);
+
void                g_byte_array_unref                  (GByteArray *array);

Atomically decrements the reference count of array by one. If the reference count drops to 0, all memory allocated by the array is released. This function is MT-safe and may be called from any -thread.

+thread. +

array :

A GByteArray. +A GByteArray.
-

array :

A GByteArray. +A GByteArray.
@@ -250,33 +259,34 @@ thread.


g_byte_array_append ()

-
GByteArray*         g_byte_array_append                 (GByteArray *array,
-                                                         const guint8 *data,
-                                                         guint len);
+
GByteArray*         g_byte_array_append                 (GByteArray *array,
+                                                         const guint8 *data,
+                                                         guint len);

Adds the given bytes to the end of the GByteArray. The array will -grow in size automatically if necessary.

+grow in size automatically if necessary. +

- - - - @@ -285,33 +295,34 @@ grow in size automatically if necessary.


g_byte_array_prepend ()

-
GByteArray*         g_byte_array_prepend                (GByteArray *array,
-                                                         const guint8 *data,
-                                                         guint len);
+
GByteArray*         g_byte_array_prepend                (GByteArray *array,
+                                                         const guint8 *data,
+                                                         guint len);

Adds the given data to the start of the GByteArray. The array will -grow in size automatically if necessary.

+grow in size automatically if necessary. +

array :

a GByteArray. +a GByteArray.

data :

the byte data to be added. +the byte data to be added.

len :

the number of bytes to add. +the number of bytes to add.

Returns :

the GByteArray. +the GByteArray.
- - - - @@ -320,27 +331,28 @@ grow in size automatically if necessary.


g_byte_array_remove_index ()

-
GByteArray*         g_byte_array_remove_index           (GByteArray *array,
-                                                         guint index_);
+
GByteArray*         g_byte_array_remove_index           (GByteArray *array,
+                                                         guint index_);

Removes the byte at the given index from a GByteArray. The -following bytes are moved down one place.

+following bytes are moved down one place. +

array :

a GByteArray. +a GByteArray.

data :

the byte data to be added. +the byte data to be added.

len :

the number of bytes to add. +the number of bytes to add.

Returns :

the GByteArray. +the GByteArray.
- - - @@ -349,29 +361,30 @@ following bytes are moved down one place.


g_byte_array_remove_index_fast ()

-
GByteArray*         g_byte_array_remove_index_fast      (GByteArray *array,
-                                                         guint index_);
+
GByteArray*         g_byte_array_remove_index_fast      (GByteArray *array,
+                                                         guint index_);

Removes the byte at the given index from a GByteArray. The last element in the array is used to fill in the space, so this function does not preserve the order of the GByteArray. But it is faster -than g_byte_array_remove_index().

+than g_byte_array_remove_index(). +

array :

a GByteArray. +a GByteArray.

index_ :

the index of the byte to remove. +the index of the byte to remove.

Returns :

the GByteArray. +the GByteArray.
- - - @@ -380,33 +393,34 @@ than

g_byte_array_remove_range ()

-
GByteArray*         g_byte_array_remove_range           (GByteArray *array,
-                                                         guint index_,
-                                                         guint length);
+
GByteArray*         g_byte_array_remove_range           (GByteArray *array,
+                                                         guint index_,
+                                                         guint length);

Removes the given number of bytes starting at the given index from a -GByteArray. The following elements are moved to close the gap.

+GByteArray. The following elements are moved to close the gap. +

array :

a GByteArray. +a GByteArray.

index_ :

the index of the byte to remove. +the index of the byte to remove.

Returns :

the GByteArray. +the GByteArray.
- - - - @@ -416,8 +430,8 @@ Removes the given number of bytes starting at the given index from a

g_byte_array_sort ()

-
void                g_byte_array_sort                   (GByteArray *array,
-                                                         GCompareFunc compare_func);
+
void                g_byte_array_sort                   (GByteArray *array,
+                                                         GCompareFunc compare_func);

Sorts a byte array, using compare_func which should be a qsort()-style comparison function (returns less than zero for first @@ -426,18 +440,19 @@ first arg is greater than second arg).

If two array elements compare equal, their order in the sorted array -is undefined.

+is undefined. +

array :

a GByteArray. +a GByteArray.

index_ :

the index of the first byte to remove. +the index of the first byte to remove.

length :

the number of bytes to remove. +the number of bytes to remove.

Returns :

the GByteArray. +the GByteArray.
- - @@ -446,28 +461,29 @@ is undefined.


g_byte_array_sort_with_data ()

-
void                g_byte_array_sort_with_data         (GByteArray *array,
-                                                         GCompareDataFunc compare_func,
-                                                         gpointer user_data);
+
void                g_byte_array_sort_with_data         (GByteArray *array,
+                                                         GCompareDataFunc compare_func,
+                                                         gpointer user_data);

Like g_byte_array_sort(), but the comparison function takes an extra -user data argument.

+user data argument. +

array :

a GByteArray. +a GByteArray.

compare_func :

comparison function. +comparison function.
- - - @@ -476,26 +492,27 @@ user data argument.


g_byte_array_set_size ()

-
GByteArray*         g_byte_array_set_size               (GByteArray *array,
-                                                         guint length);
+
GByteArray*         g_byte_array_set_size               (GByteArray *array,
+                                                         guint length);

-Sets the size of the GByteArray, expanding it if necessary.

+Sets the size of the GByteArray, expanding it if necessary. +

array :

a GByteArray. +a GByteArray.

compare_func :

comparison function. +comparison function.

user_data :

data to pass to compare_func. +data to pass to compare_func.
- - - @@ -504,29 +521,30 @@ Sets the size of the

g_byte_array_free ()

-
guint8*             g_byte_array_free                   (GByteArray *array,
-                                                         gboolean free_segment);
+
guint8*             g_byte_array_free                   (GByteArray *array,
+                                                         gboolean free_segment);

Frees the memory allocated by the GByteArray. If free_segment is TRUE it frees the actual byte data. If the reference count of array is greater than one, the GByteArray wrapper is preserved but -the size of array will be set to zero.

+the size of array will be set to zero. +

array :

a GByteArray. +a GByteArray.

length :

the new size of the GByteArray. +the new size of the GByteArray.

Returns :

the GByteArray. +the GByteArray.
- - - @@ -537,6 +555,6 @@ the size of array will be set to zero. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Byte-Order-Macros.html b/docs/reference/glib/html/glib-Byte-Order-Macros.html index ddc725d..5f4a8c3 100644 --- a/docs/reference/glib/html/glib-Byte-Order-Macros.html +++ b/docs/reference/glib/html/glib-Byte-Order-Macros.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

array :

a GByteArray. +a GByteArray.

free_segment :

if TRUE the actual byte data is freed as well. +if TRUE the actual byte data is freed as well.

Returns :

the element data if free_segment is FALSE, otherwise +the element data if free_segment is FALSE, otherwise NULL. The element data should be freed using g_free().
@@ -1701,6 +1681,6 @@ The conversion is symmetric so it can be used both ways. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Caches.html b/docs/reference/glib/html/glib-Caches.html index 0911abf..4dd6963 100644 --- a/docs/reference/glib/html/glib-Caches.html +++ b/docs/reference/glib/html/glib-Caches.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -62,29 +42,29 @@ #include <glib.h> GCache; -GCache* g_cache_new (GCacheNewFunc value_new_func, - GCacheDestroyFunc value_destroy_func, - GCacheDupFunc key_dup_func, - GCacheDestroyFunc key_destroy_func, - GHashFunc hash_key_func, - GHashFunc hash_value_func, - GEqualFunc key_equal_func); -gpointerg_cache_insert (GCache *cache, - gpointer key); -voidg_cache_remove (GCache *cache, - gconstpointer value); -voidg_cache_destroy (GCache *cache); +GCache* g_cache_new (GCacheNewFunc value_new_func, + GCacheDestroyFunc value_destroy_func, + GCacheDupFunc key_dup_func, + GCacheDestroyFunc key_destroy_func, + GHashFunc hash_key_func, + GHashFunc hash_value_func, + GEqualFunc key_equal_func); +gpointerg_cache_insert (GCache *cache, + gpointer key); +voidg_cache_remove (GCache *cache, + gconstpointer value); +voidg_cache_destroy (GCache *cache); -voidg_cache_key_foreach (GCache *cache, - GHFunc func, - gpointer user_data); -voidg_cache_value_foreach (GCache *cache, - GHFunc func, - gpointer user_data); +voidg_cache_key_foreach (GCache *cache, + GHFunc func, + gpointer user_data); +voidg_cache_value_foreach (GCache *cache, + GHFunc func, + gpointer user_data); -void (*GCacheDestroyFunc) (gpointer value); -gpointer (*GCacheDupFunc) (gpointer value); -gpointer (*GCacheNewFunc) (gpointer key); +void (*GCacheDestroyFunc) (gpointer value); +gpointer (*GCacheDupFunc) (gpointer value); +gpointer (*GCacheNewFunc) (gpointer key);
@@ -94,14 +74,15 @@ A GtkStyles and GdkGCs. These consume a lot of -resources, so a GCache is used to see if a GtkStyle or GdkGC with +GTK+ uses caches for GtkStyles and GdkGCs. These consume a lot of +resources, so a GCache is used to see if a GtkStyle or GdkGC with the required properties already exists. If it does, then the existing object is used instead of creating a new one.

GCache uses keys and values. A GCache key describes the properties -of a particular resource. A GCache value is the actual resource.

+of a particular resource. A GCache value is the actual resource. +

Details

@@ -111,33 +92,35 @@ of a particular resource. A The GCache struct is an opaque data structure containing information about a GCache. It should only be accessed via the -following functions.

+following functions. +


g_cache_new ()

-
GCache*             g_cache_new                         (GCacheNewFunc value_new_func,
-                                                         GCacheDestroyFunc value_destroy_func,
-                                                         GCacheDupFunc key_dup_func,
-                                                         GCacheDestroyFunc key_destroy_func,
-                                                         GHashFunc hash_key_func,
-                                                         GHashFunc hash_value_func,
-                                                         GEqualFunc key_equal_func);
+
GCache*             g_cache_new                         (GCacheNewFunc value_new_func,
+                                                         GCacheDestroyFunc value_destroy_func,
+                                                         GCacheDupFunc key_dup_func,
+                                                         GCacheDestroyFunc key_destroy_func,
+                                                         GHashFunc hash_key_func,
+                                                         GHashFunc hash_value_func,
+                                                         GEqualFunc key_equal_func);

-Creates a new GCache.

+Creates a new GCache. +

- - - - - - - - @@ -184,8 +167,8 @@ Creates a new

g_cache_insert ()

-
gpointer            g_cache_insert                      (GCache *cache,
-                                                         gpointer key);
+
gpointer            g_cache_insert                      (GCache *cache,
+                                                         gpointer key);

Gets the value corresponding to the given key, creating it if necessary. It first checks if the value already exists in the @@ -194,23 +177,24 @@ necessary. It first checks if the value already exists in the reference count is increased by one. If the value does not currently exist, if is created by calling the value_new_func. The key is duplicated by calling key_dup_func and the duplicated key and value -are inserted into the GCache.

+are inserted into the GCache. +

value_new_func :

a function to create a new object given a key. +a function to create a new object given a key. This is called by g_cache_insert() if an object with the given key does not already exist.

value_destroy_func :

a function to destroy an object. It is called +a function to destroy an object. It is called by g_cache_remove() when the object is no longer needed (i.e. its reference count drops to 0). @@ -145,37 +128,37 @@ Creates a new

key_dup_func :

a function to copy a key. It is called by +a function to copy a key. It is called by g_cache_insert() if the key does not already exist in the GCache.

key_destroy_func :

a function to destroy a key. It is called by +a function to destroy a key. It is called by g_cache_remove() when the object is no longer needed (i.e. its reference count drops to 0).

hash_key_func :

a function to create a hash value from a key. +a function to create a hash value from a key.

hash_value_func :

a function to create a hash value from a value. +a function to create a hash value from a value.

key_equal_func :

a function to compare two keys. It should return +a function to compare two keys. It should return TRUE if the two keys are equivalent.

Returns :

a new GCache. +a new GCache.
- - - @@ -219,23 +203,24 @@ are inserted into the

g_cache_remove ()

-
void                g_cache_remove                      (GCache *cache,
-                                                         gconstpointer value);
+
void                g_cache_remove                      (GCache *cache,
+                                                         gconstpointer value);

Decreases the reference count of the given value. If it drops to 0 then the value and its corresponding key are destroyed, using the -value_destroy_func and key_destroy_func passed to g_cache_new().

+value_destroy_func and key_destroy_func passed to g_cache_new(). +

cache :

a GCache. +a GCache.

key :

a key describing a GCache object. +a key describing a GCache object.

Returns :

a pointer to a GCache value. +a pointer to a GCache value.
- - @@ -244,18 +229,19 @@ then the value and its corresponding key are destroyed, using the

g_cache_destroy ()

-
void                g_cache_destroy                     (GCache *cache);
+
void                g_cache_destroy                     (GCache *cache);

Frees the memory allocated for the GCache.

Note that it does not destroy the keys and values which were -contained in the GCache.

+contained in the GCache. +

cache :

a GCache. +a GCache.

value :

the value to remove. +the value to remove.
-

cache :

a GCache. +a GCache.
@@ -263,9 +249,9 @@ contained in the <

g_cache_key_foreach ()

-
void                g_cache_key_foreach                 (GCache *cache,
-                                                         GHFunc func,
-                                                         gpointer user_data);
+
void                g_cache_key_foreach                 (GCache *cache,
+                                                         GHFunc func,
+                                                         gpointer user_data);

Calls the given function for each of the keys in the GCache.

@@ -273,23 +259,24 @@ Calls the given function for each of the keys in the func
is passed three parameters, the value and key of a cache entry and the user_data. The order of value and key is different from the order in which g_hash_table_foreach() passes key-value -pairs to its callback function !

+pairs to its callback function ! +

- - - @@ -298,9 +285,9 @@ pairs to its callback function !


g_cache_value_foreach ()

-
void                g_cache_value_foreach               (GCache *cache,
-                                                         GHFunc func,
-                                                         gpointer user_data);
+
void                g_cache_value_foreach               (GCache *cache,
+                                                         GHFunc func,
+                                                         gpointer user_data);

Warning

g_cache_value_foreach has been deprecated since version 2.10 and should not be used in newly-written code. The reason is that it passes pointers to internal @@ -308,23 +295,24 @@ pairs to its callback function !

instead

-Calls the given function for each of the values in the GCache.

+Calls the given function for each of the values in the GCache. +

cache :

a GCache. +a GCache.

func :

the function to call with each GCache key. +the function to call with each GCache key.

user_data :

user data to pass to the function. +user data to pass to the function.
- - - @@ -333,17 +321,18 @@ Calls the given function for each of the values in the

GCacheDestroyFunc ()

-
void                (*GCacheDestroyFunc)                (gpointer value);
+
void                (*GCacheDestroyFunc)                (gpointer value);

Specifies the type of the value_destroy_func and key_destroy_func functions passed to g_cache_new(). The functions are passed a pointer to the GCache key or GCache value and should free any -memory and other resources associated with it.

+memory and other resources associated with it. +

cache :

a GCache. +a GCache.

func :

the function to call with each GCache value. +the function to call with each GCache value.

user_data :

user data to pass to the function. +user data to pass to the function.
-

value :

the GCache value to destroy. +the GCache value to destroy.
@@ -351,24 +340,25 @@ memory and other resources associated with it.


GCacheDupFunc ()

-
gpointer            (*GCacheDupFunc)                    (gpointer value);
+
gpointer            (*GCacheDupFunc)                    (gpointer value);

Specifies the type of the key_dup_func function passed to g_cache_new(). The function is passed a key (not a value as the prototype implies) and -should return a duplicate of the key.

+should return a duplicate of the key. +

- - @@ -377,22 +367,23 @@ should return a duplicate of the key.


GCacheNewFunc ()

-
gpointer            (*GCacheNewFunc)                    (gpointer key);
+
gpointer            (*GCacheNewFunc)                    (gpointer key);

Specifies the type of the value_new_func function passed to g_cache_new(). It is passed a GCache key and should create the -value corresponding to the key.

+value corresponding to the key. +

value :

the GCache key to destroy (not a +the GCache key to destroy (not a GCache value as it seems).

Returns :

a copy of the GCache key. +a copy of the GCache key.
- - @@ -402,6 +393,6 @@ value corresponding to the key.

+ Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Character-Set-Conversion.html b/docs/reference/glib/html/glib-Character-Set-Conversion.html index cfb1927..7319f77 100644 --- a/docs/reference/glib/html/glib-Character-Set-Conversion.html +++ b/docs/reference/glib/html/glib-Character-Set-Conversion.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

key :

a GCache key. +a GCache key.

Returns :

a new GCache value corresponding to the key. +a new GCache value corresponding to the key.
@@ -60,69 +40,69 @@
 #include <glib.h>
 
-gchar*              g_convert                           (const gchar *str,
-                                                         gssize len,
-                                                         const gchar *to_codeset,
-                                                         const gchar *from_codeset,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
-gchar*              g_convert_with_fallback             (const gchar *str,
-                                                         gssize len,
-                                                         const gchar *to_codeset,
-                                                         const gchar *from_codeset,
-                                                         const gchar *fallback,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
+gchar*              g_convert                           (const gchar *str,
+                                                         gssize len,
+                                                         const gchar *to_codeset,
+                                                         const gchar *from_codeset,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
+gchar*              g_convert_with_fallback             (const gchar *str,
+                                                         gssize len,
+                                                         const gchar *to_codeset,
+                                                         const gchar *from_codeset,
+                                                         const gchar *fallback,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
                     GIConv;
-gchar*              g_convert_with_iconv                (const gchar *str,
-                                                         gssize len,
-                                                         GIConv converter,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
+gchar*              g_convert_with_iconv                (const gchar *str,
+                                                         gssize len,
+                                                         GIConv converter,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
 #define             G_CONVERT_ERROR
-GIConv              g_iconv_open                        (const gchar *to_codeset,
-                                                         const gchar *from_codeset);
-gsize               g_iconv                             (GIConv converter,
-                                                         gchar **inbuf,
-                                                         gsize *inbytes_left,
-                                                         gchar **outbuf,
-                                                         gsize *outbytes_left);
-gint                g_iconv_close                       (GIConv converter);
-gchar*              g_locale_to_utf8                    (const gchar *opsysstring,
-                                                         gssize len,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
-gchar*              g_filename_to_utf8                  (const gchar *opsysstring,
-                                                         gssize len,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
-gchar*              g_filename_from_utf8                (const gchar *utf8string,
-                                                         gssize len,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
-gchar *             g_filename_from_uri                 (const gchar *uri,
-                                                         gchar **hostname,
-                                                         GError **error);
-gchar *             g_filename_to_uri                   (const gchar *filename,
-                                                         const gchar *hostname,
-                                                         GError **error);
-gboolean            g_get_filename_charsets             (G_CONST_RETURN gchar ***charsets);
-gchar *             g_filename_display_name             (const gchar *filename);
-gchar *             g_filename_display_basename         (const gchar *filename);
-gchar*              g_locale_from_utf8                  (const gchar *utf8string,
-                                                         gssize len,
-                                                         gsize *bytes_read,
-                                                         gsize *bytes_written,
-                                                         GError **error);
+GIConv              g_iconv_open                        (const gchar *to_codeset,
+                                                         const gchar *from_codeset);
+gsize               g_iconv                             (GIConv converter,
+                                                         gchar **inbuf,
+                                                         gsize *inbytes_left,
+                                                         gchar **outbuf,
+                                                         gsize *outbytes_left);
+gint                g_iconv_close                       (GIConv converter);
+gchar*              g_locale_to_utf8                    (const gchar *opsysstring,
+                                                         gssize len,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
+gchar*              g_filename_to_utf8                  (const gchar *opsysstring,
+                                                         gssize len,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
+gchar*              g_filename_from_utf8                (const gchar *utf8string,
+                                                         gssize len,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
+gchar *             g_filename_from_uri                 (const gchar *uri,
+                                                         gchar **hostname,
+                                                         GError **error);
+gchar *             g_filename_to_uri                   (const gchar *filename,
+                                                         const gchar *hostname,
+                                                         GError **error);
+gboolean            g_get_filename_charsets             (G_CONST_RETURN gchar ***charsets);
+gchar *             g_filename_display_name             (const gchar *filename);
+gchar *             g_filename_display_basename         (const gchar *filename);
+gchar*              g_locale_from_utf8                  (const gchar *utf8string,
+                                                         gssize len,
+                                                         gsize *bytes_read,
+                                                         gsize *bytes_written,
+                                                         GError **error);
 enum                GConvertError;
 
-gboolean            g_get_charset                       (G_CONST_RETURN char **charset);
+gboolean            g_get_charset                       (G_CONST_RETURN char **charset);
 
@@ -212,7 +192,7 @@ export G_FILENAME_ENCODING=ISO-8859-1
  • If you get a file name from the file system from a function such as readdir(3) or - gtk_file_chooser_get_filename(), + gtk_file_chooser_get_filename(), you do not need to do any conversion to pass that file name to functions like open(2), rename(2), or @@ -254,46 +234,47 @@ export G_FILENAME_ENCODING=ISO-8859-1

    Details

    g_convert ()

    -
    gchar*              g_convert                           (const gchar *str,
    -                                                         gssize len,
    -                                                         const gchar *to_codeset,
    -                                                         const gchar *from_codeset,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_convert                           (const gchar *str,
    +                                                         gssize len,
    +                                                         const gchar *to_codeset,
    +                                                         const gchar *from_codeset,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string from one character set to another.

    Note that you should use g_iconv() for streaming -conversions[2].

    +conversions[2]. +

  • - - - - - - - @@ -328,14 +309,14 @@ conversions[

    g_convert_with_fallback ()

    -
    gchar*              g_convert_with_fallback             (const gchar *str,
    -                                                         gssize len,
    -                                                         const gchar *to_codeset,
    -                                                         const gchar *from_codeset,
    -                                                         const gchar *fallback,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_convert_with_fallback             (const gchar *str,
    +                                                         gssize len,
    +                                                         const gchar *to_codeset,
    +                                                         const gchar *from_codeset,
    +                                                         const gchar *fallback,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string from one character set to another, possibly including fallback sequences for characters not representable @@ -347,34 +328,35 @@ in which case GLib will simply return that approximate conversion.

    Note that you should use g_iconv() for streaming -conversions[2].

    +conversions[2]. +

    str :

    the string to convert +the string to convert

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    to_codeset :

    name of character set into which to convert str +name of character set into which to convert str

    from_codeset :

    character set of str. +character set of str.

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -305,13 +286,13 @@ conversions[bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - - - - - - @@ -425,40 +407,41 @@ and should only be accessed using the following functions.

    g_convert_with_iconv ()

    -
    gchar*              g_convert_with_iconv                (const gchar *str,
    -                                                         gssize len,
    -                                                         GIConv converter,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_convert_with_iconv                (const gchar *str,
    +                                                         gssize len,
    +                                                         GIConv converter,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string from one character set to another.

    Note that you should use g_iconv() for streaming -conversions[2].

    +conversions[2]. +

    str :

    the string to convert +the string to convert

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    to_codeset :

    name of character set into which to convert str +name of character set into which to convert str

    from_codeset :

    character set of str. +character set of str.

    fallback :

    UTF-8 string to use in place of character not +UTF-8 string to use in place of character not present in the target encoding. (The string must be representable in the target encoding). If NULL, characters not in the target encoding will @@ -383,7 +365,7 @@ conversions[bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -392,13 +374,13 @@ conversions[bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - - - - @@ -504,8 +487,8 @@ error domains.

    g_iconv_open ()

    -
    GIConv              g_iconv_open                        (const gchar *to_codeset,
    -                                                         const gchar *from_codeset);
    +
    GIConv              g_iconv_open                        (const gchar *to_codeset,
    +                                                         const gchar *from_codeset);

    Same as the standard UNIX routine iconv_open(), but may be implemented via libiconv on UNIX flavors that lack @@ -513,18 +496,19 @@ a native implementation.

    GLib provides g_convert() and g_locale_to_utf8() which are likely -more convenient than the raw iconv wrappers.

    +more convenient than the raw iconv wrappers. +

    str :

    the string to convert +the string to convert

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    converter :

    conversion descriptor from g_iconv_open() +conversion descriptor from g_iconv_open()

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -470,13 +453,13 @@ conversions[bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - @@ -539,11 +523,11 @@ more convenient than the raw iconv wrappers.


    g_iconv ()

    -
    gsize               g_iconv                             (GIConv converter,
    -                                                         gchar **inbuf,
    -                                                         gsize *inbytes_left,
    -                                                         gchar **outbuf,
    -                                                         gsize *outbytes_left);
    +
    gsize               g_iconv                             (GIConv converter,
    +                                                         gchar **inbuf,
    +                                                         gsize *inbytes_left,
    +                                                         gchar **outbuf,
    +                                                         gsize *outbytes_left);

    Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack @@ -551,33 +535,34 @@ a native implementation.

    GLib provides g_convert() and g_locale_to_utf8() which are likely -more convenient than the raw iconv wrappers.

    +more convenient than the raw iconv wrappers. +

    to_codeset :

    destination codeset +destination codeset

    from_codeset :

    source codeset +source codeset
    - - - - - @@ -591,7 +576,7 @@ more convenient than the raw iconv wrappers.


    g_iconv_close ()

    -
    gint                g_iconv_close                       (GIConv converter);
    +
    gint                g_iconv_close                       (GIConv converter);

    Same as the standard UNIX routine iconv_close(), but may be implemented via libiconv on UNIX flavors that lack @@ -601,13 +586,14 @@ you are done converting things.

    GLib provides g_convert() and g_locale_to_utf8() which are likely -more convenient than the raw iconv wrappers.

    +more convenient than the raw iconv wrappers. +

    converter :

    conversion descriptor from g_iconv_open() +conversion descriptor from g_iconv_open()

    inbuf :

    bytes to convert +bytes to convert

    inbytes_left :

    inout parameter, bytes remaining to convert in inbuf +inout parameter, bytes remaining to convert in inbuf

    outbuf :

    converted output bytes +converted output bytes

    outbytes_left :

    inout parameter, bytes available to fill in outbuf +inout parameter, bytes available to fill in outbuf
    - @@ -621,34 +607,35 @@ more convenient than the raw iconv wrappers.


    g_locale_to_utf8 ()

    -
    gchar*              g_locale_to_utf8                    (const gchar *opsysstring,
    -                                                         gssize len,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_locale_to_utf8                    (const gchar *opsysstring,
    +                                                         gssize len,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string which is in the encoding used for strings by the C runtime (usually the same as that used by the operating system) in the current locale into a -UTF-8 string.

    +UTF-8 string. +

    converter :

    a conversion descriptor from g_iconv_open() +a conversion descriptor from g_iconv_open()
    - - - - - @@ -681,33 +668,34 @@ UTF-8 string.


    g_filename_to_utf8 ()

    -
    gchar*              g_filename_to_utf8                  (const gchar *opsysstring,
    -                                                         gssize len,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_filename_to_utf8                  (const gchar *opsysstring,
    +                                                         gssize len,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string which is in the encoding used by GLib for filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8 for filenames; on other platforms, this function indirectly depends on -the current locale.

    +the current locale. +

    opsysstring :

    a string in the encoding of the current locale. On Windows +a string in the encoding of the current locale. On Windows this means the system codepage.

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -660,13 +647,13 @@ UTF-8 string.

    bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - - - @@ -740,33 +728,34 @@ the current lo

    g_filename_from_utf8 ()

    -
    gchar*              g_filename_from_utf8                (const gchar *utf8string,
    -                                                         gssize len,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_filename_from_utf8                (const gchar *utf8string,
    +                                                         gssize len,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string from UTF-8 to the encoding GLib uses for filenames. Note that on Windows GLib uses UTF-8 for filenames; on other platforms, this function indirectly depends on the -current locale.

    +current locale. +

    opsysstring :

    a string in the encoding for filenames +a string in the encoding for filenames

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -719,13 +707,13 @@ the current lo

    bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - - - @@ -799,30 +788,31 @@ on other platforms, this function indirectly depends on the

    g_filename_from_uri ()

    -
    gchar *             g_filename_from_uri                 (const gchar *uri,
    -                                                         gchar **hostname,
    -                                                         GError **error);
    +
    gchar *             g_filename_from_uri                 (const gchar *uri,
    +                                                         gchar **hostname,
    +                                                         GError **error);

    Converts an escaped ASCII-encoded URI to a local filename in the -encoding used for filenames.

    +encoding used for filenames. +

    utf8string :

    a UTF-8 encoded string. +a UTF-8 encoded string.

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated.

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -778,13 +767,13 @@ on other platforms, this function indirectly depends on the

    bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - @@ -838,30 +828,31 @@ encoding used for filenames.


    g_filename_to_uri ()

    -
    gchar *             g_filename_to_uri                   (const gchar *filename,
    -                                                         const gchar *hostname,
    -                                                         GError **error);
    +
    gchar *             g_filename_to_uri                   (const gchar *filename,
    +                                                         const gchar *hostname,
    +                                                         GError **error);

    Converts an absolute filename to an escaped ASCII-encoded URI, with the path -component following Section 3.3. of RFC 2396.

    +component following Section 3.3. of RFC 2396. +

    uri :

    a uri describing a filename (escaped, encoded in ASCII). +a uri describing a filename (escaped, encoded in ASCII).

    hostname :

    Location to store hostname for the URI, or NULL. +Location to store hostname for the URI, or NULL. If there is no hostname in the URI, NULL will be stored in this location.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - - - @@ -877,7 +868,7 @@ component following Section 3.3. of RFC 2396.


    g_get_filename_charsets ()

    -
    gboolean            g_get_filename_charsets             (G_CONST_RETURN gchar ***charsets);
    +
    gboolean            g_get_filename_charsets             (G_CONST_RETURN gchar ***charsets);

    Determines the preferred character sets used for filenames. The first character set from the charsets is the filename encoding, the @@ -907,13 +898,14 @@ The returned charsets belong to GLib and

    Note that on Unix, regardless of the locale character set or G_FILENAME_ENCODING value, the actual file names present -on a system might be in any random encoding or just gibberish.

    +on a system might be in any random encoding or just gibberish. +

    filename :

    an absolute filename specified in the GLib file name encoding, +an absolute filename specified in the GLib file name encoding, which is the on-disk file name bytes on Unix, and UTF-8 on Windows

    hostname :

    A UTF-8 encoded hostname, or NULL for none. +A UTF-8 encoded hostname, or NULL for none.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - @@ -929,7 +921,7 @@ on a system might be in any random encoding or just gibberish.


    g_filename_display_name ()

    -
    gchar *             g_filename_display_name             (const gchar *filename);
    +
    gchar *             g_filename_display_name             (const gchar *filename);

    Converts a filename into a valid UTF-8 string. The conversion is not necessarily reversible, so you should keep the original around @@ -947,13 +939,14 @@ encoding.

    If you know the whole pathname of the file you should use g_filename_display_basename(), since that allows location-based -translation of filenames.

    +translation of filenames. +

    charsets :

    return location for the NULL-terminated list of encoding names +return location for the NULL-terminated list of encoding names
    - @@ -970,7 +963,7 @@ translation of filenames.


    g_filename_display_basename ()

    -
    gchar *             g_filename_display_basename         (const gchar *filename);
    +
    gchar *             g_filename_display_basename         (const gchar *filename);

    Returns the display basename for the particular filename, guaranteed to be valid UTF-8. The display name might not be identical to the filename, @@ -990,13 +983,14 @@ translation of well known locations can be done.

    This function is preferred over g_filename_display_name() if you know the -whole path, as it allows translation.

    +whole path, as it allows translation. +

    filename :

    a pathname hopefully in the GLib file name encoding +a pathname hopefully in the GLib file name encoding
    - @@ -1013,33 +1007,34 @@ whole path, as it allows translation.


    g_locale_from_utf8 ()

    -
    gchar*              g_locale_from_utf8                  (const gchar *utf8string,
    -                                                         gssize len,
    -                                                         gsize *bytes_read,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    gchar*              g_locale_from_utf8                  (const gchar *utf8string,
    +                                                         gssize len,
    +                                                         gsize *bytes_read,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Converts a string from UTF-8 to the encoding used for strings by the C runtime (usually the same as that used by the operating system) in the current locale. On -Windows this means the system codepage.

    +Windows this means the system codepage. +

    filename :

    an absolute pathname in the GLib file name encoding +an absolute pathname in the GLib file name encoding
    - - - - - @@ -1125,7 +1120,7 @@ is not supported.

    g_get_charset ()

    -
    gboolean            g_get_charset                       (G_CONST_RETURN char **charset);
    +
    gboolean            g_get_charset                       (G_CONST_RETURN char **charset);

    Obtains the character set for the current locale; you might use this character set as an argument to @@ -1146,13 +1141,14 @@ case you can perhaps avoid calling charset is not allocated, and should not be -freed.

    +freed. +

    utf8string :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    the length of the string, or -1 if the string is +the length of the string, or -1 if the string is nul-terminated[1].

    bytes_read :

    location to store the number of bytes in the +location to store the number of bytes in the input string that were successfully converted, or NULL. Even if the conversion was successful, this may be less than len if there were partial characters @@ -1051,13 +1046,13 @@ Windows this means the system codepage.

    bytes_written :

    the number of bytes stored in the output buffer (not +the number of bytes stored in the output buffer (not including the terminating nul).

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError may occur.
    - @@ -1186,6 +1182,6 @@ character.) + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Commandline-option-parser.html b/docs/reference/glib/html/glib-Commandline-option-parser.html index b3176fa..e61625b 100644 --- a/docs/reference/glib/html/glib-Commandline-option-parser.html +++ b/docs/reference/glib/html/glib-Commandline-option-parser.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    charset :

    return location for character set name +return location for character set name
    @@ -62,84 +42,84 @@ enum GOptionError; #define G_OPTION_ERROR -gboolean (*GOptionArgFunc) (const gchar *option_name, - const gchar *value, - gpointer data, - GError **error); +gboolean (*GOptionArgFunc) (const gchar *option_name, + const gchar *value, + gpointer data, + GError **error); GOptionContext; -GOptionContext * g_option_context_new (const gchar *parameter_string); -voidg_option_context_set_summary (GOptionContext *context, - const gchar *summary); -const gchar * g_option_context_get_summary (GOptionContext *context); -voidg_option_context_set_description (GOptionContext *context, - const gchar *description); -const gchar * g_option_context_get_description (GOptionContext *context); -const gchar * (*GTranslateFunc) (const gchar *str, - gpointer data); -voidg_option_context_set_translate_func (GOptionContext *context, - GTranslateFunc func, - gpointer data, - GDestroyNotify destroy_notify); +GOptionContext * g_option_context_new (const gchar *parameter_string); +voidg_option_context_set_summary (GOptionContext *context, + const gchar *summary); +const gchar * g_option_context_get_summary (GOptionContext *context); +voidg_option_context_set_description (GOptionContext *context, + const gchar *description); +const gchar * g_option_context_get_description (GOptionContext *context); +const gchar * (*GTranslateFunc) (const gchar *str, + gpointer data); +voidg_option_context_set_translate_func (GOptionContext *context, + GTranslateFunc func, + gpointer data, + GDestroyNotify destroy_notify); voidg_option_context_set_translation_domain - (GOptionContext *context, - const gchar *domain); -voidg_option_context_free (GOptionContext *context); -gbooleang_option_context_parse (GOptionContext *context, - gint *argc, - gchar ***argv, - GError **error); -voidg_option_context_set_help_enabled (GOptionContext *context, - gboolean help_enabled); -gbooleang_option_context_get_help_enabled (GOptionContext *context); + (GOptionContext *context, + const gchar *domain); +voidg_option_context_free (GOptionContext *context); +gbooleang_option_context_parse (GOptionContext *context, + gint *argc, + gchar ***argv, + GError **error); +voidg_option_context_set_help_enabled (GOptionContext *context, + gboolean help_enabled); +gbooleang_option_context_get_help_enabled (GOptionContext *context); voidg_option_context_set_ignore_unknown_options - (GOptionContext *context, - gboolean ignore_unknown); + (GOptionContext *context, + gboolean ignore_unknown); gbooleang_option_context_get_ignore_unknown_options - (GOptionContext *context); -gchar * g_option_context_get_help (GOptionContext *context, - gboolean main_help, - GOptionGroup *group); + (GOptionContext *context); +gchar * g_option_context_get_help (GOptionContext *context, + gboolean main_help, + GOptionGroup *group); enum GOptionArg; enum GOptionFlags; #define G_OPTION_REMAININGGOptionEntry; -voidg_option_context_add_main_entries (GOptionContext *context, - const GOptionEntry *entries, - const gchar *translation_domain); +voidg_option_context_add_main_entries (GOptionContext *context, + const GOptionEntry *entries, + const gchar *translation_domain); GOptionGroup; -voidg_option_context_add_group (GOptionContext *context, - GOptionGroup *group); -voidg_option_context_set_main_group (GOptionContext *context, - GOptionGroup *group); -GOptionGroup * g_option_context_get_main_group (GOptionContext *context); -GOptionGroup * g_option_group_new (const gchar *name, - const gchar *description, - const gchar *help_description, - gpointer user_data, - GDestroyNotify destroy); -voidg_option_group_free (GOptionGroup *group); -voidg_option_group_add_entries (GOptionGroup *group, - const GOptionEntry *entries); -gboolean (*GOptionParseFunc) (GOptionContext *context, - GOptionGroup *group, - gpointer data, - GError **error); -voidg_option_group_set_parse_hooks (GOptionGroup *group, - GOptionParseFunc pre_parse_func, - GOptionParseFunc post_parse_func); -void (*GOptionErrorFunc) (GOptionContext *context, - GOptionGroup *group, - gpointer data, - GError **error); -voidg_option_group_set_error_hook (GOptionGroup *group, - GOptionErrorFunc error_func); -voidg_option_group_set_translate_func (GOptionGroup *group, - GTranslateFunc func, - gpointer data, - GDestroyNotify destroy_notify); +voidg_option_context_add_group (GOptionContext *context, + GOptionGroup *group); +voidg_option_context_set_main_group (GOptionContext *context, + GOptionGroup *group); +GOptionGroup * g_option_context_get_main_group (GOptionContext *context); +GOptionGroup * g_option_group_new (const gchar *name, + const gchar *description, + const gchar *help_description, + gpointer user_data, + GDestroyNotify destroy); +voidg_option_group_free (GOptionGroup *group); +voidg_option_group_add_entries (GOptionGroup *group, + const GOptionEntry *entries); +gboolean (*GOptionParseFunc) (GOptionContext *context, + GOptionGroup *group, + gpointer data, + GError **error); +voidg_option_group_set_parse_hooks (GOptionGroup *group, + GOptionParseFunc pre_parse_func, + GOptionParseFunc post_parse_func); +void (*GOptionErrorFunc) (GOptionContext *context, + GOptionGroup *group, + gpointer data, + GError **error); +voidg_option_group_set_error_hook (GOptionGroup *group, + GOptionErrorFunc error_func); +voidg_option_group_set_translate_func (GOptionGroup *group, + GTranslateFunc func, + gpointer data, + GDestroyNotify destroy_notify); voidg_option_group_set_translation_domain - (GOptionGroup *group, - const gchar *domain); + (GOptionGroup *group, + const gchar *domain);
    @@ -214,7 +194,7 @@ GOption groups options in GOptionContext, and parse all options by a single call -to g_option_context_parse(). See gtk_get_option_group() for an example. +to g_option_context_parse(). See gtk_get_option_group() for an example.

    If an option is declared to be of type string or filename, GOption takes @@ -228,42 +208,85 @@ commandline above and produce the example help output.

    -
    -static gint repeats = 2;
    -static gint max_size = 8;
    -static gboolean verbose = FALSE;
    -static gboolean beep = FALSE;
    -static gboolean rand = FALSE;
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    static gint repeats = 2;
    +static gint max_size = 8;
    +static gboolean verbose = FALSE;
    +static gboolean beep = FALSE;
    +static gboolean rand = FALSE;
     
    -static GOptionEntry entries[] = 
    -{
    -  { "repeats", 'r', 0, G_OPTION_ARG_INT, &repeats, "Average over N repetitions", "N" },
    -  { "max-size", 'm', 0, G_OPTION_ARG_INT, &max_size, "Test up to 2^M items", "M" },
    -  { "verbose", 'v', 0, G_OPTION_ARG_NONE, &verbose, "Be verbose", NULL },
    -  { "beep", 'b', 0, G_OPTION_ARG_NONE, &beep, "Beep when done", NULL },
    -  { "rand", 0, 0, G_OPTION_ARG_NONE, &rand, "Randomize the data", NULL },
    -  { NULL }
    -};
    +static GOptionEntry entries[] = 
    +{
    +  { "repeats", 'r', 0, G_OPTION_ARG_INT, &repeats, "Average over N repetitions", "N" },
    +  { "max-size", 'm', 0, G_OPTION_ARG_INT, &max_size, "Test up to 2^M items", "M" },
    +  { "verbose", 'v', 0, G_OPTION_ARG_NONE, &verbose, "Be verbose", NULL },
    +  { "beep", 'b', 0, G_OPTION_ARG_NONE, &beep, "Beep when done", NULL },
    +  { "rand", 0, 0, G_OPTION_ARG_NONE, &rand, "Randomize the data", NULL },
    +  { NULL }
    +};
     
    -int 
    -main (int argc, char *argv[])
    -{
    -  GError *error = NULL;
    -  GOptionContext *context;
    +int 
    +main (int argc, char *argv[])
    +{
    +  GError *error = NULL;
    +  GOptionContext *context;
     
    -  context = g_option_context_new ("- test tree model performance");
    -  g_option_context_add_main_entries (context, entries, GETTEXT_PACKAGE);
    -  g_option_context_add_group (context, gtk_get_option_group (TRUE));
    -  if (!g_option_context_parse (context, &argc, &argv, &error))
    -    {
    -      g_print ("option parsing failed: %s\n", error->message);
    -      exit (1);
    -    }
    +  context = g_option_context_new ("- test tree model performance");
    +  g_option_context_add_main_entries (context, entries, GETTEXT_PACKAGE);
    +  g_option_context_add_group (context, gtk_get_option_group (TRUE));
    +  if (!g_option_context_parse (context, &argc, &argv, &error))
    +    {
    +      g_print ("option parsing failed: %s\n", error->message);
    +      exit (1);
    +    }
     
    -  // ...
    +  // ...
     
    -}
    -
    +}
    +
    + +

    +

    Details

    @@ -277,25 +300,26 @@ main (int argc, char *argv[]) } GOptionError;

    -Error codes returned by option parsing.

    +Error codes returned by option parsing. +

    - - - @@ -309,42 +333,44 @@ Error codes returned by option parsing.

    Error domain for option parsing. Errors in this domain will be from the GOptionError enumeration. See GError for information on -error domains.

    +error domains. +


    GOptionArgFunc ()

    -
    gboolean            (*GOptionArgFunc)                   (const gchar *option_name,
    -                                                         const gchar *value,
    -                                                         gpointer data,
    -                                                         GError **error);
    +
    gboolean            (*GOptionArgFunc)                   (const gchar *option_name,
    +                                                         const gchar *value,
    +                                                         gpointer data,
    +                                                         GError **error);

    The type of function to be passed as callback for G_OPTION_ARG_CALLBACK -options.

    +options. +

    G_OPTION_ERROR_UNKNOWN_OPTION

    An option was not known to the parser. +An option was not known to the parser. This error will only be reported, if the parser hasn't been instructed to ignore unknown options, see g_option_context_set_ignore_unknown_options().

    G_OPTION_ERROR_BAD_VALUE

    A value couldn't be parsed. +A value couldn't be parsed.

    G_OPTION_ERROR_FAILED

    A GOptionArgFunc callback failed. +A GOptionArgFunc callback failed.
    - - - - @@ -364,12 +390,13 @@ options.

    A GOptionContext struct defines which options are accepted by the commandline option parser. The struct has only private -fields and should not be directly accessed.

    +fields and should not be directly accessed. +


    g_option_context_new ()

    -
    GOptionContext *    g_option_context_new                (const gchar *parameter_string);
    +
    GOptionContext *    g_option_context_new                (const gchar *parameter_string);

    Creates a new option context.

    @@ -392,13 +419,14 @@ below the usage line, use parameter_string is translated using the function set with g_option_context_set_translate_func(), so -it should normally be passed untranslated.

    +it should normally be passed untranslated. +

    option_name :

    The name of the option being parsed. This will be either a +The name of the option being parsed. This will be either a single dash followed by a single letter (for a short name) or two dashes followed by a long option name.

    value :

    The value to be parsed. +The value to be parsed.

    data :

    User data added to the GOptionGroup containing the option when it +User data added to the GOptionGroup containing the option when it was created with g_option_group_new()

    error :

    A return location for errors. The error code G_OPTION_ERROR_FAILED +A return location for errors. The error code G_OPTION_ERROR_FAILED is intended to be used for errors in GOptionArgFunc callbacks.
    -

    parameter_string :

    a string which is displayed in +a string which is displayed in the first line of --help output, after the usage summary programname [OPTION...] @@ -418,8 +446,8 @@ it should normally be passed untranslated.


    g_option_context_set_summary ()

    -
    void                g_option_context_set_summary        (GOptionContext *context,
    -                                                         const gchar *summary);
    +
    void                g_option_context_set_summary        (GOptionContext *context,
    +                                                         const gchar *summary);

    Adds a string to be displayed in --help output before the list of options. This is typically a summary of the @@ -428,18 +456,19 @@ program functionality.

    Note that the summary is translated (see g_option_context_set_translate_func() and -g_option_context_set_translation_domain()).

    +g_option_context_set_translation_domain()). +

    - - @@ -450,15 +479,16 @@ Note that the summary is translated (see

    g_option_context_get_summary ()

    -
    const gchar *       g_option_context_get_summary        (GOptionContext *context);
    +
    const gchar *       g_option_context_get_summary        (GOptionContext *context);

    -Returns the summary. See g_option_context_set_summary().

    +Returns the summary. See g_option_context_set_summary(). +

    context :

    a GOptionContext +a GOptionContext

    summary :

    a string to be shown in --help output +a string to be shown in --help output before the list of options, or NULL
    - @@ -474,8 +504,8 @@ Returns the summary. See

    g_option_context_set_description ()

    -
    void                g_option_context_set_description    (GOptionContext *context,
    -                                                         const gchar *description);
    +
    void                g_option_context_set_description    (GOptionContext *context,
    +                                                         const gchar *description);

    Adds a string to be displayed in --help output after the list of options. This text often includes a bug reporting @@ -483,18 +513,19 @@ address.

    Note that the summary is translated (see -g_option_context_set_translate_func()).

    +g_option_context_set_translate_func()). +

    context :

    a GOptionContext +a GOptionContext
    - - @@ -505,15 +536,16 @@ Note that the summary is translated (see

    g_option_context_get_description ()

    -
    const gchar *       g_option_context_get_description    (GOptionContext *context);
    +
    const gchar *       g_option_context_get_description    (GOptionContext *context);

    -Returns the description. See g_option_context_set_description().

    +Returns the description. See g_option_context_set_description(). +

    context :

    a GOptionContext +a GOptionContext

    description :

    a string to be shown in --help output +a string to be shown in --help output after the list of options, or NULL
    - @@ -529,22 +561,23 @@ Returns the description. See

    GTranslateFunc ()

    -
    const gchar *       (*GTranslateFunc)                   (const gchar *str,
    -                                                         gpointer data);
    +
    const gchar *       (*GTranslateFunc)                   (const gchar *str,
    +                                                         gpointer data);

    The type of functions which are used to translate user-visible -strings, for --help output.

    +strings, for --help output. +

    context :

    a GOptionContext +a GOptionContext
    - - @@ -560,10 +593,10 @@ strings, for --help output.


    g_option_context_set_translate_func ()

    -
    void                g_option_context_set_translate_func (GOptionContext *context,
    -                                                         GTranslateFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy_notify);
    +
    void                g_option_context_set_translate_func (GOptionContext *context,
    +                                                         GTranslateFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy_notify);

    Sets the function which is used to translate the contexts user-visible strings, for --help output. @@ -577,28 +610,29 @@ the summary (see gettext(), you only need to set the translation -domain, see g_option_context_set_translation_domain().

    +domain, see g_option_context_set_translation_domain(). +

    str :

    the untranslated string +the untranslated string

    data :

    user data specified when installing the function, e.g. +user data specified when installing the function, e.g. in g_option_group_set_translate_func()
    - - - - @@ -609,22 +643,23 @@ domain, see

    g_option_context_set_translation_domain ()

    void                g_option_context_set_translation_domain
    -                                                        (GOptionContext *context,
    -                                                         const gchar *domain);
    + (GOptionContext *context, + const gchar *domain);

    A convenience function to use gettext() for translating -user-visible strings.

    +user-visible strings. +

    context :

    a GOptionContext +a GOptionContext

    func :

    the GTranslateFunc, or NULL +the GTranslateFunc, or NULL

    data :

    user data to pass to func, or NULL +user data to pass to func, or NULL

    destroy_notify :

    a function which gets called to free data, or NULL +a function which gets called to free data, or NULL
    - - @@ -634,19 +669,20 @@ user-visible strings.


    g_option_context_free ()

    -
    void                g_option_context_free               (GOptionContext *context);
    +
    void                g_option_context_free               (GOptionContext *context);

    Frees context and all the groups which have been added to it.

    Please note that parsed arguments need to be freed separately (see -GOptionEntry).

    +GOptionEntry). +

    context :

    a GOptionContext +a GOptionContext

    domain :

    the domain to use +the domain to use
    -

    context :

    a GOptionContext +a GOptionContext
    @@ -655,10 +691,10 @@ Please note that parsed arguments need to be freed separately (see

    g_option_context_parse ()

    -
    gboolean            g_option_context_parse              (GOptionContext *context,
    -                                                         gint *argc,
    -                                                         gchar ***argv,
    -                                                         GError **error);
    +
    gboolean            g_option_context_parse              (GOptionContext *context,
    +                                                         gint *argc,
    +                                                         gchar ***argv,
    +                                                         GError **error);

    Parses the command line arguments, recognizing options which have been added to context. A side-effect of @@ -684,28 +720,29 @@ call exit (0). Note that function depends on the current locale for automatic character set conversion of string and filename -arguments.

    +arguments. +

    - - - - @@ -722,26 +759,28 @@ arguments.


    g_option_context_set_help_enabled ()

    -
    void                g_option_context_set_help_enabled   (GOptionContext *context,
    -                                                         gboolean help_enabled);
    +
    void                g_option_context_set_help_enabled   (GOptionContext *context,
    +                                                         gboolean help_enabled);

    Enables or disables automatic generation of --help output. By default, g_option_context_parse() recognizes --help, -h, -?, --help-all and --help-groupname and creates -suitable output to stdout.

    +suitable output to stdout. +

    context :

    a GOptionContext +a GOptionContext

    argc :

    a pointer to the number of command line arguments +a pointer to the number of command line arguments

    argv :

    a pointer to the array of command line arguments +a pointer to the array of command line arguments

    error :

    a return location for errors +a return location for errors
    - - @@ -751,16 +790,17 @@ suitable output to stdout.


    g_option_context_get_help_enabled ()

    -
    gboolean            g_option_context_get_help_enabled   (GOptionContext *context);
    +
    gboolean            g_option_context_get_help_enabled   (GOptionContext *context);

    Returns whether automatic --help generation -is turned on for context. See g_option_context_set_help_enabled().

    +is turned on for context. See g_option_context_set_help_enabled(). +

    context :

    a GOptionContext +a GOptionContext

    help_enabled :

    TRUE to enable --help, FALSE to disable it + +TRUE to enable --help, FALSE to disable it
    - @@ -777,8 +817,8 @@ is turned on for context. See

    g_option_context_set_ignore_unknown_options ()

    void                g_option_context_set_ignore_unknown_options
    -                                                        (GOptionContext *context,
    -                                                         gboolean ignore_unknown);
    + (GOptionContext *context, + gboolean ignore_unknown);

    Sets whether to ignore unknown options or not. If an argument is ignored, it is left in the argv array after parsing. By default, @@ -787,18 +827,20 @@ ignored, it is left in the argv array af

    This setting does not affect non-option arguments (i.e. arguments which don't start with a dash). But note that GOption cannot reliably -determine whether a non-option belongs to a preceding unknown option.

    +determine whether a non-option belongs to a preceding unknown option. +

    context :

    a GOptionContext +a GOptionContext
    - - @@ -810,16 +852,17 @@ determine whether a non-option belongs to a preceding unknown option.

    g_option_context_get_ignore_unknown_options ()

    gboolean            g_option_context_get_ignore_unknown_options
    -                                                        (GOptionContext *context);
    + (GOptionContext *context);

    Returns whether unknown options are ignored or not. See -g_option_context_set_ignore_unknown_options().

    +g_option_context_set_ignore_unknown_options(). +

    context :

    a GOptionContext +a GOptionContext

    ignore_unknown :

    TRUE to ignore unknown options, FALSE to produce + +TRUE to ignore unknown options, FALSE to produce an error when unknown options are met
    - @@ -835,9 +878,9 @@ Returns whether unknown options are ignored or not. See

    g_option_context_get_help ()

    -
    gchar *             g_option_context_get_help           (GOptionContext *context,
    -                                                         gboolean main_help,
    -                                                         GOptionGroup *group);
    +
    gchar *             g_option_context_get_help           (GOptionContext *context,
    +                                                         gboolean main_help,
    +                                                         GOptionGroup *group);

    Returns a formatted, translated help text for the given context. To obtain the text produced by --help, call @@ -845,23 +888,24 @@ To obtain the text produced by --help, call To obtain the text produced by --help-all, call g_option_context_get_help (context, FALSE, NULL). To obtain the help text for an option group, call -g_option_context_get_help (context, FALSE, group).

    +g_option_context_get_help (context, FALSE, group). +

    context :

    a GOptionContext +a GOptionContext
    - - - @@ -895,57 +939,58 @@ The -x arg, with a long option: --name arg -or combined in a single argument: --name=arg.

    +or combined in a single argument: --name=arg. +

    context :

    a GOptionContext +a GOptionContext

    main_help :

    if TRUE, only include the main group +if TRUE, only include the main group

    group :

    the GOptionGroup to create help for, or NULL +the GOptionGroup to create help for, or NULL
    - - - - - - - - -

    G_OPTION_ARG_NONE

    No extra argument. This is useful for simple flags. +No extra argument. This is useful for simple flags.

    G_OPTION_ARG_STRING

    The option takes a string argument. +The option takes a string argument.

    G_OPTION_ARG_INT

    The option takes an integer argument. +The option takes an integer argument.

    G_OPTION_ARG_CALLBACK

    The option provides a callback to parse the +The option provides a callback to parse the extra argument.

    G_OPTION_ARG_FILENAME

    The option takes a filename as argument. +The option takes a filename as argument.

    G_OPTION_ARG_STRING_ARRAY

    The option takes a string argument, multiple +The option takes a string argument, multiple uses of the option are collected into an array of strings.

    G_OPTION_ARG_FILENAME_ARRAY

    The option takes a filename as argument, +The option takes a filename as argument, multiple uses of the option are collected into an array of strings.

    G_OPTION_ARG_DOUBLE

    The option takes a double argument. The argument +The option takes a double argument. The argument can be formatted either for the user's locale or for the "C" locale. Since 2.12

    G_OPTION_ARG_INT64

    The option takes a 64-bit integer. Like G_OPTION_ARG_INT +The option takes a 64-bit integer. Like G_OPTION_ARG_INT but for larger numbers. The number can be in decimal base, or in hexadecimal (when prefixed with 0x, for example, 0xffffffff). Since 2.12 @@ -969,52 +1014,53 @@ or combined in a single argument: --name=arg.

    } GOptionFlags;

    -Flags which modify individual options.

    +Flags which modify individual options. +

    - - - - - - -

    G_OPTION_FLAG_HIDDEN

    The option doesn't appear in --help +The option doesn't appear in --help output.

    G_OPTION_FLAG_IN_MAIN

    The option appears in the main section of the +The option appears in the main section of the --help output, even if it is defined in a group.

    G_OPTION_FLAG_REVERSE

    For options of the G_OPTION_ARG_NONE kind, this flag +For options of the G_OPTION_ARG_NONE kind, this flag indicates that the sense of the option is reversed.

    G_OPTION_FLAG_NO_ARG

    For options of the G_OPTION_ARG_CALLBACK kind, +For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the callback does not take any argument (like a G_OPTION_ARG_NONE option). Since 2.8

    G_OPTION_FLAG_FILENAME

    For options of the G_OPTION_ARG_CALLBACK +For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the argument should be passed to the callback in the GLib filename encoding rather than UTF-8. Since 2.8

    G_OPTION_FLAG_OPTIONAL_ARG

    For options of the G_OPTION_ARG_CALLBACK +For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the argument supply is optional. If no argument is given then data of GOptionParseFunc will be set to NULL. Since 2.8

    G_OPTION_FLAG_NOALIAS

    This flag turns off the automatic conflict resolution +This flag turns off the automatic conflict resolution which prefixes long option names with groupname- if there is a conflict. This option should only be used in situations where aliasing is necessary to model some legacy commandline interface. It is @@ -1040,7 +1086,8 @@ or G_OPTION_REMAINING instead of simply scanning argv for leftover arguments has the advantage that GOption takes care of -necessary encoding conversions for strings or filenames.

    +necessary encoding conversions for strings or filenames. +

    Since 2.6


    @@ -1061,13 +1108,14 @@ necessary encoding conversions for strings or filenames.

    A GOptionEntry defines a single option. To have an effect, they must be added to a GOptionGroup with -g_option_context_add_main_entries() or g_option_group_add_entries().

    +g_option_context_add_main_entries() or g_option_group_add_entries(). +

    - - - - - - -

    const gchar *long_name;

    The long name of an option can be used to specify it +The long name of an option can be used to specify it in a commandline as --long_name. Every option must have a long name. To resolve conflicts if multiple option groups contain the same long name, it is also possible to @@ -1077,7 +1125,7 @@ To have an effect, they must be added to a gchar short_name;

    If an option has a short name, it can be specified +If an option has a short name, it can be specified -short_name in a commandline. short_name must be a printable ASCII character different from '-', or zero if the option has no short name. @@ -1085,17 +1133,17 @@ To have an effect, they must be added to a gint flags;

    Flags from GOptionFlags. +Flags from GOptionFlags.

    GOptionArg arg;

    The type of the option, as a GOptionArg. +The type of the option, as a GOptionArg.

    gpointer arg_data;

    If the arg type is G_OPTION_ARG_CALLBACK, then arg_data must +If the arg type is G_OPTION_ARG_CALLBACK, then arg_data must point to a GOptionArgFunc callback function, which will be called to handle the extra argument. Otherwise, arg_data is a pointer to a location to store the value, the required type of the location depends on the arg type: @@ -1141,14 +1189,14 @@ To have an effect, they must be added to a const gchar *description;

    the description for the option in --help +the description for the option in --help output. The description is translated using the translate_func of the group, see g_option_group_set_translation_domain().

    const gchar *arg_description;

    The placeholder to use for the extra argument parsed +The placeholder to use for the extra argument parsed by the option in --help output. The arg_description is translated using the translate_func of the group, see g_option_group_set_translation_domain(). @@ -1160,28 +1208,29 @@ To have an effect, they must be added to a

    g_option_context_add_main_entries ()

    -
    void                g_option_context_add_main_entries   (GOptionContext *context,
    -                                                         const GOptionEntry *entries,
    -                                                         const gchar *translation_domain);
    +
    void                g_option_context_add_main_entries   (GOptionContext *context,
    +                                                         const GOptionEntry *entries,
    +                                                         const gchar *translation_domain);

    A convenience function which creates a main group if it doesn't -exist, adds the entries to it and sets the translation domain.

    +exist, adds the entries to it and sets the translation domain. +

    - - - @@ -1202,30 +1251,32 @@ group. The struct has only private fields and should not be directly accessed. All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a GOptionGroup holding their options, which -the application can then add to its GOptionContext.

    +the application can then add to its GOptionContext. +


    g_option_context_add_group ()

    -
    void                g_option_context_add_group          (GOptionContext *context,
    -                                                         GOptionGroup *group);
    +
    void                g_option_context_add_group          (GOptionContext *context,
    +                                                         GOptionGroup *group);

    Adds a GOptionGroup to the context, so that parsing with context will recognize the options in the group. Note that the group will be freed together with the context when g_option_context_free() is called, so you must not free the group yourself after adding it -to a context.

    +to a context. +

    context :

    a GOptionContext +a GOptionContext

    entries :

    a NULL-terminated array of GOptionEntrys +a NULL-terminated array of GOptionEntrys

    translation_domain :

    a translation domain to use for translating +a translation domain to use for translating the --help output for the options in entries with gettext(), or NULL
    - - @@ -1235,24 +1286,25 @@ to a context.


    g_option_context_set_main_group ()

    -
    void                g_option_context_set_main_group     (GOptionContext *context,
    -                                                         GOptionGroup *group);
    +
    void                g_option_context_set_main_group     (GOptionContext *context,
    +                                                         GOptionGroup *group);

    Sets a GOptionGroup as main group of the context. This has the same effect as calling g_option_context_add_group(), the only difference is that the options in the main group are -treated differently when generating --help output.

    +treated differently when generating --help output. +

    context :

    a GOptionContext +a GOptionContext

    group :

    the group to add +the group to add
    - - @@ -1262,15 +1314,16 @@ treated differently when generating --help output.

    g_option_context_get_main_group ()

    -
    GOptionGroup *      g_option_context_get_main_group     (GOptionContext *context);
    +
    GOptionGroup *      g_option_context_get_main_group     (GOptionContext *context);

    -Returns a pointer to the main group of context.

    +Returns a pointer to the main group of context. +

    context :

    a GOptionContext +a GOptionContext

    group :

    the group to set as main group +the group to set as main group
    - @@ -1288,45 +1341,46 @@ Returns a pointer to the main group of context

    g_option_group_new ()

    -
    GOptionGroup *      g_option_group_new                  (const gchar *name,
    -                                                         const gchar *description,
    -                                                         const gchar *help_description,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify destroy);
    +
    GOptionGroup *      g_option_group_new                  (const gchar *name,
    +                                                         const gchar *description,
    +                                                         const gchar *help_description,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify destroy);

    -Creates a new GOptionGroup.

    +Creates a new GOptionGroup. +

    context :

    a GOptionContext +a GOptionContext
    - - - - - @@ -1343,15 +1397,16 @@ Creates a new

    g_option_group_free ()

    -
    void                g_option_group_free                 (GOptionGroup *group);
    +
    void                g_option_group_free                 (GOptionGroup *group);

    Frees a GOptionGroup. Note that you must not -free groups which have been added to a GOptionContext.

    +free groups which have been added to a GOptionContext. +

    name :

    the name for the option group, this is used to provide +the name for the option group, this is used to provide help for the options in this group with --help-name

    description :

    a description for this group to be shown in +a description for this group to be shown in --help. This string is translated using the translation domain or translation function of the group

    help_description :

    a description for the --help-name option. +a description for the --help-name option. This string is translated using the translation domain or translation function of the group

    user_data :

    user data that will be passed to the pre- and post-parse hooks, +user data that will be passed to the pre- and post-parse hooks, the error hook and to callbacks of G_OPTION_ARG_CALLBACK options, or NULL

    destroy :

    a function that will be called to free user_data, or NULL +a function that will be called to free user_data, or NULL
    -

    group :

    a GOptionGroup +a GOptionGroup
    @@ -1360,21 +1415,22 @@ free groups which have been added to a

    g_option_group_add_entries ()

    -
    void                g_option_group_add_entries          (GOptionGroup *group,
    -                                                         const GOptionEntry *entries);
    +
    void                g_option_group_add_entries          (GOptionGroup *group,
    +                                                         const GOptionEntry *entries);

    -Adds the options specified in entries to group.

    +Adds the options specified in entries to group. +

    - - @@ -1384,34 +1440,35 @@ Adds the options specified in entries to

    GOptionParseFunc ()

    -
    gboolean            (*GOptionParseFunc)                 (GOptionContext *context,
    -                                                         GOptionGroup *group,
    -                                                         gpointer data,
    -                                                         GError **error);
    +
    gboolean            (*GOptionParseFunc)                 (GOptionContext *context,
    +                                                         GOptionGroup *group,
    +                                                         gpointer data,
    +                                                         GError **error);

    -The type of function that can be called before and after parsing.

    +The type of function that can be called before and after parsing. +

    group :

    a GOptionGroup +a GOptionGroup

    entries :

    a NULL-terminated array of GOptionEntrys +a NULL-terminated array of GOptionEntrys
    - - - - @@ -1426,9 +1483,9 @@ The type of function that can be called before and after parsing.


    g_option_group_set_parse_hooks ()

    -
    void                g_option_group_set_parse_hooks      (GOptionGroup *group,
    -                                                         GOptionParseFunc pre_parse_func,
    -                                                         GOptionParseFunc post_parse_func);
    +
    void                g_option_group_set_parse_hooks      (GOptionGroup *group,
    +                                                         GOptionParseFunc pre_parse_func,
    +                                                         GOptionParseFunc post_parse_func);

    Associates two functions with group which will be called from g_option_context_parse() before the first option is parsed @@ -1437,23 +1494,24 @@ and after the last option has been parsed, respectively.

    Note that the user data to be passed to pre_parse_func and post_parse_func can be specified when constructing the group -with g_option_group_new().

    +with g_option_group_new(). +

    context :

    The active GOptionContext +The active GOptionContext

    group :

    The group to which the function belongs +The group to which the function belongs

    data :

    User data added to the GOptionGroup containing the option when it +User data added to the GOptionGroup containing the option when it was created with g_option_group_new()

    error :

    A return location for error details +A return location for error details
    - - - @@ -1463,34 +1521,35 @@ with

    GOptionErrorFunc ()

    -
    void                (*GOptionErrorFunc)                 (GOptionContext *context,
    -                                                         GOptionGroup *group,
    -                                                         gpointer data,
    -                                                         GError **error);
    +
    void                (*GOptionErrorFunc)                 (GOptionContext *context,
    +                                                         GOptionGroup *group,
    +                                                         gpointer data,
    +                                                         GError **error);

    -The type of function to be used as callback when a parse error occurs.

    +The type of function to be used as callback when a parse error occurs. +

    group :

    a GOptionGroup +a GOptionGroup

    pre_parse_func :

    a function to call before parsing, or NULL +a function to call before parsing, or NULL

    post_parse_func :

    a function to call after parsing, or NULL +a function to call after parsing, or NULL
    - - - - @@ -1499,26 +1558,27 @@ The type of function to be used as callback when a parse error occurs.


    g_option_group_set_error_hook ()

    -
    void                g_option_group_set_error_hook       (GOptionGroup *group,
    -                                                         GOptionErrorFunc error_func);
    +
    void                g_option_group_set_error_hook       (GOptionGroup *group,
    +                                                         GOptionErrorFunc error_func);

    Associates a function with group which will be called from g_option_context_parse() when an error occurs.

    Note that the user data to be passed to error_func can be -specified when constructing the group with g_option_group_new().

    +specified when constructing the group with g_option_group_new(). +

    context :

    The active GOptionContext +The active GOptionContext

    group :

    The group to which the function belongs +The group to which the function belongs

    data :

    User data added to the GOptionGroup containing the option when it +User data added to the GOptionGroup containing the option when it was created with g_option_group_new()

    error :

    The GError containing details about the parse error +The GError containing details about the parse error
    - - @@ -1528,10 +1588,10 @@ specified when constructing the group with

    g_option_group_set_translate_func ()

    -
    void                g_option_group_set_translate_func   (GOptionGroup *group,
    -                                                         GTranslateFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy_notify);
    +
    void                g_option_group_set_translate_func   (GOptionGroup *group,
    +                                                         GTranslateFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy_notify);

    Sets the function which is used to translate user-visible strings, for --help output. Different @@ -1540,28 +1600,29 @@ is

    If you are using gettext(), you only need to set the translation -domain, see g_option_group_set_translation_domain().

    +domain, see g_option_group_set_translation_domain(). +

    group :

    a GOptionGroup +a GOptionGroup

    error_func :

    a function to call when an error occurs +a function to call when an error occurs
    - - - - @@ -1572,22 +1633,23 @@ domain, see

    g_option_group_set_translation_domain ()

    void                g_option_group_set_translation_domain
    -                                                        (GOptionGroup *group,
    -                                                         const gchar *domain);
    + (GOptionGroup *group, + const gchar *domain);

    A convenience function to use gettext() for translating -user-visible strings.

    +user-visible strings. +

    group :

    a GOptionGroup +a GOptionGroup

    func :

    the GTranslateFunc, or NULL +the GTranslateFunc, or NULL

    data :

    user data to pass to func, or NULL +user data to pass to func, or NULL

    destroy_notify :

    a function which gets called to free data, or NULL +a function which gets called to free data, or NULL
    - - @@ -1598,6 +1660,6 @@ user-visible strings.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Data-Checksums.html b/docs/reference/glib/html/glib-Data-Checksums.html index 62277f3..dc4d4e0 100644 --- a/docs/reference/glib/html/glib-Data-Checksums.html +++ b/docs/reference/glib/html/glib-Data-Checksums.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    group :

    a GOptionGroup +a GOptionGroup

    domain :

    the domain to use +the domain to use
    @@ -61,26 +41,26 @@ #include <glib.h> enum GChecksumType; -gssize g_checksum_type_get_length (GChecksumType checksum_type); +gssize g_checksum_type_get_length (GChecksumType checksum_type); GChecksum; -GChecksum * g_checksum_new (GChecksumType checksum_type); -GChecksum * g_checksum_copy (const GChecksum *checksum); -void g_checksum_free (GChecksum *checksum); -void g_checksum_reset (GChecksum *checksum); -void g_checksum_update (GChecksum *checksum, - const guchar *data, - gssize length); -const gchar * g_checksum_get_string (GChecksum *checksum); -void g_checksum_get_digest (GChecksum *checksum, - guint8 *buffer, - gsize *digest_len); +GChecksum * g_checksum_new (GChecksumType checksum_type); +GChecksum * g_checksum_copy (const GChecksum *checksum); +void g_checksum_free (GChecksum *checksum); +void g_checksum_reset (GChecksum *checksum); +void g_checksum_update (GChecksum *checksum, + const guchar *data, + gssize length); +const gchar * g_checksum_get_string (GChecksum *checksum); +void g_checksum_get_digest (GChecksum *checksum, + guint8 *buffer, + gsize *digest_len); -gchar * g_compute_checksum_for_data (GChecksumType checksum_type, - const guchar *data, - gsize length); -gchar * g_compute_checksum_for_string (GChecksumType checksum_type, - const gchar *str, - gssize length); +gchar * g_compute_checksum_for_data (GChecksumType checksum_type, + const guchar *data, + gsize length); +gchar * g_compute_checksum_for_string (GChecksumType checksum_type, + const gchar *str, + gssize length);
    @@ -102,7 +82,8 @@ one go, use the convenience functions g_compute_checksum_for_string(), respectively.

    -Support for checksums has been added in GLib 2.16

    +Support for checksums has been added in GLib 2.16 +

    Details

    @@ -120,23 +101,24 @@ digest of some data.

    Note that the GChecksumType enumeration may be extended at a later -date to include new hashing algorithm types.

    +date to include new hashing algorithm types. +

    - - - @@ -146,15 +128,16 @@ date to include new hashing algorithm types.


    g_checksum_type_get_length ()

    -
    gssize              g_checksum_type_get_length          (GChecksumType checksum_type);
    +
    gssize              g_checksum_type_get_length          (GChecksumType checksum_type);

    -Gets the length in bytes of digests of type checksum_type

    +Gets the length in bytes of digests of type checksum_type +

    G_CHECKSUM_MD5

    Use the MD5 hashing algorithm +Use the MD5 hashing algorithm

    G_CHECKSUM_SHA1

    Use the SHA-1 hashing algorithm +Use the SHA-1 hashing algorithm

    G_CHECKSUM_SHA256

    Use the SHA-256 hashing algorithm +Use the SHA-256 hashing algorithm
    - @@ -175,13 +158,14 @@ not supported.

    An opaque structure representing a checksumming operation. To create a new GChecksum, use g_checksum_new(). To free -a GChecksum, use g_checksum_free().

    +a GChecksum, use g_checksum_free(). +

    Since 2.16


    g_checksum_new ()

    -
    GChecksum *         g_checksum_new                      (GChecksumType checksum_type);
    +
    GChecksum *         g_checksum_new                      (GChecksumType checksum_type);

    Creates a new GChecksum, using the checksum algorithm checksum_type. If the checksum_type is not known, NULL is returned. @@ -196,13 +180,14 @@ hexadecimal string; or g_checksum_get_string() or g_checksum_get_digest() have been called on a GChecksum, the checksum will be closed and it won't be possible to call g_checksum_update() -on it anymore.

    +on it anymore. +

    checksum_type :

    a GChecksumType +a GChecksumType
    - @@ -219,17 +204,18 @@ on it anymore.


    g_checksum_copy ()

    -
    GChecksum *         g_checksum_copy                     (const GChecksum *checksum);
    +
    GChecksum *         g_checksum_copy                     (const GChecksum *checksum);

    Copies a GChecksum. If checksum has been closed, by calling g_checksum_get_string() or g_checksum_get_digest(), the copied -checksum will be closed as well.

    +checksum will be closed as well. +

    checksum_type :

    the desired type of checksum +the desired type of checksum
    - @@ -246,14 +232,15 @@ checksum will be closed as well.


    g_checksum_free ()

    -
    void                g_checksum_free                     (GChecksum *checksum);
    +
    void                g_checksum_free                     (GChecksum *checksum);

    -Frees the memory allocated for checksum.

    +Frees the memory allocated for checksum. +

    checksum :

    the GChecksum to copy +the GChecksum to copy
    -

    checksum :

    a GChecksum +a GChecksum
    @@ -262,14 +249,15 @@ Frees the memory allocated for checksum.

    g_checksum_reset ()

    -
    void                g_checksum_reset                    (GChecksum *checksum);
    +
    void                g_checksum_reset                    (GChecksum *checksum);

    -Resets the state of the checksum back to its initial state.

    +Resets the state of the checksum back to its initial state. +

    -

    checksum :

    the GChecksum to reset +the GChecksum to reset
    @@ -278,29 +266,30 @@ Resets the state of the checksum back to

    g_checksum_update ()

    -
    void                g_checksum_update                   (GChecksum *checksum,
    -                                                         const guchar *data,
    -                                                         gssize length);
    +
    void                g_checksum_update                   (GChecksum *checksum,
    +                                                         const guchar *data,
    +                                                         gssize length);

    Feeds data into an existing GChecksum. The checksum must still be open, that is g_checksum_get_string() or g_checksum_get_digest() must -not have been called on checksum.

    +not have been called on checksum. +

    - - - @@ -310,7 +299,7 @@ not have been called on checksum.


    g_checksum_get_string ()

    -
    const gchar *       g_checksum_get_string               (GChecksum *checksum);
    +
    const gchar *       g_checksum_get_string               (GChecksum *checksum);

    Gets the digest as an hexadecimal string.

    @@ -319,13 +308,14 @@ Once this function has been called the g_checksum_update().

    -The hexadecimal characters will be lower case.

    +The hexadecimal characters will be lower case. +

    checksum :

    a GChecksum +a GChecksum

    data :

    buffer used to compute the checksum +buffer used to compute the checksum

    length :

    size of the buffer, or -1 if it is a null-terminated string. +size of the buffer, or -1 if it is a null-terminated string.
    - @@ -343,32 +333,33 @@ The hexadecimal characters will be lower case.


    g_checksum_get_digest ()

    -
    void                g_checksum_get_digest               (GChecksum *checksum,
    -                                                         guint8 *buffer,
    -                                                         gsize *digest_len);
    +
    void                g_checksum_get_digest               (GChecksum *checksum,
    +                                                         guint8 *buffer,
    +                                                         gsize *digest_len);

    Gets the digest from checksum as a raw binary vector and places it into buffer. The size of the digest depends on the type of checksum.

    Once this function has been called, the GChecksum is closed and can -no longer be updated with g_checksum_update().

    +no longer be updated with g_checksum_update(). +

    checksum :

    a GChecksum +a GChecksum
    - - - @@ -379,32 +370,33 @@ no longer be updated with

    g_compute_checksum_for_data ()

    -
    gchar *             g_compute_checksum_for_data         (GChecksumType checksum_type,
    -                                                         const guchar *data,
    -                                                         gsize length);
    +
    gchar *             g_compute_checksum_for_data         (GChecksumType checksum_type,
    +                                                         const guchar *data,
    +                                                         gsize length);

    Computes the checksum for a binary data of length. This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().

    -The hexadecimal string returned will be in lower case.

    +The hexadecimal string returned will be in lower case. +

    checksum :

    a GChecksum +a GChecksum

    buffer :

    output buffer +output buffer

    digest_len :

    an inout parameter. The caller initializes it to the size of buffer. +an inout parameter. The caller initializes it to the size of buffer. After the call it contains the length of the digest.
    - - - @@ -421,30 +413,31 @@ The hexadecimal string returned will be in lower case.


    g_compute_checksum_for_string ()

    -
    gchar *             g_compute_checksum_for_string       (GChecksumType checksum_type,
    -                                                         const gchar *str,
    -                                                         gssize length);
    +
    gchar *             g_compute_checksum_for_string       (GChecksumType checksum_type,
    +                                                         const gchar *str,
    +                                                         gssize length);

    Computes the checksum of a string.

    -The hexadecimal string returned will be in lower case.

    +The hexadecimal string returned will be in lower case. +

    checksum_type :

    a GChecksumType +a GChecksumType

    data :

    binary blob to compute the digest of +binary blob to compute the digest of

    length :

    length of data +length of data
    - - - @@ -462,6 +455,6 @@ The hexadecimal string returned will be in lower case.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Datasets.html b/docs/reference/glib/html/glib-Datasets.html index f5c7a44..1648d62 100644 --- a/docs/reference/glib/html/glib-Datasets.html +++ b/docs/reference/glib/html/glib-Datasets.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    checksum_type :

    a GChecksumType +a GChecksumType

    str :

    the string to compute the checksum of +the string to compute the checksum of

    length :

    the length of the string, or -1 if the string is null-terminated. +the length of the string, or -1 if the string is null-terminated.
    @@ -61,31 +41,42 @@
     #include <glib.h>
     
    -#define             g_dataset_id_set_data               (l, k, d)
    -void                g_dataset_id_set_data_full          (gconstpointer dataset_location,
    -                                                         GQuark key_id,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy_func);
    -void                (*GDestroyNotify)                   (gpointer data);
    -gpointer            g_dataset_id_get_data               (gconstpointer dataset_location,
    -                                                         GQuark key_id);
    -#define             g_dataset_id_remove_data            (l, k)
    -gpointer            g_dataset_id_remove_no_notify       (gconstpointer dataset_location,
    -                                                         GQuark key_id);
    +#define             g_dataset_id_set_data               (l,
    +                                                         k,
    +                                                         d)
    +void                g_dataset_id_set_data_full          (gconstpointer dataset_location,
    +                                                         GQuark key_id,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy_func);
    +void                (*GDestroyNotify)                   (gpointer data);
    +gpointer            g_dataset_id_get_data               (gconstpointer dataset_location,
    +                                                         GQuark key_id);
    +#define             g_dataset_id_remove_data            (l,
    +                                                         k)
    +gpointer            g_dataset_id_remove_no_notify       (gconstpointer dataset_location,
    +                                                         GQuark key_id);
     
    -#define             g_dataset_set_data                  (l, k, d)
    -#define             g_dataset_set_data_full             (l, k, d, f)
    -#define             g_dataset_get_data                  (l, k)
    -#define             g_dataset_remove_data               (l, k)
    -#define             g_dataset_remove_no_notify          (l, k)
    +#define             g_dataset_set_data                  (l,
    +                                                         k,
    +                                                         d)
    +#define             g_dataset_set_data_full             (l,
    +                                                         k,
    +                                                         d,
    +                                                         f)
    +#define             g_dataset_get_data                  (l,
    +                                                         k)
    +#define             g_dataset_remove_data               (l,
    +                                                         k)
    +#define             g_dataset_remove_no_notify          (l,
    +                                                         k)
     
    -void                g_dataset_foreach                   (gconstpointer dataset_location,
    -                                                         GDataForeachFunc func,
    -                                                         gpointer user_data);
    -void                (*GDataForeachFunc)                 (GQuark key_id,
    -                                                         gpointer data,
    -                                                         gpointer user_data);
    -void                g_dataset_destroy                   (gconstpointer dataset_location);
    +void                g_dataset_foreach                   (gconstpointer dataset_location,
    +                                                         GDataForeachFunc func,
    +                                                         gpointer user_data);
    +void                (*GDataForeachFunc)                 (GQuark key_id,
    +                                                         gpointer data,
    +                                                         gpointer user_data);
    +void                g_dataset_destroy                   (gconstpointer dataset_location);
     
    @@ -128,7 +119,8 @@ To remove data elements from a dataset use g_dataset_id_remove_data() and g_dataset_remove_data().

    -To destroy a dataset, use g_dataset_destroy().

    +To destroy a dataset, use g_dataset_destroy(). +

    Details

    @@ -138,23 +130,24 @@ To destroy a dataset, use GQuark id. Any previous data with the same key is removed, and its destroy function -is called.

    +is called. +

    - - - @@ -163,36 +156,37 @@ is called.


    g_dataset_id_set_data_full ()

    -
    void                g_dataset_id_set_data_full          (gconstpointer dataset_location,
    -                                                         GQuark key_id,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy_func);
    +
    void                g_dataset_id_set_data_full          (gconstpointer dataset_location,
    +                                                         GQuark key_id,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy_func);

    Sets the data element associated with the given GQuark id, and also the function to call when the data element is destroyed. Any previous data with the same key is removed, and its destroy function -is called.

    +is called. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the GQuark id to identify the data element. +the GQuark id to identify the data element.

    d :

    the data element. +the data element.
    - - - -

    dataset_location :

    the location identifying the dataset. +the location identifying the dataset.

    key_id :

    the GQuark id to identify the data element. +the GQuark id to identify the data element.

    data :

    the data element. +the data element.

    destroy_func :

    the function to call when the data element is +the function to call when the data element is removed. This function will be called with the data element and can be used to free any memory allocated for it. @@ -204,16 +198,17 @@ is called.


    GDestroyNotify ()

    -
    void                (*GDestroyNotify)                   (gpointer data);
    +
    void                (*GDestroyNotify)                   (gpointer data);

    Specifies the type of function which is called when a data element is destroyed. It is passed the pointer to the data element and -should free any memory and resources allocated for it.

    +should free any memory and resources allocated for it. +

    -

    data :

    the data element. +the data element.
    @@ -221,26 +216,27 @@ should free any memory and resources allocated for it.


    g_dataset_id_get_data ()

    -
    gpointer            g_dataset_id_get_data               (gconstpointer dataset_location,
    -                                                         GQuark key_id);
    +
    gpointer            g_dataset_id_get_data               (gconstpointer dataset_location,
    +                                                         GQuark key_id);

    -Gets the data element corresponding to a GQuark.

    +Gets the data element corresponding to a GQuark. +

    - - - @@ -253,18 +249,19 @@ Gets the data element corresponding to a #define g_dataset_id_remove_data(l, k)

    Removes a data element from a dataset. The data element's destroy -function is called if it has been set.

    +function is called if it has been set. +

    dataset_location :

    the location identifying the dataset. +the location identifying the dataset.

    key_id :

    the GQuark id to identify the data element. +the GQuark id to identify the data element.

    Returns :

    the data element corresponding to the GQuark, or NULL if +the data element corresponding to the GQuark, or NULL if it is not found.
    - - @@ -273,27 +270,28 @@ function is called if it has been set.


    g_dataset_id_remove_no_notify ()

    -
    gpointer            g_dataset_id_remove_no_notify       (gconstpointer dataset_location,
    -                                                         GQuark key_id);
    +
    gpointer            g_dataset_id_remove_no_notify       (gconstpointer dataset_location,
    +                                                         GQuark key_id);

    Removes an element, without calling its destroy notification -function.

    +function. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the GQuark id identifying the data element. +the GQuark id identifying the data element.
    - - - @@ -304,23 +302,24 @@ function.

    g_dataset_set_data()

    #define             g_dataset_set_data(l, k, d)

    -Sets the data corresponding to the given string identifier.

    +Sets the data corresponding to the given string identifier. +

    dataset_location :

    the location identifying the dataset. +the location identifying the dataset.

    key_id :

    the GQuark ID identifying the data element. +the GQuark ID identifying the data element.

    Returns :

    the data previously stored at key_id, or NULL if none. +the data previously stored at key_id, or NULL if none.
    - - - @@ -332,28 +331,29 @@ Sets the data corresponding to the given string identifier.

    #define             g_dataset_set_data_full(l, k, d, f)

    Sets the data corresponding to the given string identifier, and the -function to call when the data element is destroyed.

    +function to call when the data element is destroyed. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the string to identify the data element. +the string to identify the data element.

    d :

    the data element. +the data element.
    - - - - @@ -366,23 +366,24 @@ function to call when the data element is destroyed.

    g_dataset_get_data()

    #define             g_dataset_get_data(l, k)

    -Gets the data element corresponding to a string.

    +Gets the data element corresponding to a string. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the string to identify the data element. +the string to identify the data element.

    d :

    the data element. +the data element.

    f :

    the function to call when the data element is removed. This +the function to call when the data element is removed. This function will be called with the data element and can be used to free any memory allocated for it.
    - - - @@ -395,18 +396,19 @@ Gets the data element corresponding to a string.

    #define             g_dataset_remove_data(l, k)

    Removes a data element corresponding to a string. Its destroy -function is called if it has been set.

    +function is called if it has been set. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the string identifying the data element. +the string identifying the data element.

    Returns :

    the data element corresponding to the string, or NULL if +the data element corresponding to the string, or NULL if it is not found.
    - - @@ -417,18 +419,19 @@ function is called if it has been set.

    g_dataset_remove_no_notify()

    #define             g_dataset_remove_no_notify(l, k)

    -Removes an element, without calling its destroy notifier.

    +Removes an element, without calling its destroy notifier. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the string identifying the data element. +the string identifying the data element.
    - - @@ -437,30 +440,31 @@ Removes an element, without calling its destroy notifier.


    g_dataset_foreach ()

    -
    void                g_dataset_foreach                   (gconstpointer dataset_location,
    -                                                         GDataForeachFunc func,
    -                                                         gpointer user_data);
    +
    void                g_dataset_foreach                   (gconstpointer dataset_location,
    +                                                         GDataForeachFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each data element which is associated with the given location. Note that this function is NOT thread-safe. So unless datalist can be protected from any modifications during -invocation of this function, it should not be called.

    +invocation of this function, it should not be called. +

    l :

    the location identifying the dataset. +the location identifying the dataset.

    k :

    the string identifying the data element. +the string identifying the data element.
    - - - @@ -469,29 +473,30 @@ invocation of this function, it should not be called.


    GDataForeachFunc ()

    -
    void                (*GDataForeachFunc)                 (GQuark key_id,
    -                                                         gpointer data,
    -                                                         gpointer user_data);
    +
    void                (*GDataForeachFunc)                 (GQuark key_id,
    +                                                         gpointer data,
    +                                                         gpointer user_data);

    Specifies the type of function passed to g_dataset_foreach(). It is called with each GQuark id and associated data element, together -with the user_data parameter supplied to g_dataset_foreach().

    +with the user_data parameter supplied to g_dataset_foreach(). +

    dataset_location :

    the location identifying the dataset. +the location identifying the dataset.

    func :

    the function to call for each data element. +the function to call for each data element.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    - - - @@ -500,15 +505,16 @@ with the user_data parameter supplied to

    g_dataset_destroy ()

    -
    void                g_dataset_destroy                   (gconstpointer dataset_location);
    +
    void                g_dataset_destroy                   (gconstpointer dataset_location);

    Destroys the dataset, freeing all memory allocated, and calling any -destroy functions set for data elements.

    +destroy functions set for data elements. +

    key_id :

    the GQuark id to identifying the data element. +the GQuark id to identifying the data element.

    data :

    the data element. +the data element.

    user_data :

    user data passed to g_dataset_foreach(). +user data passed to g_dataset_foreach().
    -

    dataset_location :

    the location identifying the dataset. +the location identifying the dataset.
    @@ -517,6 +523,6 @@ destroy functions set for data elements.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Date-and-Time-Functions.html b/docs/reference/glib/html/glib-Date-and-Time-Functions.html index 177b7c5..a95cbe6 100644 --- a/docs/reference/glib/html/glib-Date-and-Time-Functions.html +++ b/docs/reference/glib/html/glib-Date-and-Time-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -62,13 +42,13 @@ #define G_USEC_PER_SECGTimeVal; -voidg_get_current_time (GTimeVal *result); -voidg_usleep (gulong microseconds); -voidg_time_val_add (GTimeVal *time_, - glong microseconds); -gbooleang_time_val_from_iso8601 (const gchar *iso_date, - GTimeVal *time_); -gchar* g_time_val_to_iso8601 (GTimeVal *time_); +voidg_get_current_time (GTimeVal *result); +voidg_usleep (gulong microseconds); +voidg_time_val_add (GTimeVal *time_, + glong microseconds); +gbooleang_time_val_from_iso8601 (const gchar *iso_date, + GTimeVal *time_); +gchar* g_time_val_to_iso8601 (GTimeVal *time_); GDate; typedef GTime; @@ -82,92 +62,92 @@ enum G_DATE_BAD_JULIAN #define G_DATE_BAD_YEAR -GDate* g_date_new (void); -GDate* g_date_new_dmy (GDateDay day, - GDateMonth month, - GDateYear year); -GDate* g_date_new_julian (guint32 julian_day); -voidg_date_clear (GDate *date, - guint n_dates); -voidg_date_free (GDate *date); +GDate* g_date_new (void); +GDate* g_date_new_dmy (GDateDay day, + GDateMonth month, + GDateYear year); +GDate* g_date_new_julian (guint32 julian_day); +voidg_date_clear (GDate *date, + guint n_dates); +voidg_date_free (GDate *date); -voidg_date_set_day (GDate *date, - GDateDay day); -voidg_date_set_month (GDate *date, - GDateMonth month); -voidg_date_set_year (GDate *date, - GDateYear year); -voidg_date_set_dmy (GDate *date, - GDateDay day, - GDateMonth month, - GDateYear y); -voidg_date_set_julian (GDate *date, - guint32 julian_date); -voidg_date_set_time (GDate *date, - GTime time_); -voidg_date_set_time_t (GDate *date, - time_t timet); -voidg_date_set_time_val (GDate *date, - GTimeVal *timeval); -voidg_date_set_parse (GDate *date, - const gchar *str); +voidg_date_set_day (GDate *date, + GDateDay day); +voidg_date_set_month (GDate *date, + GDateMonth month); +voidg_date_set_year (GDate *date, + GDateYear year); +voidg_date_set_dmy (GDate *date, + GDateDay day, + GDateMonth month, + GDateYear y); +voidg_date_set_julian (GDate *date, + guint32 julian_date); +voidg_date_set_time (GDate *date, + GTime time_); +voidg_date_set_time_t (GDate *date, + time_t timet); +voidg_date_set_time_val (GDate *date, + GTimeVal *timeval); +voidg_date_set_parse (GDate *date, + const gchar *str); -voidg_date_add_days (GDate *date, - guint n_days); -voidg_date_subtract_days (GDate *date, - guint n_days); -voidg_date_add_months (GDate *date, - guint n_months); -voidg_date_subtract_months (GDate *date, - guint n_months); -voidg_date_add_years (GDate *date, - guint n_years); -voidg_date_subtract_years (GDate *date, - guint n_years); -gintg_date_days_between (const GDate *date1, - const GDate *date2); -gintg_date_compare (const GDate *lhs, - const GDate *rhs); -voidg_date_clamp (GDate *date, - const GDate *min_date, - const GDate *max_date); -voidg_date_order (GDate *date1, - GDate *date2); +voidg_date_add_days (GDate *date, + guint n_days); +voidg_date_subtract_days (GDate *date, + guint n_days); +voidg_date_add_months (GDate *date, + guint n_months); +voidg_date_subtract_months (GDate *date, + guint n_months); +voidg_date_add_years (GDate *date, + guint n_years); +voidg_date_subtract_years (GDate *date, + guint n_years); +gintg_date_days_between (const GDate *date1, + const GDate *date2); +gintg_date_compare (const GDate *lhs, + const GDate *rhs); +voidg_date_clamp (GDate *date, + const GDate *min_date, + const GDate *max_date); +voidg_date_order (GDate *date1, + GDate *date2); -GDateDayg_date_get_day (const GDate *date); -GDateMonthg_date_get_month (const GDate *date); -GDateYearg_date_get_year (const GDate *date); -guint32g_date_get_julian (const GDate *date); -GDateWeekdayg_date_get_weekday (const GDate *date); -guintg_date_get_day_of_year (const GDate *date); +GDateDayg_date_get_day (const GDate *date); +GDateMonthg_date_get_month (const GDate *date); +GDateYearg_date_get_year (const GDate *date); +guint32g_date_get_julian (const GDate *date); +GDateWeekdayg_date_get_weekday (const GDate *date); +guintg_date_get_day_of_year (const GDate *date); -guint8g_date_get_days_in_month (GDateMonth month, - GDateYear year); -gbooleang_date_is_first_of_month (const GDate *date); -gbooleang_date_is_last_of_month (const GDate *date); -gbooleang_date_is_leap_year (GDateYear year); -guintg_date_get_monday_week_of_year (const GDate *date); -guint8g_date_get_monday_weeks_in_year (GDateYear year); -guintg_date_get_sunday_week_of_year (const GDate *date); -guint8g_date_get_sunday_weeks_in_year (GDateYear year); -guintg_date_get_iso8601_week_of_year (const GDate *date); +guint8g_date_get_days_in_month (GDateMonth month, + GDateYear year); +gbooleang_date_is_first_of_month (const GDate *date); +gbooleang_date_is_last_of_month (const GDate *date); +gbooleang_date_is_leap_year (GDateYear year); +guintg_date_get_monday_week_of_year (const GDate *date); +guint8g_date_get_monday_weeks_in_year (GDateYear year); +guintg_date_get_sunday_week_of_year (const GDate *date); +guint8g_date_get_sunday_weeks_in_year (GDateYear year); +guintg_date_get_iso8601_week_of_year (const GDate *date); -gsizeg_date_strftime (gchar *s, - gsize slen, - const gchar *format, - const GDate *date); -voidg_date_to_struct_tm (const GDate *date, - struct tm *tm); +gsizeg_date_strftime (gchar *s, + gsize slen, + const gchar *format, + const GDate *date); +voidg_date_to_struct_tm (const GDate *date, + struct tm *tm); -gbooleang_date_valid (const GDate *date); -gbooleang_date_valid_day (GDateDay day); -gbooleang_date_valid_month (GDateMonth month); -gbooleang_date_valid_year (GDateYear year); -gbooleang_date_valid_dmy (GDateDay day, - GDateMonth month, - GDateYear year); -gbooleang_date_valid_julian (guint32 julian_date); -gbooleang_date_valid_weekday (GDateWeekday weekday); +gbooleang_date_valid (const GDate *date); +gbooleang_date_valid_day (GDateDay day); +gbooleang_date_valid_month (GDateMonth month); +gbooleang_date_valid_year (GDateYear year); +gbooleang_date_valid_dmy (GDateDay day, + GDateMonth month, + GDateYear year); +gbooleang_date_valid_julian (guint32 julian_date); +gbooleang_date_valid_weekday (GDateWeekday weekday);
    @@ -264,14 +244,16 @@ the gettimeofday() U

    g_get_current_time ()

    -
    void                g_get_current_time                  (GTimeVal *result);
    +
    void                g_get_current_time                  (GTimeVal *result);

    -Equivalent to the UNIX gettimeofday() function, but portable.

    +Equivalent to the UNIX gettimeofday() function, but portable. +

    -

    result :

    GTimeVal structure in which to store current time. + +GTimeVal structure in which to store current time.
    @@ -279,7 +261,7 @@ Equivalent to the UNIX gettimeofday() function, bu

    g_usleep ()

    -
    void                g_usleep                            (gulong microseconds);
    +
    void                g_usleep                            (gulong microseconds);

    Pauses the current thread for the given number of microseconds. There are 1 million microseconds per second (represented by the @@ -299,22 +281,23 @@ length of the sleep.


    g_time_val_add ()

    -
    void                g_time_val_add                      (GTimeVal *time_,
    -                                                         glong microseconds);
    +
    void                g_time_val_add                      (GTimeVal *time_,
    +                                                         glong microseconds);

    Adds the given number of microseconds to time_. microseconds can -also be negative to decrease the value of time_.

    +also be negative to decrease the value of time_. +

    - - @@ -323,22 +306,23 @@ also be negative to decrease the value of time_

    g_time_val_from_iso8601 ()

    -
    gboolean            g_time_val_from_iso8601             (const gchar *iso_date,
    -                                                         GTimeVal *time_);
    +
    gboolean            g_time_val_from_iso8601             (const gchar *iso_date,
    +                                                         GTimeVal *time_);

    Converts a string containing an ISO 8601 encoded date and time -to a GTimeVal and puts it into time_.

    +to a GTimeVal and puts it into time_. +

    time_ :

    a GTimeVal +a GTimeVal

    microseconds :

    number of microseconds to add to time +number of microseconds to add to time
    - - @@ -354,16 +338,17 @@ to a

    g_time_val_to_iso8601 ()

    -
    gchar*              g_time_val_to_iso8601               (GTimeVal *time_);
    +
    gchar*              g_time_val_to_iso8601               (GTimeVal *time_);

    Converts time_ into an ISO 8601 encoded string, relative to the -Coordinated Universal Time (UTC).

    +Coordinated Universal Time (UTC). +

    iso_date :

    an ISO 8601 encoded date string +an ISO 8601 encoded date string

    time_ :

    a GTimeVal +a GTimeVal
    - @@ -462,12 +447,23 @@ Therefore, GTime will overflow in the year 2038, and you cannot use the address of a GTime variable as argument to the UNIX time() function. Instead, do the following:

    -
    -time_t ttime;
    -GTime gtime;
    -time (&ttime);
    -gtime = (GTime)ttime;
    -
    +
    +

    time_ :

    a GTimeVal +a GTimeVal
    + + + + + + +
    1
    +2
    +3
    +4
    time_t ttime;
    +GTime gtime;
    +time (&ttime);
    +gtime = (GTime)ttime;
    +
    +

    @@ -717,7 +713,7 @@ Represents an invalid year.

    g_date_new ()

    -
    GDate*              g_date_new                          (void);
    +
    GDate*              g_date_new                          (void);

    Allocates a GDate and initializes it to a sane state. The new date will be cleared (as if you'd called g_date_clear()) but invalid (it won't @@ -735,9 +731,9 @@ represent an existing day). Free the return value with

    g_date_new_dmy ()

    -
    GDate*              g_date_new_dmy                      (GDateDay day,
    -                                                         GDateMonth month,
    -                                                         GDateYear year);
    +
    GDate*              g_date_new_dmy                      (GDateDay day,
    +                                                         GDateMonth month,
    +                                                         GDateYear year);

    Like g_date_new(), but also sets the value of the date. Assuming the day-month-year triplet you pass in represents an existing day, the @@ -772,7 +768,7 @@ returned date will be valid.


    g_date_new_julian ()

    -
    GDate*              g_date_new_julian                   (guint32 julian_day);
    +
    GDate*              g_date_new_julian                   (guint32 julian_day);

    Like g_date_new(), but also sets the value of the date. Assuming the Julian day number you pass in is valid (greater than 0, less than an @@ -797,8 +793,8 @@ unreasonably large number), the returned date will be valid.


    g_date_clear ()

    -
    void                g_date_clear                        (GDate *date,
    -                                                         guint n_dates);
    +
    void                g_date_clear                        (GDate *date,
    +                                                         guint n_dates);

    Initializes one or more GDate structs to a sane but invalid state. The cleared dates will not represent an existing date, but will @@ -824,7 +820,7 @@ Validity can be tested with

    g_date_free ()

    -
    void                g_date_free                         (GDate *date);
    +
    void                g_date_free                         (GDate *date);

    Frees a GDate returned from g_date_new().

    @@ -840,8 +836,8 @@ Frees a

    g_date_set_day ()

    -
    void                g_date_set_day                      (GDate *date,
    -                                                         GDateDay day);
    +
    void                g_date_set_day                      (GDate *date,
    +                                                         GDateDay day);

    Sets the day of the month for a GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. @@ -865,8 +861,8 @@ triplet is invalid, the date will be invalid.


    g_date_set_month ()

    -
    void                g_date_set_month                    (GDate *date,
    -                                                         GDateMonth month);
    +
    void                g_date_set_month                    (GDate *date,
    +                                                         GDateMonth month);

    Sets the month of the year for a GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. @@ -890,8 +886,8 @@ day-month-year triplet is invalid, the date will be invalid.


    g_date_set_year ()

    -
    void                g_date_set_year                     (GDate *date,
    -                                                         GDateYear year);
    +
    void                g_date_set_year                     (GDate *date,
    +                                                         GDateYear year);

    Sets the year for a GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. @@ -915,10 +911,10 @@ invalid, the date will be invalid.


    g_date_set_dmy ()

    -
    void                g_date_set_dmy                      (GDate *date,
    -                                                         GDateDay day,
    -                                                         GDateMonth month,
    -                                                         GDateYear y);
    +
    void                g_date_set_dmy                      (GDate *date,
    +                                                         GDateDay day,
    +                                                         GDateMonth month,
    +                                                         GDateYear y);

    Sets the value of a GDate from a day, month, and year. The day-month-year triplet must be valid; if you aren't sure it is, call g_date_valid_dmy() to @@ -953,8 +949,8 @@ check before you set it.


    g_date_set_julian ()

    -
    void                g_date_set_julian                   (GDate *date,
    -                                                         guint32 julian_date);
    +
    void                g_date_set_julian                   (GDate *date,
    +                                                         guint32 julian_date);

    Sets the value of a GDate from a Julian day number.

    @@ -977,26 +973,28 @@ Sets the value of a

    g_date_set_time ()

    -
    void                g_date_set_time                     (GDate *date,
    -                                                         GTime time_);
    +
    void                g_date_set_time                     (GDate *date,
    +                                                         GTime time_);

    Warning

    g_date_set_time has been deprecated since version 2.10 and should not be used in newly-written code. Use g_date_set_time_t() instead.

    Sets the value of a date from a GTime value. -The time to date conversion is done using the user's current timezone.

    +The time to date conversion is done using the user's current timezone. +

    - - @@ -1005,8 +1003,8 @@ The time to date conversion is done using the user's current timezone.


    g_date_set_time_t ()

    -
    void                g_date_set_time_t                   (GDate *date,
    -                                                         time_t timet);
    +
    void                g_date_set_time_t                   (GDate *date,
    +                                                         time_t timet);

    Sets the value of a date to the date corresponding to a time specified as a time_t. The time to date conversion is done using @@ -1015,20 +1013,31 @@ the user's current timezone.

    To set the value of a date to the current day, you could write:

    -
    - g_date_set_time_t (date, time (NULL)); 
    -
    +
    +

    date :

    a GDate. +a GDate.

    time_ :

    GTime value to set. + +GTime value to set.
    + + + + + + +
    1
    g_date_set_time_t (date, time (NULL));
    +
    + +

    +

    - - @@ -1038,23 +1047,25 @@ To set the value of a date to the current day, you could write:

    g_date_set_time_val ()

    -
    void                g_date_set_time_val                 (GDate *date,
    -                                                         GTimeVal *timeval);
    +
    void                g_date_set_time_val                 (GDate *date,
    +                                                         GTimeVal *timeval);

    Sets the value of a date from a GTimeVal value. Note that the tv_usec member is ignored, because GDate can't make use of the -additional precision.

    +additional precision. +

    date :

    a GDate +a GDate

    timet :

    time_t value to set + +time_t value to set
    - - @@ -1064,8 +1075,8 @@ additional precision.


    g_date_set_parse ()

    -
    void                g_date_set_parse                    (GDate *date,
    -                                                         const gchar *str);
    +
    void                g_date_set_parse                    (GDate *date,
    +                                                         const gchar *str);

    Parses a user-inputted string str, and try to figure out what date it represents, taking the current locale @@ -1099,8 +1110,8 @@ capacity).


    g_date_add_days ()

    -
    void                g_date_add_days                     (GDate *date,
    -                                                         guint n_days);
    +
    void                g_date_add_days                     (GDate *date,
    +                                                         guint n_days);

    Increments a date some number of days. To move forward by weeks, add weeks*7 days. The date must be valid. @@ -1124,8 +1135,8 @@ weeks*7 days. The date must be valid.


    g_date_subtract_days ()

    -
    void                g_date_subtract_days                (GDate *date,
    -                                                         guint n_days);
    +
    void                g_date_subtract_days                (GDate *date,
    +                                                         guint n_days);

    Moves a date some number of days into the past. To move by weeks, just move by weeks*7 days. The date must be valid. @@ -1149,8 +1160,8 @@ move by weeks*7 days. The date must be valid.


    g_date_add_months ()

    -
    void                g_date_add_months                   (GDate *date,
    -                                                         guint n_months);
    +
    void                g_date_add_months                   (GDate *date,
    +                                                         guint n_months);

    Increments a date by some number of months. If the day of the month is greater than 28, this routine may change the day of the month (because @@ -1176,8 +1187,8 @@ must be valid.


    g_date_subtract_months ()

    -
    void                g_date_subtract_months              (GDate *date,
    -                                                         guint n_months);
    +
    void                g_date_subtract_months              (GDate *date,
    +                                                         guint n_months);

    Moves a date some number of months into the past. If the current day of the month doesn't exist in the destination month, the day of the month @@ -1202,8 +1213,8 @@ may change. The date must be valid.


    g_date_add_years ()

    -
    void                g_date_add_years                    (GDate *date,
    -                                                         guint n_years);
    +
    void                g_date_add_years                    (GDate *date,
    +                                                         guint n_years);

    Increments a date by some number of years. If the date is February 29, and the destination year is not a leap year, the date will be changed @@ -1228,8 +1239,8 @@ to February 28. The date must be valid.


    g_date_subtract_years ()

    -
    void                g_date_subtract_years               (GDate *date,
    -                                                         guint n_years);
    +
    void                g_date_subtract_years               (GDate *date,
    +                                                         guint n_years);

    Moves a date some number of years into the past. If the current day doesn't exist in the destination year (i.e. it's February 29 and you @@ -1255,8 +1266,8 @@ must be valid.


    g_date_days_between ()

    -
    gint                g_date_days_between                 (const GDate *date1,
    -                                                         const GDate *date2);
    +
    gint                g_date_days_between                 (const GDate *date1,
    +                                                         const GDate *date2);

    Computes the number of days between two dates. If date2 is prior to date1, the returned value is negative. @@ -1286,8 +1297,8 @@ Both dates must be valid.


    g_date_compare ()

    -
    gint                g_date_compare                      (const GDate *lhs,
    -                                                         const GDate *rhs);
    +
    gint                g_date_compare                      (const GDate *lhs,
    +                                                         const GDate *rhs);

    qsort()-style comparsion function for dates. Both dates must be valid. @@ -1317,9 +1328,9 @@ dates must be valid.


    g_date_clamp ()

    -
    void                g_date_clamp                        (GDate *date,
    -                                                         const GDate *min_date,
    -                                                         const GDate *max_date);
    +
    void                g_date_clamp                        (GDate *date,
    +                                                         const GDate *min_date,
    +                                                         const GDate *max_date);

    If date is prior to min_date, sets date equal to min_date. If date falls after max_date, sets date equal to max_date. @@ -1351,8 +1362,8 @@ must be valid.


    g_date_order ()

    -
    void                g_date_order                        (GDate *date1,
    -                                                         GDate *date2);
    +
    void                g_date_order                        (GDate *date1,
    +                                                         GDate *date2);

    Checks if date1 is less than or equal to date2, and swap the values if this is not the case. @@ -1376,7 +1387,7 @@ and swap the values if this is not the case.


    g_date_get_day ()

    -
    GDateDay            g_date_get_day                      (const GDate *date);
    +
    GDateDay            g_date_get_day                      (const GDate *date);

    Returns the day of the month. The date must be valid.

    @@ -1399,7 +1410,7 @@ Returns the day of the month. The date must be valid.

    g_date_get_month ()

    -
    GDateMonth          g_date_get_month                    (const GDate *date);
    +
    GDateMonth          g_date_get_month                    (const GDate *date);

    Returns the month of the year. The date must be valid.

    @@ -1422,7 +1433,7 @@ Returns the month of the year. The date must be valid.

    g_date_get_year ()

    -
    GDateYear           g_date_get_year                     (const GDate *date);
    +
    GDateYear           g_date_get_year                     (const GDate *date);

    Returns the year of a GDate. The date must be valid.

    @@ -1445,7 +1456,7 @@ Returns the year of a

    g_date_get_julian ()

    -
    guint32             g_date_get_julian                   (const GDate *date);
    +
    guint32             g_date_get_julian                   (const GDate *date);

    Returns the Julian day or "serial number" of the GDate. The Julian day is simply the number of days since January 1, Year 1; i.e., @@ -1471,7 +1482,7 @@ etc. The date must be valid.


    g_date_get_weekday ()

    -
    GDateWeekday        g_date_get_weekday                  (const GDate *date);
    +
    GDateWeekday        g_date_get_weekday                  (const GDate *date);

    Returns the day of the week for a GDate. The date must be valid.

    @@ -1494,7 +1505,7 @@ Returns the day of the week for a

    g_date_get_day_of_year ()

    -
    guint               g_date_get_day_of_year              (const GDate *date);
    +
    guint               g_date_get_day_of_year              (const GDate *date);

    Returns the day of the year, where Jan 1 is the first day of the year. The date must be valid. @@ -1518,8 +1529,8 @@ year. The date must be valid.


    g_date_get_days_in_month ()

    -
    guint8              g_date_get_days_in_month            (GDateMonth month,
    -                                                         GDateYear year);
    +
    guint8              g_date_get_days_in_month            (GDateMonth month,
    +                                                         GDateYear year);

    Returns the number of days in a month, taking leap years into account.

    @@ -1547,7 +1558,7 @@ Returns the number of days in a month, taking leap years into account.

    g_date_is_first_of_month ()

    -
    gboolean            g_date_is_first_of_month            (const GDate *date);
    +
    gboolean            g_date_is_first_of_month            (const GDate *date);

    Returns TRUE if the date is on the first of a month. The date must be valid.

    @@ -1571,7 +1582,7 @@ Returns

    g_date_is_last_of_month ()

    -
    gboolean            g_date_is_last_of_month             (const GDate *date);
    +
    gboolean            g_date_is_last_of_month             (const GDate *date);

    Returns TRUE if the date is the last day of the month. The date must be valid.

    @@ -1595,9 +1606,9 @@ Returns

    g_date_is_leap_year ()

    -
    gboolean            g_date_is_leap_year                 (GDateYear year);
    +
    gboolean            g_date_is_leap_year                 (GDateYear year);

    -Returns TRUE if the year is a leap year.[4] +Returns TRUE if the year is a leap year.[4]

    date :

    a GDate +a GDate

    timeval :

    GTimeVal value to set + +GTimeVal value to set
    @@ -1619,7 +1630,7 @@ Returns

    g_date_get_monday_week_of_year ()

    -
    guint               g_date_get_monday_week_of_year      (const GDate *date);
    +
    guint               g_date_get_monday_week_of_year      (const GDate *date);

    Returns the week of the year, where weeks are understood to start on Monday. If the date is before the first Monday of the year, return @@ -1644,7 +1655,7 @@ Monday. If the date is before the first Monday of the year, return


    g_date_get_monday_weeks_in_year ()

    -
    guint8              g_date_get_monday_weeks_in_year     (GDateYear year);
    +
    guint8              g_date_get_monday_weeks_in_year     (GDateYear year);

    Returns the number of weeks in the year, where weeks are taken to start on Monday. Will be 52 or 53. The date must be valid. (Years always have 52 @@ -1672,7 +1683,7 @@ to be a Monday.)


    g_date_get_sunday_week_of_year ()

    -
    guint               g_date_get_sunday_week_of_year      (const GDate *date);
    +
    guint               g_date_get_sunday_week_of_year      (const GDate *date);

    Returns the week of the year during which this date falls, if weeks are understood to being on Sunday. The date must be valid. Can return 0 if @@ -1697,7 +1708,7 @@ the day is before the first Sunday of the year.


    g_date_get_sunday_weeks_in_year ()

    -
    guint8              g_date_get_sunday_weeks_in_year     (GDateYear year);
    +
    guint8              g_date_get_sunday_weeks_in_year     (GDateYear year);

    Returns the number of weeks in the year, where weeks are taken to start on Sunday. Will be 52 or 53. The date must be valid. (Years always have 52 @@ -1725,16 +1736,17 @@ to be a Sunday.)


    g_date_get_iso8601_week_of_year ()

    -
    guint               g_date_get_iso8601_week_of_year     (const GDate *date);
    +
    guint               g_date_get_iso8601_week_of_year     (const GDate *date);

    Returns the week of the year, where weeks are interpreted according -to ISO 8601.

    +to ISO 8601. +

    - @@ -1750,10 +1762,10 @@ to ISO 8601.


    g_date_strftime ()

    -
    gsize               g_date_strftime                     (gchar *s,
    -                                                         gsize slen,
    -                                                         const gchar *format,
    -                                                         const GDate *date);
    +
    gsize               g_date_strftime                     (gchar *s,
    +                                                         gsize slen,
    +                                                         const gchar *format,
    +                                                         const GDate *date);

    Generates a printed representation of the date, in a locale-specific way. Works just like @@ -1802,8 +1814,8 @@ expect that using

    g_date_to_struct_tm ()

    -
    void                g_date_to_struct_tm                 (const GDate *date,
    -                                                         struct tm *tm);
    +
    void                g_date_to_struct_tm                 (const GDate *date,
    +                                                         struct tm *tm);

    Fills in the date-related bits of a struct tm using the date value. Initializes the non-date parts with something @@ -1829,7 +1841,7 @@ sane but meaningless.


    g_date_valid ()

    -
    gboolean            g_date_valid                        (const GDate *date);
    +
    gboolean            g_date_valid                        (const GDate *date);

    Returns TRUE if the GDate represents an existing day. The date must not contain garbage; it should have been initialized with g_date_clear() @@ -1854,7 +1866,7 @@ if it wasn't allocated by one of the

    g_date_valid_day ()

    -
    gboolean            g_date_valid_day                    (GDateDay day);
    +
    gboolean            g_date_valid_day                    (GDateDay day);

    Returns TRUE if the day of the month is valid (a day is valid if it's between 1 and 31 inclusive). @@ -1879,7 +1891,7 @@ between 1 and 31 inclusive).


    g_date_valid_month ()

    -
    gboolean            g_date_valid_month                  (GDateMonth month);
    +
    gboolean            g_date_valid_month                  (GDateMonth month);

    Returns TRUE if the month value is valid. The 12 GDateMonth enumeration values are the only valid months. @@ -1904,7 +1916,7 @@ enumeration values are the only valid months.


    g_date_valid_year ()

    -
    gboolean            g_date_valid_year                   (GDateYear year);
    +
    gboolean            g_date_valid_year                   (GDateYear year);

    Returns TRUE if the year is valid. Any year greater than 0 is valid, though there is a 16-bit limit to what GDate will understand. @@ -1929,9 +1941,9 @@ though there is a 16-bit limit to what

    g_date_valid_dmy ()

    -
    gboolean            g_date_valid_dmy                    (GDateDay day,
    -                                                         GDateMonth month,
    -                                                         GDateYear year);
    +
    gboolean            g_date_valid_dmy                    (GDateDay day,
    +                                                         GDateMonth month,
    +                                                         GDateYear year);

    Returns TRUE if the day-month-year triplet forms a valid, existing day in the range of days GDate understands (Year 1 or later, no more than @@ -1967,7 +1979,7 @@ a few thousand years in the future).


    g_date_valid_julian ()

    -
    gboolean            g_date_valid_julian                 (guint32 julian_date);
    +
    gboolean            g_date_valid_julian                 (guint32 julian_date);

    Returns TRUE if the Julian day is valid. Anything greater than zero is basically a valid Julian, though there is a 32-bit limit. @@ -1992,7 +2004,7 @@ is basically a valid Julian, though there is a 32-bit limit.


    g_date_valid_weekday ()

    -
    gboolean            g_date_valid_weekday                (GDateWeekday weekday);
    +
    gboolean            g_date_valid_weekday                (GDateWeekday weekday);

    Returns TRUE if the weekday is valid. The seven GDateWeekday enumeration values are the only valid weekdays. @@ -2017,7 +2029,7 @@ values are the only valid weekdays.



    -

    [4] +

    [4] For the purposes of this function, leap year is every year divisible by 4 unless that year is divisible by 100. If it is divisible by 100 it would be a leap year only if that year is also divisible by 400.

    @@ -2025,6 +2037,6 @@ be a leap year only if that year is also divisible by 400.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Double-ended-Queues.html b/docs/reference/glib/html/glib-Double-ended-Queues.html index 4c9f890..b7f537e 100644 --- a/docs/reference/glib/html/glib-Double-ended-Queues.html +++ b/docs/reference/glib/html/glib-Double-ended-Queues.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    date :

    a valid GDate +a valid GDate
    @@ -61,78 +41,78 @@ #include <glib.h> GQueue; -GQueue* g_queue_new (void); -voidg_queue_free (GQueue *queue); +GQueue* g_queue_new (void); +voidg_queue_free (GQueue *queue); #define G_QUEUE_INIT -voidg_queue_init (GQueue *queue); -voidg_queue_clear (GQueue *queue); -gbooleang_queue_is_empty (GQueue *queue); -guintg_queue_get_length (GQueue *queue); -voidg_queue_reverse (GQueue *queue); -GQueue * g_queue_copy (GQueue *queue); -voidg_queue_foreach (GQueue *queue, - GFunc func, - gpointer user_data); -GList * g_queue_find (GQueue *queue, - gconstpointer data); -GList * g_queue_find_custom (GQueue *queue, - gconstpointer data, - GCompareFunc func); -voidg_queue_sort (GQueue *queue, - GCompareDataFunc compare_func, - gpointer user_data); -voidg_queue_push_head (GQueue *queue, - gpointer data); -voidg_queue_push_tail (GQueue *queue, - gpointer data); -voidg_queue_push_nth (GQueue *queue, - gpointer data, - gint n); -gpointerg_queue_pop_head (GQueue *queue); -gpointerg_queue_pop_tail (GQueue *queue); -gpointerg_queue_pop_nth (GQueue *queue, - guint n); -gpointerg_queue_peek_head (GQueue *queue); -gpointerg_queue_peek_tail (GQueue *queue); -gpointerg_queue_peek_nth (GQueue *queue, - guint n); -gintg_queue_index (GQueue *queue, - gconstpointer data); -voidg_queue_remove (GQueue *queue, - gconstpointer data); -voidg_queue_remove_all (GQueue *queue, - gconstpointer data); -voidg_queue_insert_before (GQueue *queue, - GList *sibling, - gpointer data); -voidg_queue_insert_after (GQueue *queue, - GList *sibling, - gpointer data); -voidg_queue_insert_sorted (GQueue *queue, - gpointer data, - GCompareDataFunc func, - gpointer user_data); -voidg_queue_push_head_link (GQueue *queue, - GList *link_); -voidg_queue_push_tail_link (GQueue *queue, - GList *link_); -voidg_queue_push_nth_link (GQueue *queue, - gint n, - GList *link_); -GList* g_queue_pop_head_link (GQueue *queue); -GList* g_queue_pop_tail_link (GQueue *queue); -GList* g_queue_pop_nth_link (GQueue *queue, - guint n); -GList* g_queue_peek_head_link (GQueue *queue); -GList* g_queue_peek_tail_link (GQueue *queue); -GList* g_queue_peek_nth_link (GQueue *queue, - guint n); -gintg_queue_link_index (GQueue *queue, - GList *link_); -voidg_queue_unlink (GQueue *queue, - GList *link_); -voidg_queue_delete_link (GQueue *queue, - GList *link_); +voidg_queue_init (GQueue *queue); +voidg_queue_clear (GQueue *queue); +gbooleang_queue_is_empty (GQueue *queue); +guintg_queue_get_length (GQueue *queue); +voidg_queue_reverse (GQueue *queue); +GQueue * g_queue_copy (GQueue *queue); +voidg_queue_foreach (GQueue *queue, + GFunc func, + gpointer user_data); +GList * g_queue_find (GQueue *queue, + gconstpointer data); +GList * g_queue_find_custom (GQueue *queue, + gconstpointer data, + GCompareFunc func); +voidg_queue_sort (GQueue *queue, + GCompareDataFunc compare_func, + gpointer user_data); +voidg_queue_push_head (GQueue *queue, + gpointer data); +voidg_queue_push_tail (GQueue *queue, + gpointer data); +voidg_queue_push_nth (GQueue *queue, + gpointer data, + gint n); +gpointerg_queue_pop_head (GQueue *queue); +gpointerg_queue_pop_tail (GQueue *queue); +gpointerg_queue_pop_nth (GQueue *queue, + guint n); +gpointerg_queue_peek_head (GQueue *queue); +gpointerg_queue_peek_tail (GQueue *queue); +gpointerg_queue_peek_nth (GQueue *queue, + guint n); +gintg_queue_index (GQueue *queue, + gconstpointer data); +voidg_queue_remove (GQueue *queue, + gconstpointer data); +voidg_queue_remove_all (GQueue *queue, + gconstpointer data); +voidg_queue_insert_before (GQueue *queue, + GList *sibling, + gpointer data); +voidg_queue_insert_after (GQueue *queue, + GList *sibling, + gpointer data); +voidg_queue_insert_sorted (GQueue *queue, + gpointer data, + GCompareDataFunc func, + gpointer user_data); +voidg_queue_push_head_link (GQueue *queue, + GList *link_); +voidg_queue_push_tail_link (GQueue *queue, + GList *link_); +voidg_queue_push_nth_link (GQueue *queue, + gint n, + GList *link_); +GList* g_queue_pop_head_link (GQueue *queue); +GList* g_queue_pop_tail_link (GQueue *queue); +GList* g_queue_pop_nth_link (GQueue *queue, + guint n); +GList* g_queue_peek_head_link (GQueue *queue); +GList* g_queue_peek_tail_link (GQueue *queue); +GList* g_queue_peek_nth_link (GQueue *queue, + guint n); +gintg_queue_link_index (GQueue *queue, + GList *link_); +voidg_queue_unlink (GQueue *queue, + GList *link_); +voidg_queue_delete_link (GQueue *queue, + GList *link_);
    @@ -203,9 +183,10 @@ Contains the public fields of a Queue.

    g_queue_new ()

    -
    GQueue*             g_queue_new                         (void);
    +
    GQueue*             g_queue_new                         (void);

    -Creates a new GQueue.

    +Creates a new GQueue. +

    @@ -218,16 +199,17 @@ Creates a new

    g_queue_free ()

    -
    void                g_queue_free                        (GQueue *queue);
    +
    void                g_queue_free                        (GQueue *queue);

    Frees the memory allocated for the GQueue. Only call this function if queue was created with g_queue_new(). If queue elements contain -dynamically-allocated memory, they should be freed first.

    +dynamically-allocated memory, they should be freed first. +

    -

    queue :

    a GQueue. +a GQueue.
    @@ -242,25 +224,34 @@ A statically-allocated g_queue_init().

    -
    -GQueue my_queue = G_QUEUE_INIT;
    -
    +
    + + + + + + + +
    1
    GQueue my_queue = G_QUEUE_INIT;
    +
    +

    Since 2.14


    g_queue_init ()

    -
    void                g_queue_init                        (GQueue *queue);
    +
    void                g_queue_init                        (GQueue *queue);

    A statically-allocated GQueue must be initialized with this function before it can be used. Alternatively you can initialize it with G_QUEUE_INIT. It is not necessary to initialize queues created with -g_queue_new().

    +g_queue_new(). +

    -

    queue :

    an uninitialized GQueue +an uninitialized GQueue
    @@ -269,15 +260,16 @@ before it can be used. Alternatively you can initialize it with

    g_queue_clear ()

    -
    void                g_queue_clear                       (GQueue *queue);
    +
    void                g_queue_clear                       (GQueue *queue);

    Removes all the elements in queue. If queue elements contain -dynamically-allocated memory, they should be freed first.

    +dynamically-allocated memory, they should be freed first. +

    -

    queue :

    a GQueue +a GQueue
    @@ -286,15 +278,16 @@ dynamically-allocated memory, they should be freed first.


    g_queue_is_empty ()

    -
    gboolean            g_queue_is_empty                    (GQueue *queue);
    +
    gboolean            g_queue_is_empty                    (GQueue *queue);

    -Returns TRUE if the queue is empty.

    +Returns TRUE if the queue is empty. +

    - @@ -308,15 +301,16 @@ Returns

    g_queue_get_length ()

    -
    guint               g_queue_get_length                  (GQueue *queue);
    +
    guint               g_queue_get_length                  (GQueue *queue);

    -Returns the number of items in queue.

    +Returns the number of items in queue. +

    queue :

    a GQueue. +a GQueue.
    - @@ -332,14 +326,15 @@ Returns the number of items in queue.

    g_queue_reverse ()

    -
    void                g_queue_reverse                     (GQueue *queue);
    +
    void                g_queue_reverse                     (GQueue *queue);

    -Reverses the order of the items in queue.

    +Reverses the order of the items in queue. +

    queue :

    a GQueue +a GQueue
    -

    queue :

    a GQueue +a GQueue
    @@ -348,17 +343,18 @@ Reverses the order of the items in queue

    g_queue_copy ()

    -
    GQueue *            g_queue_copy                        (GQueue *queue);
    +
    GQueue *            g_queue_copy                        (GQueue *queue);

    Copies a queue. Note that is a shallow copy. If the elements in the queue consist of pointers to data, the pointers are copied, but the -actual data is not.

    +actual data is not. +

    - @@ -374,28 +370,29 @@ actual data is not.


    g_queue_foreach ()

    -
    void                g_queue_foreach                     (GQueue *queue,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_queue_foreach                     (GQueue *queue,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    Calls func for each element in the queue passing user_data to the -function.

    +function. +

    queue :

    a GQueue +a GQueue
    - - - @@ -405,21 +402,22 @@ function.


    g_queue_find ()

    -
    GList *             g_queue_find                        (GQueue *queue,
    -                                                         gconstpointer data);
    +
    GList *             g_queue_find                        (GQueue *queue,
    +                                                         gconstpointer data);

    -Finds the first link in queue which contains data.

    +Finds the first link in queue which contains data. +

    queue :

    a GQueue +a GQueue

    func :

    the function to call for each element's data +the function to call for each element's data

    user_data :

    user data to pass to func +user data to pass to func
    - - @@ -435,31 +433,32 @@ Finds the first link in queue which cont

    g_queue_find_custom ()

    -
    GList *             g_queue_find_custom                 (GQueue *queue,
    -                                                         gconstpointer data,
    -                                                         GCompareFunc func);
    +
    GList *             g_queue_find_custom                 (GQueue *queue,
    +                                                         gconstpointer data,
    +                                                         GCompareFunc func);

    Finds an element in a GQueue, using a supplied function to find the desired element. It iterates over the queue, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the GQueue element's data as the -first argument and the given user data as the second argument.

    +first argument and the given user data as the second argument. +

    queue :

    a GQueue +a GQueue

    data :

    data to find +data to find
    - - - @@ -476,22 +475,23 @@ when the desired element is found

    g_queue_sort ()

    -
    void                g_queue_sort                        (GQueue *queue,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +
    void                g_queue_sort                        (GQueue *queue,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);

    -Sorts queue using compare_func.

    +Sorts queue using compare_func. +

    queue :

    a GQueue +a GQueue

    data :

    user data passed to func +user data passed to func

    func :

    a GCompareFunc to call for each element. It should return 0 +a GCompareFunc to call for each element. It should return 0 when the desired element is found
    - - - @@ -509,21 +509,22 @@ Sorts queue using

    g_queue_push_head ()

    -
    void                g_queue_push_head                   (GQueue *queue,
    -                                                         gpointer data);
    +
    void                g_queue_push_head                   (GQueue *queue,
    +                                                         gpointer data);

    -Adds a new element at the head of the queue.

    +Adds a new element at the head of the queue. +

    queue :

    a GQueue +a GQueue

    compare_func :

    the GCompareDataFunc used to sort queue. This function +the GCompareDataFunc used to sort queue. This function is passed two elements of the queue and should return 0 if they are equal, a negative value if the first comes before the second, and a positive value if the second comes before the first. @@ -499,7 +499,7 @@ Sorts queue using

    user_data :

    user data passed to compare_func +user data passed to compare_func
    - - @@ -532,21 +533,22 @@ Adds a new element at the head of the queue.


    g_queue_push_tail ()

    -
    void                g_queue_push_tail                   (GQueue *queue,
    -                                                         gpointer data);
    +
    void                g_queue_push_tail                   (GQueue *queue,
    +                                                         gpointer data);

    -Adds a new element at the tail of the queue.

    +Adds a new element at the tail of the queue. +

    queue :

    a GQueue. +a GQueue.

    data :

    the data for the new element. +the data for the new element.
    - - @@ -555,27 +557,28 @@ Adds a new element at the tail of the queue.


    g_queue_push_nth ()

    -
    void                g_queue_push_nth                    (GQueue *queue,
    -                                                         gpointer data,
    -                                                         gint n);
    +
    void                g_queue_push_nth                    (GQueue *queue,
    +                                                         gpointer data,
    +                                                         gint n);

    -Inserts a new element into queue at the given position

    +Inserts a new element into queue at the given position +

    queue :

    a GQueue. +a GQueue.

    data :

    the data for the new element. +the data for the new element.
    - - - @@ -587,15 +590,16 @@ Inserts a new element into queue at the

    g_queue_pop_head ()

    -
    gpointer            g_queue_pop_head                    (GQueue *queue);
    +
    gpointer            g_queue_pop_head                    (GQueue *queue);

    -Removes the first element of the queue.

    +Removes the first element of the queue. +

    queue :

    a GQueue +a GQueue

    data :

    the data for the new element +the data for the new element

    n :

    the position to insert the new element. If n is negative or +the position to insert the new element. If n is negative or larger than the number of elements in the queue, the element is added to the end of the queue.
    - @@ -610,15 +614,16 @@ Removes the first element of the queue.


    g_queue_pop_tail ()

    -
    gpointer            g_queue_pop_tail                    (GQueue *queue);
    +
    gpointer            g_queue_pop_tail                    (GQueue *queue);

    -Removes the last element of the queue.

    +Removes the last element of the queue. +

    queue :

    a GQueue. +a GQueue.
    - @@ -633,21 +638,22 @@ Removes the last element of the queue.


    g_queue_pop_nth ()

    -
    gpointer            g_queue_pop_nth                     (GQueue *queue,
    -                                                         guint n);
    +
    gpointer            g_queue_pop_nth                     (GQueue *queue,
    +                                                         guint n);

    -Removes the n'th element of queue.

    +Removes the n'th element of queue. +

    queue :

    a GQueue. +a GQueue.
    - - @@ -663,15 +669,16 @@ Removes the n'th element of

    g_queue_peek_head ()

    -
    gpointer            g_queue_peek_head                   (GQueue *queue);
    +
    gpointer            g_queue_peek_head                   (GQueue *queue);

    -Returns the first element of the queue.

    +Returns the first element of the queue. +

    queue :

    a GQueue +a GQueue

    n :

    the position of the element. +the position of the element.
    - @@ -686,15 +693,16 @@ Returns the first element of the queue.


    g_queue_peek_tail ()

    -
    gpointer            g_queue_peek_tail                   (GQueue *queue);
    +
    gpointer            g_queue_peek_tail                   (GQueue *queue);

    -Returns the last element of the queue.

    +Returns the last element of the queue. +

    queue :

    a GQueue. +a GQueue.
    - @@ -709,21 +717,22 @@ Returns the last element of the queue.


    g_queue_peek_nth ()

    -
    gpointer            g_queue_peek_nth                    (GQueue *queue,
    -                                                         guint n);
    +
    gpointer            g_queue_peek_nth                    (GQueue *queue,
    +                                                         guint n);

    -Returns the n'th element of queue.

    +Returns the n'th element of queue. +

    queue :

    a GQueue. +a GQueue.
    - - @@ -740,21 +749,22 @@ Returns the n'th element of

    g_queue_index ()

    -
    gint                g_queue_index                       (GQueue *queue,
    -                                                         gconstpointer data);
    +
    gint                g_queue_index                       (GQueue *queue,
    +                                                         gconstpointer data);

    -Returns the position of the first element in queue which contains data.

    +Returns the position of the first element in queue which contains data. +

    queue :

    a GQueue +a GQueue

    n :

    the position of the element. +the position of the element.
    - - @@ -770,21 +780,22 @@ Returns the position of the first element in queue

    g_queue_remove ()

    -
    void                g_queue_remove                      (GQueue *queue,
    -                                                         gconstpointer data);
    +
    void                g_queue_remove                      (GQueue *queue,
    +                                                         gconstpointer data);

    -Removes the first element in queue that contains data.

    +Removes the first element in queue that contains data. +

    queue :

    a GQueue +a GQueue

    data :

    the data to find. +the data to find.
    - - @@ -794,21 +805,22 @@ Removes the first element in queue that

    g_queue_remove_all ()

    -
    void                g_queue_remove_all                  (GQueue *queue,
    -                                                         gconstpointer data);
    +
    void                g_queue_remove_all                  (GQueue *queue,
    +                                                         gconstpointer data);

    -Remove all elemeents in queue which contains data.

    +Remove all elemeents in queue which contains data. +

    queue :

    a GQueue +a GQueue

    data :

    data to remove. +data to remove.
    - - @@ -818,30 +830,31 @@ Remove all elemeents in queue which cont

    g_queue_insert_before ()

    -
    void                g_queue_insert_before               (GQueue *queue,
    -                                                         GList *sibling,
    -                                                         gpointer data);
    +
    void                g_queue_insert_before               (GQueue *queue,
    +                                                         GList *sibling,
    +                                                         gpointer data);

    Inserts data into queue before sibling.

    -sibling must be part of queue.

    +sibling must be part of queue. +

    queue :

    a GQueue +a GQueue

    data :

    data to remove +data to remove
    - - - @@ -851,30 +864,31 @@ Inserts data into

    g_queue_insert_after ()

    -
    void                g_queue_insert_after                (GQueue *queue,
    -                                                         GList *sibling,
    -                                                         gpointer data);
    +
    void                g_queue_insert_after                (GQueue *queue,
    +                                                         GList *sibling,
    +                                                         gpointer data);

    Inserts data into queue after sibling

    -sibling must be part of queue

    +sibling must be part of queue +

    queue :

    a GQueue +a GQueue

    sibling :

    a GList link that must be part of queue +a GList link that must be part of queue

    data :

    the data to insert +the data to insert
    - - - @@ -884,28 +898,29 @@ Inserts data into

    g_queue_insert_sorted ()

    -
    void                g_queue_insert_sorted               (GQueue *queue,
    -                                                         gpointer data,
    -                                                         GCompareDataFunc func,
    -                                                         gpointer user_data);
    +
    void                g_queue_insert_sorted               (GQueue *queue,
    +                                                         gpointer data,
    +                                                         GCompareDataFunc func,
    +                                                         gpointer user_data);

    -Inserts data into queue using func to determine the new position.

    +Inserts data into queue using func to determine the new position. +

    queue :

    a GQueue +a GQueue

    sibling :

    a GList link that must be part of queue +a GList link that must be part of queue

    data :

    the data to insert +the data to insert
    - - - - @@ -924,21 +939,22 @@ Inserts data into

    g_queue_push_head_link ()

    -
    void                g_queue_push_head_link              (GQueue *queue,
    -                                                         GList *link_);
    +
    void                g_queue_push_head_link              (GQueue *queue,
    +                                                         GList *link_);

    -Adds a new element at the head of the queue.

    +Adds a new element at the head of the queue. +

    queue :

    a GQueue +a GQueue

    data :

    the data to insert +the data to insert

    func :

    the GCompareDataFunc used to compare elements in the queue. It is +the GCompareDataFunc used to compare elements in the queue. It is called with two elements of the queue and user_data. It should return 0 if the elements are equal, a negative value if the first element comes before the second, and a positive value if the second @@ -914,7 +929,7 @@ Inserts data into

    user_data :

    user data passed to func. +user data passed to func.
    - - @@ -948,21 +964,22 @@ Adds a new element at the head of the queue.


    g_queue_push_tail_link ()

    -
    void                g_queue_push_tail_link              (GQueue *queue,
    -                                                         GList *link_);
    +
    void                g_queue_push_tail_link              (GQueue *queue,
    +                                                         GList *link_);

    -Adds a new element at the tail of the queue.

    +Adds a new element at the tail of the queue. +

    queue :

    a GQueue. +a GQueue.

    link_ :

    a single GList element, not a list with +a single GList element, not a list with more than one element.
    - - @@ -972,29 +989,30 @@ Adds a new element at the tail of the queue.


    g_queue_push_nth_link ()

    -
    void                g_queue_push_nth_link               (GQueue *queue,
    -                                                         gint n,
    -                                                         GList *link_);
    +
    void                g_queue_push_nth_link               (GQueue *queue,
    +                                                         gint n,
    +                                                         GList *link_);

    -Inserts link into queue at the given position.

    +Inserts link into queue at the given position. +

    queue :

    a GQueue. +a GQueue.

    link_ :

    a single GList element, not a list with +a single GList element, not a list with more than one element.
    - - - @@ -1004,15 +1022,16 @@ Inserts link into

    g_queue_pop_head_link ()

    -
    GList*              g_queue_pop_head_link               (GQueue *queue);
    +
    GList*              g_queue_pop_head_link               (GQueue *queue);

    -Removes the first element of the queue.

    +Removes the first element of the queue. +

    queue :

    a GQueue +a GQueue

    n :

    the position to insert the link. If this is negative or larger than +the position to insert the link. If this is negative or larger than the number of elements in queue, the link is added to the end of queue.

    link_ :

    the link to add to queue +the link to add to queue
    - @@ -1027,15 +1046,16 @@ Removes the first element of the queue.


    g_queue_pop_tail_link ()

    -
    GList*              g_queue_pop_tail_link               (GQueue *queue);
    +
    GList*              g_queue_pop_tail_link               (GQueue *queue);

    -Removes the last element of the queue.

    +Removes the last element of the queue. +

    queue :

    a GQueue. +a GQueue.
    - @@ -1050,21 +1070,22 @@ Removes the last element of the queue.


    g_queue_pop_nth_link ()

    -
    GList*              g_queue_pop_nth_link                (GQueue *queue,
    -                                                         guint n);
    +
    GList*              g_queue_pop_nth_link                (GQueue *queue,
    +                                                         guint n);

    -Removes and returns the link at the given position.

    +Removes and returns the link at the given position. +

    queue :

    a GQueue. +a GQueue.
    - - @@ -1080,15 +1101,16 @@ Removes and returns the link at the given position.


    g_queue_peek_head_link ()

    -
    GList*              g_queue_peek_head_link              (GQueue *queue);
    +
    GList*              g_queue_peek_head_link              (GQueue *queue);

    -Returns the first link in queue

    +Returns the first link in queue +

    queue :

    a GQueue +a GQueue

    n :

    the link's position +the link's position
    - @@ -1104,15 +1126,16 @@ Returns the first link in queue


    g_queue_peek_tail_link ()

    -
    GList*              g_queue_peek_tail_link              (GQueue *queue);
    +
    GList*              g_queue_peek_tail_link              (GQueue *queue);

    -Returns the last link queue.

    +Returns the last link queue. +

    queue :

    a GQueue +a GQueue
    - @@ -1128,21 +1151,22 @@ Returns the last link queue.


    g_queue_peek_nth_link ()

    -
    GList*              g_queue_peek_nth_link               (GQueue *queue,
    -                                                         guint n);
    +
    GList*              g_queue_peek_nth_link               (GQueue *queue,
    +                                                         guint n);

    -Returns the link at the given position

    +Returns the link at the given position +

    queue :

    a GQueue +a GQueue
    - - @@ -1159,21 +1183,22 @@ end of the list

    g_queue_link_index ()

    -
    gint                g_queue_link_index                  (GQueue *queue,
    -                                                         GList *link_);
    +
    gint                g_queue_link_index                  (GQueue *queue,
    +                                                         GList *link_);

    -Returns the position of link_ in queue.

    +Returns the position of link_ in queue. +

    queue :

    a GQueue +a GQueue

    n :

    the position of the link +the position of the link
    - - @@ -1190,25 +1215,26 @@ not part of queue

    g_queue_unlink ()

    -
    void                g_queue_unlink                      (GQueue *queue,
    -                                                         GList *link_);
    +
    void                g_queue_unlink                      (GQueue *queue,
    +                                                         GList *link_);

    Unlinks link_ so that it will no longer be part of queue. The link is not freed.

    -link_ must be part of queue,

    +link_ must be part of queue, +

    queue :

    a Gqueue +a Gqueue

    link_ :

    A GList link +A GList link
    - - @@ -1218,24 +1244,25 @@ not freed.

    g_queue_delete_link ()

    -
    void                g_queue_delete_link                 (GQueue *queue,
    -                                                         GList *link_);
    +
    void                g_queue_delete_link                 (GQueue *queue,
    +                                                         GList *link_);

    Removes link_ from queue and frees it.

    -link_ must be part of queue.

    +link_ must be part of queue. +

    queue :

    a GQueue +a GQueue

    link_ :

    a GList link that must be part of queue +a GList link that must be part of queue
    - - @@ -1246,6 +1273,6 @@ Removes link_ from + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Doubly-Linked-Lists.html b/docs/reference/glib/html/glib-Doubly-Linked-Lists.html index 83f69ea..32b96a4 100644 --- a/docs/reference/glib/html/glib-Doubly-Linked-Lists.html +++ b/docs/reference/glib/html/glib-Doubly-Linked-Lists.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    queue :

    a GQueue +a GQueue

    link_ :

    a GList link that must be part of queue +a GList link that must be part of queue
    @@ -64,81 +44,81 @@ GList; -GList* g_list_append (GList *list, - gpointer data); -GList* g_list_prepend (GList *list, - gpointer data); -GList* g_list_insert (GList *list, - gpointer data, - gint position); -GList* g_list_insert_before (GList *list, - GList *sibling, - gpointer data); -GList* g_list_insert_sorted (GList *list, - gpointer data, - GCompareFunc func); -GList* g_list_remove (GList *list, - gconstpointer data); -GList* g_list_remove_link (GList *list, - GList *llink); -GList* g_list_delete_link (GList *list, - GList *link_); -GList* g_list_remove_all (GList *list, - gconstpointer data); -void g_list_free (GList *list); +GList* g_list_append (GList *list, + gpointer data); +GList* g_list_prepend (GList *list, + gpointer data); +GList* g_list_insert (GList *list, + gpointer data, + gint position); +GList* g_list_insert_before (GList *list, + GList *sibling, + gpointer data); +GList* g_list_insert_sorted (GList *list, + gpointer data, + GCompareFunc func); +GList* g_list_remove (GList *list, + gconstpointer data); +GList* g_list_remove_link (GList *list, + GList *llink); +GList* g_list_delete_link (GList *list, + GList *link_); +GList* g_list_remove_all (GList *list, + gconstpointer data); +void g_list_free (GList *list); -GList* g_list_alloc (void); -void g_list_free_1 (GList *list); +GList* g_list_alloc (void); +void g_list_free_1 (GList *list); #define g_list_free1 -guint g_list_length (GList *list); -GList* g_list_copy (GList *list); -GList* g_list_reverse (GList *list); -GList* g_list_sort (GList *list, - GCompareFunc compare_func); -gint (*GCompareFunc) (gconstpointer a, - gconstpointer b); -GList* g_list_insert_sorted_with_data (GList *list, - gpointer data, - GCompareDataFunc func, - gpointer user_data); -GList* g_list_sort_with_data (GList *list, - GCompareDataFunc compare_func, - gpointer user_data); -gint (*GCompareDataFunc) (gconstpointer a, - gconstpointer b, - gpointer user_data); -GList* g_list_concat (GList *list1, - GList *list2); -void g_list_foreach (GList *list, - GFunc func, - gpointer user_data); -void (*GFunc) (gpointer data, - gpointer user_data); +guint g_list_length (GList *list); +GList* g_list_copy (GList *list); +GList* g_list_reverse (GList *list); +GList* g_list_sort (GList *list, + GCompareFunc compare_func); +gint (*GCompareFunc) (gconstpointer a, + gconstpointer b); +GList* g_list_insert_sorted_with_data (GList *list, + gpointer data, + GCompareDataFunc func, + gpointer user_data); +GList* g_list_sort_with_data (GList *list, + GCompareDataFunc compare_func, + gpointer user_data); +gint (*GCompareDataFunc) (gconstpointer a, + gconstpointer b, + gpointer user_data); +GList* g_list_concat (GList *list1, + GList *list2); +void g_list_foreach (GList *list, + GFunc func, + gpointer user_data); +void (*GFunc) (gpointer data, + gpointer user_data); -GList* g_list_first (GList *list); -GList* g_list_last (GList *list); +GList* g_list_first (GList *list); +GList* g_list_last (GList *list); #define g_list_previous (list) #define g_list_next (list) -GList* g_list_nth (GList *list, - guint n); -gpointer g_list_nth_data (GList *list, - guint n); -GList* g_list_nth_prev (GList *list, - guint n); +GList* g_list_nth (GList *list, + guint n); +gpointer g_list_nth_data (GList *list, + guint n); +GList* g_list_nth_prev (GList *list, + guint n); -GList* g_list_find (GList *list, - gconstpointer data); -GList* g_list_find_custom (GList *list, - gconstpointer data, - GCompareFunc func); -gint g_list_position (GList *list, - GList *llink); -gint g_list_index (GList *list, - gconstpointer data); +GList* g_list_find (GList *list, + gconstpointer data); +GList* g_list_find_custom (GList *list, + gconstpointer data, + GCompareFunc func); +gint g_list_position (GList *list, + GList *llink); +gint g_list_index (GList *list, + gconstpointer data); -void g_list_push_allocator (gpointer allocator); -void g_list_pop_allocator (void); +void g_list_push_allocator (gpointer allocator); +void g_list_pop_allocator (void);
    @@ -192,7 +172,8 @@ To find the index of an element use g_list_foreach().

    -To free the entire list, use g_list_free().

    +To free the entire list, use g_list_free(). +

    Details

    @@ -205,25 +186,26 @@ To free the entire list, use GList struct is used for each element in a doubly-linked list.

    +The GList struct is used for each element in a doubly-linked list. +

    - - - @@ -232,8 +214,8 @@ The

    g_list_append ()

    -
    GList*              g_list_append                       (GList *list,
    -                                                         gpointer data);
    +
    GList*              g_list_append                       (GList *list,
    +                                                         gpointer data);

    Adds a new element on to the end of the list.

    @@ -263,29 +245,48 @@ the elements and reverse the list when all elements have been added.

    -
    -/* Notice that these are initialized to the empty list. */
    -GList *list = NULL, *number_list = NULL;
    +
    +

    gpointer data;

    holds the element's data, which can be a pointer to any kind +holds the element's data, which can be a pointer to any kind of data, or any integer value using the Type Conversion Macros.

    GList *next;

    contains the link to the next element in the list. +contains the link to the next element in the list.

    GList *prev;

    contains the link to the previous element in the list. +contains the link to the previous element in the list.
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    /* Notice that these are initialized to the empty list. */
    +GList *list = NULL, *number_list = NULL;
    +
    +/* This is a list of strings. */
    +list = g_list_append (list, "first");
    +list = g_list_append (list, "second");
     
    -/* This is a list of strings. */
    -list = g_list_append (list, "first");
    -list = g_list_append (list, "second");
    +/* This is a list of integers. */
    +number_list = g_list_append (number_list, GINT_TO_POINTER (27));
    +number_list = g_list_append (number_list, GINT_TO_POINTER (14));
    +
    -/* This is a list of integers. */ -number_list = g_list_append (number_list, GINT_TO_POINTER (27)); -number_list = g_list_append (number_list, GINT_TO_POINTER (14)); -
    +

    +

    - - @@ -299,8 +300,8 @@ number_list = g_list_append (number_list, GINT_TO_POINTER (14));

    g_list_prepend ()

    -
    GList*              g_list_prepend                      (GList *list,
    -                                                         gpointer data);
    +
    GList*              g_list_prepend                      (GList *list,
    +                                                         gpointer data);

    Adds a new element on to the start of the list.

    @@ -317,23 +318,36 @@ may have changed, so make sure you store the new value.

    -
     
    -/* Notice that it is initialized to the empty list. */
    -GList *list = NULL;
    -list = g_list_prepend (list, "last");
    -list = g_list_prepend (list, "first");
    -
    +
    +

    list :

    a pointer to a GList +a pointer to a GList

    data :

    the data for the new element +the data for the new element
    + + + + + + +
    1
    +2
    +3
    +4
    /* Notice that it is initialized to the empty list. */
    +GList *list = NULL;
    +list = g_list_prepend (list, "last");
    +list = g_list_prepend (list, "first");
    +
    + +

    +

    - - @@ -347,27 +361,28 @@ list = g_list_prepend (list, "first");

    g_list_insert ()

    -
    GList*              g_list_insert                       (GList *list,
    -                                                         gpointer data,
    -                                                         gint position);
    +
    GList*              g_list_insert                       (GList *list,
    +                                                         gpointer data,
    +                                                         gint position);

    -Inserts a new element into the list at the given position.

    +Inserts a new element into the list at the given position. +

    list :

    a pointer to a GList +a pointer to a GList

    data :

    the data for the new element +the data for the new element
    - - - @@ -383,28 +398,29 @@ Inserts a new element into the list at the given position.


    g_list_insert_before ()

    -
    GList*              g_list_insert_before                (GList *list,
    -                                                         GList *sibling,
    -                                                         gpointer data);
    +
    GList*              g_list_insert_before                (GList *list,
    +                                                         GList *sibling,
    +                                                         gpointer data);

    -Inserts a new element into the list before the given position.

    +Inserts a new element into the list before the given position. +

    list :

    a pointer to a GList +a pointer to a GList

    data :

    the data for the new element +the data for the new element

    position :

    the position to insert the element. If this is +the position to insert the element. If this is negative, or is larger than the number of elements in the list, the new element is added on to the end of the list.
    - - - @@ -418,28 +434,29 @@ Inserts a new element into the list before the given position.


    g_list_insert_sorted ()

    -
    GList*              g_list_insert_sorted                (GList *list,
    -                                                         gpointer data,
    -                                                         GCompareFunc func);
    +
    GList*              g_list_insert_sorted                (GList *list,
    +                                                         gpointer data,
    +                                                         GCompareFunc func);

    Inserts a new element into the list, using the given comparison -function to determine its position.

    +function to determine its position. +

    list :

    a pointer to a GList +a pointer to a GList

    sibling :

    the list element before which the new element +the list element before which the new element is inserted or NULL to insert at the end of the list

    data :

    the data for the new element +the data for the new element
    - - - @@ -455,23 +472,24 @@ function to determine its position.


    g_list_remove ()

    -
    GList*              g_list_remove                       (GList *list,
    -                                                         gconstpointer data);
    +
    GList*              g_list_remove                       (GList *list,
    +                                                         gconstpointer data);

    Removes an element from a GList. If two elements contain the same data, only the first is removed. -If none of the elements contain the data, the GList is unchanged.

    +If none of the elements contain the data, the GList is unchanged. +

    list :

    a pointer to a GList +a pointer to a GList

    data :

    the data for the new element +the data for the new element

    func :

    the function to compare elements in the list. It should +the function to compare elements in the list. It should return a number > 0 if the first parameter comes after the second parameter in the sort order.
    - - @@ -485,23 +503,24 @@ If none of the elements contain the data, the

    g_list_remove_link ()

    -
    GList*              g_list_remove_link                  (GList *list,
    -                                                         GList *llink);
    +
    GList*              g_list_remove_link                  (GList *list,
    +                                                         GList *llink);

    Removes an element from a GList, without freeing the element. The removed element's prev and next links are set to NULL, so -that it becomes a self-contained list with one element.

    +that it becomes a self-contained list with one element. +

    list :

    a GList +a GList

    data :

    the data of the element to remove +the data of the element to remove
    - - @@ -515,23 +534,24 @@ that it becomes a self-contained list with one element.


    g_list_delete_link ()

    -
    GList*              g_list_delete_link                  (GList *list,
    -                                                         GList *link_);
    +
    GList*              g_list_delete_link                  (GList *list,
    +                                                         GList *link_);

    Removes the node link_ from the list and frees it. Compare this to g_list_remove_link() which removes the node -without freeing it.

    +without freeing it. +

    list :

    a GList +a GList

    llink :

    an element in the GList +an element in the GList
    - - @@ -545,24 +565,25 @@ without freeing it.


    g_list_remove_all ()

    -
    GList*              g_list_remove_all                   (GList *list,
    -                                                         gconstpointer data);
    +
    GList*              g_list_remove_all                   (GList *list,
    +                                                         gconstpointer data);

    Removes all list nodes with data equal to data. Returns the new head of the list. Contrast with g_list_remove() which removes only the first node -matching the given data.

    +matching the given data. +

    list :

    a GList +a GList

    link_ :

    node to delete from list +node to delete from list
    - - @@ -576,7 +597,7 @@ matching the given data.


    g_list_free ()

    -
    void                g_list_free                         (GList *list);
    +
    void                g_list_free                         (GList *list);

    Frees all of the memory used by a GList. The freed elements are returned to the slice allocator. @@ -590,11 +611,13 @@ If list elements contain dynamically-allocated memory, they should be freed first.

    +

    +

    list :

    a GList +a GList

    data :

    data to remove +data to remove
    -

    list :

    a GList +a GList
    @@ -602,16 +625,17 @@ they should be freed first.

    g_list_alloc ()

    -
    GList*              g_list_alloc                        (void);
    +
    GList*              g_list_alloc                        (void);

    Allocates space for one GList element. It is called by g_list_append(), g_list_prepend(), g_list_insert() and -g_list_insert_sorted() and so is rarely used on its own.

    +g_list_insert_sorted() and so is rarely used on its own. +

    -

    Returns :

    a pointer to the newly-allocated GList element. +a pointer to the newly-allocated GList element.
    @@ -619,15 +643,16 @@ Allocates space for one

    g_list_free_1 ()

    -
    void                g_list_free_1                       (GList *list);
    +
    void                g_list_free_1                       (GList *list);

    Frees one GList element. -It is usually used after g_list_remove_link().

    +It is usually used after g_list_remove_link(). +

    -

    list :

    a GList element +a GList element
    @@ -637,12 +662,13 @@ It is usually used after

    g_list_free1

    #define             g_list_free1

    -Another name for g_list_free_1().

    +Another name for g_list_free_1(). +


    g_list_length ()

    -
    guint               g_list_length                       (GList *list);
    +
    guint               g_list_length                       (GList *list);

    Gets the number of elements in a GList.

    @@ -655,12 +681,14 @@ This function iterates over the whole list to count its elements.

    +

    +

    - @@ -674,7 +702,7 @@ count its elements.

    g_list_copy ()

    -
    GList*              g_list_copy                         (GList *list);
    +
    GList*              g_list_copy                         (GList *list);

    Copies a GList.

    @@ -688,12 +716,14 @@ consist of pointers to data, the pointers are copied but the actual data is not.

    +

    +

    list :

    a GList +a GList
    - @@ -707,16 +737,17 @@ the actual data is not.

    g_list_reverse ()

    -
    GList*              g_list_reverse                      (GList *list);
    +
    GList*              g_list_reverse                      (GList *list);

    Reverses a GList. -It simply switches the next and prev pointers of each element.

    +It simply switches the next and prev pointers of each element. +

    list :

    a GList +a GList
    - @@ -730,21 +761,22 @@ It simply switches the next and prev pointers of each element.


    g_list_sort ()

    -
    GList*              g_list_sort                         (GList *list,
    -                                                         GCompareFunc compare_func);
    +
    GList*              g_list_sort                         (GList *list,
    +                                                         GCompareFunc compare_func);

    -Sorts a GList using the given comparison function.

    +Sorts a GList using the given comparison function. +

    list :

    a GList +a GList
    - -

    list :

    a GList +a GList

    compare_func :

    the comparison function used to sort the GList. +the comparison function used to sort the GList. This function is passed the data from 2 elements of the GList and should return 0 if they are equal, a negative value if the first element comes before the second, or a positive value if @@ -762,29 +794,30 @@ Sorts a

    GCompareFunc ()

    -
    gint                (*GCompareFunc)                     (gconstpointer a,
    -                                                         gconstpointer b);
    +
    gint                (*GCompareFunc)                     (gconstpointer a,
    +                                                         gconstpointer b);

    Specifies the type of a comparison function used to compare two values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive -integer if the first value comes after the second.

    +integer if the first value comes after the second. +

    - - - @@ -794,36 +827,37 @@ integer if the first value comes after the second.


    g_list_insert_sorted_with_data ()

    -
    GList*              g_list_insert_sorted_with_data      (GList *list,
    -                                                         gpointer data,
    -                                                         GCompareDataFunc func,
    -                                                         gpointer user_data);
    +
    GList*              g_list_insert_sorted_with_data      (GList *list,
    +                                                         gpointer data,
    +                                                         GCompareDataFunc func,
    +                                                         gpointer user_data);

    Inserts a new element into the list, using the given comparison -function to determine its position.

    +function to determine its position. +

    a :

    a value. +a value.

    b :

    a value to compare with. +a value to compare with.

    Returns :

    negative value if a < b; zero if a = b; positive +negative value if a < b; zero if a = b; positive value if a > b.
    - - - - @@ -839,28 +873,29 @@ function to determine its position.


    g_list_sort_with_data ()

    -
    GList*              g_list_sort_with_data               (GList *list,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +
    GList*              g_list_sort_with_data               (GList *list,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);

    Like g_list_sort(), but the comparison function accepts -a user data argument.

    +a user data argument. +

    list :

    a pointer to a GList +a pointer to a GList

    data :

    the data for the new element +the data for the new element

    func :

    the function to compare elements in the list. +the function to compare elements in the list. It should return a number > 0 if the first parameter comes after the second parameter in the sort order.

    user_data :

    user data to pass to comparison function. +user data to pass to comparison function.
    - - - @@ -874,35 +909,36 @@ a user data argument.


    GCompareDataFunc ()

    -
    gint                (*GCompareDataFunc)                 (gconstpointer a,
    -                                                         gconstpointer b,
    -                                                         gpointer user_data);
    +
    gint                (*GCompareDataFunc)                 (gconstpointer a,
    +                                                         gconstpointer b,
    +                                                         gpointer user_data);

    Specifies the type of a comparison function used to compare two values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive -integer if the first value comes after the second.

    +integer if the first value comes after the second. +

    list :

    a GList +a GList

    compare_func :

    comparison function +comparison function

    user_data :

    user data to pass to comparison function +user data to pass to comparison function
    - - - - @@ -912,23 +948,24 @@ integer if the first value comes after the second.


    g_list_concat ()

    -
    GList*              g_list_concat                       (GList *list1,
    -                                                         GList *list2);
    +
    GList*              g_list_concat                       (GList *list1,
    +                                                         GList *list2);

    Adds the second GList onto the end of the first GList. Note that the elements of the second GList are not copied. -They are used directly.

    +They are used directly. +

    a :

    a value. +a value.

    b :

    a value to compare with. +a value to compare with.

    user_data :

    user data to pass to comparison function. +user data to pass to comparison function.

    Returns :

    negative value if a < b; zero if a = b; positive +negative value if a < b; zero if a = b; positive value if a > b.
    - - @@ -942,27 +979,28 @@ They are used directly.


    g_list_foreach ()

    -
    void                g_list_foreach                      (GList *list,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_list_foreach                      (GList *list,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    -Calls a function for each element of a GList.

    +Calls a function for each element of a GList. +

    list1 :

    a GList +a GList

    list2 :

    the GList to add to the end of the first GList +the GList to add to the end of the first GList
    - - - @@ -971,22 +1009,23 @@ Calls a function for each element of a

    GFunc ()

    -
    void                (*GFunc)                            (gpointer data,
    -                                                         gpointer user_data);
    +
    void                (*GFunc)                            (gpointer data,
    +                                                         gpointer user_data);

    Specifies the type of functions passed to g_list_foreach() and -g_slist_foreach().

    +g_slist_foreach(). +

    list :

    a GList +a GList

    func :

    the function to call with each element's data +the function to call with each element's data

    user_data :

    user data to pass to the function +user data to pass to the function
    - - @@ -996,15 +1035,16 @@ Specifies the type of functions passed to

    g_list_first ()

    -
    GList*              g_list_first                        (GList *list);
    +
    GList*              g_list_first                        (GList *list);

    -Gets the first element in a GList.

    +Gets the first element in a GList. +

    data :

    the element's data. +the element's data.

    user_data :

    user data passed to g_list_foreach() or +user data passed to g_list_foreach() or g_slist_foreach().
    - @@ -1019,15 +1059,16 @@ Gets the first element in a

    g_list_last ()

    -
    GList*              g_list_last                         (GList *list);
    +
    GList*              g_list_last                         (GList *list);

    -Gets the last element in a GList.

    +Gets the last element in a GList. +

    list :

    a GList +a GList
    - @@ -1044,18 +1085,19 @@ Gets the last element in a

    g_list_previous()

    #define             g_list_previous(list)

    -A convenience macro to get the previous element in a GList.

    +A convenience macro to get the previous element in a GList. +

    list :

    a GList +a GList
    - - @@ -1067,18 +1109,19 @@ A convenience macro to get the previous element in a

    g_list_next()

    #define             g_list_next(list)

    -A convenience macro to get the next element in a GList.

    +A convenience macro to get the next element in a GList. +

    list :

    an element in a GList. +an element in a GList.

    Returns :

    the previous element, or NULL if there are no previous +the previous element, or NULL if there are no previous elements.
    - - @@ -1087,21 +1130,22 @@ A convenience macro to get the next element in a

    g_list_nth ()

    -
    GList*              g_list_nth                          (GList *list,
    -                                                         guint n);
    +
    GList*              g_list_nth                          (GList *list,
    +                                                         guint n);

    -Gets the element at the given position in a GList.

    +Gets the element at the given position in a GList. +

    list :

    an element in a GList. +an element in a GList.

    Returns :

    the next element, or NULL if there are no more elements. +the next element, or NULL if there are no more elements.
    - - @@ -1116,21 +1160,22 @@ Gets the element at the given position in a

    g_list_nth_data ()

    -
    gpointer            g_list_nth_data                     (GList *list,
    -                                                         guint n);
    +
    gpointer            g_list_nth_data                     (GList *list,
    +                                                         guint n);

    -Gets the data of the element at the given position.

    +Gets the data of the element at the given position. +

    list :

    a GList +a GList

    n :

    the position of the element, counting from 0 +the position of the element, counting from 0
    - - @@ -1145,21 +1190,22 @@ Gets the data of the element at the given position.


    g_list_nth_prev ()

    -
    GList*              g_list_nth_prev                     (GList *list,
    -                                                         guint n);
    +
    GList*              g_list_nth_prev                     (GList *list,
    +                                                         guint n);

    -Gets the element n places before list.

    +Gets the element n places before list. +

    list :

    a GList +a GList

    n :

    the position of the element +the position of the element
    - - @@ -1174,22 +1220,23 @@ Gets the element n places before

    g_list_find ()

    -
    GList*              g_list_find                         (GList *list,
    -                                                         gconstpointer data);
    +
    GList*              g_list_find                         (GList *list,
    +                                                         gconstpointer data);

    Finds the element in a GList which -contains the given data.

    +contains the given data. +

    list :

    a GList +a GList

    n :

    the position of the element, counting from 0 +the position of the element, counting from 0
    - - @@ -1204,32 +1251,33 @@ contains the given data.


    g_list_find_custom ()

    -
    GList*              g_list_find_custom                  (GList *list,
    -                                                         gconstpointer data,
    -                                                         GCompareFunc func);
    +
    GList*              g_list_find_custom                  (GList *list,
    +                                                         gconstpointer data,
    +                                                         GCompareFunc func);

    Finds an element in a GList, using a supplied function to find the desired element. It iterates over the list, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the GList element's data as the first argument and the -given user data.

    +given user data. +

    list :

    a GList +a GList

    data :

    the element data to find +the element data to find
    - - - @@ -1244,22 +1292,23 @@ given user data.


    g_list_position ()

    -
    gint                g_list_position                     (GList *list,
    -                                                         GList *llink);
    +
    gint                g_list_position                     (GList *list,
    +                                                         GList *llink);

    Gets the position of the given element -in the GList (starting from 0).

    +in the GList (starting from 0). +

    list :

    a GList +a GList

    data :

    user data passed to the function +user data passed to the function

    func :

    the function to call for each element. +the function to call for each element. It should return 0 when the desired element is found
    - - @@ -1274,22 +1323,23 @@ in the

    g_list_index ()

    -
    gint                g_list_index                        (GList *list,
    -                                                         gconstpointer data);
    +
    gint                g_list_index                        (GList *list,
    +                                                         gconstpointer data);

    Gets the position of the element containing -the given data (starting from 0).

    +the given data (starting from 0). +

    list :

    a GList +a GList

    llink :

    an element in the GList +an element in the GList
    - - @@ -1304,7 +1354,7 @@ the given data (starting from 0).


    g_list_push_allocator ()

    -
    void                g_list_push_allocator               (gpointer allocator);
    +
    void                g_list_push_allocator               (gpointer allocator);

    Warning

    g_list_push_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GList has been converted @@ -1317,12 +1367,13 @@ Sets the allocator to use to allocate --disable-mem-pools

    +with --disable-mem-pools +

    list :

    a GList +a GList

    data :

    the data to find +the data to find
    -

    allocator :

    the GAllocator to use when allocating GList elements. +the GAllocator to use when allocating GList elements.
    @@ -1330,7 +1381,7 @@ with --disable-mem-pools


    g_list_pop_allocator ()

    -
    void                g_list_pop_allocator                (void);
    +
    void                g_list_pop_allocator                (void);

    Warning

    g_list_pop_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GList has been converted @@ -1343,12 +1394,13 @@ elements.

    Note that this function is not available if GLib has been compiled -with --disable-mem-pools

    +with --disable-mem-pools +

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Dynamic-Loading-of-Modules.html b/docs/reference/glib/html/glib-Dynamic-Loading-of-Modules.html index 4712c89..bbf3135 100644 --- a/docs/reference/glib/html/glib-Dynamic-Loading-of-Modules.html +++ b/docs/reference/glib/html/glib-Dynamic-Loading-of-Modules.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,22 +41,22 @@ #include <gmodule.h> GModule; -gbooleang_module_supported (void); -gchar* g_module_build_path (const gchar *directory, - const gchar *module_name); -GModule* g_module_open (const gchar *file_name, - GModuleFlags flags); +gbooleang_module_supported (void); +gchar* g_module_build_path (const gchar *directory, + const gchar *module_name); +GModule* g_module_open (const gchar *file_name, + GModuleFlags flags); enum GModuleFlags; -gbooleang_module_symbol (GModule *module, - const gchar *symbol_name, - gpointer *symbol); -const gchar* g_module_name (GModule *module); -voidg_module_make_resident (GModule *module); -gbooleang_module_close (GModule *module); -const gchar* g_module_error (void); +gbooleang_module_symbol (GModule *module, + const gchar *symbol_name, + gpointer *symbol); +const gchar* g_module_name (GModule *module); +voidg_module_make_resident (GModule *module); +gbooleang_module_close (GModule *module); +const gchar* g_module_error (void); -const gchar * (*GModuleCheckInit) (GModule *module); -void (*GModuleUnload) (GModule *module); +const gchar * (*GModuleCheckInit) (GModule *module); +void (*GModuleUnload) (GModule *module); #define G_MODULE_SUFFIX #define G_MODULE_EXPORT #define G_MODULE_IMPORT @@ -120,44 +100,86 @@ it must ensure that it is never unloaded, by calling -

    Example 11. Calling a function defined in a GModule

    -
    -/* the function signature for 'say_hello' */
    -typedef void (* SayHelloFunc) (const char *message);
    -gboolean
    -just_say_hello (const char *filename, GError **error)
    -{
    -  SayHelloFunc  say_hello;
    -  GModule      *module;
    -  module = g_module_open (filename, G_MODULE_BIND_LAZY);
    -  if (!module)
    -    {
    -      g_set_error (error, FOO_ERROR, FOO_ERROR_BLAH,
    -		   "%s", g_module_error ());
    -      return FALSE;
    -    }
    -  if (!g_module_symbol (module, "say_hello", (gpointer *)&say_hello))
    -    {
    -      g_set_error (error, SAY_ERROR, SAY_ERROR_OPEN,
    -		   "%s: %s", filename, g_module_error ());
    -      if (!g_module_close (module))
    -	g_warning ("%s: %s", filename, g_module_error ());
    -      return FALSE;
    -    }
    -  if (say_hello == NULL)
    -    {
    -      g_set_error (error, SAY_ERROR, SAY_ERROR_OPEN, "symbol say_hello is NULL");
    -      if (!g_module_close (module))
    -	g_warning ("%s: %s", filename, g_module_error ());
    -      return FALSE;
    -    }
    -  /* call our function in the module */
    -  say_hello ("Hello world!");
    -  if (!g_module_close (module))
    -    g_warning ("%s: %s", filename, g_module_error ());
    -  return TRUE;
    -}
    -
    +

    Example 11. Calling a function defined in a GModule

    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    +35
    /* the function signature for 'say_hello' */
    +typedef void (* SayHelloFunc) (const char *message);
    +gboolean
    +just_say_hello (const char *filename, GError **error)
    +{
    +  SayHelloFunc  say_hello;
    +  GModule      *module;
    +  module = g_module_open (filename, G_MODULE_BIND_LAZY);
    +  if (!module)
    +    {
    +      g_set_error (error, FOO_ERROR, FOO_ERROR_BLAH,
    +           "%s", g_module_error ());
    +      return FALSE;
    +    }
    +  if (!g_module_symbol (module, "say_hello", (gpointer *)&say_hello))
    +    {
    +      g_set_error (error, SAY_ERROR, SAY_ERROR_OPEN,
    +           "%s: %s", filename, g_module_error ());
    +      if (!g_module_close (module))
    +    g_warning ("%s: %s", filename, g_module_error ());
    +      return FALSE;
    +    }
    +  if (say_hello == NULL)
    +    {
    +      g_set_error (error, SAY_ERROR, SAY_ERROR_OPEN, "symbol say_hello is NULL");
    +      if (!g_module_close (module))
    +    g_warning ("%s: %s", filename, g_module_error ());
    +      return FALSE;
    +    }
    +  /* call our function in the module */
    +  say_hello ("Hello world!");
    +  if (!g_module_close (module))
    +    g_warning ("%s: %s", filename, g_module_error ());
    +  return TRUE;
    +}
    + +


    @@ -176,7 +198,7 @@ It should only be accessed via the following functions.

    g_module_supported ()

    -
    gboolean            g_module_supported                  (void);
    +
    gboolean            g_module_supported                  (void);

    Checks if modules are supported on the current platform.

    @@ -193,8 +215,8 @@ Checks if modules are supported on the current platform.

    g_module_build_path ()

    -
    gchar*              g_module_build_path                 (const gchar *directory,
    -                                                         const gchar *module_name);
    +
    gchar*              g_module_build_path                 (const gchar *directory,
    +                                                         const gchar *module_name);

    A portable way to build the filename of a module. The platform-specific prefix and suffix are added to the filename, if needed, and the result is @@ -240,8 +262,8 @@ prefix and suffix. This should be freed when no longer needed.


    g_module_open ()

    -
    GModule*            g_module_open                       (const gchar *file_name,
    -                                                         GModuleFlags flags);
    +
    GModule*            g_module_open                       (const gchar *file_name,
    +                                                         GModuleFlags flags);

    Opens a module. If the module has already been opened, its reference count is incremented. @@ -321,9 +343,9 @@ not supported on all platforms.


    g_module_symbol ()

    -
    gboolean            g_module_symbol                     (GModule *module,
    -                                                         const gchar *symbol_name,
    -                                                         gpointer *symbol);
    +
    gboolean            g_module_symbol                     (GModule *module,
    +                                                         const gchar *symbol_name,
    +                                                         gpointer *symbol);

    Gets a symbol pointer from a module, such as one exported by G_MODULE_EXPORT.

    @@ -360,7 +382,7 @@ Note that a valid symbol can be

    g_module_name ()

    -
    const gchar*        g_module_name                       (GModule *module);
    +
    const gchar*        g_module_name                       (GModule *module);

    Gets the filename from a GModule.

    @@ -384,7 +406,7 @@ program itself.

    g_module_make_resident ()

    -
    void                g_module_make_resident              (GModule *module);
    +
    void                g_module_make_resident              (GModule *module);

    Ensures that a module will never be unloaded. Any future g_module_close() calls on the module will be ignored. @@ -401,7 +423,7 @@ Any future

    g_module_close ()

    -
    gboolean            g_module_close                      (GModule *module);
    +
    gboolean            g_module_close                      (GModule *module);

    Closes a module.

    @@ -425,7 +447,7 @@ Closes a module.

    g_module_error ()

    -
    const gchar*        g_module_error                      (void);
    +
    const gchar*        g_module_error                      (void);

    Gets a string describing the last module error.

    @@ -441,7 +463,7 @@ Gets a string describing the last module error.

    GModuleCheckInit ()

    -
    const gchar *       (*GModuleCheckInit)                 (GModule *module);
    +
    const gchar *       (*GModuleCheckInit)                 (GModule *module);

    Specifies the type of the module initialization function. @@ -470,7 +492,7 @@ error.


    GModuleUnload ()

    -
    void                (*GModuleUnload)                    (GModule *module);
    +
    void                (*GModuleUnload)                    (GModule *module);

    Specifies the type of the module function called when it is unloaded. @@ -521,6 +543,6 @@ Used to declare functions imported from modules.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Error-Reporting.html b/docs/reference/glib/html/glib-Error-Reporting.html index ffbfc65..2cb7506 100644 --- a/docs/reference/glib/html/glib-Error-Reporting.html +++ b/docs/reference/glib/html/glib-Error-Reporting.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,41 +41,41 @@ #include <glib.h> GError; -GError* g_error_new (GQuark domain, - gint code, - const gchar *format, - ...); -GError* g_error_new_literal (GQuark domain, - gint code, - const gchar *message); -GError* g_error_new_valist (GQuark domain, - gint code, - const gchar *format, - va_list args); -voidg_error_free (GError *error); -GError* g_error_copy (const GError *error); -gbooleang_error_matches (const GError *error, - GQuark domain, - gint code); -voidg_set_error (GError **err, - GQuark domain, - gint code, - const gchar *format, - ...); -voidg_set_error_literal (GError **err, - GQuark domain, - gint code, - const gchar *message); -voidg_propagate_error (GError **dest, - GError *src); -voidg_clear_error (GError **err); -voidg_prefix_error (GError **err, - const gchar *format, - ...); -voidg_propagate_prefixed_error (GError **dest, - GError *src, - const gchar *format, - ...); +GError* g_error_new (GQuark domain, + gint code, + const gchar *format, + ...); +GError* g_error_new_literal (GQuark domain, + gint code, + const gchar *message); +GError* g_error_new_valist (GQuark domain, + gint code, + const gchar *format, + va_list args); +voidg_error_free (GError *error); +GError* g_error_copy (const GError *error); +gbooleang_error_matches (const GError *error, + GQuark domain, + gint code); +voidg_set_error (GError **err, + GQuark domain, + gint code, + const gchar *format, + ...); +voidg_set_error_literal (GError **err, + GQuark domain, + gint code, + const gchar *message); +voidg_propagate_error (GError **dest, + GError *src); +voidg_clear_error (GError **err); +voidg_prefix_error (GError **err, + const gchar *format, + ...); +voidg_propagate_prefixed_error (GError **dest, + GError *src, + const gchar *format, + ...);
    @@ -130,34 +110,68 @@ This is why most functions in GLib and GTK+ do not use the GError as their last argument. For example:

    -
    -gboolean g_file_get_contents (const gchar *filename,
    -	                      gchar      **contents,
    -                              gsize       *length,
    -                              GError     **error);
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    gboolean g_file_get_contents (const gchar *filename,
    +                          gchar      **contents,
    +                              gsize       *length,
    +                              GError     **error);
    +
    +

    If you pass a non-NULL value for the error argument, it should point to a location where an error can be placed. For example:

    -
    -gchar *contents;
    -GError *err = NULL;
    -g_file_get_contents ("foo.txt", &contents, NULL, &err);
    -g_assert ((contents == NULL && err != NULL) || (contents != NULL && err == NULL));
    -if (err != NULL)
    -  {
    -    /* Report error to user, and free error */
    -    g_assert (contents == NULL);
    -    fprintf (stderr, "Unable to read file: %s\n", err->message);
    -    g_error_free (err);
    -  }
    -else
    -  {
    -    /* Use file contents */
    -    g_assert (contents != NULL);
    -  }
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    gchar *contents;
    +GError *err = NULL;
    +g_file_get_contents ("foo.txt", &contents, NULL, &err);
    +g_assert ((contents == NULL && err != NULL) || (contents != NULL && err == NULL));
    +if (err != NULL)
    +  {
    +    /* Report error to user, and free error */
    +    g_assert (contents == NULL);
    +    fprintf (stderr, "Unable to read file: %s\n", err->message);
    +    g_error_free (err);
    +  }
    +else
    +  {
    +    /* Use file contents */
    +    g_assert (contents != NULL);
    +  }
    +
    +

    Note that err != NULL in this example is a reliable indicator of whether @@ -169,12 +183,23 @@ Because NULL for the error argument:

    -
    -if (g_file_get_contents ("foo.txt", &contents, NULL, NULL)) /* ignore errors */
    -  /* no error occurred */ ;
    -else
    -  /* error */ ;
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    if (g_file_get_contents ("foo.txt", &contents, NULL, NULL)) /* ignore errors */
    +  /* no error occurred */ ;
    +else
    +  /* error */ ;
    +
    +

    @@ -198,25 +223,49 @@ When implementing a function that can report errors, the basic tool is then return immediately. g_set_error() does nothing if the error location passed to it is NULL. Here's an example:

    -
    -gint
    -foo_open_file (GError **error)
    -{
    -  gint fd;
    -  fd = open ("file.txt", O_RDONLY);
    -  if (fd < 0)
    -    {
    -      g_set_error (error,
    -                   FOO_ERROR,                 /* error domain */
    -                   FOO_ERROR_BLAH,            /* error code */
    -                   "Failed to open file: %s", /* error message format string */
    -                   g_strerror (errno));
    -      return -1;
    -    }
    -  else
    -    return fd;
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    gint
    +foo_open_file (GError **error)
    +{
    +  gint fd;
    +  fd = open ("file.txt", O_RDONLY);
    +  if (fd < 0)
    +    {
    +      g_set_error (error,
    +                   FOO_ERROR,                 /* error domain */
    +                   FOO_ERROR_BLAH,            /* error code */
    +                   "Failed to open file: %s", /* error message format string */
    +                   g_strerror (errno));
    +      return -1;
    +    }
    +  else
    +    return fd;
    +}
    +
    +

    @@ -225,21 +274,41 @@ can report a GError, such as by returning TRUE on success, you can simply do the following:

    -
    -gboolean
    -my_function_that_can_fail (GError **err)
    -{
    -  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    -  if (!sub_function_that_can_fail (err))
    -    {
    -       /* assert that error was set by the sub-function */
    -       g_assert (err == NULL || *err != NULL);
    -       return FALSE;
    -    }
    -  /* otherwise continue, no error occurred */
    -  g_assert (err == NULL || *err == NULL);
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    gboolean
    +my_function_that_can_fail (GError **err)
    +{
    +  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    +  if (!sub_function_that_can_fail (err))
    +    {
    +       /* assert that error was set by the sub-function */
    +       g_assert (err == NULL || *err != NULL);
    +       return FALSE;
    +    }
    +  /* otherwise continue, no error occurred */
    +  g_assert (err == NULL || *err == NULL);
    +}
    +
    +

    @@ -247,46 +316,91 @@ If the sub-function does not indicate errors other than by reporting a GError since the passed-in one may be NULL. g_propagate_error() is intended for use in this case.

    -
    -gboolean
    -my_function_that_can_fail (GError **err)
    -{
    -  GError *tmp_error;
    -  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    -  tmp_error = NULL;
    -  sub_function_that_can_fail (&tmp_error);
    -  if (tmp_error != NULL)
    -    {
    -       /* store tmp_error in err, if err != NULL,
    -        * otherwise call g_error_free() on tmp_error
    -        */
    -       g_propagate_error (err, tmp_error);
    -       return FALSE;
    -    }
    -  /* otherwise continue, no error occurred */
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    gboolean
    +my_function_that_can_fail (GError **err)
    +{
    +  GError *tmp_error;
    +  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    +  tmp_error = NULL;
    +  sub_function_that_can_fail (&tmp_error);
    +  if (tmp_error != NULL)
    +    {
    +       /* store tmp_error in err, if err != NULL,
    +        * otherwise call g_error_free() on tmp_error
    +        */
    +       g_propagate_error (err, tmp_error);
    +       return FALSE;
    +    }
    +  /* otherwise continue, no error occurred */
    +}
    +
    +

    Error pileups are always a bug. For example, this code is incorrect:

    -
    -gboolean
    -my_function_that_can_fail (GError **err)
    -{
    -  GError *tmp_error;
    -  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    -  tmp_error = NULL;
    -  sub_function_that_can_fail (&tmp_error);
    -  other_function_that_can_fail (&tmp_error);
    -  if (tmp_error != NULL)
    -    {
    -       g_propagate_error (err, tmp_error);
    -       return FALSE;
    -    }
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    gboolean
    +my_function_that_can_fail (GError **err)
    +{
    +  GError *tmp_error;
    +  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    +  tmp_error = NULL;
    +  sub_function_that_can_fail (&tmp_error);
    +  other_function_that_can_fail (&tmp_error);
    +  if (tmp_error != NULL)
    +    {
    +       g_propagate_error (err, tmp_error);
    +       return FALSE;
    +    }
    +}
    +
    +

    tmp_error should be checked immediately after sub_function_that_can_fail(), and either cleared or propagated upward. The rule @@ -296,22 +410,43 @@ equivalent of handling an error by always doing nothing about it. So the following code is fine, assuming errors in sub_function_that_can_fail() are not fatal to my_function_that_can_fail():

    -
    -gboolean
    -my_function_that_can_fail (GError **err)
    -{
    -  GError *tmp_error;
    -  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    -  sub_function_that_can_fail (NULL); /* ignore errors */
    -  tmp_error = NULL;
    -  other_function_that_can_fail (&tmp_error);
    -  if (tmp_error != NULL)
    -    {
    -       g_propagate_error (err, tmp_error);
    -       return FALSE;
    -    }
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    gboolean
    +my_function_that_can_fail (GError **err)
    +{
    +  GError *tmp_error;
    +  g_return_val_if_fail (err == NULL || *err == NULL, FALSE);
    +  sub_function_that_can_fail (NULL); /* ignore errors */
    +  tmp_error = NULL;
    +  other_function_that_can_fail (&tmp_error);
    +  if (tmp_error != NULL)
    +    {
    +       g_propagate_error (err, tmp_error);
    +       return FALSE;
    +    }
    +}
    +
    +

    @@ -330,14 +465,27 @@ The error domain is called <NAMESPACE>_<MODULE>_ERROR, for example G_SPAWN_ERROR or G_THREAD_ERROR:

    -
    -#define G_SPAWN_ERROR g_spawn_error_quark ()
    -GQuark
    -g_spawn_error_quark (void)
    -{
    -  return g_quark_from_static_string ("g-spawn-error-quark");
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    #define G_SPAWN_ERROR g_spawn_error_quark ()
    +GQuark
    +g_spawn_error_quark (void)
    +{
    +  return g_quark_from_static_string ("g-spawn-error-quark");
    +}
    +
    +

    @@ -461,34 +609,35 @@ information about an error that has occurred.

    g_error_new ()

    -
    GError*             g_error_new                         (GQuark domain,
    -                                                         gint code,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    GError*             g_error_new                         (GQuark domain,
    +                                                         gint code,
    +                                                         const gchar *format,
    +                                                         ...);

    Creates a new GError with the given domain and code, -and a message formatted with format.

    +and a message formatted with format. +

    - - - - @@ -502,30 +651,31 @@ and a message formatted with format.


    g_error_new_literal ()

    -
    GError*             g_error_new_literal                 (GQuark domain,
    -                                                         gint code,
    -                                                         const gchar *message);
    +
    GError*             g_error_new_literal                 (GQuark domain,
    +                                                         gint code,
    +                                                         const gchar *message);

    Creates a new GError; unlike g_error_new(), message is not a printf()-style format string. Use this function if message contains text you don't have control over, -that could include printf() escape sequences.

    +that could include printf() escape sequences. +

    domain :

    error domain +error domain

    code :

    error code +error code

    format :

    printf()-style format for error message +printf()-style format for error message

    ... :

    parameters for message format +parameters for message format
    - - - @@ -539,34 +689,36 @@ that could include printf() escape sequences.


    g_error_new_valist ()

    -
    GError*             g_error_new_valist                  (GQuark domain,
    -                                                         gint code,
    -                                                         const gchar *format,
    -                                                         va_list args);
    +
    GError*             g_error_new_valist                  (GQuark domain,
    +                                                         gint code,
    +                                                         const gchar *format,
    +                                                         va_list args);

    Creates a new GError with the given domain and code, -and a message formatted with format.

    +and a message formatted with format. +

    domain :

    error domain +error domain

    code :

    error code +error code

    message :

    error message +error message
    - - - - @@ -582,14 +734,15 @@ and a message formatted with format.


    g_error_free ()

    -
    void                g_error_free                        (GError *error);
    +
    void                g_error_free                        (GError *error);

    -Frees a GError and associated resources.

    +Frees a GError and associated resources. +

    domain :

    error domain +error domain

    code :

    error code +error code

    format :

    printf()-style format for error message +printf()-style format for error message

    args :

    va_list of parameters for the message format + +va_list of parameters for the message format
    -

    error :

    a GError +a GError
    @@ -597,15 +750,16 @@ Frees a <

    g_error_copy ()

    -
    GError*             g_error_copy                        (const GError *error);
    +
    GError*             g_error_copy                        (const GError *error);

    -Makes a copy of error.

    +Makes a copy of error. +

    - @@ -619,29 +773,30 @@ Makes a copy of error.


    g_error_matches ()

    -
    gboolean            g_error_matches                     (const GError *error,
    -                                                         GQuark domain,
    -                                                         gint code);
    +
    gboolean            g_error_matches                     (const GError *error,
    +                                                         GQuark domain,
    +                                                         gint code);

    Returns TRUE if error matches domain and code, FALSE otherwise. In particular, when error is NULL, FALSE will -be returned.

    +be returned. +

    error :

    a GError +a GError
    - - - @@ -655,40 +810,41 @@ be returned.


    g_set_error ()

    -
    void                g_set_error                         (GError **err,
    -                                                         GQuark domain,
    -                                                         gint code,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_set_error                         (GError **err,
    +                                                         GQuark domain,
    +                                                         gint code,
    +                                                         const gchar *format,
    +                                                         ...);

    Does nothing if err is NULL; if err is non-NULL, then *err -must be NULL. A new GError is created and assigned to *err.

    +must be NULL. A new GError is created and assigned to *err. +

    error :

    a GError or NULL +a GError or NULL

    domain :

    an error domain +an error domain

    code :

    an error code +an error code
    - - - - - @@ -697,37 +853,38 @@ must be

    g_set_error_literal ()

    -
    void                g_set_error_literal                 (GError **err,
    -                                                         GQuark domain,
    -                                                         gint code,
    -                                                         const gchar *message);
    +
    void                g_set_error_literal                 (GError **err,
    +                                                         GQuark domain,
    +                                                         gint code,
    +                                                         const gchar *message);

    Does nothing if err is NULL; if err is non-NULL, then *err must be NULL. A new GError is created and assigned to *err. Unlike g_set_error(), message is not a printf()-style format string. Use this function if message contains text you don't have control over, -that could include printf() escape sequences.

    +that could include printf() escape sequences. +

    err :

    a return location for a GError, or NULL +a return location for a GError, or NULL

    domain :

    error domain +error domain

    code :

    error code +error code

    format :

    printf()-style format +printf()-style format

    ... :

    args for format +args for format
    - - - - @@ -737,22 +894,23 @@ that could include printf() escape sequences.


    g_propagate_error ()

    -
    void                g_propagate_error                   (GError **dest,
    -                                                         GError *src);
    +
    void                g_propagate_error                   (GError **dest,
    +                                                         GError *src);

    If dest is NULL, free src; otherwise, moves src into *dest. -The error variable dest points to must be NULL.

    +The error variable dest points to must be NULL. +

    err :

    a return location for a GError, or NULL +a return location for a GError, or NULL

    domain :

    error domain +error domain

    code :

    error code +error code

    message :

    error message +error message
    - - @@ -761,15 +919,16 @@ The error variable dest points to must b

    g_clear_error ()

    -
    void                g_clear_error                       (GError **err);
    +
    void                g_clear_error                       (GError **err);

    If err is NULL, does nothing. If err is non-NULL, -calls g_error_free() on *err and sets *err to NULL.

    +calls g_error_free() on *err and sets *err to NULL. +

    dest :

    error return location +error return location

    src :

    error to move into the return location +error to move into the return location
    -

    err :

    a GError return location +a GError return location
    @@ -777,9 +936,9 @@ calls

    g_prefix_error ()

    -
    void                g_prefix_error                      (GError **err,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_prefix_error                      (GError **err,
    +                                                         const gchar *format,
    +                                                         ...);

    Formats a string according to format and prefix it to an existing error message. If @@ -791,23 +950,24 @@ If *err is - - - @@ -817,36 +977,37 @@ to you.


    g_propagate_prefixed_error ()

    -
    void                g_propagate_prefixed_error          (GError **dest,
    -                                                         GError *src,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_propagate_prefixed_error          (GError **dest,
    +                                                         GError *src,
    +                                                         const gchar *format,
    +                                                         ...);

    If dest is NULL, free src; otherwise, moves src into *dest. *dest must be NULL. After the move, add a prefix as with -g_prefix_error().

    +g_prefix_error(). +

    err :

    a return location for a GError, or NULL +a return location for a GError, or NULL

    format :

    printf()-style format string +printf()-style format string

    ... :

    arguments to format +arguments to format
    - - - - @@ -857,6 +1018,6 @@ After the move, add a prefix as with + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-File-Utilities.html b/docs/reference/glib/html/glib-File-Utilities.html index feb19b8..ab9ba21 100644 --- a/docs/reference/glib/html/glib-File-Utilities.html +++ b/docs/reference/glib/html/glib-File-Utilities.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    dest :

    error return location +error return location

    src :

    error to move into the return location +error to move into the return location

    format :

    printf()-style format string +printf()-style format string

    ... :

    arguments to format +arguments to format
    @@ -64,75 +44,75 @@ enum GFileError; #define G_FILE_ERROR enum GFileTest; -GFileErrorg_file_error_from_errno (gint err_no); -gbooleang_file_get_contents (const gchar *filename, - gchar **contents, - gsize *length, - GError **error); -gbooleang_file_set_contents (const gchar *filename, - const gchar *contents, - gssize length, - GError **error); -gbooleang_file_test (const gchar *filename, - GFileTest test); -gintg_mkstemp (gchar *tmpl); -gintg_mkstemp_full (gchar *tmpl, - int flags, - int mode); -gintg_file_open_tmp (const gchar *tmpl, - gchar **name_used, - GError **error); -gchar * g_file_read_link (const gchar *filename, - GError **error); -intg_mkdir_with_parents (const gchar *pathname, - int mode); +GFileErrorg_file_error_from_errno (gint err_no); +gbooleang_file_get_contents (const gchar *filename, + gchar **contents, + gsize *length, + GError **error); +gbooleang_file_set_contents (const gchar *filename, + const gchar *contents, + gssize length, + GError **error); +gbooleang_file_test (const gchar *filename, + GFileTest test); +gintg_mkstemp (gchar *tmpl); +gintg_mkstemp_full (gchar *tmpl, + int flags, + int mode); +gintg_file_open_tmp (const gchar *tmpl, + gchar **name_used, + GError **error); +gchar * g_file_read_link (const gchar *filename, + GError **error); +intg_mkdir_with_parents (const gchar *pathname, + int mode); GDir; -GDir * g_dir_open (const gchar *path, - guint flags, - GError **error); -const gchar * g_dir_read_name (GDir *dir); -voidg_dir_rewind (GDir *dir); -voidg_dir_close (GDir *dir); +GDir * g_dir_open (const gchar *path, + guint flags, + GError **error); +const gchar * g_dir_read_name (GDir *dir); +voidg_dir_rewind (GDir *dir); +voidg_dir_close (GDir *dir); GMappedFile; -GMappedFile * g_mapped_file_new (const gchar *filename, - gboolean writable, - GError **error); -GMappedFile * g_mapped_file_ref (GMappedFile *file); -voidg_mapped_file_unref (GMappedFile *file); -voidg_mapped_file_free (GMappedFile *file); -gsizeg_mapped_file_get_length (GMappedFile *file); -gchar * g_mapped_file_get_contents (GMappedFile *file); +GMappedFile * g_mapped_file_new (const gchar *filename, + gboolean writable, + GError **error); +GMappedFile * g_mapped_file_ref (GMappedFile *file); +voidg_mapped_file_unref (GMappedFile *file); +voidg_mapped_file_free (GMappedFile *file); +gsizeg_mapped_file_get_length (GMappedFile *file); +gchar * g_mapped_file_get_contents (GMappedFile *file); -intg_open (const gchar *filename, - int flags, - int mode); -intg_rename (const gchar *oldfilename, - const gchar *newfilename); -intg_mkdir (const gchar *filename, - int mode); -intg_stat (const gchar *filename, - struct _g_stat_struct *buf); -intg_lstat (const gchar *filename, - struct _g_stat_struct *buf); -intg_unlink (const gchar *filename); -intg_remove (const gchar *filename); -intg_rmdir (const gchar *filename); -FILE * g_fopen (const gchar *filename, - const gchar *mode); -FILE * g_freopen (const gchar *filename, - const gchar *mode, - FILE *stream); -intg_chmod (const gchar *filename, - int mode); -intg_access (const gchar *filename, - int mode); -intg_creat (const gchar *filename, - int mode); -intg_chdir (const gchar *path); -intg_utime (const gchar *filename, - struct utimbuf *utb); +intg_open (const gchar *filename, + int flags, + int mode); +intg_rename (const gchar *oldfilename, + const gchar *newfilename); +intg_mkdir (const gchar *filename, + int mode); +intg_stat (const gchar *filename, + struct _g_stat_struct *buf); +intg_lstat (const gchar *filename, + struct _g_stat_struct *buf); +intg_unlink (const gchar *filename); +intg_remove (const gchar *filename); +intg_rmdir (const gchar *filename); +FILE * g_fopen (const gchar *filename, + const gchar *mode); +FILE * g_freopen (const gchar *filename, + const gchar *mode, + FILE *stream); +intg_chmod (const gchar *filename, + int mode); +intg_access (const gchar *filename, + int mode); +intg_creat (const gchar *filename, + int mode); +intg_chdir (const gchar *path); +intg_utime (const gchar *filename, + struct utimbuf *utb);
    @@ -453,7 +433,7 @@ A test to perform on a file using

    g_file_error_from_errno ()

    -
    GFileError          g_file_error_from_errno             (gint err_no);
    +
    GFileError          g_file_error_from_errno             (gint err_no);

    Gets a GFileError constant based on the passed-in errno. For example, if you pass in EEXIST this function returns @@ -463,13 +443,14 @@ assume that all Normally a GFileError value goes into a GError returned from a function that manipulates files. So you would use -g_file_error_from_errno() when constructing a GError.

    +g_file_error_from_errno() when constructing a GError. +

    - @@ -483,10 +464,10 @@ from a function that manipulates files. So you would use

    g_file_get_contents ()

    -
    gboolean            g_file_get_contents                 (const gchar *filename,
    -                                                         gchar **contents,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gboolean            g_file_get_contents                 (const gchar *filename,
    +                                                         gchar **contents,
    +                                                         gsize *length,
    +                                                         GError **error);

    Reads an entire file into allocated memory, with good error checking. @@ -498,29 +479,30 @@ stored in contents will be nul-terminate NULL for the length argument. If the call was not successful, it returns FALSE and sets error. The error domain is G_FILE_ERROR. Possible error codes are those in the GFileError enumeration. In the error case, -contents is set to NULL and length is set to zero.

    +contents is set to NULL and length is set to zero. +

    err_no :

    an "errno" value +an "errno" value
    - - - - @@ -534,10 +516,10 @@ codes are those in the

    g_file_set_contents ()

    -
    gboolean            g_file_set_contents                 (const gchar *filename,
    -                                                         const gchar *contents,
    -                                                         gssize length,
    -                                                         GError **error);
    +
    gboolean            g_file_set_contents                 (const gchar *filename,
    +                                                         const gchar *contents,
    +                                                         gssize length,
    +                                                         GError **error);

    Writes all of contents to a file named filename, with good error checking. If a file called filename already exists it will be overwritten. @@ -569,29 +551,30 @@ file which is then renamed to the final name. Notes:

    If the call was sucessful, it returns TRUE. If the call was not successful, it returns FALSE and sets error. The error domain is G_FILE_ERROR. -Possible error codes are those in the GFileError enumeration.

    +Possible error codes are those in the GFileError enumeration. +

    filename :

    name of a file to read contents from, in the GLib file name encoding +name of a file to read contents from, in the GLib file name encoding

    contents :

    location to store an allocated string, use g_free() to free +location to store an allocated string, use g_free() to free the returned string

    length :

    location to store length in bytes of the contents, or NULL +location to store length in bytes of the contents, or NULL

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - @@ -607,8 +590,8 @@ Possible error codes are those in the

    g_file_test ()

    -
    gboolean            g_file_test                         (const gchar *filename,
    -                                                         GFileTest test);
    +
    gboolean            g_file_test                         (const gchar *filename,
    +                                                         GFileTest test);

    Returns TRUE if any of the tests in the bitfield test are TRUE. For example, (G_FILE_TEST_EXISTS | @@ -634,14 +617,27 @@ For example, you might think you could use

    -/* DON'T DO THIS */
    - if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK)) 
    -   {
    -     fd = g_open (filename, O_WRONLY);
    -     /* write to fd */
    -   }
    -
    +
    +

    filename :

    name of a file to write contents to, in the GLib file name +name of a file to write contents to, in the GLib file name encoding

    contents :

    string to write to the file +string to write to the file

    length :

    length of contents, or -1 if contents is a nul-terminated string +length of contents, or -1 if contents is a nul-terminated string

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    /* DON'T DO THIS */
    + if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK)) 
    +   {
    +     fd = g_open (filename, O_WRONLY);
    +     /* write to fd */
    +   }
    +

    +

    @@ -657,18 +653,19 @@ On Windows, there are no symlinks, so testing for G_FILE_TEST_IS_SYMLINK will always return FALSE. Testing for G_FILE_TEST_IS_EXECUTABLE will just check that the file exists and its name indicates that it is executable, checking for well-known -extensions and those listed in the PATHEXT environment variable.

    +extensions and those listed in the PATHEXT environment variable. +

    - - @@ -682,7 +679,7 @@ extensions and those listed in the PATHEXT environm

    g_mkstemp ()

    -
    gint                g_mkstemp                           (gchar *tmpl);
    +
    gint                g_mkstemp                           (gchar *tmpl);

    Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems. @@ -695,13 +692,14 @@ in that the sequence does not have to occur at the very end of the template. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, -on Windows it should be in UTF-8.

    +on Windows it should be in UTF-8. +

    filename :

    a filename to test in the GLib file name encoding +a filename to test in the GLib file name encoding

    test :

    bitfield of GFileTest flags +bitfield of GFileTest flags
    - @@ -718,9 +716,9 @@ closed with close(). In case of errors, -1 is retu

    g_mkstemp_full ()

    -
    gint                g_mkstemp_full                      (gchar *tmpl,
    -                                                         int flags,
    -                                                         int mode);
    +
    gint                g_mkstemp_full                      (gchar *tmpl,
    +                                                         int flags,
    +                                                         int mode);

    Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems. @@ -733,24 +731,25 @@ in that the sequence does not have to occur at the very end of the template and you can pass a mode and additional flags. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, -on Windows it should be in UTF-8.

    +on Windows it should be in UTF-8. +

    tmpl :

    template filename +template filename
    - - - @@ -768,9 +767,9 @@ on Windows it should be in UTF-8.


    g_file_open_tmp ()

    -
    gint                g_file_open_tmp                     (const gchar *tmpl,
    -                                                         gchar **name_used,
    -                                                         GError **error);
    +
    gint                g_file_open_tmp                     (const gchar *tmpl,
    +                                                         gchar **name_used,
    +                                                         GError **error);

    Opens a file for writing in the preferred directory for temporary files (as returned by g_get_tmp_dir()). @@ -789,24 +788,25 @@ Note that in contrast to name_used if non-NULL. This string should be freed with g_free() when not needed any longer. -The returned name is in the GLib file name encoding.

    +The returned name is in the GLib file name encoding. +

    tmpl :

    template filename +template filename

    flags :

    flags to pass to an open() call in addition to O_EXCL and +flags to pass to an open() call in addition to O_EXCL and O_CREAT, which are passed automatically

    mode :

    permissios to create the temporary file with +permissios to create the temporary file with
    - - - @@ -824,23 +824,24 @@ and error will be set.

    g_file_read_link ()

    -
    gchar *             g_file_read_link                    (const gchar *filename,
    -                                                         GError **error);
    +
    gchar *             g_file_read_link                    (const gchar *filename,
    +                                                         GError **error);

    Reads the contents of the symbolic link filename like the POSIX readlink() function. The returned string is in the encoding used -for filenames. Use g_filename_to_utf8() to convert it to UTF-8.

    +for filenames. Use g_filename_to_utf8() to convert it to UTF-8. +

    tmpl :

    Template for file name, as in g_mkstemp(), basename only, +Template for file name, as in g_mkstemp(), basename only, or NULL, to a default template

    name_used :

    location to store actual name used, or NULL +location to store actual name used, or NULL

    error :

    return location for a GError +return location for a GError
    - - @@ -857,22 +858,23 @@ for filenames. Use

    g_mkdir_with_parents ()

    -
    int                 g_mkdir_with_parents                (const gchar *pathname,
    -                                                         int mode);
    +
    int                 g_mkdir_with_parents                (const gchar *pathname,
    +                                                         int mode);

    Create a directory if it doesn't already exist. Create intermediate -parent directories as needed, too.

    +parent directories as needed, too. +

    filename :

    the symbolic link +the symbolic link

    error :

    return location for a GError +return location for a GError
    - - @@ -897,29 +899,30 @@ An opaque structure representing an opened directory.

    g_dir_open ()

    -
    GDir *              g_dir_open                          (const gchar *path,
    -                                                         guint flags,
    -                                                         GError **error);
    +
    GDir *              g_dir_open                          (const gchar *path,
    +                                                         guint flags,
    +                                                         GError **error);

    Opens a directory for reading. The names of the files in the -directory can then be retrieved using g_dir_read_name().

    +directory can then be retrieved using g_dir_read_name(). +

    pathname :

    a pathname in the GLib file name encoding +a pathname in the GLib file name encoding

    mode :

    permissions to use for newly created directories +permissions to use for newly created directories
    - - - @@ -937,17 +940,18 @@ directory can then be retrieved using

    g_dir_read_name ()

    -
    const gchar *       g_dir_read_name                     (GDir *dir);
    +
    const gchar *       g_dir_read_name                     (GDir *dir);

    Retrieves the name of the next entry in the directory. The '.' and '..' entries are omitted. On Windows, the returned name is in -UTF-8. On Unix, it is in the on-disk encoding.

    +UTF-8. On Unix, it is in the on-disk encoding. +

    path :

    the path to the directory you are interested in. On Unix +the path to the directory you are interested in. On Unix in the on-disk encoding. On Windows in UTF-8

    flags :

    Currently must be set to 0. Reserved for future use. +Currently must be set to 0. Reserved for future use.

    error :

    return location for a GError, or NULL. +return location for a GError, or NULL. If non-NULL, an error will be set if and only if g_dir_open() fails.
    - @@ -963,15 +967,16 @@ UTF-8. On Unix, it is in the on-disk encoding.


    g_dir_rewind ()

    -
    void                g_dir_rewind                        (GDir *dir);
    +
    void                g_dir_rewind                        (GDir *dir);

    Resets the given directory. The next call to g_dir_read_name() -will return the first entry again.

    +will return the first entry again. +

    dir :

    a GDir* created by g_dir_open() +a GDir* created by g_dir_open()
    -

    dir :

    a GDir* created by g_dir_open() +a GDir* created by g_dir_open()
    @@ -979,14 +984,15 @@ will return the first entry again.


    g_dir_close ()

    -
    void                g_dir_close                         (GDir *dir);
    +
    void                g_dir_close                         (GDir *dir);

    -Closes the directory and deallocates all related resources.

    +Closes the directory and deallocates all related resources. +

    -

    dir :

    a GDir* created by g_dir_open() +a GDir* created by g_dir_open()
    @@ -1004,9 +1010,9 @@ not be accessed directly.

    g_mapped_file_new ()

    -
    GMappedFile *       g_mapped_file_new                   (const gchar *filename,
    -                                                         gboolean writable,
    -                                                         GError **error);
    +
    GMappedFile *       g_mapped_file_new                   (const gchar *filename,
    +                                                         gboolean writable,
    +                                                         GError **error);

    Maps a file into memory. On UNIX, this is using the mmap() function.

    @@ -1020,23 +1026,24 @@ written back to the file. Note that modifications of the underlying file might affect the contents of the GMappedFile. Therefore, mapping should only be used if the file will not be modified, or if all modifications of the file are done -atomically (e.g. using g_file_set_contents()).

    +atomically (e.g. using g_file_set_contents()). +

    - - - @@ -1053,16 +1060,17 @@ atomically (e.g. using

    g_mapped_file_ref ()

    -
    GMappedFile *       g_mapped_file_ref                   (GMappedFile *file);
    +
    GMappedFile *       g_mapped_file_ref                   (GMappedFile *file);

    Increments the reference count of file by one. It is safe to call -this function from any thread.

    +this function from any thread. +

    filename :

    The path of the file to load, in the GLib filename encoding +The path of the file to load, in the GLib filename encoding

    writable :

    whether the mapping should be writable +whether the mapping should be writable

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - @@ -1078,7 +1086,7 @@ this function from any thread.


    g_mapped_file_unref ()

    -
    void                g_mapped_file_unref                 (GMappedFile *file);
    +
    void                g_mapped_file_unref                 (GMappedFile *file);

    Decrements the reference count of file by one. If the reference count drops to 0, unmaps the buffer of file and frees it. @@ -1087,12 +1095,13 @@ drops to 0, unmaps the buffer of file an It is safe to call this function from any thread.

    -Since 2.22

    +Since 2.22 +

    file :

    a GMappedFile +a GMappedFile
    -

    file :

    a GMappedFile +a GMappedFile
    @@ -1100,19 +1109,20 @@ Since 2.22


    g_mapped_file_free ()

    -
    void                g_mapped_file_free                  (GMappedFile *file);
    +
    void                g_mapped_file_free                  (GMappedFile *file);

    Warning

    g_mapped_file_free has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mapped_file_unref() instead.

    This call existed before GMappedFile had refcounting and is currently -exactly the same as g_mapped_file_unref().

    +exactly the same as g_mapped_file_unref(). +

    -

    file :

    a GMappedFile +a GMappedFile
    @@ -1121,15 +1131,16 @@ exactly the same as

    g_mapped_file_get_length ()

    -
    gsize               g_mapped_file_get_length            (GMappedFile *file);
    +
    gsize               g_mapped_file_get_length            (GMappedFile *file);

    -Returns the length of the contents of a GMappedFile.

    +Returns the length of the contents of a GMappedFile. +

    - @@ -1145,7 +1156,7 @@ Returns the length of the contents of a

    g_mapped_file_get_contents ()

    -
    gchar *             g_mapped_file_get_contents          (GMappedFile *file);
    +
    gchar *             g_mapped_file_get_contents          (GMappedFile *file);

    Returns the contents of a GMappedFile.

    @@ -1154,13 +1165,14 @@ Note that the contents may not be zero-terminated, even if the GMappedFile is backed by a text file.

    -If the file is empty then NULL is returned.

    +If the file is empty then NULL is returned. +

    file :

    a GMappedFile +a GMappedFile
    - @@ -1176,9 +1188,9 @@ If the file is empty then

    g_open ()

    -
    int                 g_open                              (const gchar *filename,
    -                                                         int flags,
    -                                                         int mode);
    +
    int                 g_open                              (const gchar *filename,
    +                                                         int flags,
    +                                                         int mode);

    A wrapper for the POSIX open() function. The open() function is used to convert a pathname into a file descriptor. @@ -1200,23 +1212,24 @@ this function cannot be passed to C library functions like read().

    -See your C library manual for more details about open().

    +See your C library manual for more details about open(). +

    file :

    a GMappedFile +a GMappedFile
    - - - @@ -1233,8 +1246,8 @@ return value can be used exactly like the return value from

    g_rename ()

    -
    int                 g_rename                            (const gchar *oldfilename,
    -                                                         const gchar *newfilename);
    +
    int                 g_rename                            (const gchar *oldfilename,
    +                                                         const gchar *newfilename);

    A wrapper for the POSIX rename() function. The rename() function renames a file, moving it between directories if required. @@ -1242,18 +1255,19 @@ renames a file, moving it between directories if required.

    See your C library manual for more details about how rename() works on your system. It is not possible in general on Windows to rename -a file that is open to some process.

    +a file that is open to some process. +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    flags :

    as in open() +as in open()

    mode :

    as in open() +as in open()
    - - @@ -1269,26 +1283,27 @@ a file that is open to some process.


    g_mkdir ()

    -
    int                 g_mkdir                             (const gchar *filename,
    -                                                         int mode);
    +
    int                 g_mkdir                             (const gchar *filename,
    +                                                         int mode);

    A wrapper for the POSIX mkdir() function. The mkdir() function attempts to create a directory with the given name and permissions. The mode argument is ignored on Windows.

    -See your C library manual for more details about mkdir().

    +See your C library manual for more details about mkdir(). +

    oldfilename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    newfilename :

    a pathname in the GLib file name encoding +a pathname in the GLib file name encoding
    - - @@ -1305,8 +1320,8 @@ See your C library manual for more details about mkdir()<

    g_stat ()

    -
    int                 g_stat                              (const gchar *filename,
    -                                                         struct _g_stat_struct *buf);
    +
    int                 g_stat                              (const gchar *filename,
    +                                                         struct _g_stat_struct *buf);

    A wrapper for the POSIX stat() function. The stat() function returns information about a file. On Windows the stat() function in @@ -1315,18 +1330,19 @@ not look at the ACL at all. Thus on Windows the protection bits in the st_mode field are a fabrication of little use.

    -See your C library manual for more details about stat().

    +See your C library manual for more details about stat(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    permissions to use for the newly created directory +permissions to use for the newly created directory
    - - @@ -1344,8 +1360,8 @@ See your C library manual for more details about stat()

    g_lstat ()

    -
    int                 g_lstat                             (const gchar *filename,
    -                                                         struct _g_stat_struct *buf);
    +
    int                 g_lstat                             (const gchar *filename,
    +                                                         struct _g_stat_struct *buf);

    A wrapper for the POSIX lstat() function. The lstat() function is like stat() except that in the case of symbolic links, it returns @@ -1354,18 +1370,19 @@ refers to. If the system does not support symbolic links g_stat().

    -See your C library manual for more details about lstat().

    +See your C library manual for more details about lstat(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    buf :

    a pointer to a stat struct, which +a pointer to a stat struct, which will be filled with the file information
    - - @@ -1383,7 +1400,7 @@ See your C library manual for more details about lstat()<

    g_unlink ()

    -
    int                 g_unlink                            (const gchar *filename);
    +
    int                 g_unlink                            (const gchar *filename);

    A wrapper for the POSIX unlink() function. The unlink() function deletes a name from the filesystem. If this was the last link to the @@ -1393,13 +1410,14 @@ file is freed.

    See your C library manual for more details about unlink(). Note that on Windows, it is in general not possible to delete files that -are open to some process, or mapped into memory.

    +are open to some process, or mapped into memory. +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    buf :

    a pointer to a stat struct, which +a pointer to a stat struct, which will be filled with the file information
    - @@ -1416,7 +1434,7 @@ are open to some process, or mapped into memory.


    g_remove ()

    -
    int                 g_remove                            (const gchar *filename);
    +
    int                 g_remove                            (const gchar *filename);

    A wrapper for the POSIX remove() function. The remove() function deletes a name from the filesystem. @@ -1435,13 +1453,14 @@ open to some process, or mapped into memory. If this function fails on Windows you can't infer too much from the errno value. rmdir() is tried regardless of what caused remove() to fail. Any errno value set by remove() will be overwritten by that -set by rmdir().

    +set by rmdir(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)
    - @@ -1458,20 +1477,21 @@ set by rmdir().


    g_rmdir ()

    -
    int                 g_rmdir                             (const gchar *filename);
    +
    int                 g_rmdir                             (const gchar *filename);

    A wrapper for the POSIX rmdir() function. The rmdir() function deletes a directory from the filesystem.

    See your C library manual for more details about how rmdir() works -on your system.

    +on your system. +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)
    - @@ -1488,8 +1508,8 @@ on your system.


    g_fopen ()

    -
    FILE *              g_fopen                             (const gchar *filename,
    -                                                         const gchar *mode);
    +
    FILE *              g_fopen                             (const gchar *filename,
    +                                                         const gchar *mode);

    A wrapper for the stdio fopen() function. The fopen() function opens a file and associates a new stream with it. @@ -1504,18 +1524,19 @@ code uses a different C library than GLib does, the passed to C library functions like fprintf() or fread().

    -See your C library manual for more details about fopen().

    +See your C library manual for more details about fopen(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)
    - - @@ -1533,32 +1554,33 @@ See your C library manual for more details about fopen()<

    g_freopen ()

    -
    FILE *              g_freopen                           (const gchar *filename,
    -                                                         const gchar *mode,
    -                                                         FILE *stream);
    +
    FILE *              g_freopen                           (const gchar *filename,
    +                                                         const gchar *mode,
    +                                                         FILE *stream);

    A wrapper for the POSIX freopen() function. The freopen() function opens a file and associates it with an existing stream.

    -See your C library manual for more details about freopen().

    +See your C library manual for more details about freopen(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    a string describing the mode in which the file should be +a string describing the mode in which the file should be opened
    - - - @@ -1575,8 +1597,8 @@ See your C library manual for more details about freopen(

    g_chmod ()

    -
    int                 g_chmod                             (const gchar *filename,
    -                                                         int mode);
    +
    int                 g_chmod                             (const gchar *filename,
    +                                                         int mode);

    A wrapper for the POSIX chmod() function. The chmod() function is used to set the permissions of a file system object. @@ -1589,18 +1611,19 @@ ACL. Software that needs to manage file permissions on Windows exactly should use the Win32 API.

    -See your C library manual for more details about chmod().

    +See your C library manual for more details about chmod(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    a string describing the mode in which the file should be +a string describing the mode in which the file should be opened

    stream :

    an existing stream which will be reused, or NULL +an existing stream which will be reused, or NULL
    - - @@ -1616,8 +1639,8 @@ See your C library manual for more details about chmod()<

    g_access ()

    -
    int                 g_access                            (const gchar *filename,
    -                                                         int mode);
    +
    int                 g_access                            (const gchar *filename,
    +                                                         int mode);

    A wrapper for the POSIX access() function. This function is used to test a pathname for one or several of read, write or execute @@ -1632,18 +1655,19 @@ Windows. Software that needs to handle file permissions on Windows more exactly should use the Win32 API.

    -See your C library manual for more details about access().

    +See your C library manual for more details about access(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    as in chmod() +as in chmod()
    - - @@ -1661,8 +1685,8 @@ error.

    g_creat ()

    -
    int                 g_creat                             (const gchar *filename,
    -                                                         int mode);
    +
    int                 g_creat                             (const gchar *filename,
    +                                                         int mode);

    A wrapper for the POSIX creat() function. The creat() function is used to convert a pathname into a file descriptor, creating a file @@ -1685,18 +1709,19 @@ this function cannot be passed to C library functions like read().

    -See your C library manual for more details about creat().

    +See your C library manual for more details about creat(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    as in access() +as in access()
    - - @@ -1713,19 +1738,20 @@ return value can be used exactly like the return value from

    g_chdir ()

    -
    int                 g_chdir                             (const gchar *path);
    +
    int                 g_chdir                             (const gchar *path);

    A wrapper for the POSIX chdir() function. The function changes the current directory of the process to path.

    -See your C library manual for more details about chdir().

    +See your C library manual for more details about chdir(). +

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    mode :

    as in creat() +as in creat()
    - @@ -1741,26 +1767,27 @@ See your C library manual for more details about chdir()<

    g_utime ()

    -
    int                 g_utime                             (const gchar *filename,
    -                                                         struct utimbuf *utb);
    +
    int                 g_utime                             (const gchar *filename,
    +                                                         struct utimbuf *utb);

    A wrapper for the POSIX utime() function. The utime() function sets the access and modification timestamps of a file.

    See your C library manual for more details about how utime() works -on your system.

    +on your system. +

    path :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)
    - - @@ -1778,6 +1805,6 @@ on your system.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-GVariant.html b/docs/reference/glib/html/glib-GVariant.html index e22d687..b1b01d9 100644 --- a/docs/reference/glib/html/glib-GVariant.html +++ b/docs/reference/glib/html/glib-GVariant.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    filename :

    a pathname in the GLib file name encoding (UTF-8 on Windows) +a pathname in the GLib file name encoding (UTF-8 on Windows)

    utb :

    a pointer to a struct utimbuf. +a pointer to a struct utimbuf.
    @@ -61,158 +41,158 @@ #include <glib.h> GVariant; -void g_variant_unref (GVariant *value); -GVariant * g_variant_ref (GVariant *value); -GVariant * g_variant_ref_sink (GVariant *value); -const GVariantType * g_variant_get_type (GVariant *value); -const gchar * g_variant_get_type_string (GVariant *value); -gboolean g_variant_is_of_type (GVariant *value, - const GVariantType *type); -gboolean g_variant_is_container (GVariant *value); +void g_variant_unref (GVariant *value); +GVariant * g_variant_ref (GVariant *value); +GVariant * g_variant_ref_sink (GVariant *value); +const GVariantType * g_variant_get_type (GVariant *value); +const gchar * g_variant_get_type_string (GVariant *value); +gboolean g_variant_is_of_type (GVariant *value, + const GVariantType *type); +gboolean g_variant_is_container (GVariant *value); -GVariantClass g_variant_classify (GVariant *value); +GVariantClass g_variant_classify (GVariant *value); enum GVariantClass; -void g_variant_get (GVariant *value, - const gchar *format_string, - ...); -void g_variant_get_va (GVariant *value, - const gchar *format_string, - const gchar **endptr, - va_list *app); -GVariant * g_variant_new (const gchar *format_string, - ...); -GVariant * g_variant_new_va (const gchar *format_string, - const gchar **endptr, - va_list *app); +void g_variant_get (GVariant *value, + const gchar *format_string, + ...); +void g_variant_get_va (GVariant *value, + const gchar *format_string, + const gchar **endptr, + va_list *app); +GVariant * g_variant_new (const gchar *format_string, + ...); +GVariant * g_variant_new_va (const gchar *format_string, + const gchar **endptr, + va_list *app); -GVariant * g_variant_new_boolean (gboolean boolean); -GVariant * g_variant_new_byte (guchar byte); -GVariant * g_variant_new_int16 (gint16 int16); -GVariant * g_variant_new_uint16 (guint16 uint16); -GVariant * g_variant_new_int32 (gint32 int32); -GVariant * g_variant_new_uint32 (guint32 uint32); -GVariant * g_variant_new_int64 (gint64 int64); -GVariant * g_variant_new_uint64 (guint64 uint64); -GVariant * g_variant_new_handle (gint32 handle); -GVariant * g_variant_new_double (gdouble floating); -GVariant * g_variant_new_string (const gchar *string); -GVariant * g_variant_new_object_path (const gchar *object_path); -gboolean g_variant_is_object_path (const gchar *string); -GVariant * g_variant_new_signature (const gchar *signature); -gboolean g_variant_is_signature (const gchar *string); -GVariant * g_variant_new_variant (GVariant *value); -GVariant * g_variant_new_strv (const gchar * const *strv, - gssize length); +GVariant * g_variant_new_boolean (gboolean boolean); +GVariant * g_variant_new_byte (guchar byte); +GVariant * g_variant_new_int16 (gint16 int16); +GVariant * g_variant_new_uint16 (guint16 uint16); +GVariant * g_variant_new_int32 (gint32 int32); +GVariant * g_variant_new_uint32 (guint32 uint32); +GVariant * g_variant_new_int64 (gint64 int64); +GVariant * g_variant_new_uint64 (guint64 uint64); +GVariant * g_variant_new_handle (gint32 handle); +GVariant * g_variant_new_double (gdouble floating); +GVariant * g_variant_new_string (const gchar *string); +GVariant * g_variant_new_object_path (const gchar *object_path); +gboolean g_variant_is_object_path (const gchar *string); +GVariant * g_variant_new_signature (const gchar *signature); +gboolean g_variant_is_signature (const gchar *string); +GVariant * g_variant_new_variant (GVariant *value); +GVariant * g_variant_new_strv (const gchar * const *strv, + gssize length); -gboolean g_variant_get_boolean (GVariant *value); -guchar g_variant_get_byte (GVariant *value); -gint16 g_variant_get_int16 (GVariant *value); -guint16 g_variant_get_uint16 (GVariant *value); -gint32 g_variant_get_int32 (GVariant *value); -guint32 g_variant_get_uint32 (GVariant *value); -gint64 g_variant_get_int64 (GVariant *value); -guint64 g_variant_get_uint64 (GVariant *value); -gint32 g_variant_get_handle (GVariant *value); -gdouble g_variant_get_double (GVariant *value); -const gchar * g_variant_get_string (GVariant *value, - gsize *length); -gchar * g_variant_dup_string (GVariant *value, - gsize *length); -GVariant * g_variant_get_variant (GVariant *value); -const gchar ** g_variant_get_strv (GVariant *value, - gsize *length); -gchar ** g_variant_dup_strv (GVariant *value, - gsize *length); +gboolean g_variant_get_boolean (GVariant *value); +guchar g_variant_get_byte (GVariant *value); +gint16 g_variant_get_int16 (GVariant *value); +guint16 g_variant_get_uint16 (GVariant *value); +gint32 g_variant_get_int32 (GVariant *value); +guint32 g_variant_get_uint32 (GVariant *value); +gint64 g_variant_get_int64 (GVariant *value); +guint64 g_variant_get_uint64 (GVariant *value); +gint32 g_variant_get_handle (GVariant *value); +gdouble g_variant_get_double (GVariant *value); +const gchar * g_variant_get_string (GVariant *value, + gsize *length); +gchar * g_variant_dup_string (GVariant *value, + gsize *length); +GVariant * g_variant_get_variant (GVariant *value); +const gchar ** g_variant_get_strv (GVariant *value, + gsize *length); +gchar ** g_variant_dup_strv (GVariant *value, + gsize *length); -GVariant * g_variant_new_maybe (const GVariantType *child_type, - GVariant *child); -GVariant * g_variant_new_array (const GVariantType *child_type, - GVariant * const *children, - gsize n_children); -GVariant * g_variant_new_tuple (GVariant * const *children, - gsize n_children); -GVariant * g_variant_new_dict_entry (GVariant *key, - GVariant *value); +GVariant * g_variant_new_maybe (const GVariantType *child_type, + GVariant *child); +GVariant * g_variant_new_array (const GVariantType *child_type, + GVariant * const *children, + gsize n_children); +GVariant * g_variant_new_tuple (GVariant * const *children, + gsize n_children); +GVariant * g_variant_new_dict_entry (GVariant *key, + GVariant *value); -GVariant * g_variant_get_maybe (GVariant *value); -gsize g_variant_n_children (GVariant *value); -GVariant * g_variant_get_child_value (GVariant *value, - gsize index_); -void g_variant_get_child (GVariant *value, - gsize index_, - const gchar *format_string, - ...); -gconstpointer g_variant_get_fixed_array (GVariant *value, - gsize *n_elements, - gsize element_size); +GVariant * g_variant_get_maybe (GVariant *value); +gsize g_variant_n_children (GVariant *value); +GVariant * g_variant_get_child_value (GVariant *value, + gsize index_); +void g_variant_get_child (GVariant *value, + gsize index_, + const gchar *format_string, + ...); +gconstpointer g_variant_get_fixed_array (GVariant *value, + gsize *n_elements, + gsize element_size); -gsize g_variant_get_size (GVariant *value); -gconstpointer g_variant_get_data (GVariant *value); -void g_variant_store (GVariant *value, - gpointer data); -GVariant * g_variant_new_from_data (const GVariantType *type, - gconstpointer data, - gsize size, - gboolean trusted, - GDestroyNotify notify, - gpointer user_data); -GVariant * g_variant_byteswap (GVariant *value); -GVariant * g_variant_get_normal_form (GVariant *value); -gboolean g_variant_is_normal_form (GVariant *value); +gsize g_variant_get_size (GVariant *value); +gconstpointer g_variant_get_data (GVariant *value); +void g_variant_store (GVariant *value, + gpointer data); +GVariant * g_variant_new_from_data (const GVariantType *type, + gconstpointer data, + gsize size, + gboolean trusted, + GDestroyNotify notify, + gpointer user_data); +GVariant * g_variant_byteswap (GVariant *value); +GVariant * g_variant_get_normal_form (GVariant *value); +gboolean g_variant_is_normal_form (GVariant *value); -guint g_variant_hash (gconstpointer value); -gboolean g_variant_equal (gconstpointer one, - gconstpointer two); +guint g_variant_hash (gconstpointer value); +gboolean g_variant_equal (gconstpointer one, + gconstpointer two); -gchar * g_variant_print (GVariant *value, - gboolean type_annotate); -GString * g_variant_print_string (GVariant *value, - GString *string, - gboolean type_annotate); +gchar * g_variant_print (GVariant *value, + gboolean type_annotate); +GString * g_variant_print_string (GVariant *value, + GString *string, + gboolean type_annotate); GVariantIter; -GVariantIter * g_variant_iter_copy (GVariantIter *iter); -void g_variant_iter_free (GVariantIter *iter); -gsize g_variant_iter_init (GVariantIter *iter, - GVariant *value); -gsize g_variant_iter_n_children (GVariantIter *iter); -GVariantIter * g_variant_iter_new (GVariant *value); -GVariant * g_variant_iter_next_value (GVariantIter *iter); -gboolean g_variant_iter_next (GVariantIter *iter, - const gchar *format_string, - ...); -gboolean g_variant_iter_loop (GVariantIter *iter, - const gchar *format_string, - ...); +GVariantIter * g_variant_iter_copy (GVariantIter *iter); +void g_variant_iter_free (GVariantIter *iter); +gsize g_variant_iter_init (GVariantIter *iter, + GVariant *value); +gsize g_variant_iter_n_children (GVariantIter *iter); +GVariantIter * g_variant_iter_new (GVariant *value); +GVariant * g_variant_iter_next_value (GVariantIter *iter); +gboolean g_variant_iter_next (GVariantIter *iter, + const gchar *format_string, + ...); +gboolean g_variant_iter_loop (GVariantIter *iter, + const gchar *format_string, + ...); GVariantBuilder; -void g_variant_builder_unref (GVariantBuilder *builder); -GVariantBuilder * g_variant_builder_ref (GVariantBuilder *builder); -GVariantBuilder * g_variant_builder_new (const GVariantType *type); -void g_variant_builder_init (GVariantBuilder *builder, - const GVariantType *type); -void g_variant_builder_clear (GVariantBuilder *builder); -void g_variant_builder_add_value (GVariantBuilder *builder, - GVariant *value); -void g_variant_builder_add (GVariantBuilder *builder, - const gchar *format_string, - ...); -GVariant * g_variant_builder_end (GVariantBuilder *builder); -void g_variant_builder_open (GVariantBuilder *builder, - const GVariantType *type); -void g_variant_builder_close (GVariantBuilder *builder); +void g_variant_builder_unref (GVariantBuilder *builder); +GVariantBuilder * g_variant_builder_ref (GVariantBuilder *builder); +GVariantBuilder * g_variant_builder_new (const GVariantType *type); +void g_variant_builder_init (GVariantBuilder *builder, + const GVariantType *type); +void g_variant_builder_clear (GVariantBuilder *builder); +void g_variant_builder_add_value (GVariantBuilder *builder, + GVariant *value); +void g_variant_builder_add (GVariantBuilder *builder, + const gchar *format_string, + ...); +GVariant * g_variant_builder_end (GVariantBuilder *builder); +void g_variant_builder_open (GVariantBuilder *builder, + const GVariantType *type); +void g_variant_builder_close (GVariantBuilder *builder); #define G_VARIANT_PARSE_ERROR -GVariant * g_variant_parse (const GVariantType *type, - const gchar *text, - const gchar *limit, - const gchar **endptr, - GError **error); -GVariant * g_variant_new_parsed_va (const gchar *format, - va_list *app); -GVariant * g_variant_new_parsed (const gchar *format, - ...); +GVariant * g_variant_parse (const GVariantType *type, + const gchar *text, + const gchar *limit, + const gchar **endptr, + GError **error); +GVariant * g_variant_new_parsed_va (const gchar *format, + va_list *app); +GVariant * g_variant_new_parsed (const gchar *format, + ...);
    @@ -261,10 +241,8 @@ There is a Python-inspired text language for describing GVariant includes a printer for this language and a parser with type inferencing.

    -

    -

    -

    Memory Use

    +

    Memory Use

    GVariant tries to be quite efficient with respect to memory use. This section gives a rough idea of how much memory is used by the @@ -278,7 +256,7 @@ with type inferencing. GVariant structure itself.

    -

    Serialised Data Memory

    +

    Serialised Data Memory

    This is the memory that is used for storing GVariant data in serialised form. This is what would be sent over the network or @@ -346,7 +324,7 @@ with type inferencing.

    -

    Type Information Cache

    +

    Type Information Cache

    For each GVariant type that currently exists in the program a type information structure is kept in the type information cache. The @@ -401,7 +379,7 @@ with type inferencing.

    -

    Buffer Management Memory

    +

    Buffer Management Memory

    GVariant uses an internal buffer management structure to deal with the various different possible sources of serialised data @@ -417,7 +395,7 @@ with type inferencing.

    -

    GVariant structure

    +

    GVariant structure

    The size of a GVariant structure is 6 * (void *). On 32 bit systems, that's 24 bytes. @@ -442,7 +420,7 @@ with type inferencing.

    -

    Summary

    +

    Summary

    To put the entire example together, for our dictionary mapping strings to variants (with two entries, as given above), we are @@ -466,21 +444,23 @@ with type inferencing.

    typedef struct _GVariant GVariant;

    GVariant is an opaque data structure and can only be accessed -using the following functions.

    +using the following functions. +

    Since 2.24


    g_variant_unref ()

    -
    void                g_variant_unref                     (GVariant *value);
    +
    void                g_variant_unref                     (GVariant *value);

    Decreases the reference count of value. When its reference count -drops to 0, the memory used by the variant is freed.

    +drops to 0, the memory used by the variant is freed. +

    -

    value :

    a GVariant +a GVariant
    @@ -489,20 +469,21 @@ drops to 0, the memory used by the variant is freed.


    g_variant_ref ()

    -
    GVariant *          g_variant_ref                       (GVariant *value);
    +
    GVariant *          g_variant_ref                       (GVariant *value);

    -Increases the reference count of value.

    +Increases the reference count of value. +

    - - @@ -512,7 +493,7 @@ Increases the reference count of value.<

    g_variant_ref_sink ()

    -
    GVariant *          g_variant_ref_sink                  (GVariant *value);
    +
    GVariant *          g_variant_ref_sink                  (GVariant *value);

    GVariant uses a floating reference count system. All functions with names starting with g_variant_new_ return floating @@ -538,18 +519,19 @@ reference) then the container will assume sole ownership of the value at that point and the caller will not need to unreference it. This makes certain common styles of programming much easier while still maintaining normal refcounting semantics in situations where values -are not floating.

    +are not floating. +

    value :

    a GVariant +a GVariant

    Returns :

    the same value +the same value
    - - @@ -559,24 +541,25 @@ are not floating.


    g_variant_get_type ()

    -
    const GVariantType * g_variant_get_type                 (GVariant *value);
    +
    const GVariantType * g_variant_get_type                 (GVariant *value);

    Determines the type of value.

    The return value is valid for the lifetime of value and must not -be freed.

    +be freed. +

    value :

    a GVariant +a GVariant

    Returns :

    the same value +the same value
    - - @@ -586,22 +569,23 @@ be freed.


    g_variant_get_type_string ()

    -
    const gchar *       g_variant_get_type_string           (GVariant *value);
    +
    const gchar *       g_variant_get_type_string           (GVariant *value);

    Returns the type string of value. Unlike the result of calling g_variant_type_peek_string(), this string is nul-terminated. This -string belongs to GVariant and must not be freed.

    +string belongs to GVariant and must not be freed. +

    value :

    a GVariant +a GVariant

    Returns :

    a GVariantType +a GVariantType
    - - @@ -611,26 +595,28 @@ string belongs to

    g_variant_is_of_type ()

    -
    gboolean            g_variant_is_of_type                (GVariant *value,
    -                                                         const GVariantType *type);
    +
    gboolean            g_variant_is_of_type                (GVariant *value,
    +                                                         const GVariantType *type);

    -Checks if a value has a type matching the provided type.

    +Checks if a value has a type matching the provided type. +

    value :

    a GVariant +a GVariant

    Returns :

    the type string for the type of value +the type string for the type of value
    - - - @@ -640,20 +626,22 @@ Checks if a value has a type matching the provided type.


    g_variant_is_container ()

    -
    gboolean            g_variant_is_container              (GVariant *value);
    +
    gboolean            g_variant_is_container              (GVariant *value);

    -Checks if value is a container.

    +Checks if value is a container. +

    value :

    a GVariant instance +a GVariant instance

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if the type of value matches type + +TRUE if the type of value matches type
    - - @@ -662,20 +650,21 @@ Checks if value is a container.


    g_variant_classify ()

    -
    GVariantClass       g_variant_classify                  (GVariant *value);
    +
    GVariantClass       g_variant_classify                  (GVariant *value);

    -Classifies value according to its top-level type.

    +Classifies value according to its top-level type. +

    value :

    a GVariant instance +a GVariant instance

    Returns :

    TRUE if value is a container + +TRUE if value is a container
    - - @@ -708,100 +697,101 @@ Classifies value according to its top-le } GVariantClass;

    -The range of possible top-level types of GVariant instances.

    +The range of possible top-level types of GVariant instances. +

    value :

    a GVariant +a GVariant

    Returns :

    the GVariantClass of value +the GVariantClass of value
    - - - - - - - - - - - - - - - - - - @@ -811,9 +801,9 @@ The range of possible top-level types of

    g_variant_get ()

    -
    void                g_variant_get                       (GVariant *value,
    -                                                         const gchar *format_string,
    -                                                         ...);
    +
    void                g_variant_get                       (GVariant *value,
    +                                                         const gchar *format_string,
    +                                                         ...);

    Deconstructs a GVariant instance.

    @@ -826,23 +816,24 @@ determined by format_string. value. It is an error to give a value with an incompatible type. See the section on GVariant Format Strings. Please note that the syntax of the format string is very likely to be -extended in the future.

    +extended in the future. +

    G_VARIANT_CLASS_BOOLEAN

    The GVariant is a boolean. +The GVariant is a boolean.

    G_VARIANT_CLASS_BYTE

    The GVariant is a byte. +The GVariant is a byte.

    G_VARIANT_CLASS_INT16

    The GVariant is a signed 16 bit integer. +The GVariant is a signed 16 bit integer.

    G_VARIANT_CLASS_UINT16

    The GVariant is an unsigned 16 bit integer. +The GVariant is an unsigned 16 bit integer.

    G_VARIANT_CLASS_INT32

    The GVariant is a signed 32 bit integer. +The GVariant is a signed 32 bit integer.

    G_VARIANT_CLASS_UINT32

    The GVariant is an unsigned 32 bit integer. +The GVariant is an unsigned 32 bit integer.

    G_VARIANT_CLASS_INT64

    The GVariant is a signed 64 bit integer. +The GVariant is a signed 64 bit integer.

    G_VARIANT_CLASS_UINT64

    The GVariant is an unsigned 64 bit integer. +The GVariant is an unsigned 64 bit integer.

    G_VARIANT_CLASS_HANDLE

    The GVariant is a file handle index. +The GVariant is a file handle index.

    G_VARIANT_CLASS_DOUBLE

    The GVariant is a double precision floating +The GVariant is a double precision floating point value.

    G_VARIANT_CLASS_STRING

    The GVariant is a normal string. +The GVariant is a normal string.

    G_VARIANT_CLASS_OBJECT_PATH

    The GVariant is a DBus object path +The GVariant is a DBus object path string.

    G_VARIANT_CLASS_SIGNATURE

    The GVariant is a DBus signature string. +The GVariant is a DBus signature string.

    G_VARIANT_CLASS_VARIANT

    The GVariant is a variant. +The GVariant is a variant.

    G_VARIANT_CLASS_MAYBE

    The GVariant is a maybe-typed value. +The GVariant is a maybe-typed value.

    G_VARIANT_CLASS_ARRAY

    The GVariant is an array. +The GVariant is an array.

    G_VARIANT_CLASS_TUPLE

    The GVariant is a tuple. +The GVariant is a tuple.

    G_VARIANT_CLASS_DICT_ENTRY

    The GVariant is a dictionary entry. +The GVariant is a dictionary entry.
    - - - @@ -852,10 +843,10 @@ extended in the future.


    g_variant_get_va ()

    -
    void                g_variant_get_va                    (GVariant *value,
    -                                                         const gchar *format_string,
    -                                                         const gchar **endptr,
    -                                                         va_list *app);
    +
    void                g_variant_get_va                    (GVariant *value,
    +                                                         const gchar *format_string,
    +                                                         const gchar **endptr,
    +                                                         va_list *app);

    This function is intended to be used by libraries based on GVariant that want to provide g_variant_get()-like functionality to their @@ -879,28 +870,29 @@ pointing to the argument following the last.

    These two generalisations allow mixing of multiple calls to g_variant_new_va() and g_variant_get_va() within a single actual -varargs call by the user.

    +varargs call by the user. +

    value :

    a GVariant instance +a GVariant instance

    format_string :

    a GVariant format string +a GVariant format string

    ... :

    arguments, as per format_string +arguments, as per format_string
    - - - - @@ -910,8 +902,8 @@ varargs call by the user.


    g_variant_new ()

    -
    GVariant *          g_variant_new                       (const gchar *format_string,
    -                                                         ...);
    +
    GVariant *          g_variant_new                       (const gchar *format_string,
    +                                                         ...);

    Creates a new GVariant instance.

    @@ -928,23 +920,24 @@ very likely to be extended in the future.

    The first character of the format string must not be '*' '?' '@' or 'r'; in essence, a new GVariant must always be constructed by this -function (and not merely passed through it unmodified).

    +function (and not merely passed through it unmodified). +

    value :

    a GVariant +a GVariant

    format_string :

    a string that is prefixed with a format string +a string that is prefixed with a format string

    endptr :

    location to store the end pointer, or NULL +location to store the end pointer, or NULL

    app :

    a pointer to a va_list +a pointer to a va_list
    - - - @@ -954,9 +947,9 @@ function (and not merely passed through it unmodified).


    g_variant_new_va ()

    -
    GVariant *          g_variant_new_va                    (const gchar *format_string,
    -                                                         const gchar **endptr,
    -                                                         va_list *app);
    +
    GVariant *          g_variant_new_va                    (const gchar *format_string,
    +                                                         const gchar **endptr,
    +                                                         va_list *app);

    This function is intended to be used by libraries based on GVariant that want to provide g_variant_new()-like functionality @@ -995,28 +988,29 @@ calling function to g_variant_new() call.

    +or by passing it to another g_variant_new() call. +

    format_string :

    a GVariant format string +a GVariant format string

    ... :

    arguments, as per format_string +arguments, as per format_string

    Returns :

    a new floating GVariant instance +a new floating GVariant instance
    - - - - @@ -1026,20 +1020,21 @@ or by passing it to another

    g_variant_new_boolean ()

    -
    GVariant *          g_variant_new_boolean               (gboolean boolean);
    +
    GVariant *          g_variant_new_boolean               (gboolean boolean);

    -Creates a new boolean GVariant instance -- either TRUE or FALSE.

    +Creates a new boolean GVariant instance -- either TRUE or FALSE. +

    format_string :

    a string that is prefixed with a format string +a string that is prefixed with a format string

    endptr :

    location to store the end pointer, or NULL +location to store the end pointer, or NULL

    app :

    a pointer to a va_list +a pointer to a va_list

    Returns :

    a new, usually floating, GVariant +a new, usually floating, GVariant
    - - @@ -1049,20 +1044,21 @@ Creates a new boolean

    g_variant_new_byte ()

    -
    GVariant *          g_variant_new_byte                  (guchar byte);
    +
    GVariant *          g_variant_new_byte                  (guchar byte);

    -Creates a new byte GVariant instance.

    +Creates a new byte GVariant instance. +

    boolean :

    a gboolean value +a gboolean value

    Returns :

    a new boolean GVariant instance +a new boolean GVariant instance
    - - @@ -1072,20 +1068,21 @@ Creates a new byte

    g_variant_new_int16 ()

    -
    GVariant *          g_variant_new_int16                 (gint16 int16);
    +
    GVariant *          g_variant_new_int16                 (gint16 int16);

    -Creates a new int16 GVariant instance.

    +Creates a new int16 GVariant instance. +

    byte :

    a guint8 value +a guint8 value

    Returns :

    a new byte GVariant instance +a new byte GVariant instance
    - - @@ -1095,20 +1092,21 @@ Creates a new int16

    g_variant_new_uint16 ()

    -
    GVariant *          g_variant_new_uint16                (guint16 uint16);
    +
    GVariant *          g_variant_new_uint16                (guint16 uint16);

    -Creates a new uint16 GVariant instance.

    +Creates a new uint16 GVariant instance. +

    int16 :

    a gint16 value +a gint16 value

    Returns :

    a new int16 GVariant instance +a new int16 GVariant instance
    - - @@ -1118,20 +1116,21 @@ Creates a new uint16

    g_variant_new_int32 ()

    -
    GVariant *          g_variant_new_int32                 (gint32 int32);
    +
    GVariant *          g_variant_new_int32                 (gint32 int32);

    -Creates a new int32 GVariant instance.

    +Creates a new int32 GVariant instance. +

    uint16 :

    a guint16 value +a guint16 value

    Returns :

    a new uint16 GVariant instance +a new uint16 GVariant instance
    - - @@ -1141,20 +1140,21 @@ Creates a new int32

    g_variant_new_uint32 ()

    -
    GVariant *          g_variant_new_uint32                (guint32 uint32);
    +
    GVariant *          g_variant_new_uint32                (guint32 uint32);

    -Creates a new uint32 GVariant instance.

    +Creates a new uint32 GVariant instance. +

    int32 :

    a gint32 value +a gint32 value

    Returns :

    a new int32 GVariant instance +a new int32 GVariant instance
    - - @@ -1164,20 +1164,21 @@ Creates a new uint32

    g_variant_new_int64 ()

    -
    GVariant *          g_variant_new_int64                 (gint64 int64);
    +
    GVariant *          g_variant_new_int64                 (gint64 int64);

    -Creates a new int64 GVariant instance.

    +Creates a new int64 GVariant instance. +

    uint32 :

    a guint32 value +a guint32 value

    Returns :

    a new uint32 GVariant instance +a new uint32 GVariant instance
    - - @@ -1187,20 +1188,21 @@ Creates a new int64

    g_variant_new_uint64 ()

    -
    GVariant *          g_variant_new_uint64                (guint64 uint64);
    +
    GVariant *          g_variant_new_uint64                (guint64 uint64);

    -Creates a new uint64 GVariant instance.

    +Creates a new uint64 GVariant instance. +

    int64 :

    a gint64 value +a gint64 value

    Returns :

    a new int64 GVariant instance +a new int64 GVariant instance
    - - @@ -1210,25 +1212,26 @@ Creates a new uint64

    g_variant_new_handle ()

    -
    GVariant *          g_variant_new_handle                (gint32 handle);
    +
    GVariant *          g_variant_new_handle                (gint32 handle);

    Creates a new handle GVariant instance.

    By convention, handles are indexes into an array of file descriptors that are sent alongside a DBus message. If you're not interacting -with DBus, you probably don't need them.

    +with DBus, you probably don't need them. +

    uint64 :

    a guint64 value +a guint64 value

    Returns :

    a new uint64 GVariant instance +a new uint64 GVariant instance
    - - @@ -1238,20 +1241,21 @@ with DBus, you probably don't need them.


    g_variant_new_double ()

    -
    GVariant *          g_variant_new_double                (gdouble floating);
    +
    GVariant *          g_variant_new_double                (gdouble floating);

    -Creates a new double GVariant instance.

    +Creates a new double GVariant instance. +

    handle :

    a gint32 value +a gint32 value

    Returns :

    a new handle GVariant instance +a new handle GVariant instance
    - - @@ -1261,20 +1265,21 @@ Creates a new double

    g_variant_new_string ()

    -
    GVariant *          g_variant_new_string                (const gchar *string);
    +
    GVariant *          g_variant_new_string                (const gchar *string);

    -Creates a string GVariant with the contents of string.

    +Creates a string GVariant with the contents of string. +

    floating :

    a gdouble floating point value +a gdouble floating point value

    Returns :

    a new double GVariant instance +a new double GVariant instance
    - - @@ -1284,22 +1289,23 @@ Creates a string

    g_variant_new_object_path ()

    -
    GVariant *          g_variant_new_object_path           (const gchar *object_path);
    +
    GVariant *          g_variant_new_object_path           (const gchar *object_path);

    Creates a DBus object path GVariant with the contents of string. string must be a valid DBus object path. Use -g_variant_is_object_path() if you're not sure.

    +g_variant_is_object_path() if you're not sure. +

    string :

    a normal C nul-terminated string +a normal C nul-terminated string

    Returns :

    a new string GVariant instance +a new string GVariant instance
    - - @@ -1309,7 +1315,7 @@ Creates a DBus object path

    g_variant_is_object_path ()

    -
    gboolean            g_variant_is_object_path            (const gchar *string);
    +
    gboolean            g_variant_is_object_path            (const gchar *string);

    Determines if a given string is a valid DBus object path. You should ensure that a string is a valid DBus object path before @@ -1319,18 +1325,20 @@ passing it to +(including the one following the final '/' character) may be empty. +

    object_path :

    a normal C nul-terminated string +a normal C nul-terminated string

    Returns :

    a new object path GVariant instance +a new object path GVariant instance
    - - @@ -1340,22 +1348,23 @@ must contain only the characters "[A-Z][a-z][0-9]_". No sequence

    g_variant_new_signature ()

    -
    GVariant *          g_variant_new_signature             (const gchar *signature);
    +
    GVariant *          g_variant_new_signature             (const gchar *signature);

    Creates a DBus type signature GVariant with the contents of string. string must be a valid DBus type signature. Use -g_variant_is_signature() if you're not sure.

    +g_variant_is_signature() if you're not sure. +

    string :

    a normal C nul-terminated string +a normal C nul-terminated string

    Returns :

    TRUE if string is a DBus object path + +TRUE if string is a DBus object path
    - - @@ -1365,7 +1374,7 @@ Creates a DBus type signature

    g_variant_is_signature ()

    -
    gboolean            g_variant_is_signature              (const gchar *string);
    +
    gboolean            g_variant_is_signature              (const gchar *string);

    Determines if a given string is a valid DBus type signature. You should ensure that a string is a valid DBus object path before @@ -1373,18 +1382,20 @@ passing it to

    DBus type signatures consist of zero or more definite GVariantType -strings in sequence.

    +strings in sequence. +

    signature :

    a normal C nul-terminated string +a normal C nul-terminated string

    Returns :

    a new signature GVariant instance +a new signature GVariant instance
    - - @@ -1394,21 +1405,22 @@ strings in sequence.


    g_variant_new_variant ()

    -
    GVariant *          g_variant_new_variant               (GVariant *value);
    +
    GVariant *          g_variant_new_variant               (GVariant *value);

    Boxes value. The result is a GVariant instance representing a -variant containing the original value.

    +variant containing the original value. +

    string :

    a normal C nul-terminated string +a normal C nul-terminated string

    Returns :

    TRUE if string is a DBus type signature + +TRUE if string is a DBus type signature
    - - @@ -1418,31 +1430,32 @@ variant containing the original value.


    g_variant_new_strv ()

    -
    GVariant *          g_variant_new_strv                  (const gchar * const *strv,
    -                                                         gssize length);
    +
    GVariant *          g_variant_new_strv                  (const gchar * const *strv,
    +                                                         gssize length);

    Constructs an array of strings GVariant from the given array of strings.

    If length is not -1 then it gives the maximum length of strv. In -any case, a NULL pointer in strv is taken as a terminator.

    +any case, a NULL pointer in strv is taken as a terminator. +

    value :

    a GVariance instance +a GVariance instance

    Returns :

    a new variant GVariant instance +a new variant GVariant instance
    - - - @@ -1452,24 +1465,26 @@ any case, a

    g_variant_get_boolean ()

    -
    gboolean            g_variant_get_boolean               (GVariant *value);
    +
    gboolean            g_variant_get_boolean               (GVariant *value);

    Returns the boolean value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_BOOLEAN.

    +other than G_VARIANT_TYPE_BOOLEAN. +

    strv :

    an array of strings +an array of strings

    length :

    the length of strv, or -1 +the length of strv, or -1

    Returns :

    a new floating GVariant instance +a new floating GVariant instance
    - - @@ -1479,24 +1494,25 @@ other than

    g_variant_get_byte ()

    -
    guchar              g_variant_get_byte                  (GVariant *value);
    +
    guchar              g_variant_get_byte                  (GVariant *value);

    Returns the byte value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_BYTE.

    +other than G_VARIANT_TYPE_BYTE. +

    value :

    a boolean GVariant instance +a boolean GVariant instance

    Returns :

    TRUE or FALSE + +TRUE or FALSE
    - - @@ -1506,24 +1522,25 @@ other than

    g_variant_get_int16 ()

    -
    gint16              g_variant_get_int16                 (GVariant *value);
    +
    gint16              g_variant_get_int16                 (GVariant *value);

    Returns the 16-bit signed integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_INT16.

    +other than G_VARIANT_TYPE_INT16. +

    value :

    a byte GVariant instance +a byte GVariant instance

    Returns :

    a guchar +a guchar
    - - @@ -1533,24 +1550,25 @@ other than

    g_variant_get_uint16 ()

    -
    guint16             g_variant_get_uint16                (GVariant *value);
    +
    guint16             g_variant_get_uint16                (GVariant *value);

    Returns the 16-bit unsigned integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_UINT16.

    +other than G_VARIANT_TYPE_UINT16. +

    value :

    a int16 GVariant instance +a int16 GVariant instance

    Returns :

    a gint16 +a gint16
    - - @@ -1560,24 +1578,25 @@ other than

    g_variant_get_int32 ()

    -
    gint32              g_variant_get_int32                 (GVariant *value);
    +
    gint32              g_variant_get_int32                 (GVariant *value);

    Returns the 32-bit signed integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_INT32.

    +other than G_VARIANT_TYPE_INT32. +

    value :

    a uint16 GVariant instance +a uint16 GVariant instance

    Returns :

    a guint16 +a guint16
    - - @@ -1587,24 +1606,25 @@ other than

    g_variant_get_uint32 ()

    -
    guint32             g_variant_get_uint32                (GVariant *value);
    +
    guint32             g_variant_get_uint32                (GVariant *value);

    Returns the 32-bit unsigned integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_UINT32.

    +other than G_VARIANT_TYPE_UINT32. +

    value :

    a int32 GVariant instance +a int32 GVariant instance

    Returns :

    a gint32 +a gint32
    - - @@ -1614,24 +1634,25 @@ other than

    g_variant_get_int64 ()

    -
    gint64              g_variant_get_int64                 (GVariant *value);
    +
    gint64              g_variant_get_int64                 (GVariant *value);

    Returns the 64-bit signed integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_INT64.

    +other than G_VARIANT_TYPE_INT64. +

    value :

    a uint32 GVariant instance +a uint32 GVariant instance

    Returns :

    a guint32 +a guint32
    - - @@ -1641,24 +1662,25 @@ other than

    g_variant_get_uint64 ()

    -
    guint64             g_variant_get_uint64                (GVariant *value);
    +
    guint64             g_variant_get_uint64                (GVariant *value);

    Returns the 64-bit unsigned integer value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_UINT64.

    +other than G_VARIANT_TYPE_UINT64. +

    value :

    a int64 GVariant instance +a int64 GVariant instance

    Returns :

    a gint64 +a gint64
    - - @@ -1668,7 +1690,7 @@ other than

    g_variant_get_handle ()

    -
    gint32              g_variant_get_handle                (GVariant *value);
    +
    gint32              g_variant_get_handle                (GVariant *value);

    Returns the 32-bit signed integer value of value.

    @@ -1679,18 +1701,19 @@ than By convention, handles are indexes into an array of file descriptors that are sent alongside a DBus message. If you're not interacting -with DBus, you probably don't need them.

    +with DBus, you probably don't need them. +

    value :

    a uint64 GVariant instance +a uint64 GVariant instance

    Returns :

    a guint64 +a guint64
    - - @@ -1700,24 +1723,25 @@ with DBus, you probably don't need them.


    g_variant_get_double ()

    -
    gdouble             g_variant_get_double                (GVariant *value);
    +
    gdouble             g_variant_get_double                (GVariant *value);

    Returns the double precision floating point value of value.

    It is an error to call this function with a value of any type -other than G_VARIANT_TYPE_DOUBLE.

    +other than G_VARIANT_TYPE_DOUBLE. +

    value :

    a handle GVariant instance +a handle GVariant instance

    Returns :

    a gint32 +a gint32
    - - @@ -1727,8 +1751,8 @@ other than

    g_variant_get_string ()

    -
    const gchar *       g_variant_get_string                (GVariant *value,
    -                                                         gsize *length);
    +
    const gchar *       g_variant_get_string                (GVariant *value,
    +                                                         gsize *length);

    Returns the string value of a GVariant instance with a string type. This includes the types G_VARIANT_TYPE_STRING, @@ -1744,23 +1768,24 @@ It is an error to call this function with a value

    -The return value remains valid as long as value exists.

    +The return value remains valid as long as value exists. +

    value :

    a double GVariant instance +a double GVariant instance

    Returns :

    a gdouble +a gdouble
    - - - @@ -1770,30 +1795,31 @@ The return value remains valid as long as value

    g_variant_dup_string ()

    -
    gchar *             g_variant_dup_string                (GVariant *value,
    -                                                         gsize *length);
    +
    gchar *             g_variant_dup_string                (GVariant *value,
    +                                                         gsize *length);

    Similar to g_variant_get_string() except that instead of returning a constant string, the string is duplicated.

    -The return value must be freed using g_free().

    +The return value must be freed using g_free(). +

    value :

    a string GVariant instance +a string GVariant instance

    length :

    a pointer to a gsize, to store the length +a pointer to a gsize, to store the length

    Returns :

    the constant string +the constant string
    - - - @@ -1803,21 +1829,22 @@ The return value must be freed using

    g_variant_get_variant ()

    -
    GVariant *          g_variant_get_variant               (GVariant *value);
    +
    GVariant *          g_variant_get_variant               (GVariant *value);

    Unboxes value. The result is the GVariant instance that was -contained in value.

    +contained in value. +

    value :

    a string GVariant instance +a string GVariant instance

    length :

    a pointer to a gsize, to store the length +a pointer to a gsize, to store the length

    Returns :

    a newly allocated string +a newly allocated string
    - - @@ -1827,8 +1854,8 @@ contained in value.


    g_variant_get_strv ()

    -
    const gchar **      g_variant_get_strv                  (GVariant *value,
    -                                                         gsize *length);
    +
    const gchar **      g_variant_get_strv                  (GVariant *value,
    +                                                         gsize *length);

    Gets the contents of an array of strings GVariant. This call makes a shallow copy; the return result should be released with @@ -1841,23 +1868,24 @@ is stored there. In any case, the resulting array will be

    For an empty array, length will be set to 0 and a pointer to a -NULL pointer will be returned.

    +NULL pointer will be returned. +

    value :

    a variant GVariance instance +a variant GVariance instance

    Returns :

    the item contained in the variant +the item contained in the variant
    - - - @@ -1867,8 +1895,8 @@ For an empty array, length will be set t

    g_variant_dup_strv ()

    -
    gchar **            g_variant_dup_strv                  (GVariant *value,
    -                                                         gsize *length);
    +
    gchar **            g_variant_dup_strv                  (GVariant *value,
    +                                                         gsize *length);

    Gets the contents of an array of strings GVariant. This call makes a deep copy; the return result should be released with @@ -1881,23 +1909,24 @@ is stored there. In any case, the resulting array will be

    For an empty array, length will be set to 0 and a pointer to a -NULL pointer will be returned.

    +NULL pointer will be returned. +

    value :

    an array of strings GVariant +an array of strings GVariant

    length :

    the length of the result, or NULL +the length of the result, or NULL

    Returns :

    an array of constant strings +an array of constant strings
    - - - @@ -1907,8 +1936,8 @@ For an empty array, length will be set t

    g_variant_new_maybe ()

    -
    GVariant *          g_variant_new_maybe                 (const GVariantType *child_type,
    -                                                         GVariant *child);
    +
    GVariant *          g_variant_new_maybe                 (const GVariantType *child_type,
    +                                                         GVariant *child);

    Depending on if value is NULL, either wraps value inside of a maybe container or creates a Nothing instance for the given type. @@ -1916,23 +1945,24 @@ maybe container or creates a Nothing instance for the given type and value must be non-NULL. If type is non-NULL then it must be a definite type. If they are both -non-NULL then type must be the type of value.

    +non-NULL then type must be the type of value. +

    value :

    an array of strings GVariant +an array of strings GVariant

    length :

    the length of the result, or NULL +the length of the result, or NULL

    Returns :

    an array of constant strings +an array of constant strings
    - - - @@ -1942,9 +1972,9 @@ non-

    g_variant_new_array ()

    -
    GVariant *          g_variant_new_array                 (const GVariantType *child_type,
    -                                                         GVariant * const *children,
    -                                                         gsize n_children);
    +
    GVariant *          g_variant_new_array                 (const GVariantType *child_type,
    +                                                         GVariant * const *children,
    +                                                         gsize n_children);

    Creates a new GVariant array from children.

    @@ -1960,28 +1990,29 @@ in the children array may be child_type
    , if given.

    +same as child_type, if given. +

    child_type :

    the GVariantType of the child +the GVariantType of the child

    child :

    the child value, or NULL +the child value, or NULL

    Returns :

    a new GVariant maybe instance +a new GVariant maybe instance
    - - - - @@ -1991,31 +2022,32 @@ same as child_type, if given.


    g_variant_new_tuple ()

    -
    GVariant *          g_variant_new_tuple                 (GVariant * const *children,
    -                                                         gsize n_children);
    +
    GVariant *          g_variant_new_tuple                 (GVariant * const *children,
    +                                                         gsize n_children);

    Creates a new tuple GVariant out of the items in children. The type is determined from the types of children. No entry in the children array may be NULL.

    -If n_children is 0 then the unit tuple is constructed.

    +If n_children is 0 then the unit tuple is constructed. +

    child_type :

    the element type of the new array +the element type of the new array

    children :

    an array of GVariant pointers, the children +an array of GVariant pointers, the children

    n_children :

    the length of children +the length of children

    Returns :

    a new GVariant array +a new GVariant array
    - - - @@ -2025,30 +2057,31 @@ If n_children is 0 then the unit tuple i

    g_variant_new_dict_entry ()

    -
    GVariant *          g_variant_new_dict_entry            (GVariant *key,
    -                                                         GVariant *value);
    +
    GVariant *          g_variant_new_dict_entry            (GVariant *key,
    +                                                         GVariant *value);

    Creates a new dictionary entry GVariant. key and value must be non-NULL.

    -key must be a value of a basic type (ie: not a container).

    +key must be a value of a basic type (ie: not a container). +

    children :

    the items to make the tuple out of +the items to make the tuple out of

    n_children :

    the length of children +the length of children

    Returns :

    a new GVariant tuple +a new GVariant tuple
    - - - @@ -2058,21 +2091,22 @@ non-

    g_variant_get_maybe ()

    -
    GVariant *          g_variant_get_maybe                 (GVariant *value);
    +
    GVariant *          g_variant_get_maybe                 (GVariant *value);

    Given a maybe-typed GVariant instance, extract its value. If the -value is Nothing, then this function returns NULL.

    +value is Nothing, then this function returns NULL. +

    key :

    a basic GVariant, the key +a basic GVariant, the key

    value :

    a GVariant, the value +a GVariant, the value

    Returns :

    a new dictionary entry GVariant +a new dictionary entry GVariant
    - - @@ -2082,7 +2116,7 @@ value is Nothing, then this function returns

    g_variant_n_children ()

    -
    gsize               g_variant_n_children                (GVariant *value);
    +
    gsize               g_variant_n_children                (GVariant *value);

    Determines the number of children in a container GVariant instance. This includes variants, maybes, arrays, tuples and dictionary @@ -2096,18 +2130,19 @@ array. For tuples it is the number of tuple items (which depends only on the type). For dictionary entries, it is always 2

    -This function is O(1).

    +This function is O(1). +

    value :

    a maybe-typed value +a maybe-typed value

    Returns :

    the contents of value, or NULL +the contents of value, or NULL
    - - @@ -2117,8 +2152,8 @@ This function is O(1).


    g_variant_get_child_value ()

    -
    GVariant *          g_variant_get_child_value           (GVariant *value,
    -                                                         gsize index_);
    +
    GVariant *          g_variant_get_child_value           (GVariant *value,
    +                                                         gsize index_);

    Reads a child item out of a container GVariant instance. This includes variants, maybes, arrays, tuples and dictionary @@ -2130,23 +2165,24 @@ It is an error if index_ is greater than in the container. See g_variant_n_children().

    -This function is O(1).

    +This function is O(1). +

    value :

    a container GVariant +a container GVariant

    Returns :

    the number of children in the container +the number of children in the container
    - - - @@ -2156,36 +2192,37 @@ This function is O(1).


    g_variant_get_child ()

    -
    void                g_variant_get_child                 (GVariant *value,
    -                                                         gsize index_,
    -                                                         const gchar *format_string,
    -                                                         ...);
    +
    void                g_variant_get_child                 (GVariant *value,
    +                                                         gsize index_,
    +                                                         const gchar *format_string,
    +                                                         ...);

    Reads a child item out of a container GVariant instance and deconstructs it according to format_string. This call is essentially a combination of g_variant_get_child_value() and -g_variant_get().

    +g_variant_get(). +

    value :

    a container GVariant +a container GVariant

    index_ :

    the index of the child to fetch +the index of the child to fetch

    Returns :

    the child at the specified index +the child at the specified index
    - - - - @@ -2195,9 +2232,9 @@ essentially a combination of

    g_variant_get_fixed_array ()

    -
    gconstpointer       g_variant_get_fixed_array           (GVariant *value,
    -                                                         gsize *n_elements,
    -                                                         gsize element_size);
    +
    gconstpointer       g_variant_get_fixed_array           (GVariant *value,
    +                                                         gsize *n_elements,
    +                                                         gsize element_size);

    Provides access to the serialised data for an array of fixed-sized items. @@ -2215,28 +2252,29 @@ seralised data matches the caller's expectation.

    n_elements, which must be non-NULL is set equal to the number of -items in the array.

    +items in the array. +

    value :

    a container GVariant +a container GVariant

    index_ :

    the index of the child to deconstruct +the index of the child to deconstruct

    format_string :

    a GVariant format string +a GVariant format string

    ... :

    arguments, as per format_string +arguments, as per format_string
    - - - - @@ -2246,7 +2284,7 @@ items in the array.


    g_variant_get_size ()

    -
    gsize               g_variant_get_size                  (GVariant *value);
    +
    gsize               g_variant_get_size                  (GVariant *value);

    Determines the number of bytes that would be required to store value with g_variant_store(). @@ -2260,18 +2298,19 @@ In the case that value is already in ser already been calculated (ie: this function has been called before) then this function is O(1). Otherwise, the size is calculated, an operation which is approximately O(n) in the number of values -involved.

    +involved. +

    value :

    a GVariant array with fixed-sized elements +a GVariant array with fixed-sized elements

    n_elements :

    a pointer to the location to store the number of items +a pointer to the location to store the number of items

    element_size :

    the size of each element +the size of each element

    Returns :

    a pointer to the fixed array +a pointer to the fixed array
    - - @@ -2281,7 +2320,7 @@ involved.


    g_variant_get_data ()

    -
    gconstpointer       g_variant_get_data                  (GVariant *value);
    +
    gconstpointer       g_variant_get_data                  (GVariant *value);

    Returns a pointer to the serialised form of a GVariant instance. The returned data may not be in fully-normalised form if read from an @@ -2299,18 +2338,19 @@ then value is already in serialised form, this function is O(1). If the value is not already in serialised form, serialisation occurs implicitly and is approximately O(n) in the size -of the result.

    +of the result. +

    value :

    a GVariant instance +a GVariant instance

    Returns :

    the serialised size of value +the serialised size of value
    - - @@ -2320,8 +2360,8 @@ of the result.


    g_variant_store ()

    -
    void                g_variant_store                     (GVariant *value,
    -                                                         gpointer data);
    +
    void                g_variant_store                     (GVariant *value,
    +                                                         gpointer data);

    Stores the serialised form of value at data. data should be large enough. See g_variant_get_size(). @@ -2332,18 +2372,19 @@ fully-normalised form if read from an untrusted source. See g_variant_normalise() for a solution.

    -This function is approximately O(n) in the size of data.

    +This function is approximately O(n) in the size of data. +

    value :

    a GVariant instance +a GVariant instance

    Returns :

    the serialised form of value, or NULL +the serialised form of value, or NULL
    - - @@ -2353,12 +2394,12 @@ This function is approximately O(n) in the size of d

    g_variant_new_from_data ()

    -
    GVariant *          g_variant_new_from_data             (const GVariantType *type,
    -                                                         gconstpointer data,
    -                                                         gsize size,
    -                                                         gboolean trusted,
    -                                                         GDestroyNotify notify,
    -                                                         gpointer user_data);
    +
    GVariant *          g_variant_new_from_data             (const GVariantType *type,
    +                                                         gconstpointer data,
    +                                                         gsize size,
    +                                                         gboolean trusted,
    +                                                         GDestroyNotify notify,
    +                                                         gpointer user_data);

    Creates a new GVariant instance from serialised data.

    @@ -2383,43 +2424,45 @@ file in the user's home directory, etc.

    notify will be called with user_data when data is no longer needed. The exact time of this call is unspecified and might even be -before this function returns.

    +before this function returns. +

    value :

    the GVariant to store +the GVariant to store

    data :

    the location to store the serialised data at +the location to store the serialised data at
    - - - - - - - @@ -2429,7 +2472,7 @@ before this function returns.


    g_variant_byteswap ()

    -
    GVariant *          g_variant_byteswap                  (GVariant *value);
    +
    GVariant *          g_variant_byteswap                  (GVariant *value);

    Performs a byteswapping operation on the contents of value. The result is that all multi-byte numeric data contained in value is @@ -2443,18 +2486,19 @@ contain multi-byte numeric data. That include strings, booleans, bytes and containers containing only these things (recursively).

    -The returned value is always in normal form and is marked as trusted.

    +The returned value is always in normal form and is marked as trusted. +

    type :

    a GVariantType +a definite GVariantType

    data :

    the serialised data +the serialised data

    size :

    the size of data +the size of data

    trusted :

    TRUE if data is definitely in normal form + +TRUE if data is definitely in normal form

    notify :

    function to call when data is no longer needed +function to call when data is no longer needed

    user_data :

    data for notify +data for notify

    Returns :

    a new floating GVariant of type type +a new floating GVariant of type type
    - - @@ -2464,7 +2508,7 @@ The returned value is always in normal form and is marked as trusted.


    g_variant_get_normal_form ()

    -
    GVariant *          g_variant_get_normal_form           (GVariant *value);
    +
    GVariant *          g_variant_get_normal_form           (GVariant *value);

    Gets a GVariant instance that has the same value as value and is trusted to be in normal form. @@ -2485,18 +2529,19 @@ If value is found not to be in normal fo

    It makes sense to call this function if you've received GVariant data from untrusted sources and you want to ensure your serialised -output is definitely in normal form.

    +output is definitely in normal form. +

    value :

    a GVariant +a GVariant

    Returns :

    the byteswapped form of value +the byteswapped form of value
    - - @@ -2506,7 +2551,7 @@ output is definitely in normal form.


    g_variant_is_normal_form ()

    -
    gboolean            g_variant_is_normal_form            (GVariant *value);
    +
    gboolean            g_variant_is_normal_form            (GVariant *value);

    Checks if value is in normal form.

    @@ -2519,18 +2564,20 @@ check.

    If value is found to be in normal form then it will be marked as being trusted. If the value was already marked as being trusted then -this function will immediately return TRUE.

    +this function will immediately return TRUE. +

    value :

    a GVariant +a GVariant

    Returns :

    a trusted GVariant +a trusted GVariant
    - - @@ -2540,7 +2587,7 @@ this function will immediately return

    g_variant_hash ()

    -
    guint               g_variant_hash                      (gconstpointer value);
    +
    guint               g_variant_hash                      (gconstpointer value);

    Generates a hash value for a GVariant instance.

    @@ -2552,18 +2599,19 @@ function as a basis for building protocols or file formats.

    The type of value is gconstpointer only to allow use of this -function with GHashTable. value must be a GVariant.

    +function with GHashTable. value must be a GVariant. +

    value :

    a GVariant instance +a GVariant instance

    Returns :

    TRUE if value is in normal form + +TRUE if value is in normal form
    - - @@ -2573,30 +2621,32 @@ function with

    g_variant_equal ()

    -
    gboolean            g_variant_equal                     (gconstpointer one,
    -                                                         gconstpointer two);
    +
    gboolean            g_variant_equal                     (gconstpointer one,
    +                                                         gconstpointer two);

    Checks if one and two have the same type and value.

    The types of one and two are gconstpointer only to allow use of -this function with GHashTable. They must each be a GVariant.

    +this function with GHashTable. They must each be a GVariant. +

    value :

    a basic GVariant value as a gconstpointer +a basic GVariant value as a gconstpointer

    Returns :

    a hash value corresponding to value +a hash value corresponding to value
    - - - @@ -2606,31 +2656,33 @@ this function with

    g_variant_print ()

    -
    gchar *             g_variant_print                     (GVariant *value,
    -                                                         gboolean type_annotate);
    +
    gchar *             g_variant_print                     (GVariant *value,
    +                                                         gboolean type_annotate);

    Pretty-prints value in the format understood by g_variant_parse().

    If type_annotate is TRUE, then type information is included in -the output.

    +the output. +

    one :

    a GVariant instance +a GVariant instance

    two :

    a GVariant instance +a GVariant instance

    Returns :

    TRUE if one and two are equal + +TRUE if one and two are equal
    - - - @@ -2639,37 +2691,39 @@ the output.


    g_variant_print_string ()

    -
    GString *           g_variant_print_string              (GVariant *value,
    -                                                         GString *string,
    -                                                         gboolean type_annotate);
    +
    GString *           g_variant_print_string              (GVariant *value,
    +                                                         GString *string,
    +                                                         gboolean type_annotate);

    Behaves as g_variant_print(), but operates on a GString.

    If string is non-NULL then it is appended to and returned. Else, -a new empty GString is allocated and it is returned.

    +a new empty GString is allocated and it is returned. +

    value :

    a GVariant +a GVariant

    type_annotate :

    TRUE if type information should be included in + +TRUE if type information should be included in the output

    Returns :

    a newly-allocated string holding the result. +a newly-allocated string holding the result.
    - - - - @@ -2684,12 +2738,13 @@ a new empty

    GVariantIter is an opaque data structure and can only be accessed -using the following functions.

    +using the following functions. +


    g_variant_iter_copy ()

    -
    GVariantIter *      g_variant_iter_copy                 (GVariantIter *iter);
    +
    GVariantIter *      g_variant_iter_copy                 (GVariantIter *iter);

    Creates a new heap-allocated GVariantIter to iterate over the container that was being iterated over by iter. Iteration begins on @@ -2702,18 +2757,19 @@ need it.

    A reference is taken to the container that iter is iterating over -and will be releated only when g_variant_iter_free() is called.

    +and will be releated only when g_variant_iter_free() is called. +

    value :

    a GVariant +a GVariant

    string :

    a GString, or NULL +a GString, or NULL

    type_annotate :

    TRUE if type information should be included in + +TRUE if type information should be included in the output

    Returns :

    a GString containing the string +a GString containing the string
    - - @@ -2723,16 +2779,17 @@ and will be releated only when

    g_variant_iter_free ()

    -
    void                g_variant_iter_free                 (GVariantIter *iter);
    +
    void                g_variant_iter_free                 (GVariantIter *iter);

    Frees a heap-allocated GVariantIter. Only call this function on iterators that were returned by g_variant_iter_new() or -g_variant_iter_copy().

    +g_variant_iter_copy(). +

    iter :

    a GVariantIter +a GVariantIter

    Returns :

    a new heap-allocated GVariantIter +a new heap-allocated GVariantIter
    -

    iter :

    a heap-allocated GVariantIter +a heap-allocated GVariantIter
    @@ -2741,8 +2798,8 @@ iterators that were returned by

    g_variant_iter_init ()

    -
    gsize               g_variant_iter_init                 (GVariantIter *iter,
    -                                                         GVariant *value);
    +
    gsize               g_variant_iter_init                 (GVariantIter *iter,
    +                                                         GVariant *value);

    Initialises (without allocating) a GVariantIter. iter may be completely uninitialised prior to this call; its old value is @@ -2750,23 +2807,24 @@ ignored.

    The iterator remains valid for as long as value exists, and need not -be freed in any way.

    +be freed in any way. +

    - - - @@ -2776,25 +2834,26 @@ be freed in any way.


    g_variant_iter_n_children ()

    -
    gsize               g_variant_iter_n_children           (GVariantIter *iter);
    +
    gsize               g_variant_iter_n_children           (GVariantIter *iter);

    Queries the number of child items in the container that we are iterating over. This is the total number of items -- not the number of items remaining.

    -This function might be useful for preallocation of arrays.

    +This function might be useful for preallocation of arrays. +

    iter :

    a pointer to a GVariantIter +a pointer to a GVariantIter

    value :

    a container GVariant +a container GVariant

    Returns :

    the number of items in value +the number of items in value
    - - @@ -2804,7 +2863,7 @@ This function might be useful for preallocation of arrays.


    g_variant_iter_new ()

    -
    GVariantIter *      g_variant_iter_new                  (GVariant *value);
    +
    GVariantIter *      g_variant_iter_new                  (GVariant *value);

    Creates a heap-allocated GVariantIter for iterating over the items in value. @@ -2815,18 +2874,19 @@ need it.

    A reference is taken to value and will be released only when -g_variant_iter_free() is called.

    +g_variant_iter_free() is called. +

    iter :

    a GVariantIter +a GVariantIter

    Returns :

    the number of children in the container +the number of children in the container
    - - @@ -2836,7 +2896,7 @@ A reference is taken to value and will b

    g_variant_iter_next_value ()

    -
    GVariant *          g_variant_iter_next_value           (GVariantIter *iter);
    +
    GVariant *          g_variant_iter_next_value           (GVariantIter *iter);

    Gets the next item in the container. If no more items remain then NULL is returned. @@ -2848,40 +2908,66 @@ you no longer need it.

    -

    Example 23. Iterating with g_variant_iter_next_value()

    -
    -  /* recursively iterate a container */
    -  void
    -  iterate_container_recursive (GVariant *container)
    -  {
    -    GVariantIter iter;
    -    GVariant *child;
    +

    Example 23. Iterating with g_variant_iter_next_value()

    +
    +

    value :

    a container GVariant +a container GVariant

    Returns :

    a new heap-allocated GVariantIter +a new heap-allocated GVariantIter
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    /* recursively iterate a container */
    +void
    +iterate_container_recursive (GVariant *container)
    +{
    +  GVariantIter iter;
    +  GVariant *child;
    +
    +  g_variant_iter_init (&iter, dictionary);
    +  while ((child = g_variant_iter_next_value (&iter)))
    +    {
    +      g_print ("type '%s'\n", g_variant_get_type_string (child));
     
    -    g_variant_iter_init (&iter, dictionary);
    -    while ((child = g_variant_iter_next_value (&iter)))
    -      {
    -        g_print ("type '%s'\n", g_variant_get_type_string (child));
    +      if (g_variant_is_container (child))
    +        iterate_container_recursive (child);
     
    -        if (g_variant_is_container (child))
    -          iterate_container_recursive (child);
    +      g_variant_unref (child);
    +    }
    +}
    +
    - g_variant_unref (child); - } - } -
    -


    +


    +

    - - @@ -2891,9 +2977,9 @@ you no longer need it.

    g_variant_iter_next ()

    -
    gboolean            g_variant_iter_next                 (GVariantIter *iter,
    -                                                         const gchar *format_string,
    -                                                         ...);
    +
    gboolean            g_variant_iter_next                 (GVariantIter *iter,
    +                                                         const gchar *format_string,
    +                                                         ...);

    Gets the next item in the container and unpacks it into the variable argument list according to format_string, returning TRUE. @@ -2910,55 +2996,83 @@ the unpacking process.

    -

    Example 24. Memory management with g_variant_iter_next()

    -
    -  /* Iterates a dictionary of type 'a{sv}' */
    -  void
    -  iterate_dictionary (GVariant *dictionary)
    -  {
    -    GVariantIter iter;
    -    GVariant *value;
    -    gchar *key;
    +

    Example 24. Memory management with g_variant_iter_next()

    +
    +

    iter :

    a GVariantIter +a GVariantIter

    Returns :

    a GVariant, or NULL +a GVariant, or NULL
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    /* Iterates a dictionary of type 'a{sv}' */
    +void
    +iterate_dictionary (GVariant *dictionary)
    +{
    +  GVariantIter iter;
    +  GVariant *value;
    +  gchar *key;
     
    -    g_variant_iter_init (&iter, dictionary);
    -    while (g_variant_iter_next (&iter, "{sv}", &key, &value))
    -      {
    -        g_print ("Item '%s' has type '%s'\n", key,
    -                 g_variant_get_type_string (value));
    +  g_variant_iter_init (&iter, dictionary);
    +  while (g_variant_iter_next (&iter, "{sv}", &key, &value))
    +    {
    +      g_print ("Item '%s' has type '%s'\n", key,
    +               g_variant_get_type_string (value));
    +
    +      /* must free data for ourselves */
    +      g_variant_unref (value);
    +      g_free (key);
    +    }
    +}
    +
    - /* must free data for ourselves */ - g_variant_unref (value); - g_free (key); - } - } -


    For a solution that is likely to be more convenient to C programmers -when dealing with loops, see g_variant_iter_loop().

    +when dealing with loops, see g_variant_iter_loop(). +

    - - - - @@ -2969,9 +3083,9 @@ when dealing with loops, see

    g_variant_iter_loop ()

    -
    gboolean            g_variant_iter_loop                 (GVariantIter *iter,
    -                                                         const gchar *format_string,
    -                                                         ...);
    +
    gboolean            g_variant_iter_loop                 (GVariantIter *iter,
    +                                                         const gchar *format_string,
    +                                                         ...);

    Gets the next item in the container and unpacks it into the variable argument list according to format_string, returning TRUE. @@ -2999,53 +3113,79 @@ the same iterator is not recommended.

    -

    Example 25. Memory management with g_variant_iter_loop()

    -
    -  /* Iterates a dictionary of type 'a{sv}' */
    -  void
    -  iterate_dictionary (GVariant *dictionary)
    -  {
    -    GVariantIter iter;
    -    GVariant *value;
    -    gchar *key;
    +

    Example 25. Memory management with g_variant_iter_loop()

    +
    +

    iter :

    a GVariantIter +a GVariantIter

    format_string :

    a GVariant format string +a GVariant format string

    ... :

    the arguments to unpack the value into +the arguments to unpack the value into

    Returns :

    TRUE if a value was unpacked, or FALSE if there as no + +TRUE if a value was unpacked, or FALSE if there as no value
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    /* Iterates a dictionary of type 'a{sv}' */
    +void
    +iterate_dictionary (GVariant *dictionary)
    +{
    +  GVariantIter iter;
    +  GVariant *value;
    +  gchar *key;
     
    -    g_variant_iter_init (&iter, dictionary);
    -    while (g_variant_iter_loop (&iter, "{sv}", &key, &value))
    -      {
    -        g_print ("Item '%s' has type '%s'\n", key,
    -                 g_variant_get_type_string (value));
    +  g_variant_iter_init (&iter, dictionary);
    +  while (g_variant_iter_loop (&iter, "{sv}", &key, &value))
    +    {
    +      g_print ("Item '%s' has type '%s'\n", key,
    +               g_variant_get_type_string (value));
    +
    +      /* no need to free 'key' and 'value' here */
    +    }
    +}
    +
    - /* no need to free 'key' and 'value' here */ - } - } -


    If you want a slightly less magical alternative that requires more -typing, see g_variant_iter_next().

    +typing, see g_variant_iter_next(). +

    - - - - @@ -3068,12 +3208,13 @@ following functions.

    GVariantBuilder is not threadsafe in any way. Do not attempt to -access it from more than one thread.

    +access it from more than one thread. +


    g_variant_builder_unref ()

    -
    void                g_variant_builder_unref             (GVariantBuilder *builder);
    +
    void                g_variant_builder_unref             (GVariantBuilder *builder);

    Decreases the reference count on builder.

    @@ -3083,12 +3224,13 @@ associated with the

    Don't call this on stack-allocated GVariantBuilder instances or bad -things will happen.

    +things will happen. +

    iter :

    a GVariantIter +a GVariantIter

    format_string :

    a GVariant format string +a GVariant format string

    ... :

    the arguments to unpack the value into +the arguments to unpack the value into

    Returns :

    TRUE if a value was unpacked, or FALSE if there as no + +TRUE if a value was unpacked, or FALSE if there as no value
    -

    builder :

    a GVariantBuilder allocated by g_variant_builder_new() +a GVariantBuilder allocated by g_variant_builder_new()
    @@ -3097,24 +3239,25 @@ things will happen.


    g_variant_builder_ref ()

    -
    GVariantBuilder *   g_variant_builder_ref               (GVariantBuilder *builder);
    +
    GVariantBuilder *   g_variant_builder_ref               (GVariantBuilder *builder);

    Increases the reference count on builder.

    Don't call this on stack-allocated GVariantBuilder instances or bad -things will happen.

    +things will happen. +

    - - @@ -3124,7 +3267,7 @@ things will happen.


    g_variant_builder_new ()

    -
    GVariantBuilder *   g_variant_builder_new               (const GVariantType *type);
    +
    GVariantBuilder *   g_variant_builder_new               (const GVariantType *type);

    Allocates and initialises a new GVariantBuilder.

    @@ -3136,18 +3279,19 @@ any other call.

    In most cases it is easier to place a GVariantBuilder directly on the stack of the calling function and initialise it with -g_variant_builder_init().

    +g_variant_builder_init(). +

    builder :

    a GVariantBuilder allocated by g_variant_builder_new() +a GVariantBuilder allocated by g_variant_builder_new()

    Returns :

    a new reference to builder +a new reference to builder
    - - @@ -3157,8 +3301,8 @@ the stack of the calling function and initialise it with

    g_variant_builder_init ()

    -
    void                g_variant_builder_init              (GVariantBuilder *builder,
    -                                                         const GVariantType *type);
    +
    void                g_variant_builder_init              (GVariantBuilder *builder,
    +                                                         const GVariantType *type);

    Initialises a GVariantBuilder structure.

    @@ -3193,18 +3337,19 @@ with this function. If you ever pass a reference to a GVariantBuilder outside of the control of your own code then you should assume that the person receiving that reference may try to use reference counting; you should use g_variant_builder_new() instead of -this function.

    +this function. +

    type :

    a container type +a container type

    Returns :

    a GVariantBuilder +a GVariantBuilder
    - - @@ -3214,7 +3359,7 @@ this function.


    g_variant_builder_clear ()

    -
    void                g_variant_builder_clear             (GVariantBuilder *builder);
    +
    void                g_variant_builder_clear             (GVariantBuilder *builder);

    Releases all memory associated with a GVariantBuilder without freeing the GVariantBuilder structure itself. @@ -3231,12 +3376,13 @@ builders allocated with g_variant_builder_new (see This function leaves the GVariantBuilder structure set to all-zeros. It is valid to call this function on either an initialised GVariantBuilder or one that is set to all-zeros but it is not valid -to call this function on uninitialised memory.

    +to call this function on uninitialised memory. +

    builder :

    a GVariantBuilder +a GVariantBuilder

    type :

    a container type +a container type
    -

    builder :

    a GVariantBuilder +a GVariantBuilder
    @@ -3245,8 +3391,8 @@ to call this function on uninitialised memory.


    g_variant_builder_add_value ()

    -
    void                g_variant_builder_add_value         (GVariantBuilder *builder,
    -                                                         GVariant *value);
    +
    void                g_variant_builder_add_value         (GVariantBuilder *builder,
    +                                                         GVariant *value);

    Adds value to builder.

    @@ -3255,18 +3401,19 @@ It is an error to call this function in any way that would create an inconsistent value to be constructed. Some examples of this are putting different types of items into an array, putting the wrong types or number of items in a tuple, putting more than one value into -a variant, etc.

    +a variant, etc. +

    - - @@ -3276,9 +3423,9 @@ a variant, etc.


    g_variant_builder_add ()

    -
    void                g_variant_builder_add               (GVariantBuilder *builder,
    -                                                         const gchar *format_string,
    -                                                         ...);
    +
    void                g_variant_builder_add               (GVariantBuilder *builder,
    +                                                         const gchar *format_string,
    +                                                         ...);

    Adds to a GVariantBuilder.

    @@ -3311,22 +3458,24 @@ make_pointless_dictionary (void) return g_variant_builder_end (builder); } +

    +

    builder :

    a GVariantBuilder +a GVariantBuilder

    value :

    a GVariant +a GVariant
    - - - @@ -3336,20 +3485,15 @@ make_pointless_dictionary (void)

    g_variant_builder_end ()

    -
    GVariant *          g_variant_builder_end               (GVariantBuilder *builder);
    +
    GVariant *          g_variant_builder_end               (GVariantBuilder *builder);

    Ends the builder process and returns the constructed value.

    -This call automatically reduces the reference count on builder by -one, unless it has previously had g_variant_builder_no_autofree() -called on it. Unless you've taken other actions, this is usually -sufficient to free builder. -

    -

    -Even if additional references are held, it is not permissible to use -builder in any way after this call except for further reference -counting operations. +It is not permissible to use builder in any way after this call +except for reference counting operations (in the case of a +heap-allocated GVariantBuilder) or by reinitialising it with +g_variant_builder_init() (in the case of stack-allocated).

    It is an error to call this function in any way that would create an @@ -3358,18 +3502,19 @@ items added to a container with a specific number of children required). It is also an error to call this function if the builder was created with an indefinite array or maybe type and no children have been added; in this case it is impossible to infer the type of -the empty array.

    +the empty array. +

    builder :

    a GVariantBuilder +a GVariantBuilder

    format_string :

    a GVariant varargs format string +a GVariant varargs format string

    ... :

    arguments, as per format_string +arguments, as per format_string
    - - @@ -3379,8 +3524,8 @@ the empty array.


    g_variant_builder_open ()

    -
    void                g_variant_builder_open              (GVariantBuilder *builder,
    -                                                         const GVariantType *type);
    +
    void                g_variant_builder_open              (GVariantBuilder *builder,
    +                                                         const GVariantType *type);

    Opens a subcontainer inside the given builder. When done adding items to the subcontainer, g_variant_builder_close() must be called. @@ -3388,18 +3533,19 @@ items to the subcontainer,

    builder :

    a GVariantBuilder +a GVariantBuilder

    Returns :

    a new, floating, GVariant +a new, floating, GVariant
    - - @@ -3409,7 +3555,7 @@ a value of an incorrect type).


    g_variant_builder_close ()

    -
    void                g_variant_builder_close             (GVariantBuilder *builder);
    +
    void                g_variant_builder_close             (GVariantBuilder *builder);

    Closes the subcontainer inside the given builder that was opened by the most recent call to g_variant_builder_open(). @@ -3417,12 +3563,13 @@ the most recent call to

    builder :

    a GVariantBuilder +a GVariantBuilder

    type :

    a GVariantType +a GVariantType
    -

    builder :

    a GVariantBuilder +a GVariantBuilder
    @@ -3436,16 +3583,17 @@ subcontainer).

    Error domain for GVariant text format parsing. Specific error codes are not currently defined for this domain. See GError for -information on error domains.

    +information on error domains. +


    g_variant_parse ()

    -
    GVariant *          g_variant_parse                     (const GVariantType *type,
    -                                                         const gchar *text,
    -                                                         const gchar *limit,
    -                                                         const gchar **endptr,
    -                                                         GError **error);
    +
    GVariant *          g_variant_parse                     (const GVariantType *type,
    +                                                         const gchar *text,
    +                                                         const gchar *limit,
    +                                                         const gchar **endptr,
    +                                                         GError **error);

    Parses a GVariant from a text representation.

    @@ -3481,38 +3629,39 @@ then it will be set to reflect the error that occured.

    Officially, the language understood by the parser is "any string -produced by g_variant_print()".

    +produced by g_variant_print()". +

    - - - - - - @@ -3521,8 +3670,8 @@ produced by

    g_variant_new_parsed_va ()

    -
    GVariant *          g_variant_new_parsed_va             (const gchar *format,
    -                                                         va_list *app);
    +
    GVariant *          g_variant_new_parsed_va             (const gchar *format,
    +                                                         va_list *app);

    Parses format and returns the result.

    @@ -3543,23 +3692,24 @@ calling function to g_variant_new() call.

    +or by passing it to another g_variant_new() call. +

    type :

    a GVariantType, or NULL +a GVariantType, or NULL

    text :

    a string containing a GVariant in text form +a string containing a GVariant in text form

    limit :

    a pointer to the end of text, or NULL +a pointer to the end of text, or NULL

    endptr :

    a location to store the end pointer, or NULL +a location to store the end pointer, or NULL

    error :

    a pointer to a NULL GError pointer, or NULL +a pointer to a NULL GError pointer, or NULL

    Returns :

    a reference to a GVariant, or NULL +a reference to a GVariant, or NULL
    - - - @@ -3568,8 +3718,8 @@ or by passing it to another

    g_variant_new_parsed ()

    -
    GVariant *          g_variant_new_parsed                (const gchar *format,
    -                                                         ...);
    +
    GVariant *          g_variant_new_parsed                (const gchar *format,
    +                                                         ...);

    Parses format and returns the result.

    @@ -3585,9 +3735,17 @@ Consider this simple example:

    -
    - g_variant_new_parsed ("[('one', 1), ('two', %i), (%s, 3)]", 2, "three");
    -
    +
    +

    format :

    a text format GVariant +a text format GVariant

    app :

    a pointer to a va_list +a pointer to a va_list

    Returns :

    a new, usually floating, GVariant +a new, usually floating, GVariant
    + + + + + + +
    1
    g_variant_new_parsed ("[('one', 1), ('two', %i), (%s, 3)]", 2, "three");
    +
    +

    @@ -3604,23 +3762,24 @@ want to parse data from untrusted sources, use GVariant pointer from the argument list. ie: format may not solely be anything along the lines of "%*", "%?", "r", or anything starting -with "%@".

    +with "%@". +

    - - - @@ -3634,6 +3793,6 @@ GVariantType + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-GVariantType.html b/docs/reference/glib/html/glib-GVariantType.html index c1b6183..75294aa 100644 --- a/docs/reference/glib/html/glib-GVariantType.html +++ b/docs/reference/glib/html/glib-GVariantType.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    format :

    a text format GVariant +a text format GVariant

    ... :

    arguments as per format +arguments as per format

    Returns :

    a new floating GVariant instance +a new floating GVariant instance
    @@ -85,46 +65,46 @@ #define G_VARIANT_TYPE_DICTIONARY #define G_VARIANT_TYPE (type_string) -voidg_variant_type_free (GVariantType *type); -GVariantType * g_variant_type_copy (const GVariantType *type); -GVariantType * g_variant_type_new (const gchar *type_string); +voidg_variant_type_free (GVariantType *type); +GVariantType * g_variant_type_copy (const GVariantType *type); +GVariantType * g_variant_type_new (const gchar *type_string); -gbooleang_variant_type_string_is_valid (const gchar *type_string); -gbooleang_variant_type_string_scan (const gchar *string, - const gchar *limit, - const gchar **endptr); -gsizeg_variant_type_get_string_length (const GVariantType *type); -const gchar * g_variant_type_peek_string (const GVariantType *type); -gchar * g_variant_type_dup_string (const GVariantType *type); +gbooleang_variant_type_string_is_valid (const gchar *type_string); +gbooleang_variant_type_string_scan (const gchar *string, + const gchar *limit, + const gchar **endptr); +gsizeg_variant_type_get_string_length (const GVariantType *type); +const gchar * g_variant_type_peek_string (const GVariantType *type); +gchar * g_variant_type_dup_string (const GVariantType *type); -gbooleang_variant_type_is_definite (const GVariantType *type); -gbooleang_variant_type_is_container (const GVariantType *type); -gbooleang_variant_type_is_basic (const GVariantType *type); -gbooleang_variant_type_is_maybe (const GVariantType *type); -gbooleang_variant_type_is_array (const GVariantType *type); -gbooleang_variant_type_is_tuple (const GVariantType *type); -gbooleang_variant_type_is_dict_entry (const GVariantType *type); -gbooleang_variant_type_is_variant (const GVariantType *type); +gbooleang_variant_type_is_definite (const GVariantType *type); +gbooleang_variant_type_is_container (const GVariantType *type); +gbooleang_variant_type_is_basic (const GVariantType *type); +gbooleang_variant_type_is_maybe (const GVariantType *type); +gbooleang_variant_type_is_array (const GVariantType *type); +gbooleang_variant_type_is_tuple (const GVariantType *type); +gbooleang_variant_type_is_dict_entry (const GVariantType *type); +gbooleang_variant_type_is_variant (const GVariantType *type); -guintg_variant_type_hash (gconstpointer type); -gbooleang_variant_type_equal (gconstpointer type1, - gconstpointer type2); -gbooleang_variant_type_is_subtype_of (const GVariantType *type, - const GVariantType *supertype); +guintg_variant_type_hash (gconstpointer type); +gbooleang_variant_type_equal (gconstpointer type1, + gconstpointer type2); +gbooleang_variant_type_is_subtype_of (const GVariantType *type, + const GVariantType *supertype); -GVariantType * g_variant_type_new_maybe (const GVariantType *element); -GVariantType * g_variant_type_new_array (const GVariantType *element); -GVariantType * g_variant_type_new_tuple (const GVariantType * const *items, - gint length); -GVariantType * g_variant_type_new_dict_entry (const GVariantType *key, - const GVariantType *value); +GVariantType * g_variant_type_new_maybe (const GVariantType *element); +GVariantType * g_variant_type_new_array (const GVariantType *element); +GVariantType * g_variant_type_new_tuple (const GVariantType * const *items, + gint length); +GVariantType * g_variant_type_new_dict_entry (const GVariantType *key, + const GVariantType *value); -const GVariantType * g_variant_type_element (const GVariantType *type); -gsizeg_variant_type_n_items (const GVariantType *type); -const GVariantType * g_variant_type_first (const GVariantType *type); -const GVariantType * g_variant_type_next (const GVariantType *type); -const GVariantType * g_variant_type_key (const GVariantType *type); -const GVariantType * g_variant_type_value (const GVariantType *type); +const GVariantType * g_variant_type_element (const GVariantType *type); +gsizeg_variant_type_n_items (const GVariantType *type); +const GVariantType * g_variant_type_first (const GVariantType *type); +const GVariantType * g_variant_type_next (const GVariantType *type); +const GVariantType * g_variant_type_key (const GVariantType *type); +const GVariantType * g_variant_type_value (const GVariantType *type);
    @@ -187,16 +167,14 @@ certainly matches the type of "an array of no particular type", since This is similar to how instances of abstract classes may not directly exist in other type systems, but instances of their non-abstract subtypes may. For example, in GTK, no object that has -the type of GtkBin can exist (since GtkBin is an abstract class), -but a GtkWindow can certainly be instantiated, and you would say -that the GtkWindow is a GtkBin (since GtkWindow is a subclass of -GtkBin). +the type of GtkBin can exist (since GtkBin is an abstract class), +but a GtkWindow can certainly be instantiated, and you would say +that the GtkWindow is a GtkBin (since GtkWindow is a subclass of +GtkBin).

    A detailed description of GVariant type strings is given here:

    -

    -

    GVariant Type Strings

    @@ -585,7 +563,8 @@ A type in the GVariant type system.

    Two types may not be compared by value; use g_variant_type_equal() or g_variant_type_is_subtype(). May be copied using -g_variant_type_copy() and freed using g_variant_type_free().

    +g_variant_type_copy() and freed using g_variant_type_free(). +


    @@ -593,7 +572,8 @@ Two types may not be compared by value; use #define G_VARIANT_TYPE_BOOLEAN ((const GVariantType *) "b")

    -The type of a value that can be either TRUE or FALSE.

    +The type of a value that can be either TRUE or FALSE. +



    @@ -609,7 +590,8 @@ The type of an integer value that can range from 0 to 255.

    #define G_VARIANT_TYPE_INT16                ((const GVariantType *) "n")
     

    -The type of an integer value that can range from -32768 to 32767.

    +The type of an integer value that can range from -32768 to 32767. +


    @@ -618,7 +600,8 @@ The type of an integer value that can range from -32768 to 32767.

    The type of an integer value that can range from 0 to 65535. -There were about this many people living in Toronto in the 1870s.

    +There were about this many people living in Toronto in the 1870s. +


    @@ -627,7 +610,8 @@ There were about this many people living in Toronto in the 1870s.

    The type of an integer value that can range from -2147483648 to -2147483647.

    +2147483647. +


    @@ -636,7 +620,8 @@ The type of an integer value that can range from -2147483648 to

    The type of an integer value that can range from 0 to 4294967295. -That's one number for everyone who was around in the late 1970s.

    +That's one number for everyone who was around in the late 1970s. +


    @@ -645,7 +630,8 @@ That's one number for everyone who was around in the late 1970s.

    The type of an integer value that can range from --9223372036854775808 to 9223372036854775807.

    +-9223372036854775808 to 9223372036854775807. +


    @@ -655,7 +641,8 @@ The type of an integer value that can range from

    The type of an integer value that can range from 0 to 18446744073709551616. That's a really big number, but a Rubik's -cube can have a bit more than twice as many possible positions.

    +cube can have a bit more than twice as many possible positions. +


    @@ -669,7 +656,8 @@ a DBus message.

    If you are not interacting with DBus, then there is no reason to make -use of this type.

    +use of this type. +


    @@ -681,7 +669,8 @@ The type of a double precision IEEE754 floating point number. These guys go up to about 1.80e308 (plus and minus) but miss out on some numbers in between. In any case, that's far greater than the estimated number of fundamental particles in the observable -universe.

    +universe. +



    @@ -704,7 +694,8 @@ the bus.

    If you are not interacting with DBus, then there is no reason to make use of this type. If you are, then the DBus specification contains a -precise description of valid object paths.

    +precise description of valid object paths. +


    @@ -718,7 +709,8 @@ format used as type signatures for DBus methods and messages.

    If you are not interacting with DBus, then there is no reason to make use of this type. If you are, then the DBus specification contains a -precise description of valid signature strings.

    +precise description of valid signature strings. +


    @@ -727,7 +719,8 @@ precise description of valid signature strings.

    The type of a box that contains any other value (including another -variant).

    +variant). +


    @@ -736,7 +729,8 @@ variant).

    An indefinite type that is a supertype of every type (including -itself).

    +itself). +


    @@ -745,7 +739,8 @@ itself).

    An indefinite type that is a supertype of every basic (ie: -non-container) type.

    +non-container) type. +


    @@ -753,7 +748,8 @@ non-container) type.

    #define G_VARIANT_TYPE_MAYBE                ((const GVariantType *) "m*")
     

    -An indefinite type that is a supertype of every maybe type.

    +An indefinite type that is a supertype of every maybe type. +


    @@ -761,7 +757,8 @@ An indefinite type that is a supertype of every maybe type.

    #define G_VARIANT_TYPE_ARRAY                ((const GVariantType *) "a*")
     

    -An indefinite type that is a supertype of every array type.

    +An indefinite type that is a supertype of every array type. +


    @@ -770,7 +767,8 @@ An indefinite type that is a supertype of every array type.

    An indefinite type that is a supertype of every tuple type, -regardless of the number of items in the tuple.

    +regardless of the number of items in the tuple. +


    @@ -779,7 +777,8 @@ regardless of the number of items in the tuple.

    The empty tuple type. Has only one instance. Known also as "triv" -or "void".

    +or "void". +


    @@ -788,7 +787,8 @@ or "void".

    An indefinite type that is a supertype of every dictionary entry -type.

    +type. +


    @@ -798,7 +798,8 @@ type.

    An indefinite type that is a supertype of every dictionary type -- that is, any array type that has an element type equal to any -dictionary entry type.

    +dictionary entry type. +


    @@ -814,12 +815,13 @@ It is always a programmer error to use this macro with an invalid type string.

    -Since 2.24

    +Since 2.24 +

    -

    type_string :

    a well-formed GVariantType type string +a well-formed GVariantType type string
    @@ -827,7 +829,7 @@ Since 2.24


    g_variant_type_free ()

    -
    void                g_variant_type_free                 (GVariantType *type);
    +
    void                g_variant_type_free                 (GVariantType *type);

    Frees a GVariantType that was allocated with g_variant_type_copy(), g_variant_type_new() or one of the container @@ -837,12 +839,13 @@ type constructor functions. In the case that type is NULL, this function does nothing.

    -Since 2.24

    +Since 2.24 +

    -

    type :

    a GVariantType, or NULL +a GVariantType, or NULL
    @@ -850,24 +853,25 @@ Since 2.24


    g_variant_type_copy ()

    -
    GVariantType *      g_variant_type_copy                 (const GVariantType *type);
    +
    GVariantType *      g_variant_type_copy                 (const GVariantType *type);

    Makes a copy of a GVariantType. It is appropriate to call g_variant_type_free() on the return value. type may not be NULL.

    -Since 2.24

    +Since 2.24 +

    - - @@ -876,7 +880,7 @@ Since 2.24


    g_variant_type_new ()

    -
    GVariantType *      g_variant_type_new                  (const gchar *type_string);
    +
    GVariantType *      g_variant_type_new                  (const gchar *type_string);

    Creates a new GVariantType corresponding to the type string given by type_string. It is appropriate to call g_variant_type_free() on @@ -884,18 +888,19 @@ the return value.

    It is a programmer error to call this function with an invalid type -string. Use g_variant_type_string_is_valid() if you are unsure.

    +string. Use g_variant_type_string_is_valid() if you are unsure. +

    type :

    a GVariantType +a GVariantType

    Returns :

    a new GVariantType +a new GVariantType
    - - @@ -905,25 +910,27 @@ string. Use

    g_variant_type_string_is_valid ()

    -
    gboolean            g_variant_type_string_is_valid      (const gchar *type_string);
    +
    gboolean            g_variant_type_string_is_valid      (const gchar *type_string);

    Checks if type_string is a valid GVariant type string. This call is equivalent to calling g_variant_type_string_scan() and confirming that the following character is a nul terminator.

    -Since 2.24

    +Since 2.24 +

    type_string :

    a valid GVariant type string +a valid GVariant type string

    Returns :

    a new GVariantType +a new GVariantType
    - - @@ -932,9 +939,9 @@ Since 2.24


    g_variant_type_string_scan ()

    -
    gboolean            g_variant_type_string_scan          (const gchar *string,
    -                                                         const gchar *limit,
    -                                                         const gchar **endptr);
    +
    gboolean            g_variant_type_string_scan          (const gchar *string,
    +                                                         const gchar *limit,
    +                                                         const gchar **endptr);

    Scan for a single complete and valid GVariant type string in string. The memory pointed to by limit (or bytes beyond it) is never @@ -951,28 +958,30 @@ string does not end before limit then

    For the simple case of checking if a string is a valid type string, -see g_variant_type_string_is_valid().

    +see g_variant_type_string_is_valid(). +

    type_string :

    a pointer to any string +a pointer to any string

    Returns :

    TRUE if type_string is exactly one valid type string + +TRUE if type_string is exactly one valid type string
    - - - - @@ -982,25 +991,26 @@ see

    g_variant_type_get_string_length ()

    -
    gsize               g_variant_type_get_string_length    (const GVariantType *type);
    +
    gsize               g_variant_type_get_string_length    (const GVariantType *type);

    Returns the length of the type string corresponding to the given type. This function must be used to determine the valid extent of the memory region returned by g_variant_type_peek_string().

    -Since 2.24

    +Since 2.24 +

    string :

    a pointer to any string +a pointer to any string

    limit :

    the end of string, or NULL +the end of string, or NULL

    endptr :

    location to store the end pointer, or NULL +location to store the end pointer, or NULL

    Returns :

    TRUE if a valid type string was found + +TRUE if a valid type string was found
    - - @@ -1009,7 +1019,7 @@ Since 2.24


    g_variant_type_peek_string ()

    -
    const gchar *       g_variant_type_peek_string          (const GVariantType *type);
    +
    const gchar *       g_variant_type_peek_string          (const GVariantType *type);

    Returns the type string corresponding to the given type. The result is not nul-terminated; in order to determine its length you @@ -1019,18 +1029,19 @@ must call g_variant_type_dup_string().

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    the length of the corresponding type string +the length of the corresponding type string
    - - @@ -1039,25 +1050,26 @@ Since 2.24


    g_variant_type_dup_string ()

    -
    gchar *             g_variant_type_dup_string           (const GVariantType *type);
    +
    gchar *             g_variant_type_dup_string           (const GVariantType *type);

    Returns a newly-allocated copy of the type string corresponding to type. The returned string is nul-terminated. It is appropriate to call g_free() on the return value.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    the corresponding type string (not nul-terminated) +the corresponding type string (not nul-terminated)
    - - @@ -1066,7 +1078,7 @@ Since 2.24


    g_variant_type_is_definite ()

    -
    gboolean            g_variant_type_is_definite          (const GVariantType *type);
    +
    gboolean            g_variant_type_is_definite          (const GVariantType *type);

    Determines if the given type is definite (ie: not indefinite).

    @@ -1082,18 +1094,20 @@ indefinite type like FALSE being returned.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    the corresponding type string +the corresponding type string
    - - @@ -1102,7 +1116,7 @@ Since 2.24


    g_variant_type_is_container ()

    -
    gboolean            g_variant_type_is_container         (const GVariantType *type);
    +
    gboolean            g_variant_type_is_container         (const GVariantType *type);

    Determines if the given type is a container type.

    @@ -1116,18 +1130,20 @@ definite subtype is a container --

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is definite + +TRUE if type is definite
    - - @@ -1136,7 +1152,7 @@ Since 2.24


    g_variant_type_is_basic ()

    -
    gboolean            g_variant_type_is_basic             (const GVariantType *type);
    +
    gboolean            g_variant_type_is_basic             (const GVariantType *type);

    Determines if the given type is a basic type.

    @@ -1152,18 +1168,20 @@ This function returns G_VARIANT_TYPE_BASIC.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a container type + +TRUE if type is a container type
    - - @@ -1172,7 +1190,7 @@ Since 2.24


    g_variant_type_is_maybe ()

    -
    gboolean            g_variant_type_is_maybe             (const GVariantType *type);
    +
    gboolean            g_variant_type_is_maybe             (const GVariantType *type);

    Determines if the given type is a maybe type. This is true if the type string for type starts with an 'm'. @@ -1183,18 +1201,20 @@ definite subtype is a maybe type --

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a basic type + +TRUE if type is a basic type
    - - @@ -1203,7 +1223,7 @@ Since 2.24


    g_variant_type_is_array ()

    -
    gboolean            g_variant_type_is_array             (const GVariantType *type);
    +
    gboolean            g_variant_type_is_array             (const GVariantType *type);

    Determines if the given type is an array type. This is true if the type string for type starts with an 'a'. @@ -1214,18 +1234,20 @@ definite subtype is an array type --

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a maybe type + +TRUE if type is a maybe type
    - - @@ -1234,7 +1256,7 @@ Since 2.24


    g_variant_type_is_tuple ()

    -
    gboolean            g_variant_type_is_tuple             (const GVariantType *type);
    +
    gboolean            g_variant_type_is_tuple             (const GVariantType *type);

    Determines if the given type is a tuple type. This is true if the type string for type starts with a '(' or if type is @@ -1246,18 +1268,20 @@ definite subtype is a tuple type --

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is an array type + +TRUE if type is an array type
    - - @@ -1266,7 +1290,7 @@ Since 2.24


    g_variant_type_is_dict_entry ()

    -
    gboolean            g_variant_type_is_dict_entry        (const GVariantType *type);
    +
    gboolean            g_variant_type_is_dict_entry        (const GVariantType *type);

    Determines if the given type is a dictionary entry type. This is true if the type string for type starts with a '{'. @@ -1277,18 +1301,20 @@ definite subtype is a dictionary entry type -- G_VARIANT_TYPE_DICT_ENTRY, for example.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a tuple type + +TRUE if type is a tuple type
    - - @@ -1297,23 +1323,25 @@ Since 2.24


    g_variant_type_is_variant ()

    -
    gboolean            g_variant_type_is_variant           (const GVariantType *type);
    +
    gboolean            g_variant_type_is_variant           (const GVariantType *type);

    Determines if the given type is the variant type.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a dictionary entry type + +TRUE if type is a dictionary entry type
    - - @@ -1322,7 +1350,7 @@ Since 2.24


    g_variant_type_hash ()

    -
    guint               g_variant_type_hash                 (gconstpointer type);
    +
    guint               g_variant_type_hash                 (gconstpointer type);

    Hashes type.

    @@ -1332,18 +1360,19 @@ The argument type of type is only GVariantType must be provided.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is the variant type + +TRUE if type is the variant type
    - - @@ -1352,8 +1381,8 @@ Since 2.24


    g_variant_type_equal ()

    -
    gboolean            g_variant_type_equal                (gconstpointer type1,
    -                                                         gconstpointer type2);
    +
    gboolean            g_variant_type_equal                (gconstpointer type1,
    +                                                         gconstpointer type2);

    Compares type1 and type2 for equality.

    @@ -1369,23 +1398,25 @@ allow use with GVariantType must be provided.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    Returns :

    the hash value +the hash value
    - - - @@ -1394,8 +1425,8 @@ Since 2.24


    g_variant_type_is_subtype_of ()

    -
    gboolean            g_variant_type_is_subtype_of        (const GVariantType *type,
    -                                                         const GVariantType *supertype);
    +
    gboolean            g_variant_type_is_subtype_of        (const GVariantType *type,
    +                                                         const GVariantType *supertype);

    Checks if type is a subtype of supertype.

    @@ -1405,23 +1436,25 @@ types are considered to be subtypes of themselves. Aside from that, only indefinite types can have subtypes.

    -Since 2.24

    +Since 2.24 +

    type1 :

    a GVariantType +a GVariantType

    type2 :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type1 and type2 are exactly equal + +TRUE if type1 and type2 are exactly equal
    - - - @@ -1430,7 +1463,7 @@ Since 2.24


    g_variant_type_new_maybe ()

    -
    GVariantType *      g_variant_type_new_maybe            (const GVariantType *element);
    +
    GVariantType *      g_variant_type_new_maybe            (const GVariantType *element);

    Constructs the type corresponding to a maybe instance containing type type or Nothing. @@ -1439,18 +1472,19 @@ type type or Nothing. It is appropriate to call g_variant_type_free() on the return value.

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType +a GVariantType

    supertype :

    a GVariantType +a GVariantType

    Returns :

    TRUE if type is a subtype of supertype + +TRUE if type is a subtype of supertype
    - - @@ -1459,7 +1493,7 @@ Since 2.24


    g_variant_type_new_array ()

    -
    GVariantType *      g_variant_type_new_array            (const GVariantType *element);
    +
    GVariantType *      g_variant_type_new_array            (const GVariantType *element);

    Constructs the type corresponding to an array of elements of the type type. @@ -1468,18 +1502,19 @@ type type. It is appropriate to call g_variant_type_free() on the return value.

    -Since 2.24

    +Since 2.24 +

    element :

    a GVariantType +a GVariantType

    Returns :

    a new maybe GVariantType +a new maybe GVariantType
    - - @@ -1488,8 +1523,8 @@ Since 2.24


    g_variant_type_new_tuple ()

    -
    GVariantType *      g_variant_type_new_tuple            (const GVariantType * const *items,
    -                                                         gint length);
    +
    GVariantType *      g_variant_type_new_tuple            (const GVariantType * const *items,
    +                                                         gint length);

    Constructs a new tuple type, from items.

    @@ -1501,23 +1536,24 @@ Constructs a new tuple type, from items. It is appropriate to call g_variant_type_free() on the return value.

    -Since 2.24

    +Since 2.24 +

    element :

    a GVariantType +a GVariantType

    Returns :

    a new array GVariantType +a new array GVariantType
    - - - @@ -1526,8 +1562,8 @@ Since 2.24


    g_variant_type_new_dict_entry ()

    -
    GVariantType *      g_variant_type_new_dict_entry       (const GVariantType *key,
    -                                                         const GVariantType *value);
    +
    GVariantType *      g_variant_type_new_dict_entry       (const GVariantType *key,
    +                                                         const GVariantType *value);

    Constructs the type corresponding to a dictionary entry with a key of type key and a value of type value. @@ -1536,23 +1572,24 @@ of type key and a value of type g_variant_type_free() on the return value.

    -Since 2.24

    +Since 2.24 +

    items :

    an array of GVariantTypes, one for each item +an array of GVariantTypes, one for each item

    length :

    the length of items, or -1 +the length of items, or -1

    Returns :

    a new tuple GVariantType +a new tuple GVariantType
    - - - @@ -1561,7 +1598,7 @@ Since 2.24


    g_variant_type_element ()

    -
    const GVariantType * g_variant_type_element             (const GVariantType *type);
    +
    const GVariantType * g_variant_type_element             (const GVariantType *type);

    Determines the element type of an array or maybe type.

    @@ -1569,18 +1606,19 @@ Determines the element type of an array or maybe type. This function may only be used with array or maybe types.

    -Since 2.24

    +Since 2.24 +

    key :

    a basic GVariantType +a basic GVariantType

    value :

    a GVariantType +a GVariantType

    Returns :

    a new dictionary entry GVariantType +a new dictionary entry GVariantType
    - - @@ -1589,7 +1627,7 @@ Since 2.24


    g_variant_type_n_items ()

    -
    gsize               g_variant_type_n_items              (const GVariantType *type);
    +
    gsize               g_variant_type_n_items              (const GVariantType *type);

    Determines the number of items contained in a tuple or dictionary entry type. @@ -1604,18 +1642,19 @@ In the case of a dictionary entry type, this function will always return 2.

    -Since 2.24

    +Since 2.24 +

    type :

    an array or maybe GVariantType +an array or maybe GVariantType

    Returns :

    the element type of type +the element type of type
    - - @@ -1624,7 +1663,7 @@ Since 2.24


    g_variant_type_first ()

    -
    const GVariantType * g_variant_type_first               (const GVariantType *type);
    +
    const GVariantType * g_variant_type_first               (const GVariantType *type);

    Determines the first item type of a tuple or dictionary entry type. @@ -1646,18 +1685,19 @@ This call, together with

    type :

    a tuple or dictionary entry GVariantType +a tuple or dictionary entry GVariantType

    Returns :

    the number of items in type +the number of items in type
    - - @@ -1666,7 +1706,7 @@ Since 2.24


    g_variant_type_next ()

    -
    const GVariantType * g_variant_type_next                (const GVariantType *type);
    +
    const GVariantType * g_variant_type_next                (const GVariantType *type);

    Determines the next item type of a tuple or dictionary entry type. @@ -1684,18 +1724,19 @@ entry then this call returns NULL is returned when type is the last item in a tuple.

    -Since 2.24

    +Since 2.24 +

    type :

    a tuple or dictionary entry GVariantType +a tuple or dictionary entry GVariantType

    Returns :

    the first item type of type, or NULL +the first item type of type, or NULL
    - - @@ -1704,7 +1745,7 @@ Since 2.24


    g_variant_type_key ()

    -
    const GVariantType * g_variant_type_key                 (const GVariantType *type);
    +
    const GVariantType * g_variant_type_key                 (const GVariantType *type);

    Determines the key type of a dictionary entry type.

    @@ -1714,18 +1755,19 @@ than the additional restriction, this call is equivalent to g_variant_type_first().

    -Since 2.24

    +Since 2.24 +

    type :

    a GVariantType from a previous call +a GVariantType from a previous call

    Returns :

    the next GVariantType after type, or NULL +the next GVariantType after type, or NULL
    - - @@ -1734,7 +1776,7 @@ Since 2.24


    g_variant_type_value ()

    -
    const GVariantType * g_variant_type_value               (const GVariantType *type);
    +
    const GVariantType * g_variant_type_value               (const GVariantType *type);

    Determines the value type of a dictionary entry type.

    @@ -1742,18 +1784,19 @@ Determines the value type of a dictionary entry type. This function may only be used with a dictionary entry type.

    -Since 2.24

    +Since 2.24 +

    type :

    a dictionary entry GVariantType +a dictionary entry GVariantType

    Returns :

    the key type of the dictionary entry +the key type of the dictionary entry
    - - @@ -1767,6 +1810,6 @@ Since 2.24

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Glob-style-pattern-matching.html b/docs/reference/glib/html/glib-Glob-style-pattern-matching.html index d2a0f6b..7623a73 100644 --- a/docs/reference/glib/html/glib-Glob-style-pattern-matching.html +++ b/docs/reference/glib/html/glib-Glob-style-pattern-matching.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    type :

    a dictionary entry GVariantType +a dictionary entry GVariantType

    Returns :

    the value type of the dictionary entry +the value type of the dictionary entry
    @@ -62,18 +42,18 @@ #include <glib.h> GPatternSpec; -GPatternSpec* g_pattern_spec_new (const gchar *pattern); -void g_pattern_spec_free (GPatternSpec *pspec); -gboolean g_pattern_spec_equal (GPatternSpec *pspec1, - GPatternSpec *pspec2); -gboolean g_pattern_match (GPatternSpec *pspec, - guint string_length, - const gchar *string, - const gchar *string_reversed); -gboolean g_pattern_match_string (GPatternSpec *pspec, - const gchar *string); -gboolean g_pattern_match_simple (const gchar *pattern, - const gchar *string); +GPatternSpec* g_pattern_spec_new (const gchar *pattern); +void g_pattern_spec_free (GPatternSpec *pspec); +gboolean g_pattern_spec_equal (GPatternSpec *pspec1, + GPatternSpec *pspec2); +gboolean g_pattern_match (GPatternSpec *pspec, + guint string_length, + const gchar *string, + const gchar *string_reversed); +gboolean g_pattern_match_string (GPatternSpec *pspec, + const gchar *string); +gboolean g_pattern_match_simple (const gchar *pattern, + const gchar *string);
    @@ -96,7 +76,8 @@ When multiple strings must be matched against the same pattern, it is better to compile the pattern to a GPatternSpec using g_pattern_spec_new() and use g_pattern_match_string() instead of g_pattern_match_simple(). This avoids the overhead of repeated -pattern compilation.

    +pattern compilation. +

    Details

    @@ -106,25 +87,27 @@ pattern compilation.

    A GPatternSpec is the 'compiled' form of a pattern. This structure is opaque and its fields cannot be accessed -directly.

    +directly. +


    g_pattern_spec_new ()

    -
    GPatternSpec*       g_pattern_spec_new                  (const gchar *pattern);
    +
    GPatternSpec*       g_pattern_spec_new                  (const gchar *pattern);

    -Compiles a pattern to a GPatternSpec.

    +Compiles a pattern to a GPatternSpec. +

    - - @@ -133,14 +116,15 @@ Compiles a pattern to a

    g_pattern_spec_free ()

    -
    void                g_pattern_spec_free                 (GPatternSpec *pspec);
    +
    void                g_pattern_spec_free                 (GPatternSpec *pspec);

    -Frees the memory allocated for the GPatternSpec.

    +Frees the memory allocated for the GPatternSpec. +

    pattern :

    a zero-terminated UTF-8 encoded string +a zero-terminated UTF-8 encoded string

    Returns :

    a newly-allocated GPatternSpec +a newly-allocated GPatternSpec
    -

    pspec :

    a GPatternSpec +a GPatternSpec
    @@ -148,27 +132,28 @@ Frees the memory allocated for the

    g_pattern_spec_equal ()

    -
    gboolean            g_pattern_spec_equal                (GPatternSpec *pspec1,
    -                                                         GPatternSpec *pspec2);
    +
    gboolean            g_pattern_spec_equal                (GPatternSpec *pspec1,
    +                                                         GPatternSpec *pspec2);

    Compares two compiled pattern specs and returns whether they will -match the same set of strings.

    +match the same set of strings. +

    - - - @@ -177,10 +162,10 @@ match the same set of strings.


    g_pattern_match ()

    -
    gboolean            g_pattern_match                     (GPatternSpec *pspec,
    -                                                         guint string_length,
    -                                                         const gchar *string,
    -                                                         const gchar *string_reversed);
    +
    gboolean            g_pattern_match                     (GPatternSpec *pspec,
    +                                                         guint string_length,
    +                                                         const gchar *string,
    +                                                         const gchar *string_reversed);

    Matches a string against a compiled pattern. Passing the correct length of the string given is mandatory. The reversed string can be @@ -201,34 +186,36 @@ Note also that the reverse of a UTF-8 encoded string can in general not be obtained by g_strreverse(). This works only if the string doesn't contain any multibyte characters. GLib offers the g_utf8_strreverse() function to reverse UTF-8 encoded -strings.

    +strings. +

    pspec1 :

    a GPatternSpec +a GPatternSpec

    pspec2 :

    another GPatternSpec +another GPatternSpec

    Returns :

    Whether the compiled patterns are equal +Whether the compiled patterns are equal
    - - - - - @@ -237,28 +224,30 @@ strings.


    g_pattern_match_string ()

    -
    gboolean            g_pattern_match_string              (GPatternSpec *pspec,
    -                                                         const gchar *string);
    +
    gboolean            g_pattern_match_string              (GPatternSpec *pspec,
    +                                                         const gchar *string);

    Matches a string against a compiled pattern. If the string is to be matched against more than one pattern, consider using -g_pattern_match() instead while supplying the reversed string.

    +g_pattern_match() instead while supplying the reversed string. +

    pspec :

    a GPatternSpec +a GPatternSpec

    string_length :

    the length of string (in bytes, i.e. strlen(), +the length of string (in bytes, i.e. strlen(), not g_utf8_strlen())

    string :

    the UTF-8 encoded string to match +the UTF-8 encoded string to match

    string_reversed :

    the reverse of string or NULL +the reverse of string or NULL

    Returns :

    TRUE if string matches pspec + +TRUE if string matches pspec
    - - - @@ -267,29 +256,31 @@ matched against more than one pattern, consider using

    g_pattern_match_simple ()

    -
    gboolean            g_pattern_match_simple              (const gchar *pattern,
    -                                                         const gchar *string);
    +
    gboolean            g_pattern_match_simple              (const gchar *pattern,
    +                                                         const gchar *string);

    Matches a string against a pattern given as a string. If this function is to be called in a loop, it's more efficient to compile the pattern once with g_pattern_spec_new() and call -g_pattern_match_string() repeatedly.

    +g_pattern_match_string() repeatedly. +

    pspec :

    a GPatternSpec +a GPatternSpec

    string :

    the UTF-8 encoded string to match +the UTF-8 encoded string to match

    Returns :

    TRUE if string matches pspec + +TRUE if string matches pspec
    - - - @@ -299,6 +290,6 @@ the pattern once with
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Hash-Tables.html b/docs/reference/glib/html/glib-Hash-Tables.html index fac40b5..a36b7e0 100644 --- a/docs/reference/glib/html/glib-Hash-Tables.html +++ b/docs/reference/glib/html/glib-Hash-Tables.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    pattern :

    the UTF-8 encoded pattern +the UTF-8 encoded pattern

    string :

    the UTF-8 encoded string to match +the UTF-8 encoded string to match

    Returns :

    TRUE if string matches pspec + +TRUE if string matches pspec
    @@ -62,84 +42,84 @@ #include <glib.h> GHashTable; -GHashTable* g_hash_table_new (GHashFunc hash_func, - GEqualFunc key_equal_func); -GHashTable* g_hash_table_new_full (GHashFunc hash_func, - GEqualFunc key_equal_func, - GDestroyNotify key_destroy_func, - GDestroyNotify value_destroy_func); -guint (*GHashFunc) (gconstpointer key); -gboolean (*GEqualFunc) (gconstpointer a, - gconstpointer b); -voidg_hash_table_insert (GHashTable *hash_table, - gpointer key, - gpointer value); -voidg_hash_table_replace (GHashTable *hash_table, - gpointer key, - gpointer value); -guintg_hash_table_size (GHashTable *hash_table); -gpointerg_hash_table_lookup (GHashTable *hash_table, - gconstpointer key); -gbooleang_hash_table_lookup_extended (GHashTable *hash_table, - gconstpointer lookup_key, - gpointer *orig_key, - gpointer *value); -voidg_hash_table_foreach (GHashTable *hash_table, - GHFunc func, - gpointer user_data); -gpointerg_hash_table_find (GHashTable *hash_table, - GHRFunc predicate, - gpointer user_data); -void (*GHFunc) (gpointer key, - gpointer value, - gpointer user_data); -gbooleang_hash_table_remove (GHashTable *hash_table, - gconstpointer key); -gbooleang_hash_table_steal (GHashTable *hash_table, - gconstpointer key); -guintg_hash_table_foreach_remove (GHashTable *hash_table, - GHRFunc func, - gpointer user_data); -guintg_hash_table_foreach_steal (GHashTable *hash_table, - GHRFunc func, - gpointer user_data); -voidg_hash_table_remove_all (GHashTable *hash_table); -voidg_hash_table_steal_all (GHashTable *hash_table); -GList * g_hash_table_get_keys (GHashTable *hash_table); -GList * g_hash_table_get_values (GHashTable *hash_table); -gboolean (*GHRFunc) (gpointer key, - gpointer value, - gpointer user_data); +GHashTable* g_hash_table_new (GHashFunc hash_func, + GEqualFunc key_equal_func); +GHashTable* g_hash_table_new_full (GHashFunc hash_func, + GEqualFunc key_equal_func, + GDestroyNotify key_destroy_func, + GDestroyNotify value_destroy_func); +guint (*GHashFunc) (gconstpointer key); +gboolean (*GEqualFunc) (gconstpointer a, + gconstpointer b); +voidg_hash_table_insert (GHashTable *hash_table, + gpointer key, + gpointer value); +voidg_hash_table_replace (GHashTable *hash_table, + gpointer key, + gpointer value); +guintg_hash_table_size (GHashTable *hash_table); +gpointerg_hash_table_lookup (GHashTable *hash_table, + gconstpointer key); +gbooleang_hash_table_lookup_extended (GHashTable *hash_table, + gconstpointer lookup_key, + gpointer *orig_key, + gpointer *value); +voidg_hash_table_foreach (GHashTable *hash_table, + GHFunc func, + gpointer user_data); +gpointerg_hash_table_find (GHashTable *hash_table, + GHRFunc predicate, + gpointer user_data); +void (*GHFunc) (gpointer key, + gpointer value, + gpointer user_data); +gbooleang_hash_table_remove (GHashTable *hash_table, + gconstpointer key); +gbooleang_hash_table_steal (GHashTable *hash_table, + gconstpointer key); +guintg_hash_table_foreach_remove (GHashTable *hash_table, + GHRFunc func, + gpointer user_data); +guintg_hash_table_foreach_steal (GHashTable *hash_table, + GHRFunc func, + gpointer user_data); +voidg_hash_table_remove_all (GHashTable *hash_table); +voidg_hash_table_steal_all (GHashTable *hash_table); +GList * g_hash_table_get_keys (GHashTable *hash_table); +GList * g_hash_table_get_values (GHashTable *hash_table); +gboolean (*GHRFunc) (gpointer key, + gpointer value, + gpointer user_data); #define g_hash_table_freeze (hash_table) #define g_hash_table_thaw (hash_table) -voidg_hash_table_destroy (GHashTable *hash_table); -GHashTable* g_hash_table_ref (GHashTable *hash_table); -voidg_hash_table_unref (GHashTable *hash_table); +voidg_hash_table_destroy (GHashTable *hash_table); +GHashTable* g_hash_table_ref (GHashTable *hash_table); +voidg_hash_table_unref (GHashTable *hash_table); GHashTableIter; -voidg_hash_table_iter_init (GHashTableIter *iter, - GHashTable *hash_table); -gbooleang_hash_table_iter_next (GHashTableIter *iter, - gpointer *key, - gpointer *value); -GHashTable* g_hash_table_iter_get_hash_table (GHashTableIter *iter); -voidg_hash_table_iter_remove (GHashTableIter *iter); -voidg_hash_table_iter_steal (GHashTableIter *iter); +voidg_hash_table_iter_init (GHashTableIter *iter, + GHashTable *hash_table); +gbooleang_hash_table_iter_next (GHashTableIter *iter, + gpointer *key, + gpointer *value); +GHashTable* g_hash_table_iter_get_hash_table (GHashTableIter *iter); +voidg_hash_table_iter_remove (GHashTableIter *iter); +voidg_hash_table_iter_steal (GHashTableIter *iter); -gbooleang_direct_equal (gconstpointer v1, - gconstpointer v2); -guintg_direct_hash (gconstpointer v); -gbooleang_int_equal (gconstpointer v1, - gconstpointer v2); -guintg_int_hash (gconstpointer v); -gbooleang_int64_equal (gconstpointer v1, - gconstpointer v2); -guintg_int64_hash (gconstpointer v); -gbooleang_double_equal (gconstpointer v1, - gconstpointer v2); -guintg_double_hash (gconstpointer v); -gbooleang_str_equal (gconstpointer v1, - gconstpointer v2); -guintg_str_hash (gconstpointer v); +gbooleang_direct_equal (gconstpointer v1, + gconstpointer v2); +guintg_direct_hash (gconstpointer v); +gbooleang_int_equal (gconstpointer v1, + gconstpointer v2); +guintg_int_hash (gconstpointer v); +gbooleang_int64_equal (gconstpointer v1, + gconstpointer v2); +guintg_int64_hash (gconstpointer v); +gbooleang_double_equal (gconstpointer v1, + gconstpointer v2); +guintg_double_hash (gconstpointer v); +gbooleang_str_equal (gconstpointer v1, + gconstpointer v2); +guintg_str_hash (gconstpointer v);
    @@ -184,7 +164,8 @@ To call a function for each key and value pair use key/value pairs in the hash table, see GHashTableIter.

    -To destroy a GHashTable use g_hash_table_destroy().

    +To destroy a GHashTable use g_hash_table_destroy(). +

    Details

    @@ -194,21 +175,23 @@ To destroy a GHashTable struct is an opaque data structure to represent a Hash Table. It should only be -accessed via the following functions.

    +accessed via the following functions. +


    g_hash_table_new ()

    -
    GHashTable*         g_hash_table_new                    (GHashFunc hash_func,
    -                                                         GEqualFunc key_equal_func);
    +
    GHashTable*         g_hash_table_new                    (GHashFunc hash_func,
    +                                                         GEqualFunc key_equal_func);

    -Creates a new GHashTable with a reference count of 1.

    +Creates a new GHashTable with a reference count of 1. +

    - -

    hash_func :

    a function to create a hash value from a key. +a function to create a hash value from a key. Hash values are used to determine where keys are stored within the GHashTable data structure. The g_direct_hash(), g_int_hash(), g_int64_hash(), g_double_hash() and g_str_hash() functions are provided @@ -218,7 +201,7 @@ Creates a new key_equal_func :

    a function to check two keys for equality. This is +a function to check two keys for equality. This is used when looking up keys in the GHashTable. The g_direct_equal(), g_int_equal(), g_int64_equal(), g_double_equal() and g_str_equal() functions are provided for the most common types of keys. @@ -237,37 +220,38 @@ Creates a new

    g_hash_table_new_full ()

    -
    GHashTable*         g_hash_table_new_full               (GHashFunc hash_func,
    -                                                         GEqualFunc key_equal_func,
    -                                                         GDestroyNotify key_destroy_func,
    -                                                         GDestroyNotify value_destroy_func);
    +
    GHashTable*         g_hash_table_new_full               (GHashFunc hash_func,
    +                                                         GEqualFunc key_equal_func,
    +                                                         GDestroyNotify key_destroy_func,
    +                                                         GDestroyNotify value_destroy_func);

    Creates a new GHashTable like g_hash_table_new() with a reference count of 1 and allows to specify functions to free the memory allocated for the -key and value that get called when removing the entry from the GHashTable.

    +key and value that get called when removing the entry from the GHashTable. +

    - - - - @@ -283,7 +267,7 @@ key and value that get called when removing the entry from the

    GHashFunc ()

    -
    guint               (*GHashFunc)                        (gconstpointer key);
    +
    guint               (*GHashFunc)                        (gconstpointer key);

    Specifies the type of the hash function which is passed to g_hash_table_new() when a GHashTable is created. @@ -299,18 +283,19 @@ and +for each key lookup. +

    hash_func :

    a function to create a hash value from a key. +a function to create a hash value from a key.

    key_equal_func :

    a function to check two keys for equality. +a function to check two keys for equality.

    key_destroy_func :

    a function to free the memory allocated for the key +a function to free the memory allocated for the key used when removing the entry from the GHashTable or NULL if you don't want to supply such a function.

    value_destroy_func :

    a function to free the memory allocated for the +a function to free the memory allocated for the value used when removing the entry from the GHashTable or NULL if you don't want to supply such a function.
    - - @@ -319,28 +304,30 @@ for each key lookup.


    GEqualFunc ()

    -
    gboolean            (*GEqualFunc)                       (gconstpointer a,
    -                                                         gconstpointer b);
    +
    gboolean            (*GEqualFunc)                       (gconstpointer a,
    +                                                         gconstpointer b);

    Specifies the type of a function used to test two values for equality. The function should return TRUE if both values are equal -and FALSE otherwise.

    +and FALSE otherwise. +

    key :

    a key. +a key.

    Returns :

    the hash value corresponding to the key. +the hash value corresponding to the key.
    - - - @@ -349,9 +336,9 @@ and

    g_hash_table_insert ()

    -
    void                g_hash_table_insert                 (GHashTable *hash_table,
    -                                                         gpointer key,
    -                                                         gpointer value);
    +
    void                g_hash_table_insert                 (GHashTable *hash_table,
    +                                                         gpointer key,
    +                                                         gpointer value);

    Inserts a new key and value into a GHashTable.

    @@ -360,23 +347,24 @@ If the key already exists in the value_destroy_func when creating the GHashTable, the old value is freed using that function. If you supplied a key_destroy_func when creating the GHashTable, the passed key is freed -using that function.

    +using that function. +

    a :

    a value. +a value.

    b :

    a value to compare with. +a value to compare with.

    Returns :

    TRUE if a = b; FALSE otherwise. + +TRUE if a = b; FALSE otherwise.
    - - - @@ -385,32 +373,33 @@ using that function.


    g_hash_table_replace ()

    -
    void                g_hash_table_replace                (GHashTable *hash_table,
    -                                                         gpointer key,
    -                                                         gpointer value);
    +
    void                g_hash_table_replace                (GHashTable *hash_table,
    +                                                         gpointer key,
    +                                                         gpointer value);

    Inserts a new key and value into a GHashTable similar to g_hash_table_insert(). The difference is that if the key already exists in the GHashTable, it gets replaced by the new key. If you supplied a value_destroy_func when creating the GHashTable, the old value is freed using that function. If you supplied a key_destroy_func when creating the -GHashTable, the old key is freed using that function.

    +GHashTable, the old key is freed using that function. +

    hash_table :

    a GHashTable. +a GHashTable.

    key :

    a key to insert. +a key to insert.

    value :

    the value to associate with the key. +the value to associate with the key.
    - - - @@ -419,15 +408,16 @@ using that function. If you supplied a key_destroy_f

    g_hash_table_size ()

    -
    guint               g_hash_table_size                   (GHashTable *hash_table);
    +
    guint               g_hash_table_size                   (GHashTable *hash_table);

    -Returns the number of elements contained in the GHashTable.

    +Returns the number of elements contained in the GHashTable. +

    hash_table :

    a GHashTable. +a GHashTable.

    key :

    a key to insert. +a key to insert.

    value :

    the value to associate with the key. +the value to associate with the key.
    - @@ -441,24 +431,25 @@ Returns the number of elements contained in the

    g_hash_table_lookup ()

    -
    gpointer            g_hash_table_lookup                 (GHashTable *hash_table,
    -                                                         gconstpointer key);
    +
    gpointer            g_hash_table_lookup                 (GHashTable *hash_table,
    +                                                         gconstpointer key);

    Looks up a key in a GHashTable. Note that this function cannot distinguish between a key that is not present and one which is present and has the value NULL. If you need this distinction, use -g_hash_table_lookup_extended().

    +g_hash_table_lookup_extended(). +

    hash_table :

    a GHashTable. +a GHashTable.
    - - @@ -472,10 +463,10 @@ and has the value

    g_hash_table_lookup_extended ()

    -
    gboolean            g_hash_table_lookup_extended        (GHashTable *hash_table,
    -                                                         gconstpointer lookup_key,
    -                                                         gpointer *orig_key,
    -                                                         gpointer *value);
    +
    gboolean            g_hash_table_lookup_extended        (GHashTable *hash_table,
    +                                                         gconstpointer lookup_key,
    +                                                         gpointer *orig_key,
    +                                                         gpointer *value);

    Looks up a key in the GHashTable, returning the original key and the associated value and a gboolean which is TRUE if the key was found. This @@ -484,28 +475,29 @@ for example before calling NULL for lookup_key to test -whether the NULL key exists.

    +whether the NULL key exists. +

    hash_table :

    a GHashTable. +a GHashTable.

    key :

    the key to look up. +the key to look up.
    - - - - @@ -519,9 +511,9 @@ whether the

    g_hash_table_foreach ()

    -
    void                g_hash_table_foreach                (GHashTable *hash_table,
    -                                                         GHFunc func,
    -                                                         gpointer user_data);
    +
    void                g_hash_table_foreach                (GHashTable *hash_table,
    +                                                         GHFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each of the key/value pairs in the GHashTable. The function is passed the key and value of each @@ -532,23 +524,24 @@ items). To remove all items matching a predicate, use

    See g_hash_table_find() for performance caveats for linear -order searches in contrast to g_hash_table_lookup().

    +order searches in contrast to g_hash_table_lookup(). +

    hash_table :

    a GHashTable +a GHashTable

    lookup_key :

    the key to look up +the key to look up

    orig_key :

    return location for the original key, or NULL +return location for the original key, or NULL

    value :

    return location for the value associated with the key, or NULL +return location for the value associated with the key, or NULL
    - - - @@ -557,9 +550,9 @@ order searches in contrast to

    g_hash_table_find ()

    -
    gpointer            g_hash_table_find                   (GHashTable *hash_table,
    -                                                         GHRFunc predicate,
    -                                                         gpointer user_data);
    +
    gpointer            g_hash_table_find                   (GHashTable *hash_table,
    +                                                         GHRFunc predicate,
    +                                                         gpointer user_data);

    Calls the given function for key/value pairs in the GHashTable until predicate returns TRUE. The function is passed the key and value of @@ -574,23 +567,24 @@ So code that frequently issues

    hash_table :

    a GHashTable. +a GHashTable.

    func :

    the function to call for each key/value pair. +the function to call for each key/value pair.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    - - - @@ -608,29 +602,30 @@ func evaluates to

    GHFunc ()

    -
    void                (*GHFunc)                           (gpointer key,
    -                                                         gpointer value,
    -                                                         gpointer user_data);
    +
    void                (*GHFunc)                           (gpointer key,
    +                                                         gpointer value,
    +                                                         gpointer user_data);

    Specifies the type of the function passed to g_hash_table_foreach(). It is called with each key/value pair, together with the user_data -parameter which is passed to g_hash_table_foreach().

    +parameter which is passed to g_hash_table_foreach(). +

    hash_table :

    a GHashTable. +a GHashTable.

    predicate :

    function to test the key/value pairs for a certain property. +function to test the key/value pairs for a certain property.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    - - - @@ -639,8 +634,8 @@ parameter which is passed to

    g_hash_table_remove ()

    -
    gboolean            g_hash_table_remove                 (GHashTable *hash_table,
    -                                                         gconstpointer key);
    +
    gboolean            g_hash_table_remove                 (GHashTable *hash_table,
    +                                                         gconstpointer key);

    Removes a key and its associated value from a GHashTable.

    @@ -648,18 +643,19 @@ Removes a key and its associated value from a GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed -yourself.

    +yourself. +

    key :

    a key. +a key.

    value :

    the value corresponding to the key. +the value corresponding to the key.

    user_data :

    user data passed to g_hash_table_foreach(). +user data passed to g_hash_table_foreach().
    - - @@ -673,22 +669,23 @@ yourself.


    g_hash_table_steal ()

    -
    gboolean            g_hash_table_steal                  (GHashTable *hash_table,
    -                                                         gconstpointer key);
    +
    gboolean            g_hash_table_steal                  (GHashTable *hash_table,
    +                                                         gconstpointer key);

    Removes a key and its associated value from a GHashTable without -calling the key and value destroy functions.

    +calling the key and value destroy functions. +

    hash_table :

    a GHashTable. +a GHashTable.

    key :

    the key to remove. +the key to remove.
    - - @@ -702,9 +699,9 @@ calling the key and value destroy functions.


    g_hash_table_foreach_remove ()

    -
    guint               g_hash_table_foreach_remove         (GHashTable *hash_table,
    -                                                         GHRFunc func,
    -                                                         gpointer user_data);
    +
    guint               g_hash_table_foreach_remove         (GHashTable *hash_table,
    +                                                         GHRFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each key/value pair in the GHashTable. If the function returns TRUE, then the key/value pair is removed from the @@ -714,23 +711,24 @@ keys and values.

    See GHashTableIter for an alternative way to loop over the -key/value pairs in the hash table.

    +key/value pairs in the hash table. +

    hash_table :

    a GHashTable. +a GHashTable.

    key :

    the key to remove. +the key to remove.
    - - - @@ -744,9 +742,9 @@ key/value pairs in the hash table.


    g_hash_table_foreach_steal ()

    -
    guint               g_hash_table_foreach_steal          (GHashTable *hash_table,
    -                                                         GHRFunc func,
    -                                                         gpointer user_data);
    +
    guint               g_hash_table_foreach_steal          (GHashTable *hash_table,
    +                                                         GHRFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each key/value pair in the GHashTable. If the function returns TRUE, then the key/value pair is removed from the @@ -754,23 +752,24 @@ If the function returns GHashTableIter for an alternative way to loop over the -key/value pairs in the hash table.

    +key/value pairs in the hash table. +

    hash_table :

    a GHashTable. +a GHashTable.

    func :

    the function to call for each key/value pair. +the function to call for each key/value pair.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    - - - @@ -784,7 +783,7 @@ key/value pairs in the hash table.


    g_hash_table_remove_all ()

    -
    void                g_hash_table_remove_all             (GHashTable *hash_table);
    +
    void                g_hash_table_remove_all             (GHashTable *hash_table);

    Removes all keys and their associated values from a GHashTable.

    @@ -792,12 +791,13 @@ Removes all keys and their associated values from a GHashTable was created using g_hash_table_new_full(), the keys and values are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed -yourself.

    +yourself. +

    hash_table :

    a GHashTable. +a GHashTable.

    func :

    the function to call for each key/value pair. +the function to call for each key/value pair.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    -

    hash_table :

    a GHashTable +a GHashTable
    @@ -806,15 +806,16 @@ yourself.


    g_hash_table_steal_all ()

    -
    void                g_hash_table_steal_all              (GHashTable *hash_table);
    +
    void                g_hash_table_steal_all              (GHashTable *hash_table);

    Removes all keys and their associated values from a GHashTable -without calling the key and value destroy functions.

    +without calling the key and value destroy functions. +

    -

    hash_table :

    a GHashTable. +a GHashTable.
    @@ -823,16 +824,17 @@ without calling the key and value destroy functions.


    g_hash_table_get_keys ()

    -
    GList *             g_hash_table_get_keys               (GHashTable *hash_table);
    +
    GList *             g_hash_table_get_keys               (GHashTable *hash_table);

    Retrieves every key inside hash_table. The returned data is valid -until hash_table is modified.

    +until hash_table is modified. +

    - @@ -851,16 +853,17 @@ until hash_table is modified.


    g_hash_table_get_values ()

    -
    GList *             g_hash_table_get_values             (GHashTable *hash_table);
    +
    GList *             g_hash_table_get_values             (GHashTable *hash_table);

    Retrieves every value inside hash_table. The returned data is -valid until hash_table is modified.

    +valid until hash_table is modified. +

    hash_table :

    a GHashTable +a GHashTable
    - @@ -879,36 +882,38 @@ valid until hash_table is modified.


    GHRFunc ()

    -
    gboolean            (*GHRFunc)                          (gpointer key,
    -                                                         gpointer value,
    -                                                         gpointer user_data);
    +
    gboolean            (*GHRFunc)                          (gpointer key,
    +                                                         gpointer value,
    +                                                         gpointer user_data);

    Specifies the type of the function passed to g_hash_table_foreach_remove(). It is called with each key/value pair, together with the user_data parameter passed to g_hash_table_foreach_remove(). It should return TRUE if the -key/value pair should be removed from the GHashTable.

    +key/value pair should be removed from the GHashTable. +

    hash_table :

    a GHashTable +a GHashTable
    - - - - @@ -925,12 +930,13 @@ key/value pair should be removed from the

    key :

    a key. +a key.

    value :

    the value associated with the key. +the value associated with the key.

    user_data :

    user data passed to g_hash_table_remove(). +user data passed to g_hash_table_remove().

    Returns :

    TRUE if the key/value pair should be removed from the + +TRUE if the key/value pair should be removed from the GHashTable.
    -

    hash_table :

    a GHashTable +a GHashTable
    @@ -945,12 +951,13 @@ release of GLib. It does nothing.

    This function is deprecated and will be removed in the next major -release of GLib. It does nothing.

    +release of GLib. It does nothing. +

    -

    hash_table :

    a GHashTable +a GHashTable
    @@ -958,19 +965,20 @@ release of GLib. It does nothing.


    g_hash_table_destroy ()

    -
    void                g_hash_table_destroy                (GHashTable *hash_table);
    +
    void                g_hash_table_destroy                (GHashTable *hash_table);

    Destroys all keys and values in the GHashTable and decrements its reference count by 1. If keys and/or values are dynamically allocated, you should either free them first or create the GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the -destruction phase.

    +destruction phase. +

    -

    hash_table :

    a GHashTable. +a GHashTable.
    @@ -978,16 +986,17 @@ destruction phase.


    g_hash_table_ref ()

    -
    GHashTable*         g_hash_table_ref                    (GHashTable *hash_table);
    +
    GHashTable*         g_hash_table_ref                    (GHashTable *hash_table);

    Atomically increments the reference count of hash_table by one. -This function is MT-safe and may be called from any thread.

    +This function is MT-safe and may be called from any thread. +

    - @@ -1003,17 +1012,18 @@ This function is MT-safe and may be called from any thread.


    g_hash_table_unref ()

    -
    void                g_hash_table_unref                  (GHashTable *hash_table);
    +
    void                g_hash_table_unref                  (GHashTable *hash_table);

    Atomically decrements the reference count of hash_table by one. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. -This function is MT-safe and may be called from any thread.

    +This function is MT-safe and may be called from any thread. +

    hash_table :

    a valid GHashTable. +a valid GHashTable.
    -

    hash_table :

    a valid GHashTable. +a valid GHashTable.
    @@ -1029,39 +1039,57 @@ This function is MT-safe and may be called from any thread.

    A GHashTableIter structure represents an iterator that can be used to iterate over the elements of a GHashTable. GHashTableIter structures are typically allocated on the stack and then initialized -with g_hash_table_iter_init().

    +with g_hash_table_iter_init(). +


    g_hash_table_iter_init ()

    -
    void                g_hash_table_iter_init              (GHashTableIter *iter,
    -                                                         GHashTable *hash_table);
    +
    void                g_hash_table_iter_init              (GHashTableIter *iter,
    +                                                         GHashTable *hash_table);

    Initializes a key/value pair iterator and associates it with hash_table. Modifying the hash table after calling this function invalidates the returned iterator.

    -
    -GHashTableIter iter;
    -gpointer key, value;
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    GHashTableIter iter;
    +gpointer key, value;
    +
    +g_hash_table_iter_init (&iter, hash_table);
    +while (g_hash_table_iter_next (&iter, &key, &value)) 
    +  {
    +    /* do something with key and value */
    +  }
    +
    -g_hash_table_iter_init (&iter, hash_table); -while (g_hash_table_iter_next (&iter, &key, &value)) - { - /* do something with key and value */ - } -
    +

    +

    - - @@ -1071,29 +1099,30 @@ while (g_hash_table_iter_next (&iter, &key, &value))

    g_hash_table_iter_next ()

    -
    gboolean            g_hash_table_iter_next              (GHashTableIter *iter,
    -                                                         gpointer *key,
    -                                                         gpointer *value);
    +
    gboolean            g_hash_table_iter_next              (GHashTableIter *iter,
    +                                                         gpointer *key,
    +                                                         gpointer *value);

    Advances iter and retrieves the key and/or value that are now pointed to as a result of this advancement. If FALSE is returned, -key and value are not set, and the iterator becomes invalid.

    +key and value are not set, and the iterator becomes invalid. +

    iter :

    an uninitialized GHashTableIter. +an uninitialized GHashTableIter.

    hash_table :

    a GHashTable. +a GHashTable.
    - - - @@ -1109,15 +1138,16 @@ pointed to as a result of this advancement. If

    g_hash_table_iter_get_hash_table ()

    -
    GHashTable*         g_hash_table_iter_get_hash_table    (GHashTableIter *iter);
    +
    GHashTable*         g_hash_table_iter_get_hash_table    (GHashTableIter *iter);

    -Returns the GHashTable associated with iter.

    +Returns the GHashTable associated with iter. +

    iter :

    an initialized GHashTableIter. +an initialized GHashTableIter.

    key :

    a location to store the key, or NULL. +a location to store the key, or NULL.

    value :

    a location to store the value, or NULL. +a location to store the value, or NULL.
    - @@ -1133,7 +1163,7 @@ Returns the

    g_hash_table_iter_remove ()

    -
    void                g_hash_table_iter_remove            (GHashTableIter *iter);
    +
    void                g_hash_table_iter_remove            (GHashTableIter *iter);

    Removes the key/value pair currently pointed to by the iterator from its associated GHashTable. Can only be called after @@ -1144,12 +1174,13 @@ than once for the same key/value pair. If the GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed -yourself.

    +yourself. +

    iter :

    an initialized GHashTableIter. +an initialized GHashTableIter.
    -

    iter :

    an initialized GHashTableIter. +an initialized GHashTableIter.
    @@ -1158,18 +1189,19 @@ yourself.


    g_hash_table_iter_steal ()

    -
    void                g_hash_table_iter_steal             (GHashTableIter *iter);
    +
    void                g_hash_table_iter_steal             (GHashTableIter *iter);

    Removes the key/value pair currently pointed to by the iterator from its associated GHashTable, without calling the key and value destroy functions. Can only be called after g_hash_table_iter_next() returned TRUE, and cannot be called more -than once for the same key/value pair.

    +than once for the same key/value pair. +

    -

    iter :

    an initialized GHashTableIter. +an initialized GHashTableIter.
    @@ -1178,23 +1210,24 @@ than once for the same key/value pair.


    g_direct_equal ()

    -
    gboolean            g_direct_equal                      (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            g_direct_equal                      (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares two gpointer arguments and returns TRUE if they are equal. It can be passed to g_hash_table_new() as the key_equal_func -parameter, when using pointers as keys in a GHashTable.

    +parameter, when using pointers as keys in a GHashTable. +

    - - @@ -1208,17 +1241,18 @@ parameter, when using pointers as keys in a

    g_direct_hash ()

    -
    guint               g_direct_hash                       (gconstpointer v);
    +
    guint               g_direct_hash                       (gconstpointer v);

    Converts a gpointer to a hash value. It can be passed to g_hash_table_new() as the hash_func parameter, -when using pointers as keys in a GHashTable.

    +when using pointers as keys in a GHashTable. +

    v1 :

    a key. +a key.

    v2 :

    a key to compare with v1. +a key to compare with v1.
    - @@ -1232,24 +1266,25 @@ when using pointers as keys in a

    g_int_equal ()

    -
    gboolean            g_int_equal                         (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            g_int_equal                         (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares the two gint values being pointed to and returns TRUE if they are equal. It can be passed to g_hash_table_new() as the key_equal_func -parameter, when using pointers to integers as keys in a GHashTable.

    +parameter, when using pointers to integers as keys in a GHashTable. +

    v :

    a gpointer key +a gpointer key
    - - @@ -1263,17 +1298,18 @@ parameter, when using pointers to integers as keys in a

    g_int_hash ()

    -
    guint               g_int_hash                          (gconstpointer v);
    +
    guint               g_int_hash                          (gconstpointer v);

    Converts a pointer to a gint to a hash value. It can be passed to g_hash_table_new() as the hash_func parameter, -when using pointers to integers values as keys in a GHashTable.

    +when using pointers to integers values as keys in a GHashTable. +

    v1 :

    a pointer to a gint key. +a pointer to a gint key.

    v2 :

    a pointer to a gint key to compare with v1. +a pointer to a gint key to compare with v1.
    - @@ -1287,24 +1323,25 @@ when using pointers to integers values as keys in a

    g_int64_equal ()

    -
    gboolean            g_int64_equal                       (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            g_int64_equal                       (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares the two gint64 values being pointed to and returns TRUE if they are equal. It can be passed to g_hash_table_new() as the key_equal_func -parameter, when using pointers to 64-bit integers as keys in a GHashTable.

    +parameter, when using pointers to 64-bit integers as keys in a GHashTable. +

    v :

    a pointer to a gint key +a pointer to a gint key
    - - @@ -1320,17 +1357,18 @@ parameter, when using pointers to 64-bit integers as keys in a

    g_int64_hash ()

    -
    guint               g_int64_hash                        (gconstpointer v);
    +
    guint               g_int64_hash                        (gconstpointer v);

    Converts a pointer to a gint64 to a hash value. It can be passed to g_hash_table_new() as the hash_func parameter, -when using pointers to 64-bit integers values as keys in a GHashTable.

    +when using pointers to 64-bit integers values as keys in a GHashTable. +

    v1 :

    a pointer to a gint64 key. +a pointer to a gint64 key.

    v2 :

    a pointer to a gint64 key to compare with v1. +a pointer to a gint64 key to compare with v1.
    - @@ -1346,24 +1384,25 @@ when using pointers to 64-bit integers values as keys in a

    g_double_equal ()

    -
    gboolean            g_double_equal                      (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            g_double_equal                      (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares the two gdouble values being pointed to and returns TRUE if they are equal. It can be passed to g_hash_table_new() as the key_equal_func -parameter, when using pointers to doubles as keys in a GHashTable.

    +parameter, when using pointers to doubles as keys in a GHashTable. +

    v :

    a pointer to a gint64 key +a pointer to a gint64 key
    - - @@ -1379,17 +1418,18 @@ parameter, when using pointers to doubles as keys in a

    g_double_hash ()

    -
    guint               g_double_hash                       (gconstpointer v);
    +
    guint               g_double_hash                       (gconstpointer v);

    Converts a pointer to a gdouble to a hash value. It can be passed to g_hash_table_new() as the hash_func parameter, -when using pointers to doubles as keys in a GHashTable.

    +when using pointers to doubles as keys in a GHashTable. +

    v1 :

    a pointer to a gdouble key. +a pointer to a gdouble key.

    v2 :

    a pointer to a gdouble key to compare with v1. +a pointer to a gdouble key to compare with v1.
    - @@ -1405,8 +1445,8 @@ when using pointers to doubles as keys in a

    g_str_equal ()

    -
    gboolean            g_str_equal                         (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            g_str_equal                         (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares two strings for byte-by-byte equality and returns TRUE if they are equal. It can be passed to g_hash_table_new() as the @@ -1415,18 +1455,19 @@ if they are equal. It can be passed to NULL-safe string comparison function, -see g_strcmp0().

    +see g_strcmp0(). +

    v :

    a pointer to a gdouble key +a pointer to a gdouble key
    - - @@ -1440,17 +1481,18 @@ see

    g_str_hash ()

    -
    guint               g_str_hash                          (gconstpointer v);
    +
    guint               g_str_hash                          (gconstpointer v);

    Converts a string to a hash value. It can be passed to g_hash_table_new() as the hash_func -parameter, when using strings as keys in a GHashTable.

    +parameter, when using strings as keys in a GHashTable. +

    v1 :

    a key +a key

    v2 :

    a key to compare with v1 +a key to compare with v1
    - @@ -1465,6 +1507,6 @@ parameter, when using strings as keys in a
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Hook-Functions.html b/docs/reference/glib/html/glib-Hook-Functions.html index afd3b17..d967415 100644 --- a/docs/reference/glib/html/glib-Hook-Functions.html +++ b/docs/reference/glib/html/glib-Hook-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    v :

    a string key +a string key
    @@ -61,71 +41,72 @@ #include <glib.h> GHookList; -void (*GHookFinalizeFunc) (GHookList *hook_list, - GHook *hook); +void (*GHookFinalizeFunc) (GHookList *hook_list, + GHook *hook); GHook; -void (*GHookFunc) (gpointer data); -gboolean (*GHookCheckFunc) (gpointer data); +void (*GHookFunc) (gpointer data); +gboolean (*GHookCheckFunc) (gpointer data); -voidg_hook_list_init (GHookList *hook_list, - guint hook_size); -voidg_hook_list_invoke (GHookList *hook_list, - gboolean may_recurse); -voidg_hook_list_invoke_check (GHookList *hook_list, - gboolean may_recurse); -voidg_hook_list_marshal (GHookList *hook_list, - gboolean may_recurse, - GHookMarshaller marshaller, - gpointer marshal_data); -void (*GHookMarshaller) (GHook *hook, - gpointer marshal_data); -voidg_hook_list_marshal_check (GHookList *hook_list, - gboolean may_recurse, - GHookCheckMarshaller marshaller, - gpointer marshal_data); -gboolean (*GHookCheckMarshaller) (GHook *hook, - gpointer marshal_data); -voidg_hook_list_clear (GHookList *hook_list); +voidg_hook_list_init (GHookList *hook_list, + guint hook_size); +voidg_hook_list_invoke (GHookList *hook_list, + gboolean may_recurse); +voidg_hook_list_invoke_check (GHookList *hook_list, + gboolean may_recurse); +voidg_hook_list_marshal (GHookList *hook_list, + gboolean may_recurse, + GHookMarshaller marshaller, + gpointer marshal_data); +void (*GHookMarshaller) (GHook *hook, + gpointer marshal_data); +voidg_hook_list_marshal_check (GHookList *hook_list, + gboolean may_recurse, + GHookCheckMarshaller marshaller, + gpointer marshal_data); +gboolean (*GHookCheckMarshaller) (GHook *hook, + gpointer marshal_data); +voidg_hook_list_clear (GHookList *hook_list); -GHook* g_hook_alloc (GHookList *hook_list); -#define g_hook_append ( hook_list, hook ) -voidg_hook_prepend (GHookList *hook_list, - GHook *hook); -voidg_hook_insert_before (GHookList *hook_list, - GHook *sibling, - GHook *hook); -voidg_hook_insert_sorted (GHookList *hook_list, - GHook *hook, - GHookCompareFunc func); -gint (*GHookCompareFunc) (GHook *new_hook, - GHook *sibling); -gintg_hook_compare_ids (GHook *new_hook, - GHook *sibling); +GHook* g_hook_alloc (GHookList *hook_list); +#define g_hook_append (hook_list, + hook) +voidg_hook_prepend (GHookList *hook_list, + GHook *hook); +voidg_hook_insert_before (GHookList *hook_list, + GHook *sibling, + GHook *hook); +voidg_hook_insert_sorted (GHookList *hook_list, + GHook *hook, + GHookCompareFunc func); +gint (*GHookCompareFunc) (GHook *new_hook, + GHook *sibling); +gintg_hook_compare_ids (GHook *new_hook, + GHook *sibling); -GHook* g_hook_get (GHookList *hook_list, - gulong hook_id); -GHook* g_hook_find (GHookList *hook_list, - gboolean need_valids, - GHookFindFunc func, - gpointer data); -gboolean (*GHookFindFunc) (GHook *hook, - gpointer data); -GHook* g_hook_find_data (GHookList *hook_list, - gboolean need_valids, - gpointer data); -GHook* g_hook_find_func (GHookList *hook_list, - gboolean need_valids, - gpointer func); -GHook* g_hook_find_func_data (GHookList *hook_list, - gboolean need_valids, - gpointer func, - gpointer data); +GHook* g_hook_get (GHookList *hook_list, + gulong hook_id); +GHook* g_hook_find (GHookList *hook_list, + gboolean need_valids, + GHookFindFunc func, + gpointer data); +gboolean (*GHookFindFunc) (GHook *hook, + gpointer data); +GHook* g_hook_find_data (GHookList *hook_list, + gboolean need_valids, + gpointer data); +GHook* g_hook_find_func (GHookList *hook_list, + gboolean need_valids, + gpointer func); +GHook* g_hook_find_func_data (GHookList *hook_list, + gboolean need_valids, + gpointer func, + gpointer data); -GHook* g_hook_first_valid (GHookList *hook_list, - gboolean may_be_in_call); -GHook* g_hook_next_valid (GHookList *hook_list, - GHook *hook, - gboolean may_be_in_call); +GHook* g_hook_first_valid (GHookList *hook_list, + gboolean may_be_in_call); +GHook* g_hook_next_valid (GHookList *hook_list, + GHook *hook, + gboolean may_be_in_call); enum GHookFlagMask; #define G_HOOK_FLAGS (hook) #define G_HOOK_FLAG_USER_SHIFT @@ -136,16 +117,16 @@ enum G_HOOK_IN_CALL (hook) #define G_HOOK_IS_UNLINKED (hook) -GHook * g_hook_ref (GHookList *hook_list, - GHook *hook); -voidg_hook_unref (GHookList *hook_list, - GHook *hook); -voidg_hook_free (GHookList *hook_list, - GHook *hook); -gbooleang_hook_destroy (GHookList *hook_list, - gulong hook_id); -voidg_hook_destroy_link (GHookList *hook_list, - GHook *hook); +GHook * g_hook_ref (GHookList *hook_list, + GHook *hook); +voidg_hook_unref (GHookList *hook_list, + GHook *hook); +voidg_hook_free (GHookList *hook_list, + GHook *hook); +gbooleang_hook_destroy (GHookList *hook_list, + gulong hook_id); +voidg_hook_destroy_link (GHookList *hook_list, + GHook *hook);
    @@ -219,8 +200,8 @@ default behaviour is to call the hooks destroy fun

    GHookFinalizeFunc ()

    -
    void                (*GHookFinalizeFunc)                (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    void                (*GHookFinalizeFunc)                (GHookList *hook_list,
    +                                                         GHook *hook);

    Defines the type of function to be called when a hook in a list of hooks gets finalized. @@ -311,7 +292,7 @@ signatures for this function are

    GHookFunc ()

    -
    void                (*GHookFunc)                        (gpointer data);
    +
    void                (*GHookFunc)                        (gpointer data);

    Defines the type of a hook function that can be invoked by g_hook_list_invoke(). @@ -328,7 +309,7 @@ by

    GHookCheckFunc ()

    -
    gboolean            (*GHookCheckFunc)                   (gpointer data);
    +
    gboolean            (*GHookCheckFunc)                   (gpointer data);

    Defines the type of a hook function that can be invoked by g_hook_list_invoke_check(). @@ -353,8 +334,8 @@ by

    g_hook_list_init ()

    -
    void                g_hook_list_init                    (GHookList *hook_list,
    -                                                         guint hook_size);
    +
    void                g_hook_list_init                    (GHookList *hook_list,
    +                                                         guint hook_size);

    Initializes a GHookList. This must be called before the GHookList is used. @@ -379,8 +360,8 @@ This must be called before the

    g_hook_list_invoke ()

    -
    void                g_hook_list_invoke                  (GHookList *hook_list,
    -                                                         gboolean may_recurse);
    +
    void                g_hook_list_invoke                  (GHookList *hook_list,
    +                                                         gboolean may_recurse);

    Calls all of the GHook functions in a GHookList.

    @@ -405,8 +386,8 @@ Calls all of the

    g_hook_list_invoke_check ()

    -
    void                g_hook_list_invoke_check            (GHookList *hook_list,
    -                                                         gboolean may_recurse);
    +
    void                g_hook_list_invoke_check            (GHookList *hook_list,
    +                                                         gboolean may_recurse);

    Calls all of the GHook functions in a GHookList. Any function which returns FALSE is removed from the GHookList. @@ -432,10 +413,10 @@ thread) can be called. If set to

    g_hook_list_marshal ()

    -
    void                g_hook_list_marshal                 (GHookList *hook_list,
    -                                                         gboolean may_recurse,
    -                                                         GHookMarshaller marshaller,
    -                                                         gpointer marshal_data);
    +
    void                g_hook_list_marshal                 (GHookList *hook_list,
    +                                                         gboolean may_recurse,
    +                                                         GHookMarshaller marshaller,
    +                                                         gpointer marshal_data);

    Calls a function on each valid GHook.

    @@ -470,8 +451,8 @@ Calls a function on each valid

    GHookMarshaller ()

    -
    void                (*GHookMarshaller)                  (GHook *hook,
    -                                                         gpointer marshal_data);
    +
    void                (*GHookMarshaller)                  (GHook *hook,
    +                                                         gpointer marshal_data);

    Defines the type of function used by g_hook_list_marshal().

    @@ -494,10 +475,10 @@ Defines the type of function used by

    g_hook_list_marshal_check ()

    -
    void                g_hook_list_marshal_check           (GHookList *hook_list,
    -                                                         gboolean may_recurse,
    -                                                         GHookCheckMarshaller marshaller,
    -                                                         gpointer marshal_data);
    +
    void                g_hook_list_marshal_check           (GHookList *hook_list,
    +                                                         gboolean may_recurse,
    +                                                         GHookCheckMarshaller marshaller,
    +                                                         gpointer marshal_data);

    Calls a function on each valid GHook and destroys it if the function returns FALSE. @@ -533,8 +514,8 @@ function returns

    GHookCheckMarshaller ()

    -
    gboolean            (*GHookCheckMarshaller)             (GHook *hook,
    -                                                         gpointer marshal_data);
    +
    gboolean            (*GHookCheckMarshaller)             (GHook *hook,
    +                                                         gpointer marshal_data);

    Defines the type of function used by g_hook_list_marshal_check().

    @@ -563,7 +544,7 @@ Defines the type of function used by

    g_hook_list_clear ()

    -
    void                g_hook_list_clear                   (GHookList *hook_list);
    +
    void                g_hook_list_clear                   (GHookList *hook_list);

    Removes all the GHook elements from a GHookList.

    @@ -579,7 +560,7 @@ Removes all the

    g_hook_alloc ()

    -
    GHook*              g_hook_alloc                        (GHookList *hook_list);
    +
    GHook*              g_hook_alloc                        (GHookList *hook_list);

    Allocates space for a GHook and initializes it.

    @@ -625,8 +606,8 @@ Appends a

    g_hook_prepend ()

    -
    void                g_hook_prepend                      (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    void                g_hook_prepend                      (GHookList *hook_list,
    +                                                         GHook *hook);

    Prepends a GHook on the start of a GHookList.

    @@ -649,9 +630,9 @@ Prepends a <

    g_hook_insert_before ()

    -
    void                g_hook_insert_before                (GHookList *hook_list,
    -                                                         GHook *sibling,
    -                                                         GHook *hook);
    +
    void                g_hook_insert_before                (GHookList *hook_list,
    +                                                         GHook *sibling,
    +                                                         GHook *hook);

    Inserts a GHook into a GHookList, before a given GHook.

    @@ -679,9 +660,9 @@ Inserts a

    g_hook_insert_sorted ()

    -
    void                g_hook_insert_sorted                (GHookList *hook_list,
    -                                                         GHook *hook,
    -                                                         GHookCompareFunc func);
    +
    void                g_hook_insert_sorted                (GHookList *hook_list,
    +                                                         GHook *hook,
    +                                                         GHookCompareFunc func);

    Inserts a GHook into a GHookList, sorted by the given function.

    @@ -709,8 +690,8 @@ Inserts a

    GHookCompareFunc ()

    -
    gint                (*GHookCompareFunc)                 (GHook *new_hook,
    -                                                         GHook *sibling);
    +
    gint                (*GHookCompareFunc)                 (GHook *new_hook,
    +                                                         GHook *sibling);

    Defines the type of function used to compare GHook elements in g_hook_insert_sorted(). @@ -739,8 +720,8 @@ Defines the type of function used to compare

    g_hook_compare_ids ()

    -
    gint                g_hook_compare_ids                  (GHook *new_hook,
    -                                                         GHook *sibling);
    +
    gint                g_hook_compare_ids                  (GHook *new_hook,
    +                                                         GHook *sibling);

    Compares the ids of two GHook elements, returning a negative value if the second id is greater than the first. @@ -769,8 +750,8 @@ if the second id is greater than the first.


    g_hook_get ()

    -
    GHook*              g_hook_get                          (GHookList *hook_list,
    -                                                         gulong hook_id);
    +
    GHook*              g_hook_get                          (GHookList *hook_list,
    +                                                         gulong hook_id);

    Returns the GHook with the given id, or NULL if it is not found.

    @@ -798,10 +779,10 @@ Returns the

    g_hook_find ()

    -
    GHook*              g_hook_find                         (GHookList *hook_list,
    -                                                         gboolean need_valids,
    -                                                         GHookFindFunc func,
    -                                                         gpointer data);
    +
    GHook*              g_hook_find                         (GHookList *hook_list,
    +                                                         gboolean need_valids,
    +                                                         GHookFindFunc func,
    +                                                         gpointer data);

    Finds a GHook in a GHookList using the given function to test for a match.

    @@ -842,8 +823,8 @@ Finds a

    GHookFindFunc ()

    -
    gboolean            (*GHookFindFunc)                    (GHook *hook,
    -                                                         gpointer data);
    +
    gboolean            (*GHookFindFunc)                    (GHook *hook,
    +                                                         gpointer data);

    Defines the type of the function passed to g_hook_find().

    @@ -872,9 +853,9 @@ Defines the type of the function passed to

    g_hook_find_data ()

    -
    GHook*              g_hook_find_data                    (GHookList *hook_list,
    -                                                         gboolean need_valids,
    -                                                         gpointer data);
    +
    GHook*              g_hook_find_data                    (GHookList *hook_list,
    +                                                         gboolean need_valids,
    +                                                         gpointer data);

    Finds a GHook in a GHookList with the given data.

    @@ -910,9 +891,9 @@ Finds a

    g_hook_find_func ()

    -
    GHook*              g_hook_find_func                    (GHookList *hook_list,
    -                                                         gboolean need_valids,
    -                                                         gpointer func);
    +
    GHook*              g_hook_find_func                    (GHookList *hook_list,
    +                                                         gboolean need_valids,
    +                                                         gpointer func);

    Finds a GHook in a GHookList with the given function.

    @@ -948,10 +929,10 @@ Finds a

    g_hook_find_func_data ()

    -
    GHook*              g_hook_find_func_data               (GHookList *hook_list,
    -                                                         gboolean need_valids,
    -                                                         gpointer func,
    -                                                         gpointer data);
    +
    GHook*              g_hook_find_func_data               (GHookList *hook_list,
    +                                                         gboolean need_valids,
    +                                                         gpointer func,
    +                                                         gpointer data);

    Finds a GHook in a GHookList with the given function and data.

    @@ -992,8 +973,8 @@ Finds a

    g_hook_first_valid ()

    -
    GHook*              g_hook_first_valid                  (GHookList *hook_list,
    -                                                         gboolean may_be_in_call);
    +
    GHook*              g_hook_first_valid                  (GHookList *hook_list,
    +                                                         gboolean may_be_in_call);

    Returns the first GHook in a GHookList which has not been destroyed. The reference count for the GHook is incremented, so you must call @@ -1026,9 +1007,9 @@ The reference count for the

    g_hook_next_valid ()

    -
    GHook*              g_hook_next_valid                   (GHookList *hook_list,
    -                                                         GHook *hook,
    -                                                         gboolean may_be_in_call);
    +
    GHook*              g_hook_next_valid                   (GHookList *hook_list,
    +                                                         GHook *hook,
    +                                                         gboolean may_be_in_call);

    Returns the next GHook in a GHookList which has not been destroyed. The reference count for the GHook is incremented, so you must call @@ -1245,8 +1226,8 @@ Returns


    g_hook_ref ()

    -
    GHook *             g_hook_ref                          (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    GHook *             g_hook_ref                          (GHookList *hook_list,
    +                                                         GHook *hook);

    Increments the reference count for a GHook.

    @@ -1274,8 +1255,8 @@ Increments the reference count for a

    g_hook_unref ()

    -
    void                g_hook_unref                        (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    void                g_hook_unref                        (GHookList *hook_list,
    +                                                         GHook *hook);

    Decrements the reference count of a GHook. If the reference count falls to 0, the GHook is removed from the GHookList @@ -1300,8 +1281,8 @@ and

    g_hook_free ()

    -
    void                g_hook_free                         (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    void                g_hook_free                         (GHookList *hook_list,
    +                                                         GHook *hook);

    Calls the GHookList finalize_hook function if it exists, and frees the memory allocated for the GHook. @@ -1325,8 +1306,8 @@ allocated for the

    g_hook_destroy ()

    -
    gboolean            g_hook_destroy                      (GHookList *hook_list,
    -                                                         gulong hook_id);
    +
    gboolean            g_hook_destroy                      (GHookList *hook_list,
    +                                                         gulong hook_id);

    Destroys a GHook, given its ID.

    @@ -1355,8 +1336,8 @@ Destroys a <

    g_hook_destroy_link ()

    -
    void                g_hook_destroy_link                 (GHookList *hook_list,
    -                                                         GHook *hook);
    +
    void                g_hook_destroy_link                 (GHookList *hook_list,
    +                                                         GHook *hook);

    Removes one GHook from a GHookList, marking it inactive and calling g_hook_unref() on it. @@ -1381,6 +1362,6 @@ Removes one

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Hostname-Utilities.html b/docs/reference/glib/html/glib-Hostname-Utilities.html index e828a31..5c6d54f 100644 --- a/docs/reference/glib/html/glib-Hostname-Utilities.html +++ b/docs/reference/glib/html/glib-Hostname-Utilities.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -60,13 +40,13 @@
     #include <glib.h>
     
    -gchar *             g_hostname_to_ascii                 (const gchar *hostname);
    -gchar *             g_hostname_to_unicode               (const gchar *hostname);
    +gchar *             g_hostname_to_ascii                 (const gchar *hostname);
    +gchar *             g_hostname_to_unicode               (const gchar *hostname);
     
    -gboolean            g_hostname_is_non_ascii             (const gchar *hostname);
    -gboolean            g_hostname_is_ascii_encoded         (const gchar *hostname);
    +gboolean            g_hostname_is_non_ascii             (const gchar *hostname);
    +gboolean            g_hostname_is_ascii_encoded         (const gchar *hostname);
     
    -gboolean            g_hostname_is_ip_address            (const gchar *hostname);
    +gboolean            g_hostname_is_ip_address            (const gchar *hostname);
     
    @@ -83,23 +63,25 @@ of Unicode domain names in applications, while providing backward-compatibility with the old ASCII-only DNS, by defining an ASCII-Compatible Encoding of any given Unicode name, which can be used with non-IDN-aware applications and protocols. (For example, -"Παν語.org" maps to "xn--4wa8awb4637h.org".)

    +"Παν語.org" maps to "xn--4wa8awb4637h.org".) +

    Details

    g_hostname_to_ascii ()

    -
    gchar *             g_hostname_to_ascii                 (const gchar *hostname);
    +
    gchar *             g_hostname_to_ascii                 (const gchar *hostname);

    Converts hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a -trailing dot.

    +trailing dot. +

    - @@ -116,7 +98,7 @@ trailing dot.


    g_hostname_to_unicode ()

    -
    gchar *             g_hostname_to_unicode               (const gchar *hostname);
    +
    gchar *             g_hostname_to_unicode               (const gchar *hostname);

    Converts hostname to its canonical presentation form; a UTF-8 string in Unicode normalization form C, containing no uppercase @@ -125,13 +107,14 @@ and not ending with a trailing dot.

    Of course if hostname is not an internationalized hostname, then -the canonical presentation form will be entirely ASCII.

    +the canonical presentation form will be entirely ASCII. +

    hostname :

    a valid UTF-8 or ASCII hostname +a valid UTF-8 or ASCII hostname
    - @@ -148,7 +131,7 @@ the canonical presentation form will be entirely ASCII.


    g_hostname_is_non_ascii ()

    -
    gboolean            g_hostname_is_non_ascii             (const gchar *hostname);
    +
    gboolean            g_hostname_is_non_ascii             (const gchar *hostname);

    Tests if hostname contains Unicode characters. If this returns TRUE, you need to encode the hostname with g_hostname_to_ascii() @@ -157,13 +140,14 @@ before using it in non-IDN-aware contexts.

    Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and -g_hostname_is_ascii_encoded() to both return TRUE for a name.

    +g_hostname_is_ascii_encoded() to both return TRUE for a name. +

    hostname :

    a valid UTF-8 or ASCII hostname +a valid UTF-8 or ASCII hostname
    - @@ -179,7 +163,7 @@ segments, and so it is possible for

    g_hostname_is_ascii_encoded ()

    -
    gboolean            g_hostname_is_ascii_encoded         (const gchar *hostname);
    +
    gboolean            g_hostname_is_ascii_encoded         (const gchar *hostname);

    Tests if hostname contains segments with an ASCII-compatible encoding of an Internationalized Domain Name. If this returns @@ -189,13 +173,14 @@ before displaying it to the user.

    Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and -g_hostname_is_ascii_encoded() to both return TRUE for a name.

    +g_hostname_is_ascii_encoded() to both return TRUE for a name. +

    hostname :

    a hostname +a hostname
    - @@ -212,16 +197,17 @@ segments.

    g_hostname_is_ip_address ()

    -
    gboolean            g_hostname_is_ip_address            (const gchar *hostname);
    +
    gboolean            g_hostname_is_ip_address            (const gchar *hostname);

    Tests if hostname is the string form of an IPv4 or IPv6 address. -(Eg, "192.168.0.1".)

    +(Eg, "192.168.0.1".) +

    hostname :

    a hostname +a hostname
    - @@ -238,6 +224,6 @@ Tests if hostname is the string form of + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-I18N.html b/docs/reference/glib/html/glib-I18N.html index 76b7c1d..b00a7c8 100644 --- a/docs/reference/glib/html/glib-I18N.html +++ b/docs/reference/glib/html/glib-I18N.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    hostname :

    a hostname (or IP address in string form) +a hostname (or IP address in string form)
    @@ -62,25 +42,27 @@ #include <glib/gi18n.h> #define Q_ (String) -#define C_ (Context,String) +#define C_ (Context, + String) #define N_ (String) -#define NC_ (Context, String) -const gchar * g_dgettext (const gchar *domain, - const gchar *msgid); -const gchar * g_dngettext (const gchar *domain, - const gchar *msgid, - const gchar *msgid_plural, - gulong n); -const gchar * g_dpgettext (const gchar *domain, - const gchar *msgctxtid, - gsize msgidoffset); -const gchar * g_dpgettext2 (const gchar *domain, - const gchar *context, - const gchar *msgid); -const gchar * g_strip_context (const gchar *msgid, - const gchar *msgval); +#define NC_ (Context, + String) +const gchar * g_dgettext (const gchar *domain, + const gchar *msgid); +const gchar * g_dngettext (const gchar *domain, + const gchar *msgid, + const gchar *msgid_plural, + gulong n); +const gchar * g_dpgettext (const gchar *domain, + const gchar *msgctxtid, + gsize msgidoffset); +const gchar * g_dpgettext2 (const gchar *domain, + const gchar *context, + const gchar *msgid); +const gchar * g_strip_context (const gchar *msgid, + const gchar *msgval); -const gchar* const * g_get_language_names (void); +const gchar* const * g_get_language_names (void);
    @@ -97,10 +79,19 @@ In order to use these macros in an application, you must include glib/gi18n-lib.h after defining the GETTEXT_PACKAGE macro suitably for your library:

    -
    -#define GETTEXT_PACKAGE "gtk20"
    -#include <glib/gi18n-lib.h>
    -
    +
    +
    + + + + + + +
    1
    +2
    #define GETTEXT_PACKAGE "gtk20"
    +#include <glib/gi18n-lib.h>
    +
    +

    The gettext manual covers details of how to set up message extraction with xgettext. @@ -166,10 +157,19 @@ used as a context. This is mainly useful for short strings which may need different translations, depending on the context in which they are used.

    -
    -label1 = C_("Navigation", "Back");
    -label2 = C_("Body part", "Back");
    -
    +
    + + + + + + + +
    1
    +2
    label1 = C_("Navigation", "Back");
    +label2 = C_("Body part", "Back");
    +
    +

    @@ -212,21 +212,41 @@ This is useful in situations where the translated strings can't be directly used, e.g. in string array initializers. To get the translated string, call gettext() at runtime.

    -
    -     {
    -       static const char *messages[] = {
    -         N_("some very meaningful message"),
    -         N_("and another one")
    -       };
    -       const char *string;
    -       ...
    -       string
    -         = index > 1 ? _("a default message") : gettext (messages[index]);
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    {
    +  static const char *messages[] = {
    +    N_("some very meaningful message"),
    +    N_("and another one")
    +  };
    +  const char *string;
    +  ...
    +  string
    +    = index > 1 ? _("a default message") : gettext (messages[index]);
    +
    +  fputs (string);
    +  ...
    +}
    +
    - fputs (string); - ... - } -
    @@ -247,21 +267,41 @@ This is useful in situations where the translated strings can't be directly used, e.g. in string array initializers. To get the translated string, you should call g_dpgettext2() at runtime.

    -
    -     {
    -       static const char *messages[] = {
    -         NC_("some context", "some very meaningful message"),
    -         NC_("some context", "and another one")
    -       };
    -       const char *string;
    -       ...
    -       string
    -         = index > 1 ? g_dpgettext2 (NULL, "some context", "a default message") : g_dpgettext2 (NULL, "some context", messages[index]);
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    {
    +  static const char *messages[] = {
    +    NC_("some context", "some very meaningful message"),
    +    NC_("some context", "and another one")
    +  };
    +  const char *string;
    +  ...
    +  string
    +    = index > 1 ? g_dpgettext2 (NULL, "some context", "a default message") : g_dpgettext2 (NULL, "some context", messages[index]);
    +
    +  fputs (string);
    +  ...
    +}
    +
    - fputs (string); - ... - } -

    Note

    @@ -291,8 +331,8 @@ Intltool has support for the

    g_dgettext ()

    -
    const gchar *       g_dgettext                          (const gchar *domain,
    -                                                         const gchar *msgid);
    +
    const gchar *       g_dgettext                          (const gchar *domain,
    +                                                         const gchar *msgid);

    This function is a wrapper of dgettext() which does not translate the message if the default domain as set with textdomain() has no @@ -332,19 +372,20 @@ cases the application should call textdomain() aft

    Applications should normally not use this function directly, -but use the _() macro for translations.

    +but use the _() macro for translations. +

    - - @@ -360,10 +401,10 @@ but use the _() macro for translations.


    g_dngettext ()

    -
    const gchar *       g_dngettext                         (const gchar *domain,
    -                                                         const gchar *msgid,
    -                                                         const gchar *msgid_plural,
    -                                                         gulong n);
    +
    const gchar *       g_dngettext                         (const gchar *domain,
    +                                                         const gchar *msgid,
    +                                                         const gchar *msgid_plural,
    +                                                         gulong n);

    This function is a wrapper of dngettext() which does not translate the message if the default domain as set with textdomain() has no @@ -371,29 +412,30 @@ translations for the current locale.

    See g_dgettext() for details of how this differs from dngettext() -proper.

    +proper. +

    domain :

    the translation domain to use, or NULL to use +the translation domain to use, or NULL to use the domain set with textdomain()

    msgid :

    message to translate +message to translate
    - - - - @@ -409,9 +451,9 @@ proper.


    g_dpgettext ()

    -
    const gchar *       g_dpgettext                         (const gchar *domain,
    -                                                         const gchar *msgctxtid,
    -                                                         gsize msgidoffset);
    +
    const gchar *       g_dpgettext                         (const gchar *domain,
    +                                                         const gchar *msgctxtid,
    +                                                         gsize msgidoffset);

    This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the @@ -427,25 +469,26 @@ with dgettext() proper.

    Applications should normally not use this function directly, -but use the C_() macro for translations with context.

    +but use the C_() macro for translations with context. +

    domain :

    the translation domain to use, or NULL to use +the translation domain to use, or NULL to use the domain set with textdomain()

    msgid :

    message to translate +message to translate

    msgid_plural :

    plural form of the message +plural form of the message

    n :

    the quantity for which translation is needed +the quantity for which translation is needed
    - - - @@ -461,9 +504,9 @@ but use the

    g_dpgettext2 ()

    -
    const gchar *       g_dpgettext2                        (const gchar *domain,
    -                                                         const gchar *context,
    -                                                         const gchar *msgid);
    +
    const gchar *       g_dpgettext2                        (const gchar *domain,
    +                                                         const gchar *context,
    +                                                         const gchar *msgid);

    This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the @@ -476,24 +519,25 @@ with dgettext() proper.

    This function differs from C_() in that it is not a macro and -thus you may use non-string-literals as context and msgid arguments.

    +thus you may use non-string-literals as context and msgid arguments. +

    domain :

    the translation domain to use, or NULL to use +the translation domain to use, or NULL to use the domain set with textdomain()

    msgctxtid :

    a combined message context and message id, separated +a combined message context and message id, separated by a \004 character

    msgidoffset :

    the offset of the message id in msgctxid +the offset of the message id in msgctxid
    - - - @@ -509,21 +553,22 @@ thus you may use non-string-literals as context and msgid arguments.


    g_strip_context ()

    -
    const gchar *       g_strip_context                     (const gchar *msgid,
    -                                                         const gchar *msgval);
    +
    const gchar *       g_strip_context                     (const gchar *msgid,
    +                                                         const gchar *msgval);

    -An auxiliary function for gettext() support (see Q_()).

    +An auxiliary function for gettext() support (see Q_()). +

    domain :

    the translation domain to use, or NULL to use +the translation domain to use, or NULL to use the domain set with textdomain()

    context :

    the message context +the message context

    msgid :

    the message +the message
    - - @@ -541,7 +586,7 @@ An auxiliary function for gettext() support (see <

    g_get_language_names ()

    -
    const gchar* const * g_get_language_names               (void);
    +
    const gchar* const * g_get_language_names               (void);

    Computes a list of applicable locale names, which can be used to e.g. construct locale-dependent filenames or search paths. The returned @@ -555,7 +600,8 @@ For example, if LANGUAGE=de:en_US, then the returned list is

    This function consults the environment variables LANGUAGE, LC_ALL, LC_MESSAGES and LANG -to find the list of locales specified by the user.

    +to find the list of locales specified by the user. +

    msgid :

    a string +a string

    msgval :

    another string +another string
    @@ -578,6 +624,6 @@ The gettext manual. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-IO-Channels.html b/docs/reference/glib/html/glib-IO-Channels.html index ebd9021..a1a9056 100644 --- a/docs/reference/glib/html/glib-IO-Channels.html +++ b/docs/reference/glib/html/glib-IO-Channels.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -63,123 +43,123 @@ GIOChannel; -GIOChannel* g_io_channel_unix_new (int fd); -gint g_io_channel_unix_get_fd (GIOChannel *channel); -GIOChannel* g_io_channel_win32_new_fd (gint fd); -GIOChannel * g_io_channel_win32_new_socket (gint socket); -GIOChannel * g_io_channel_win32_new_messages (gsize hwnd); +GIOChannel* g_io_channel_unix_new (int fd); +gint g_io_channel_unix_get_fd (GIOChannel *channel); +GIOChannel* g_io_channel_win32_new_fd (gint fd); +GIOChannel * g_io_channel_win32_new_socket (gint socket); +GIOChannel * g_io_channel_win32_new_messages (gsize hwnd); -void g_io_channel_init (GIOChannel *channel); +void g_io_channel_init (GIOChannel *channel); -GIOChannel* g_io_channel_new_file (const gchar *filename, - const gchar *mode, - GError **error); -GIOStatus g_io_channel_read_chars (GIOChannel *channel, - gchar *buf, - gsize count, - gsize *bytes_read, - GError **error); -GIOStatus g_io_channel_read_unichar (GIOChannel *channel, - gunichar *thechar, - GError **error); -GIOStatus g_io_channel_read_line (GIOChannel *channel, - gchar **str_return, - gsize *length, - gsize *terminator_pos, - GError **error); -GIOStatus g_io_channel_read_line_string (GIOChannel *channel, - GString *buffer, - gsize *terminator_pos, - GError **error); -GIOStatus g_io_channel_read_to_end (GIOChannel *channel, - gchar **str_return, - gsize *length, - GError **error); -GIOStatus g_io_channel_write_chars (GIOChannel *channel, - const gchar *buf, - gssize count, - gsize *bytes_written, - GError **error); -GIOStatus g_io_channel_write_unichar (GIOChannel *channel, - gunichar thechar, - GError **error); -GIOStatus g_io_channel_flush (GIOChannel *channel, - GError **error); -GIOStatus g_io_channel_seek_position (GIOChannel *channel, - gint64 offset, - GSeekType type, - GError **error); +GIOChannel* g_io_channel_new_file (const gchar *filename, + const gchar *mode, + GError **error); +GIOStatus g_io_channel_read_chars (GIOChannel *channel, + gchar *buf, + gsize count, + gsize *bytes_read, + GError **error); +GIOStatus g_io_channel_read_unichar (GIOChannel *channel, + gunichar *thechar, + GError **error); +GIOStatus g_io_channel_read_line (GIOChannel *channel, + gchar **str_return, + gsize *length, + gsize *terminator_pos, + GError **error); +GIOStatus g_io_channel_read_line_string (GIOChannel *channel, + GString *buffer, + gsize *terminator_pos, + GError **error); +GIOStatus g_io_channel_read_to_end (GIOChannel *channel, + gchar **str_return, + gsize *length, + GError **error); +GIOStatus g_io_channel_write_chars (GIOChannel *channel, + const gchar *buf, + gssize count, + gsize *bytes_written, + GError **error); +GIOStatus g_io_channel_write_unichar (GIOChannel *channel, + gunichar thechar, + GError **error); +GIOStatus g_io_channel_flush (GIOChannel *channel, + GError **error); +GIOStatus g_io_channel_seek_position (GIOChannel *channel, + gint64 offset, + GSeekType type, + GError **error); enum GSeekType; -GIOStatus g_io_channel_shutdown (GIOChannel *channel, - gboolean flush, - GError **err); +GIOStatus g_io_channel_shutdown (GIOChannel *channel, + gboolean flush, + GError **err); enum GIOStatus; enum GIOChannelError; #define G_IO_CHANNEL_ERROR -GIOChannelError g_io_channel_error_from_errno (gint en); +GIOChannelError g_io_channel_error_from_errno (gint en); -GIOChannel * g_io_channel_ref (GIOChannel *channel); -void g_io_channel_unref (GIOChannel *channel); +GIOChannel * g_io_channel_ref (GIOChannel *channel); +void g_io_channel_unref (GIOChannel *channel); -GSource * g_io_create_watch (GIOChannel *channel, - GIOCondition condition); -guint g_io_add_watch (GIOChannel *channel, - GIOCondition condition, - GIOFunc func, - gpointer user_data); -guint g_io_add_watch_full (GIOChannel *channel, - gint priority, - GIOCondition condition, - GIOFunc func, - gpointer user_data, - GDestroyNotify notify); +GSource * g_io_create_watch (GIOChannel *channel, + GIOCondition condition); +guint g_io_add_watch (GIOChannel *channel, + GIOCondition condition, + GIOFunc func, + gpointer user_data); +guint g_io_add_watch_full (GIOChannel *channel, + gint priority, + GIOCondition condition, + GIOFunc func, + gpointer user_data, + GDestroyNotify notify); enum GIOCondition; -gboolean (*GIOFunc) (GIOChannel *source, - GIOCondition condition, - gpointer data); +gboolean (*GIOFunc) (GIOChannel *source, + GIOCondition condition, + gpointer data); GIOFuncs; -gsize g_io_channel_get_buffer_size (GIOChannel *channel); -void g_io_channel_set_buffer_size (GIOChannel *channel, - gsize size); -GIOCondition g_io_channel_get_buffer_condition (GIOChannel *channel); -GIOFlags g_io_channel_get_flags (GIOChannel *channel); -GIOStatus g_io_channel_set_flags (GIOChannel *channel, - GIOFlags flags, - GError **error); +gsize g_io_channel_get_buffer_size (GIOChannel *channel); +void g_io_channel_set_buffer_size (GIOChannel *channel, + gsize size); +GIOCondition g_io_channel_get_buffer_condition (GIOChannel *channel); +GIOFlags g_io_channel_get_flags (GIOChannel *channel); +GIOStatus g_io_channel_set_flags (GIOChannel *channel, + GIOFlags flags, + GError **error); enum GIOFlags; -const gchar* g_io_channel_get_line_term (GIOChannel *channel, - gint *length); -void g_io_channel_set_line_term (GIOChannel *channel, - const gchar *line_term, - gint length); -gboolean g_io_channel_get_buffered (GIOChannel *channel); -void g_io_channel_set_buffered (GIOChannel *channel, - gboolean buffered); -const gchar* g_io_channel_get_encoding (GIOChannel *channel); -GIOStatus g_io_channel_set_encoding (GIOChannel *channel, - const gchar *encoding, - GError **error); -gboolean g_io_channel_get_close_on_unref (GIOChannel *channel); -void g_io_channel_set_close_on_unref (GIOChannel *channel, - gboolean do_close); +const gchar* g_io_channel_get_line_term (GIOChannel *channel, + gint *length); +void g_io_channel_set_line_term (GIOChannel *channel, + const gchar *line_term, + gint length); +gboolean g_io_channel_get_buffered (GIOChannel *channel); +void g_io_channel_set_buffered (GIOChannel *channel, + gboolean buffered); +const gchar* g_io_channel_get_encoding (GIOChannel *channel); +GIOStatus g_io_channel_set_encoding (GIOChannel *channel, + const gchar *encoding, + GError **error); +gboolean g_io_channel_get_close_on_unref (GIOChannel *channel); +void g_io_channel_set_close_on_unref (GIOChannel *channel, + gboolean do_close); -GIOError g_io_channel_read (GIOChannel *channel, - gchar *buf, - gsize count, - gsize *bytes_read); +GIOError g_io_channel_read (GIOChannel *channel, + gchar *buf, + gsize count, + gsize *bytes_read); enum GIOError; -GIOError g_io_channel_write (GIOChannel *channel, - const gchar *buf, - gsize count, - gsize *bytes_written); -GIOError g_io_channel_seek (GIOChannel *channel, - gint64 offset, - GSeekType type); -void g_io_channel_close (GIOChannel *channel); +GIOError g_io_channel_write (GIOChannel *channel, + const gchar *buf, + gsize count, + gsize *bytes_written); +GIOError g_io_channel_seek (GIOChannel *channel, + gint64 offset, + GSeekType type); +void g_io_channel_close (GIOChannel *channel);
    @@ -224,7 +204,8 @@ The new functions g_io_channel_read_to_end(), g_io_channel_write_chars(), g_io_channel_seek_position(), and g_io_channel_flush() should not be mixed with the deprecated functions g_io_channel_read(), -g_io_channel_write(), and g_io_channel_seek() on the same channel.

    +g_io_channel_write(), and g_io_channel_seek() on the same channel. +

    Details

    @@ -236,12 +217,13 @@ mixed with the deprecated functions

    g_io_channel_unix_new ()

    -
    GIOChannel*         g_io_channel_unix_new               (int fd);
    +
    GIOChannel*         g_io_channel_unix_new               (int fd);

    Creates a new GIOChannel given a file descriptor. On UNIX systems this works for plain files, pipes, and sockets. @@ -266,18 +248,19 @@ avoid using it on Windows. The domain of file descriptors and sockets overlap. There is no way for GLib to know which one you mean in case the argument you pass to this function happens to be both a valid file descriptor and socket. If that happens a warning is -issued, and GLib assumes that it is the file descriptor you mean.

    +issued, and GLib assumes that it is the file descriptor you mean. +

    - - @@ -286,24 +269,25 @@ issued, and GLib assumes that it is the file descriptor you mean.


    g_io_channel_unix_get_fd ()

    -
    gint                g_io_channel_unix_get_fd            (GIOChannel *channel);
    +
    gint                g_io_channel_unix_get_fd            (GIOChannel *channel);

    Returns the file descriptor of the GIOChannel.

    On Windows this function returns the file descriptor or socket of -the GIOChannel.

    +the GIOChannel. +

    fd :

    a file descriptor. +a file descriptor.

    Returns :

    a new GIOChannel. +a new GIOChannel.
    - - @@ -312,7 +296,7 @@ the <

    g_io_channel_win32_new_fd ()

    -
    GIOChannel*         g_io_channel_win32_new_fd           (gint fd);
    +
    GIOChannel*         g_io_channel_win32_new_fd           (gint fd);

    Creates a new GIOChannel given a file descriptor on Windows. This works for file descriptors from the C runtime. @@ -338,18 +322,19 @@ reads from the file descriptor should be done by this internal GLib thread. Your code should call only g_io_channel_read().

    -This function is available only in GLib on Windows.

    +This function is available only in GLib on Windows. +

    channel :

    a GIOChannel, created with g_io_channel_unix_new(). +a GIOChannel, created with g_io_channel_unix_new().

    Returns :

    the file descriptor of the GIOChannel. +the file descriptor of the GIOChannel.
    - - @@ -358,7 +343,7 @@ This function is available only in GLib on Windows.


    g_io_channel_win32_new_socket ()

    -
    GIOChannel *        g_io_channel_win32_new_socket       (gint socket);
    +
    GIOChannel *        g_io_channel_win32_new_socket       (gint socket);

    Creates a new GIOChannel given a socket on Windows.

    @@ -369,18 +354,19 @@ only in GLib on Windows.

    Polling a GSource created to watch a channel for a socket puts the socket in non-blocking mode. This is a side-effect of the -implementation and unavoidable.

    +implementation and unavoidable. +

    fd :

    a C library file descriptor. +a C library file descriptor.

    Returns :

    a new GIOChannel. +a new GIOChannel.
    - - @@ -389,24 +375,25 @@ implementation and unavoidable.


    g_io_channel_win32_new_messages ()

    -
    GIOChannel *        g_io_channel_win32_new_messages     (gsize hwnd);
    +
    GIOChannel *        g_io_channel_win32_new_messages     (gsize hwnd);

    Creates a new GIOChannel given a window handle on Windows.

    This function creates a GIOChannel that can be used to poll for -Windows messages for the window in question.

    +Windows messages for the window in question. +

    socket :

    a Winsock socket +a Winsock socket

    Returns :

    a new GIOChannel +a new GIOChannel
    - - @@ -415,19 +402,20 @@ Windows messages for the window in question.


    g_io_channel_init ()

    -
    void                g_io_channel_init                   (GIOChannel *channel);
    +
    void                g_io_channel_init                   (GIOChannel *channel);

    Initializes a GIOChannel struct.

    This is called by each of the above functions when creating a GIOChannel, and so is not often needed by the application -programmer (unless you are creating a new type of GIOChannel).

    +programmer (unless you are creating a new type of GIOChannel). +

    hwnd :

    a window handle. +a window handle.

    Returns :

    a new GIOChannel. +a new GIOChannel.
    -

    channel :

    a GIOChannel +a GIOChannel
    @@ -435,32 +423,33 @@ programmer (unless you are creating a new type of

    g_io_channel_new_file ()

    -
    GIOChannel*         g_io_channel_new_file               (const gchar *filename,
    -                                                         const gchar *mode,
    -                                                         GError **error);
    +
    GIOChannel*         g_io_channel_new_file               (const gchar *filename,
    +                                                         const gchar *mode,
    +                                                         GError **error);

    Open a file filename as a GIOChannel using mode mode. This channel will be closed when the last reference to it is dropped, so there is no need to call g_io_channel_close() (though doing so will not cause problems, as long as no attempt is made to -access the channel after it is closed).

    +access the channel after it is closed). +

    - - - @@ -474,29 +463,30 @@ access the channel after it is closed).


    g_io_channel_read_chars ()

    -
    GIOStatus           g_io_channel_read_chars             (GIOChannel *channel,
    -                                                         gchar *buf,
    -                                                         gsize count,
    -                                                         gsize *bytes_read,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_read_chars             (GIOChannel *channel,
    +                                                         gchar *buf,
    +                                                         gsize count,
    +                                                         gsize *bytes_read,
    +                                                         GError **error);

    -Replacement for g_io_channel_read() with the new API.

    +Replacement for g_io_channel_read() with the new API. +

    filename :

    A string containing the name of a file +A string containing the name of a file

    mode :

    One of "r", "w", "a", "r+", "w+", "a+". These have +One of "r", "w", "a", "r+", "w+", "a+". These have the same meaning as in fopen()

    error :

    A location to return an error of type G_FILE_ERROR +A location to return an error of type G_FILE_ERROR
    - - - - - @@ -527,28 +517,29 @@ Replacement for

    g_io_channel_read_unichar ()

    -
    GIOStatus           g_io_channel_read_unichar           (GIOChannel *channel,
    -                                                         gunichar *thechar,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_read_unichar           (GIOChannel *channel,
    +                                                         gunichar *thechar,
    +                                                         GError **error);

    Reads a Unicode character from channel. -This function cannot be called on a channel with NULL encoding.

    +This function cannot be called on a channel with NULL encoding. +

    channel :

    a GIOChannel +a GIOChannel

    buf :

    a buffer to read data into +a buffer to read data into

    count :

    the size of the buffer. Note that the buffer may +the size of the buffer. Note that the buffer may not be complelely filled even if there is data in the buffer if the remaining data is not a complete character. @@ -504,7 +494,7 @@ Replacement for

    bytes_read :

    The number of bytes read. This may be zero even on +The number of bytes read. This may be zero even on success if count < 6 and the channel's encoding is non-NULL. This indicates that the next UTF-8 character is too wide for the buffer. @@ -512,7 +502,7 @@ Replacement for

    error :

    a location to return an error of type GConvertError +a location to return an error of type GConvertError or GIOChannelError.
    - - - @@ -563,27 +554,28 @@ This function cannot be called on a channel with

    g_io_channel_read_line ()

    -
    GIOStatus           g_io_channel_read_line              (GIOChannel *channel,
    -                                                         gchar **str_return,
    -                                                         gsize *length,
    -                                                         gsize *terminator_pos,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_read_line              (GIOChannel *channel,
    +                                                         gchar **str_return,
    +                                                         gsize *length,
    +                                                         gsize *terminator_pos,
    +                                                         GError **error);

    Reads a line, including the terminating character(s), from a GIOChannel into a newly-allocated string. str_return will contain allocated memory if the return -is G_IO_STATUS_NORMAL.

    +is G_IO_STATUS_NORMAL. +

    channel :

    a GIOChannel +a GIOChannel

    thechar :

    a location to return a character +a location to return a character

    error :

    a location to return an error of type GConvertError +a location to return an error of type GConvertError or GIOChannelError
    - - - - - @@ -616,35 +608,36 @@ is

    g_io_channel_read_line_string ()

    -
    GIOStatus           g_io_channel_read_line_string       (GIOChannel *channel,
    -                                                         GString *buffer,
    -                                                         gsize *terminator_pos,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_read_line_string       (GIOChannel *channel,
    +                                                         GString *buffer,
    +                                                         gsize *terminator_pos,
    +                                                         GError **error);

    -Reads a line from a GIOChannel, using a GString as a buffer.

    +Reads a line from a GIOChannel, using a GString as a buffer. +

    channel :

    a GIOChannel +a GIOChannel

    str_return :

    The line read from the GIOChannel, including the +The line read from the GIOChannel, including the line terminator. This data should be freed with g_free() when no longer needed. This is a nul-terminated string. If a length of zero is returned, this will be NULL instead. @@ -591,17 +583,17 @@ is

    length :

    location to store length of the read data, or NULL +location to store length of the read data, or NULL

    terminator_pos :

    location to store position of line terminator, or NULL +location to store position of line terminator, or NULL

    error :

    A location to return an error of type GConvertError +A location to return an error of type GConvertError or GIOChannelError
    - - - - @@ -659,23 +652,24 @@ Reads a line from a

    g_io_channel_read_to_end ()

    -
    GIOStatus           g_io_channel_read_to_end            (GIOChannel *channel,
    -                                                         gchar **str_return,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_read_to_end            (GIOChannel *channel,
    +                                                         gchar **str_return,
    +                                                         gsize *length,
    +                                                         GError **error);

    -Reads all the remaining data from the file.

    +Reads all the remaining data from the file. +

    channel :

    a GIOChannel +a GIOChannel

    buffer :

    a GString into which the line will be written. +a GString into which the line will be written. If buffer already contains data, the old data will be overwritten.

    terminator_pos :

    location to store position of line terminator, or NULL +location to store position of line terminator, or NULL

    error :

    a location to store an error of type GConvertError +a location to store an error of type GConvertError or GIOChannelError
    - - - - @@ -705,11 +699,11 @@ Reads all the remaining data from the file.


    g_io_channel_write_chars ()

    -
    GIOStatus           g_io_channel_write_chars            (GIOChannel *channel,
    -                                                         const gchar *buf,
    -                                                         gssize count,
    -                                                         gsize *bytes_written,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_write_chars            (GIOChannel *channel,
    +                                                         const gchar *buf,
    +                                                         gssize count,
    +                                                         gsize *bytes_written,
    +                                                         GError **error);

    Replacement for g_io_channel_write() with the new API.

    @@ -717,29 +711,30 @@ Replacement for NULL or UTF-8, generic mixing of reading and writing is not allowed. A call to g_io_channel_write_chars() may only be made on a channel from which data has been read in the -cases described in the documentation for g_io_channel_set_encoding().

    +cases described in the documentation for g_io_channel_set_encoding(). +

    channel :

    a GIOChannel +a GIOChannel

    str_return :

    Location to store a pointer to a string holding +Location to store a pointer to a string holding the remaining data in the GIOChannel. This data should be freed with g_free() when no longer needed. This data is terminated by an extra nul character, but there @@ -684,12 +678,12 @@ Reads all the remaining data from the file.

    length :

    location to store length of the data +location to store length of the data

    error :

    location to return an error of type GConvertError +location to return an error of type GConvertError or GIOChannelError
    - - - - - @@ -763,28 +758,29 @@ cases described in the documentation for

    g_io_channel_write_unichar ()

    -
    GIOStatus           g_io_channel_write_unichar          (GIOChannel *channel,
    -                                                         gunichar thechar,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_write_unichar          (GIOChannel *channel,
    +                                                         gunichar thechar,
    +                                                         GError **error);

    Writes a Unicode character to channel. -This function cannot be called on a channel with NULL encoding.

    +This function cannot be called on a channel with NULL encoding. +

    channel :

    a GIOChannel +a GIOChannel

    buf :

    a buffer to write data from +a buffer to write data from

    count :

    the size of the buffer. If -1, the buffer +the size of the buffer. If -1, the buffer is taken to be a nul-terminated string.

    bytes_written :

    The number of bytes written. This can be nonzero +The number of bytes written. This can be nonzero even if the return value is not G_IO_STATUS_NORMAL. If the return value is G_IO_STATUS_NORMAL and the channel is blocking, this will always be equal @@ -748,7 +743,7 @@ cases described in the documentation for error :

    a location to return an error of type GConvertError +a location to return an error of type GConvertError or GIOChannelError
    - - - @@ -799,21 +795,22 @@ This function cannot be called on a channel with

    g_io_channel_flush ()

    -
    GIOStatus           g_io_channel_flush                  (GIOChannel *channel,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_flush                  (GIOChannel *channel,
    +                                                         GError **error);

    -Flushes the write buffer for the GIOChannel.

    +Flushes the write buffer for the GIOChannel. +

    channel :

    a GIOChannel +a GIOChannel

    thechar :

    a character +a character

    error :

    location to return an error of type GConvertError +location to return an error of type GConvertError or GIOChannelError
    - - @@ -829,28 +826,29 @@ Flushes the write buffer for the GIOChannel.


    g_io_channel_seek_position ()

    -
    GIOStatus           g_io_channel_seek_position          (GIOChannel *channel,
    -                                                         gint64 offset,
    -                                                         GSeekType type,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_seek_position          (GIOChannel *channel,
    +                                                         gint64 offset,
    +                                                         GSeekType type,
    +                                                         GError **error);

    -Replacement for g_io_channel_seek() with the new API.

    +Replacement for g_io_channel_seek() with the new API. +

    channel :

    a GIOChannel +a GIOChannel

    error :

    location to store an error of type GIOChannelError +location to store an error of type GIOChannelError
    - - - - @@ -881,23 +879,24 @@ Replacement for

    An enumeration specifying the base position for a -g_io_channel_seek_position() operation.

    +g_io_channel_seek_position() operation. +

    channel :

    a GIOChannel +a GIOChannel

    offset :

    The offset in bytes from the position specified by type +The offset in bytes from the position specified by type

    type :

    a GSeekType. The type G_SEEK_CUR is only allowed in those +a GSeekType. The type G_SEEK_CUR is only allowed in those cases where a call to g_io_channel_set_encoding() is allowed. See the documentation for g_io_channel_set_encoding() for details. @@ -858,7 +856,7 @@ Replacement for

    error :

    A location to return an error of type GIOChannelError +A location to return an error of type GIOChannelError
    - - - @@ -906,29 +905,30 @@ An enumeration specifying the base position for a

    g_io_channel_shutdown ()

    -
    GIOStatus           g_io_channel_shutdown               (GIOChannel *channel,
    -                                                         gboolean flush,
    -                                                         GError **err);
    +
    GIOStatus           g_io_channel_shutdown               (GIOChannel *channel,
    +                                                         gboolean flush,
    +                                                         GError **err);

    Close an IO channel. Any pending data to be written will be flushed if flush is TRUE. The channel will not be freed until the -last reference is dropped using g_io_channel_unref().

    +last reference is dropped using g_io_channel_unref(). +

    G_SEEK_CUR

    the current position in the file. +the current position in the file.

    G_SEEK_SET

    the start of the file. +the start of the file.

    G_SEEK_END

    the end of the file. +the end of the file.
    - - - @@ -951,28 +951,29 @@ last reference is dropped using GIOFuncs functions.

    +Stati returned by most of the GIOFuncs functions. +

    channel :

    a GIOChannel +a GIOChannel

    flush :

    if TRUE, flush pending +if TRUE, flush pending

    err :

    location to store a GIOChannelError +location to store a GIOChannelError
    - - - - @@ -997,53 +998,54 @@ Stati returned by most of the GIOChannel operations.

    +Error codes returned by GIOChannel operations. +

    G_IO_STATUS_ERROR

    An error occurred. +An error occurred.

    G_IO_STATUS_NORMAL

    Success. +Success.

    G_IO_STATUS_EOF

    End of file. +End of file.

    G_IO_STATUS_AGAIN

    Resource temporarily unavailable. +Resource temporarily unavailable.
    - - - - - - - - - @@ -1057,20 +1059,22 @@ Error codes returned by Error domain for GIOChannel operations. Errors in this domain will be from the GIOChannelError enumeration. See GError for -information on error domains.

    +information on error domains. +


    g_io_channel_error_from_errno ()

    -
    GIOChannelError     g_io_channel_error_from_errno       (gint en);
    +
    GIOChannelError     g_io_channel_error_from_errno       (gint en);

    -Converts an errno error number to a GIOChannelError.

    +Converts an errno error number to a GIOChannelError. +

    G_IO_CHANNEL_ERROR_FBIG

    File too large. +File too large.

    G_IO_CHANNEL_ERROR_INVAL

    Invalid argument. +Invalid argument.

    G_IO_CHANNEL_ERROR_IO

    IO error. +IO error.

    G_IO_CHANNEL_ERROR_ISDIR

    File is a directory. +File is a directory.

    G_IO_CHANNEL_ERROR_NOSPC

    No space left on device. +No space left on device.

    G_IO_CHANNEL_ERROR_NXIO

    No such device or address. +No such device or address.

    G_IO_CHANNEL_ERROR_OVERFLOW

    Value too large for defined datatype. +Value too large for defined datatype.

    G_IO_CHANNEL_ERROR_PIPE

    Broken pipe. +Broken pipe.

    G_IO_CHANNEL_ERROR_FAILED

    Some other error. +Some other error.
    - @@ -1085,15 +1089,16 @@ Converts an errno error number to a

    g_io_channel_ref ()

    -
    GIOChannel *        g_io_channel_ref                    (GIOChannel *channel);
    +
    GIOChannel *        g_io_channel_ref                    (GIOChannel *channel);

    -Increments the reference count of a GIOChannel.

    +Increments the reference count of a GIOChannel. +

    en :

    an errno error number, e.g. EINVAL +an errno error number, e.g. EINVAL
    - @@ -1107,14 +1112,15 @@ Increments the reference count of a

    g_io_channel_unref ()

    -
    void                g_io_channel_unref                  (GIOChannel *channel);
    +
    void                g_io_channel_unref                  (GIOChannel *channel);

    -Decrements the reference count of a GIOChannel.

    +Decrements the reference count of a GIOChannel. +

    channel :

    a GIOChannel +a GIOChannel
    -

    channel :

    a GIOChannel +a GIOChannel
    @@ -1122,8 +1128,8 @@ Decrements the reference count of a

    g_io_create_watch ()

    -
    GSource *           g_io_create_watch                   (GIOChannel *channel,
    -                                                         GIOCondition condition);
    +
    GSource *           g_io_create_watch                   (GIOChannel *channel,
    +                                                         GIOCondition condition);

    Creates a GSource that's dispatched when condition is met for the given channel. For example, if condition is G_IO_IN, the source will @@ -1137,18 +1143,19 @@ at the default priority.

    On Windows, polling a GSource created to watch a channel for a socket puts the socket in non-blocking mode. This is a side-effect of the -implementation and unavoidable.

    +implementation and unavoidable. +

    - - @@ -1162,34 +1169,35 @@ implementation and unavoidable.


    g_io_add_watch ()

    -
    guint               g_io_add_watch                      (GIOChannel *channel,
    -                                                         GIOCondition condition,
    -                                                         GIOFunc func,
    -                                                         gpointer user_data);
    +
    guint               g_io_add_watch                      (GIOChannel *channel,
    +                                                         GIOCondition condition,
    +                                                         GIOFunc func,
    +                                                         gpointer user_data);

    Adds the GIOChannel into the default main loop context -with the default priority.

    +with the default priority. +

    channel :

    a GIOChannel to watch +a GIOChannel to watch

    condition :

    conditions to watch for +conditions to watch for
    - - - - @@ -1203,12 +1211,12 @@ with the default priority.


    g_io_add_watch_full ()

    -
    guint               g_io_add_watch_full                 (GIOChannel *channel,
    -                                                         gint priority,
    -                                                         GIOCondition condition,
    -                                                         GIOFunc func,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify notify);
    +
    guint               g_io_add_watch_full                 (GIOChannel *channel,
    +                                                         gint priority,
    +                                                         GIOCondition condition,
    +                                                         GIOFunc func,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify notify);

    Adds the GIOChannel into the default main loop context with the given priority. @@ -1216,38 +1224,39 @@ with the given priority.

    This internally creates a main loop source using g_io_create_watch() and attaches it to the main loop context with g_source_attach(). -You can do these steps manuallt if you need greater control.

    +You can do these steps manuallt if you need greater control. +

    channel :

    a GIOChannel +a GIOChannel

    condition :

    the condition to watch for +the condition to watch for

    func :

    the function to call when the condition is satisfied +the function to call when the condition is satisfied

    user_data :

    user data to pass to func +user data to pass to func
    - - - - - - @@ -1273,39 +1282,40 @@ You can do these steps manuallt if you need greater control.

    A bitwise combination representing a condition to watch for on an -event source.

    +event source. +

    channel :

    a GIOChannel +a GIOChannel

    priority :

    the priority of the GIOChannel source +the priority of the GIOChannel source

    condition :

    the condition to watch for +the condition to watch for

    func :

    the function to call when the condition is satisfied +the function to call when the condition is satisfied

    user_data :

    user data to pass to func +user data to pass to func

    notify :

    the function to call when the source is removed +the function to call when the source is removed
    - - - - - - @@ -1314,34 +1324,35 @@ event source.


    GIOFunc ()

    -
    gboolean            (*GIOFunc)                          (GIOChannel *source,
    -                                                         GIOCondition condition,
    -                                                         gpointer data);
    +
    gboolean            (*GIOFunc)                          (GIOChannel *source,
    +                                                         GIOCondition condition,
    +                                                         gpointer data);

    Specifies the type of function passed to g_io_add_watch() or g_io_add_watch_full(), which is called when the requested condition -on a GIOChannel is satisfied.

    +on a GIOChannel is satisfied. +

    G_IO_IN

    There is data to read. +There is data to read.

    G_IO_OUT

    Data can be written (without blocking). +Data can be written (without blocking).

    G_IO_PRI

    There is urgent data to read. +There is urgent data to read.

    G_IO_ERR

    Error condition. +Error condition.

    G_IO_HUP

    Hung up (the connection has been broken, usually for +Hung up (the connection has been broken, usually for pipes and sockets).

    G_IO_NVAL

    Invalid request. The file descriptor is not open. +Invalid request. The file descriptor is not open.
    - - - - @@ -1379,13 +1390,14 @@ on a

    A table of functions used to handle different types of GIOChannel -in a generic way.

    +in a generic way. +

    source :

    the GIOChannel event source +the GIOChannel event source

    condition :

    the condition which has been satisfied +the condition which has been satisfied

    data :

    user data set in g_io_add_watch() or g_io_add_watch_full() +user data set in g_io_add_watch() or g_io_add_watch_full()

    Returns :

    the function should return FALSE if the event source +the function should return FALSE if the event source should be removed
    - - - - - - - -

    io_read ()

    reads raw bytes from the channel. This is called from +reads raw bytes from the channel. This is called from various functions such as g_io_channel_read_chars() to read raw bytes from the channel. Encoding and buffering issues are dealt with at a higher level. @@ -1393,7 +1405,7 @@ in a generic way.

    io_write ()

    writes raw bytes to the channel. This is called from +writes raw bytes to the channel. This is called from various functions such as g_io_channel_write_chars() to write raw bytes to the channel. Encoding and buffering issues are dealt with at a higher level. @@ -1401,25 +1413,25 @@ in a generic way.

    io_seek ()

    (optional) seeks the channel. This is called from +(optional) seeks the channel. This is called from g_io_channel_seek() on channels that support it.

    io_close ()

    closes the channel. This is called from +closes the channel. This is called from g_io_channel_close() after flushing the buffers.

    io_create_watch ()

    creates a watch on the channel. This call +creates a watch on the channel. This call corresponds directly to g_io_create_watch().

    io_free ()

    called from g_io_channel_unref() when the channel needs to +called from g_io_channel_unref() when the channel needs to be freed. This function must free the memory associated with the channel, including freeing the GIOChannel structure itself. The channel buffers have been flushed @@ -1429,7 +1441,7 @@ in a generic way.

    io_set_flags ()

    sets the GIOFlags on the channel. This is called +sets the GIOFlags on the channel. This is called from g_io_channel_set_flags() with all flags except for G_IO_FLAG_APPEND and G_IO_FLAG_NONBLOCK masked out. @@ -1437,7 +1449,7 @@ in a generic way.

    io_get_flags ()

    gets the GIOFlags for the channel. This function +gets the GIOFlags for the channel. This function need only return the G_IO_FLAG_APPEND and G_IO_FLAG_NONBLOCK flags; g_io_channel_get_flags() automatically adds the others as appropriate. @@ -1449,15 +1461,16 @@ in a generic way.


    g_io_channel_get_buffer_size ()

    -
    gsize               g_io_channel_get_buffer_size        (GIOChannel *channel);
    +
    gsize               g_io_channel_get_buffer_size        (GIOChannel *channel);

    -Gets the buffer size.

    +Gets the buffer size. +

    - @@ -1471,21 +1484,22 @@ Gets the buffer size.


    g_io_channel_set_buffer_size ()

    -
    void                g_io_channel_set_buffer_size        (GIOChannel *channel,
    -                                                         gsize size);
    +
    void                g_io_channel_set_buffer_size        (GIOChannel *channel,
    +                                                         gsize size);

    -Sets the buffer size.

    +Sets the buffer size. +

    channel :

    a GIOChannel +a GIOChannel
    - - @@ -1494,17 +1508,18 @@ Sets the buffer size.


    g_io_channel_get_buffer_condition ()

    -
    GIOCondition        g_io_channel_get_buffer_condition   (GIOChannel *channel);
    +
    GIOCondition        g_io_channel_get_buffer_condition   (GIOChannel *channel);

    This function returns a GIOCondition depending on whether there is data to be read/space to write data in the internal buffers in -the GIOChannel. Only the flags G_IO_IN and G_IO_OUT may be set.

    +the GIOChannel. Only the flags G_IO_IN and G_IO_OUT may be set. +

    channel :

    a GIOChannel +a GIOChannel

    size :

    the size of the buffer, or 0 to let GLib pick a good size +the size of the buffer, or 0 to let GLib pick a good size
    - @@ -1518,7 +1533,7 @@ the <

    g_io_channel_get_flags ()

    -
    GIOFlags            g_io_channel_get_flags              (GIOChannel *channel);
    +
    GIOFlags            g_io_channel_get_flags              (GIOChannel *channel);

    Gets the current flags for a GIOChannel, including read-only flags such as G_IO_FLAG_IS_READABLE. @@ -1529,13 +1544,14 @@ are cached for internal use by the channel when it is created. If they should change at some later point (e.g. partial shutdown of a socket with the UNIX shutdown() function), the user should immediately call g_io_channel_get_flags() to update -the internal values of these flags.

    +the internal values of these flags. +

    channel :

    A GIOChannel +A GIOChannel
    - @@ -1549,27 +1565,28 @@ the internal values of these flags.


    g_io_channel_set_flags ()

    -
    GIOStatus           g_io_channel_set_flags              (GIOChannel *channel,
    -                                                         GIOFlags flags,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_set_flags              (GIOChannel *channel,
    +                                                         GIOFlags flags,
    +                                                         GError **error);

    -Sets the (writeable) flags in channel to (flags & G_IO_CHANNEL_SET_MASK).

    +Sets the (writeable) flags in channel to (flags & G_IO_CHANNEL_SET_MASK). +

    channel :

    a GIOChannel +a GIOChannel
    - - - @@ -1598,57 +1615,58 @@ Sets the (writeable) flags in channel to

    Specifies properties of a GIOChannel. Some of the flags can only be read with g_io_channel_get_flags(), but not changed with -g_io_channel_set_flags().

    +g_io_channel_set_flags(). +

    channel :

    a GIOChannel +a GIOChannel

    flags :

    the flags to set on the IO channel +the flags to set on the IO channel

    error :

    A location to return an error of type GIOChannelError +A location to return an error of type GIOChannelError
    - - - - - - - - @@ -1658,23 +1676,24 @@ read with

    g_io_channel_get_line_term ()

    -
    const gchar*        g_io_channel_get_line_term          (GIOChannel *channel,
    -                                                         gint *length);
    +
    const gchar*        g_io_channel_get_line_term          (GIOChannel *channel,
    +                                                         gint *length);

    This returns the string that GIOChannel uses to determine where in the file a line break occurs. A value of NULL -indicates autodetection.

    +indicates autodetection. +

    G_IO_FLAG_APPEND

    turns on append mode, corresponds to O_APPEND +turns on append mode, corresponds to O_APPEND (see the documentation of the UNIX open() syscall).

    G_IO_FLAG_NONBLOCK

    turns on nonblocking mode, corresponds to +turns on nonblocking mode, corresponds to O_NONBLOCK/O_NDELAY (see the documentation of the UNIX open() syscall).

    G_IO_FLAG_IS_READABLE

    indicates that the io channel is readable. +indicates that the io channel is readable. This flag can not be changed.

    G_IO_FLAG_IS_WRITEABLE

    indicates that the io channel is writable. +indicates that the io channel is writable. This flag can not be changed.

    G_IO_FLAG_IS_SEEKABLE

    indicates that the io channel is seekable, +indicates that the io channel is seekable, i.e. that g_io_channel_seek_position() can be used on it. This flag can not be changed.

    G_IO_FLAG_MASK

    the mask that specifies all the valid flags. +the mask that specifies all the valid flags.

    G_IO_FLAG_GET_MASK

    the mask of the flags that are returned from +the mask of the flags that are returned from g_io_channel_get_flags().

    G_IO_FLAG_SET_MASK

    the mask of the flags that the user can modify +the mask of the flags that the user can modify with g_io_channel_set_flags().
    - - @@ -1689,23 +1708,24 @@ indicates autodetection.


    g_io_channel_set_line_term ()

    -
    void                g_io_channel_set_line_term          (GIOChannel *channel,
    -                                                         const gchar *line_term,
    -                                                         gint length);
    +
    void                g_io_channel_set_line_term          (GIOChannel *channel,
    +                                                         const gchar *line_term,
    +                                                         gint length);

    This sets the string that GIOChannel uses to determine -where in the file a line break occurs.

    +where in the file a line break occurs. +

    channel :

    a GIOChannel +a GIOChannel

    length :

    a location to return the length of the line terminator +a location to return the length of the line terminator
    - - - @@ -1724,15 +1744,16 @@ where in the file a line break occurs.


    g_io_channel_get_buffered ()

    -
    gboolean            g_io_channel_get_buffered           (GIOChannel *channel);
    +
    gboolean            g_io_channel_get_buffered           (GIOChannel *channel);

    -Returns whether channel is buffered.

    +Returns whether channel is buffered. +

    channel :

    a GIOChannel +a GIOChannel

    line_term :

    The line termination string. Use NULL for autodetect. +The line termination string. Use NULL for autodetect. Autodetection breaks on "\n", "\r\n", "\r", "\0", and the Unicode paragraph separator. Autodetection should not be used for anything other than file-based channels. @@ -1713,7 +1733,7 @@ where in the file a line break occurs.

    length :

    The length of the termination string. If -1 is passed, the +The length of the termination string. If -1 is passed, the string is assumed to be nul-terminated. This option allows termination strings with embedded nuls.
    - @@ -1746,8 +1767,8 @@ Returns whether channel is buffered.


    g_io_channel_set_buffered ()

    -
    void                g_io_channel_set_buffered           (GIOChannel *channel,
    -                                                         gboolean buffered);
    +
    void                g_io_channel_set_buffered           (GIOChannel *channel,
    +                                                         gboolean buffered);

    The buffering state can only be set if the channel's encoding is NULL. For any other encoding, the channel must be buffered. @@ -1770,18 +1791,19 @@ calls from the new and old APIs, if this is necessary for maintaining old code.

    -The default state of the channel is buffered.

    +The default state of the channel is buffered. +

    channel :

    a GIOChannel +a GIOChannel
    - - @@ -1790,17 +1812,18 @@ The default state of the channel is buffered.


    g_io_channel_get_encoding ()

    -
    const gchar*        g_io_channel_get_encoding           (GIOChannel *channel);
    +
    const gchar*        g_io_channel_get_encoding           (GIOChannel *channel);

    Gets the encoding for the input/output of the channel. The internal encoding is always UTF-8. The encoding NULL -makes the channel safe for binary data.

    +makes the channel safe for binary data. +

    channel :

    a GIOChannel +a GIOChannel

    buffered :

    whether to set the channel buffered or unbuffered +whether to set the channel buffered or unbuffered
    - @@ -1815,9 +1838,9 @@ makes the channel safe for binary data.


    g_io_channel_set_encoding ()

    -
    GIOStatus           g_io_channel_set_encoding           (GIOChannel *channel,
    -                                                         const gchar *encoding,
    -                                                         GError **error);
    +
    GIOStatus           g_io_channel_set_encoding           (GIOChannel *channel,
    +                                                         const gchar *encoding,
    +                                                         GError **error);

    Sets the encoding for the input/output of the channel. The internal encoding is always UTF-8. The default encoding @@ -1865,23 +1888,24 @@ is true: Channels which do not meet one of the above conditions cannot call g_io_channel_seek_position() with an offset of G_SEEK_CUR, and, if they are "seekable", cannot call g_io_channel_write_chars() after -calling one of the API "read" functions.

    +calling one of the API "read" functions. +

    channel :

    a GIOChannel +a GIOChannel
    - - - @@ -1895,18 +1919,19 @@ calling one of the API "read" functions.


    g_io_channel_get_close_on_unref ()

    -
    gboolean            g_io_channel_get_close_on_unref     (GIOChannel *channel);
    +
    gboolean            g_io_channel_get_close_on_unref     (GIOChannel *channel);

    Returns whether the file/socket/whatever associated with channel will be closed when channel receives its final unref and is destroyed. The default value of this is TRUE for channels created -by g_io_channel_new_file(), and FALSE for all other channels.

    +by g_io_channel_new_file(), and FALSE for all other channels. +

    channel :

    a GIOChannel +a GIOChannel

    encoding :

    the encoding type +the encoding type

    error :

    location to store an error of type GConvertError +location to store an error of type GConvertError
    - @@ -1921,22 +1946,23 @@ by

    g_io_channel_set_close_on_unref ()

    -
    void                g_io_channel_set_close_on_unref     (GIOChannel *channel,
    -                                                         gboolean do_close);
    +
    void                g_io_channel_set_close_on_unref     (GIOChannel *channel,
    +                                                         gboolean do_close);

    Setting this flag to TRUE for a channel you have already closed -can cause problems.

    +can cause problems. +

    channel :

    a GIOChannel. +a GIOChannel.
    - -

    channel :

    a GIOChannel +a GIOChannel

    do_close :

    Whether to close the channel on the final unref of +Whether to close the channel on the final unref of the GIOChannel data structure. The default value of this is TRUE for channels created by g_io_channel_new_file(), and FALSE for all other channels. @@ -1948,38 +1974,39 @@ can cause problems.


    g_io_channel_read ()

    -
    GIOError            g_io_channel_read                   (GIOChannel *channel,
    -                                                         gchar *buf,
    -                                                         gsize count,
    -                                                         gsize *bytes_read);
    +
    GIOError            g_io_channel_read                   (GIOChannel *channel,
    +                                                         gchar *buf,
    +                                                         gsize count,
    +                                                         gsize *bytes_read);

    Warning

    g_io_channel_read has been deprecated since version 2.2 and should not be used in newly-written code. Use g_io_channel_read_chars() instead.

    -Reads data from a GIOChannel.

    +Reads data from a GIOChannel. +

    - - - - @@ -2004,28 +2031,29 @@ Reads data from a

    GIOError is only used by the deprecated functions -g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek().

    +g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). +

    channel :

    a GIOChannel +a GIOChannel

    buf :

    a buffer to read the data into (which should be at least +a buffer to read the data into (which should be at least count bytes long)

    count :

    the number of bytes to read from the GIOChannel +the number of bytes to read from the GIOChannel

    bytes_read :

    returns the number of bytes actually read +returns the number of bytes actually read
    - - - - @@ -2034,37 +2062,38 @@ Reads data from a

    g_io_channel_write ()

    -
    GIOError            g_io_channel_write                  (GIOChannel *channel,
    -                                                         const gchar *buf,
    -                                                         gsize count,
    -                                                         gsize *bytes_written);
    +
    GIOError            g_io_channel_write                  (GIOChannel *channel,
    +                                                         const gchar *buf,
    +                                                         gsize count,
    +                                                         gsize *bytes_written);

    Warning

    g_io_channel_write has been deprecated since version 2.2 and should not be used in newly-written code. Use g_io_channel_write_chars() instead.

    -Writes data to a GIOChannel.

    +Writes data to a GIOChannel. +

    G_IO_ERROR_NONE

    no error +no error

    G_IO_ERROR_AGAIN

    an EAGAIN error occurred +an EAGAIN error occurred

    G_IO_ERROR_INVAL

    an EINVAL error occurred +an EINVAL error occurred

    G_IO_ERROR_UNKNOWN

    another error occurred +another error occurred
    - - - - @@ -2079,33 +2108,34 @@ Writes data to a

    g_io_channel_seek ()

    -
    GIOError            g_io_channel_seek                   (GIOChannel *channel,
    -                                                         gint64 offset,
    -                                                         GSeekType type);
    +
    GIOError            g_io_channel_seek                   (GIOChannel *channel,
    +                                                         gint64 offset,
    +                                                         GSeekType type);

    Warning

    g_io_channel_seek has been deprecated since version 2.2 and should not be used in newly-written code. Use g_io_channel_seek_position() instead.

    Sets the current position in the GIOChannel, similar to the standard -library function fseek().

    +library function fseek(). +

    channel :

    a GIOChannel +a GIOChannel

    buf :

    the buffer containing the data to write +the buffer containing the data to write

    count :

    the number of bytes to write +the number of bytes to write

    bytes_written :

    the number of bytes actually written +the number of bytes actually written
    - - - @@ -2122,7 +2152,7 @@ library function fseek().


    g_io_channel_close ()

    -
    void                g_io_channel_close                  (GIOChannel *channel);
    +
    void                g_io_channel_close                  (GIOChannel *channel);

    Warning

    g_io_channel_close has been deprecated since version 2.2 and should not be used in newly-written code. Use g_io_channel_shutdown() instead.

    @@ -2130,12 +2160,13 @@ library function fseek().

    Close an IO channel. Any pending data to be written will be flushed, ignoring errors. The channel will not be freed until the -last reference is dropped using g_io_channel_unref().

    +last reference is dropped using g_io_channel_unref(). +

    channel :

    a GIOChannel +a GIOChannel

    offset :

    an offset, in bytes, which is added to the position specified +an offset, in bytes, which is added to the position specified by type

    type :

    the position in the file, which can be G_SEEK_CUR (the current +the position in the file, which can be G_SEEK_CUR (the current position), G_SEEK_SET (the start of the file), or G_SEEK_END (the end of the file)
    -

    channel :

    A GIOChannel +A GIOChannel
    @@ -2160,6 +2191,6 @@ last reference is dropped using
    - Generated by GTK-Doc V1.13
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Key-value-file-parser.html b/docs/reference/glib/html/glib-Key-value-file-parser.html index 9053cb1..f2ece0a 100644 --- a/docs/reference/glib/html/glib-Key-value-file-parser.html +++ b/docs/reference/glib/html/glib-Key-value-file-parser.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -65,170 +45,170 @@ enum GKeyFileError; enum GKeyFileFlags; -GKeyFile * g_key_file_new (void); -voidg_key_file_free (GKeyFile *key_file); -voidg_key_file_set_list_separator (GKeyFile *key_file, - gchar separator); -gbooleang_key_file_load_from_file (GKeyFile *key_file, - const gchar *file, - GKeyFileFlags flags, - GError **error); -gbooleang_key_file_load_from_data (GKeyFile *key_file, - const gchar *data, - gsize length, - GKeyFileFlags flags, - GError **error); -gbooleang_key_file_load_from_data_dirs (GKeyFile *key_file, - const gchar *file, - gchar **full_path, - GKeyFileFlags flags, - GError **error); -gbooleang_key_file_load_from_dirs (GKeyFile *key_file, - const gchar *file, - const gchar **search_dirs, - gchar **full_path, - GKeyFileFlags flags, - GError **error); -gchar * g_key_file_to_data (GKeyFile *key_file, - gsize *length, - GError **error); -gchar * g_key_file_get_start_group (GKeyFile *key_file); -gchar ** g_key_file_get_groups (GKeyFile *key_file, - gsize *length); -gchar ** g_key_file_get_keys (GKeyFile *key_file, - const gchar *group_name, - gsize *length, - GError **error); -gbooleang_key_file_has_group (GKeyFile *key_file, - const gchar *group_name); -gbooleang_key_file_has_key (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); +GKeyFile * g_key_file_new (void); +voidg_key_file_free (GKeyFile *key_file); +voidg_key_file_set_list_separator (GKeyFile *key_file, + gchar separator); +gbooleang_key_file_load_from_file (GKeyFile *key_file, + const gchar *file, + GKeyFileFlags flags, + GError **error); +gbooleang_key_file_load_from_data (GKeyFile *key_file, + const gchar *data, + gsize length, + GKeyFileFlags flags, + GError **error); +gbooleang_key_file_load_from_data_dirs (GKeyFile *key_file, + const gchar *file, + gchar **full_path, + GKeyFileFlags flags, + GError **error); +gbooleang_key_file_load_from_dirs (GKeyFile *key_file, + const gchar *file, + const gchar **search_dirs, + gchar **full_path, + GKeyFileFlags flags, + GError **error); +gchar * g_key_file_to_data (GKeyFile *key_file, + gsize *length, + GError **error); +gchar * g_key_file_get_start_group (GKeyFile *key_file); +gchar ** g_key_file_get_groups (GKeyFile *key_file, + gsize *length); +gchar ** g_key_file_get_keys (GKeyFile *key_file, + const gchar *group_name, + gsize *length, + GError **error); +gbooleang_key_file_has_group (GKeyFile *key_file, + const gchar *group_name); +gbooleang_key_file_has_key (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); -gchar * g_key_file_get_value (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gchar * g_key_file_get_string (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gchar * g_key_file_get_locale_string (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *locale, - GError **error); -gbooleang_key_file_get_boolean (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gintg_key_file_get_integer (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gdoubleg_key_file_get_double (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gchar ** g_key_file_get_string_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gsize *length, - GError **error); -gchar ** g_key_file_get_locale_string_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *locale, - gsize *length, - GError **error); -gboolean * g_key_file_get_boolean_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gsize *length, - GError **error); -gint * g_key_file_get_integer_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gsize *length, - GError **error); -gdouble * g_key_file_get_double_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gsize *length, - GError **error); -gchar * g_key_file_get_comment (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); +gchar * g_key_file_get_value (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gchar * g_key_file_get_string (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gchar * g_key_file_get_locale_string (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *locale, + GError **error); +gbooleang_key_file_get_boolean (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gintg_key_file_get_integer (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gdoubleg_key_file_get_double (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gchar ** g_key_file_get_string_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gsize *length, + GError **error); +gchar ** g_key_file_get_locale_string_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *locale, + gsize *length, + GError **error); +gboolean * g_key_file_get_boolean_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gsize *length, + GError **error); +gint * g_key_file_get_integer_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gsize *length, + GError **error); +gdouble * g_key_file_get_double_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gsize *length, + GError **error); +gchar * g_key_file_get_comment (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); -voidg_key_file_set_value (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *value); -voidg_key_file_set_string (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *string); -voidg_key_file_set_locale_string (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *locale, - const gchar *string); -voidg_key_file_set_boolean (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gboolean value); -voidg_key_file_set_integer (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gint value); -voidg_key_file_set_double (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gdouble value); -voidg_key_file_set_string_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar * const list[], - gsize length); -voidg_key_file_set_locale_string_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *locale, - const gchar * const list[], - gsize length); -voidg_key_file_set_boolean_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gboolean list[], - gsize length); -voidg_key_file_set_integer_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gint list[], - gsize length); -voidg_key_file_set_double_list (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - gdouble list[], - gsize length); -gbooleang_key_file_set_comment (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - const gchar *comment, - GError **error); -gbooleang_key_file_remove_group (GKeyFile *key_file, - const gchar *group_name, - GError **error); -gbooleang_key_file_remove_key (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); -gbooleang_key_file_remove_comment (GKeyFile *key_file, - const gchar *group_name, - const gchar *key, - GError **error); +voidg_key_file_set_value (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *value); +voidg_key_file_set_string (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *string); +voidg_key_file_set_locale_string (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *locale, + const gchar *string); +voidg_key_file_set_boolean (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gboolean value); +voidg_key_file_set_integer (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gint value); +voidg_key_file_set_double (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gdouble value); +voidg_key_file_set_string_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar * const list[], + gsize length); +voidg_key_file_set_locale_string_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *locale, + const gchar * const list[], + gsize length); +voidg_key_file_set_boolean_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gboolean list[], + gsize length); +voidg_key_file_set_integer_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gint list[], + gsize length); +voidg_key_file_set_double_list (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + gdouble list[], + gsize length); +gbooleang_key_file_set_comment (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + const gchar *comment, + GError **error); +gbooleang_key_file_remove_group (GKeyFile *key_file, + const gchar *group_name, + GError **error); +gbooleang_key_file_remove_key (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); +gbooleang_key_file_remove_comment (GKeyFile *key_file, + const gchar *group_name, + const gchar *key, + GError **error); #define G_KEY_FILE_DESKTOP_GROUP #define G_KEY_FILE_DESKTOP_KEY_TYPE @@ -273,21 +253,41 @@ The syntax of key files is described in detail in the Entry Specification, here is a quick summary: Key files consists of groups of key-value pairs, interspersed with comments.

    -
    -# this is just an example
    -# there can be comments before the first group
    -[First Group]
    -Name=Key File Example\tthis value shows\nescaping
    -# localized strings are stored in multiple key-value pairs
    -Welcome=Hello
    -Welcome[de]=Hallo
    -Welcome[fr_FR]=Bonjour
    -Welcome[it]=Ciao
    -Welcome[be@latin]=Hello
    -[Another Group]
    -Numbers=2;20;-200;0
    -Booleans=true;false;true;true
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    # this is just an example
    +# there can be comments before the first group
    +[First Group]
    +Name=Key File Example\tthis value shows\nescaping
    +# localized strings are stored in multiple key-value pairs
    +Welcome=Hello
    +Welcome[de]=Hallo
    +Welcome[fr_FR]=Bonjour
    +Welcome[it]=Ciao
    +Welcome[be@latin]=Hello
    +[Another Group]
    +Numbers=2;20;-200;0
    +Booleans=true;false;true;true
    + +

    Lines beginning with a '#' and blank lines are considered comments.

    @@ -463,12 +463,13 @@ Flags which influence the parsing.

    g_key_file_new ()

    -
    GKeyFile *          g_key_file_new                      (void);
    +
    GKeyFile *          g_key_file_new                      (void);

    Creates a new empty GKeyFile object. Use g_key_file_load_from_file(), g_key_file_load_from_data(), g_key_file_load_from_dirs() or g_key_file_load_from_data_dirs() to -read an existing key file.

    +read an existing key file. +

    @@ -483,14 +484,15 @@ read an existing key file.


    g_key_file_free ()

    -
    void                g_key_file_free                     (GKeyFile *key_file);
    +
    void                g_key_file_free                     (GKeyFile *key_file);

    -Frees a GKeyFile.

    +Frees a GKeyFile. +

    -

    key_file :

    a GKeyFile +a GKeyFile
    @@ -499,23 +501,24 @@ Frees a

    g_key_file_set_list_separator ()

    -
    void                g_key_file_set_list_separator       (GKeyFile *key_file,
    -                                                         gchar separator);
    +
    void                g_key_file_set_list_separator       (GKeyFile *key_file,
    +                                                         gchar separator);

    Sets the character which is used to separate values in lists. Typically ';' or ',' are used -as separators. The default list separator is ';'.

    +as separators. The default list separator is ';'. +

    - - @@ -525,35 +528,36 @@ as separators. The default list separator is ';'.


    g_key_file_load_from_file ()

    -
    gboolean            g_key_file_load_from_file           (GKeyFile *key_file,
    -                                                         const gchar *file,
    -                                                         GKeyFileFlags flags,
    -                                                         GError **error);
    +
    gboolean            g_key_file_load_from_file           (GKeyFile *key_file,
    +                                                         const gchar *file,
    +                                                         GKeyFileFlags flags,
    +                                                         GError **error);

    Loads a key file into an empty GKeyFile structure. If the file could not be loaded then error is set to -either a GFileError or GKeyFileError.

    +either a GFileError or GKeyFileError. +

    key_file :

    a GKeyFile +a GKeyFile

    separator :

    the separator +the separator
    - - - - @@ -569,40 +573,41 @@ either a

    g_key_file_load_from_data ()

    -
    gboolean            g_key_file_load_from_data           (GKeyFile *key_file,
    -                                                         const gchar *data,
    -                                                         gsize length,
    -                                                         GKeyFileFlags flags,
    -                                                         GError **error);
    +
    gboolean            g_key_file_load_from_data           (GKeyFile *key_file,
    +                                                         const gchar *data,
    +                                                         gsize length,
    +                                                         GKeyFileFlags flags,
    +                                                         GError **error);

    Loads a key file from memory into an empty GKeyFile structure. -If the object cannot be created then error is set to a GKeyFileError.

    +If the object cannot be created then error is set to a GKeyFileError. +

    key_file :

    an empty GKeyFile struct +an empty GKeyFile struct

    file :

    the path of a filename to load, in the GLib filename encoding +the path of a filename to load, in the GLib filename encoding

    flags :

    flags from GKeyFileFlags +flags from GKeyFileFlags

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - - @@ -618,44 +623,45 @@ If the object cannot be created then error is set t

    g_key_file_load_from_data_dirs ()

    -
    gboolean            g_key_file_load_from_data_dirs      (GKeyFile *key_file,
    -                                                         const gchar *file,
    -                                                         gchar **full_path,
    -                                                         GKeyFileFlags flags,
    -                                                         GError **error);
    +
    gboolean            g_key_file_load_from_data_dirs      (GKeyFile *key_file,
    +                                                         const gchar *file,
    +                                                         gchar **full_path,
    +                                                         GKeyFileFlags flags,
    +                                                         GError **error);

    This function looks for a key file named file in the paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into key_file and returns the file's full path in full_path. If the file could not be loaded then an error is -set to either a GFileError or GKeyFileError.

    +set to either a GFileError or GKeyFileError. +

    key_file :

    an empty GKeyFile struct +an empty GKeyFile struct

    data :

    key file loaded in memory +key file loaded in memory

    length :

    the length of data in bytes +the length of data in bytes

    flags :

    flags from GKeyFileFlags +flags from GKeyFileFlags

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - - @@ -670,50 +676,52 @@ set to either a

    g_key_file_load_from_dirs ()

    -
    gboolean            g_key_file_load_from_dirs           (GKeyFile *key_file,
    -                                                         const gchar *file,
    -                                                         const gchar **search_dirs,
    -                                                         gchar **full_path,
    -                                                         GKeyFileFlags flags,
    -                                                         GError **error);
    +
    gboolean            g_key_file_load_from_dirs           (GKeyFile *key_file,
    +                                                         const gchar *file,
    +                                                         const gchar **search_dirs,
    +                                                         gchar **full_path,
    +                                                         GKeyFileFlags flags,
    +                                                         GError **error);

    This function looks for a key file named file in the paths specified in search_dirs, loads the file into key_file and returns the file's full path in full_path. If the file could not be loaded then an error is set to either a GFileError or -GKeyFileError.

    +GKeyFileError. +

    key_file :

    an empty GKeyFile struct +an empty GKeyFile struct

    file :

    a relative path to a filename to open and parse +a relative path to a filename to open and parse

    full_path :

    return location for a string containing the full path +return location for a string containing the full path of the file, or NULL

    flags :

    flags from GKeyFileFlags +flags from GKeyFileFlags

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - - - @@ -729,32 +737,33 @@ be loaded then an error is set to either a

    g_key_file_to_data ()

    -
    gchar *             g_key_file_to_data                  (GKeyFile *key_file,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gchar *             g_key_file_to_data                  (GKeyFile *key_file,
    +                                                         gsize *length,
    +                                                         GError **error);

    This function outputs key_file as a string.

    Note that this function never reports an error, -so it is safe to pass NULL as error.

    +so it is safe to pass NULL as error. +

    key_file :

    an empty GKeyFile struct +an empty GKeyFile struct

    file :

    a relative path to a filename to open and parse +a relative path to a filename to open and parse

    search_dirs :

    NULL-terminated array of directories to search + +NULL-terminated array of directories to search

    full_path :

    return location for a string containing the full path +return location for a string containing the full path of the file, or NULL

    flags :

    flags from GKeyFileFlags +flags from GKeyFileFlags

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - @@ -771,15 +780,16 @@ so it is safe to pass

    g_key_file_get_start_group ()

    -
    gchar *             g_key_file_get_start_group          (GKeyFile *key_file);
    +
    gchar *             g_key_file_get_start_group          (GKeyFile *key_file);

    -Returns the name of the start group of the file.

    +Returns the name of the start group of the file. +

    key_file :

    a GKeyFile +a GKeyFile

    length :

    return location for the length of the +return location for the length of the returned string, or NULL

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - @@ -795,23 +805,24 @@ Returns the name of the start group of the file.


    g_key_file_get_groups ()

    -
    gchar **            g_key_file_get_groups               (GKeyFile *key_file,
    -                                                         gsize *length);
    +
    gchar **            g_key_file_get_groups               (GKeyFile *key_file,
    +                                                         gsize *length);

    Returns all groups in the key file loaded with key_file. The array of returned groups will be NULL-terminated, so -length may optionally be NULL.

    +length may optionally be NULL. +

    key_file :

    a GKeyFile +a GKeyFile
    - - @@ -827,37 +838,38 @@ The array of returned groups will be

    g_key_file_get_keys ()

    -
    gchar **            g_key_file_get_keys                 (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gchar **            g_key_file_get_keys                 (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns all keys for the group name group_name. The array of returned keys will be NULL-terminated, so length may optionally be NULL. In the event that the group_name cannot be found, NULL is returned and error is set to -G_KEY_FILE_ERROR_GROUP_NOT_FOUND.

    +G_KEY_FILE_ERROR_GROUP_NOT_FOUND. +

    key_file :

    a GKeyFile +a GKeyFile

    length :

    return location for the number of returned groups, or NULL +return location for the number of returned groups, or NULL
    - - - - @@ -874,21 +886,22 @@ be found,

    g_key_file_has_group ()

    -
    gboolean            g_key_file_has_group                (GKeyFile *key_file,
    -                                                         const gchar *group_name);
    +
    gboolean            g_key_file_has_group                (GKeyFile *key_file,
    +                                                         const gchar *group_name);

    -Looks whether the key file has the group group_name.

    +Looks whether the key file has the group group_name. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    length :

    return location for the number of keys returned, or NULL +return location for the number of keys returned, or NULL

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - @@ -904,34 +917,35 @@ otherwise.

    g_key_file_has_key ()

    -
    gboolean            g_key_file_has_key                  (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gboolean            g_key_file_has_key                  (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Looks whether the key file has the key key in the group -group_name.

    +group_name. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name
    - - - - @@ -948,10 +962,10 @@ otherwise.

    g_key_file_get_value ()

    -
    gchar *             g_key_file_get_value                (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gchar *             g_key_file_get_value                (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Returns the raw value associated with key under group_name. Use g_key_file_get_string() to retrieve an unescaped UTF-8 string. @@ -960,28 +974,29 @@ Use NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the group_name cannot be found, NULL is returned -and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND.

    +and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key name +a key name

    error :

    return location for a GError +return location for a GError
    - - - - @@ -998,10 +1013,10 @@ and error is set to

    g_key_file_get_string ()

    -
    gchar *             g_key_file_get_string               (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gchar *             g_key_file_get_string               (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Returns the string value associated with key under group_name. Unlike g_key_file_get_value(), this function handles escape sequences @@ -1011,28 +1026,29 @@ like \s. In the event the key cannot be found, NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the group_name cannot be found, NULL is returned -and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND.

    +and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - @@ -1049,11 +1065,11 @@ and error is set to

    g_key_file_get_locale_string ()

    -
    gchar *             g_key_file_get_locale_string        (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *locale,
    -                                                         GError **error);
    +
    gchar *             g_key_file_get_locale_string        (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *locale,
    +                                                         GError **error);

    Returns the value associated with key under group_name translated in the given locale if available. If locale is @@ -1063,33 +1079,34 @@ translated in the given locale if availa If key cannot be found then NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the value associated with key cannot be interpreted or no suitable translation can -be found then the untranslated value is returned.

    +be found then the untranslated value is returned. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - - @@ -1106,10 +1123,10 @@ be found then the untranslated value is returned.


    g_key_file_get_boolean ()

    -
    gboolean            g_key_file_get_boolean              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gboolean            g_key_file_get_boolean              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Returns the value associated with key under group_name as a boolean. @@ -1118,28 +1135,29 @@ boolean. If key cannot be found then FALSE is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with key cannot be interpreted as a boolean then FALSE -is returned and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +is returned and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    locale :

    a locale identifier or NULL +a locale identifier or NULL

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - @@ -1156,10 +1174,10 @@ is returned and error is set to

    g_key_file_get_integer ()

    -
    gint                g_key_file_get_integer              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gint                g_key_file_get_integer              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Returns the value associated with key under group_name as an integer. @@ -1168,28 +1186,29 @@ integer. If key cannot be found then 0 is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with key cannot be interpreted as an integer then 0 is returned -and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    error :

    return location for a GError +return location for a GError
    - - - - @@ -1206,10 +1225,10 @@ and error is set to

    g_key_file_get_double ()

    -
    gdouble             g_key_file_get_double               (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gdouble             g_key_file_get_double               (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Returns the value associated with key under group_name as a double. If group_name is NULL, the start_group is used. @@ -1218,28 +1237,29 @@ double. If group_name is key cannot be found then 0.0 is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with key cannot be interpreted as a double then 0.0 is returned -and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    error :

    return location for a GError +return location for a GError
    - - - - @@ -1256,11 +1276,11 @@ and error is set to

    g_key_file_get_string_list ()

    -
    gchar **            g_key_file_get_string_list          (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gchar **            g_key_file_get_string_list          (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns the values associated with key under group_name.

    @@ -1268,33 +1288,34 @@ Returns the values associated with key u In the event the key cannot be found, NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the group_name cannot be found, NULL is returned -and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND.

    +and error is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    error :

    return location for a GError +return location for a GError
    - - - - - @@ -1311,12 +1332,12 @@ and error is set to

    g_key_file_get_locale_string_list ()

    -
    gchar **            g_key_file_get_locale_string_list   (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *locale,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gchar **            g_key_file_get_locale_string_list   (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *locale,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns the values associated with key under group_name translated in the given locale if available. If locale is @@ -1328,38 +1349,39 @@ to key cannot be interpreted or no suitable translations can be found then the untranslated values are returned. The returned array is NULL-terminated, so length may optionally -be NULL.

    +be NULL. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    length :

    return location for the number of returned strings, or NULL +return location for the number of returned strings, or NULL

    error :

    return location for a GError, or NULL +return location for a GError, or NULL
    - - - - - - @@ -1377,11 +1399,11 @@ be

    g_key_file_get_boolean_list ()

    -
    gboolean *          g_key_file_get_boolean_list         (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gboolean *          g_key_file_get_boolean_list         (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns the values associated with key under group_name as booleans. @@ -1390,33 +1412,34 @@ booleans. If key cannot be found then NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with key cannot be interpreted as booleans then NULL is returned -and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    locale :

    a locale identifier or NULL +a locale identifier or NULL

    length :

    return location for the number of returned strings or NULL +return location for the number of returned strings or NULL

    error :

    return location for a GError or NULL +return location for a GError or NULL
    - - - - - @@ -1433,11 +1456,11 @@ and error is set to

    g_key_file_get_integer_list ()

    -
    gint *              g_key_file_get_integer_list         (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gint *              g_key_file_get_integer_list         (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns the values associated with key under group_name as integers. @@ -1446,33 +1469,34 @@ integers. If key cannot be found then NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with key cannot be interpreted as integers then NULL is returned -and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    length :

    the number of booleans returned +the number of booleans returned

    error :

    return location for a GError +return location for a GError
    - - - - - @@ -1489,11 +1513,11 @@ and error is set to

    g_key_file_get_double_list ()

    -
    gdouble *           g_key_file_get_double_list          (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gsize *length,
    -                                                         GError **error);
    +
    gdouble *           g_key_file_get_double_list          (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gsize *length,
    +                                                         GError **error);

    Returns the values associated with key under group_name as doubles. @@ -1502,33 +1526,34 @@ doubles. If key cannot be found then NULL is returned and error is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with key cannot be interpreted as doubles then NULL is returned -and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.

    +and error is set to G_KEY_FILE_ERROR_INVALID_VALUE. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    length :

    the number of integers returned +the number of integers returned

    error :

    return location for a GError +return location for a GError
    - - - - - @@ -1545,36 +1570,37 @@ and error is set to

    g_key_file_get_comment ()

    -
    gchar *             g_key_file_get_comment              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gchar *             g_key_file_get_comment              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Retrieves a comment above key from group_name. If key is NULL then comment will be read from above group_name. If both key and group_name are NULL, then -comment will be read from above the first group in the file.

    +comment will be read from above the first group in the file. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    length :

    the number of doubles returned +the number of doubles returned

    error :

    return location for a GError +return location for a GError
    - - - - @@ -1590,10 +1616,10 @@ If key is

    g_key_file_set_value ()

    -
    void                g_key_file_set_value                (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *value);
    +
    void                g_key_file_set_value                (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *value);

    Associates a new value with key under group_name.

    @@ -1601,28 +1627,29 @@ Associates a new value with key under key cannot be found then it is created. If group_name cannot be found then it is created. To set an UTF-8 string which may contain characters that need escaping (such as newlines or spaces), use -g_key_file_set_string().

    +g_key_file_set_string(). +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name, or NULL +a group name, or NULL

    key :

    a key +a key

    error :

    return location for a GError +return location for a GError
    - - - - @@ -1632,37 +1659,38 @@ characters that need escaping (such as newlines or spaces), use

    g_key_file_set_string ()

    -
    void                g_key_file_set_string               (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *string);
    +
    void                g_key_file_set_string               (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *string);

    Associates a new string value with key under group_name. If key cannot be found then it is created. If group_name cannot be found then it is created. Unlike g_key_file_set_value(), this function handles characters -that need escaping, such as newlines.

    +that need escaping, such as newlines. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    value :

    a string +a string
    - - - - @@ -1672,40 +1700,41 @@ that need escaping, such as newlines.


    g_key_file_set_locale_string ()

    -
    void                g_key_file_set_locale_string        (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *locale,
    -                                                         const gchar *string);
    +
    void                g_key_file_set_locale_string        (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *locale,
    +                                                         const gchar *string);

    Associates a string value for key and locale under group_name. -If the translation for key cannot be found then it is created.

    +If the translation for key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    string :

    a string +a string
    - - - - - @@ -1715,34 +1744,36 @@ If the translation for key cannot be fou

    g_key_file_set_boolean ()

    -
    void                g_key_file_set_boolean              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gboolean value);
    +
    void                g_key_file_set_boolean              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gboolean value);

    Associates a new boolean value with key under group_name. -If key cannot be found then it is created.

    +If key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    locale :

    a locale identifier +a locale identifier

    string :

    a string +a string
    - - - - @@ -1752,34 +1783,35 @@ If key cannot be found then it is create

    g_key_file_set_integer ()

    -
    void                g_key_file_set_integer              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gint value);
    +
    void                g_key_file_set_integer              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gint value);

    Associates a new integer value with key under group_name. -If key cannot be found then it is created.

    +If key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    value :

    TRUE or FALSE + +TRUE or FALSE
    - - - - @@ -1789,34 +1821,35 @@ If key cannot be found then it is create

    g_key_file_set_double ()

    -
    void                g_key_file_set_double               (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gdouble value);
    +
    void                g_key_file_set_double               (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gdouble value);

    Associates a new double value with key under group_name. -If key cannot be found then it is created.

    +If key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    value :

    an integer value +an integer value
    - - - - @@ -1826,41 +1859,42 @@ If key cannot be found then it is create

    g_key_file_set_string_list ()

    -
    void                g_key_file_set_string_list          (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar * const list[],
    -                                                         gsize length);
    +
    void                g_key_file_set_string_list          (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar * const list[],
    +                                                         gsize length);

    Associates a list of string values for key under group_name. If key cannot be found then it is created. -If group_name cannot be found then it is created.

    +If group_name cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    value :

    an double value +an double value
    - - - - - @@ -1870,47 +1904,48 @@ If group_name cannot be found then it is

    g_key_file_set_locale_string_list ()

    -
    void                g_key_file_set_locale_string_list   (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *locale,
    -                                                         const gchar * const list[],
    -                                                         gsize length);
    +
    void                g_key_file_set_locale_string_list   (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *locale,
    +                                                         const gchar * const list[],
    +                                                         gsize length);

    Associates a list of string values for key and locale under group_name. If the translation for key cannot be found then -it is created.

    +it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    list :

    an array of string values +an array of string values

    length :

    number of string values in list +number of string values in list
    - - - - - - @@ -1920,41 +1955,42 @@ it is created.


    g_key_file_set_boolean_list ()

    -
    void                g_key_file_set_boolean_list         (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gboolean list[],
    -                                                         gsize length);
    +
    void                g_key_file_set_boolean_list         (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gboolean list[],
    +                                                         gsize length);

    Associates a list of boolean values with key under group_name. If key cannot be found then it is created. -If group_name is NULL, the start_group is used.

    +If group_name is NULL, the start_group is used. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    locale :

    a locale identifier +a locale identifier

    list :

    a NULL-terminated array of locale string values +a NULL-terminated array of locale string values

    length :

    the length of list +the length of list
    - - - - - @@ -1964,40 +2000,41 @@ If group_name is

    g_key_file_set_integer_list ()

    -
    void                g_key_file_set_integer_list         (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gint list[],
    -                                                         gsize length);
    +
    void                g_key_file_set_integer_list         (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gint list[],
    +                                                         gsize length);

    Associates a list of integer values with key under group_name. -If key cannot be found then it is created.

    +If key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    list :

    an array of boolean values +an array of boolean values

    length :

    length of list +length of list
    - - - - - @@ -2007,40 +2044,41 @@ If key cannot be found then it is create

    g_key_file_set_double_list ()

    -
    void                g_key_file_set_double_list          (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         gdouble list[],
    -                                                         gsize length);
    +
    void                g_key_file_set_double_list          (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         gdouble list[],
    +                                                         gsize length);

    Associates a list of double values with key under -group_name. If key cannot be found then it is created.

    +group_name. If key cannot be found then it is created. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    list :

    an array of integer values +an array of integer values

    length :

    number of integer values in list +number of integer values in list
    - - - - - @@ -2050,42 +2088,43 @@ Associates a list of double values with key

    g_key_file_set_comment ()

    -
    gboolean            g_key_file_set_comment              (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         const gchar *comment,
    -                                                         GError **error);
    +
    gboolean            g_key_file_set_comment              (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         const gchar *comment,
    +                                                         GError **error);

    Places a comment above key from group_name. If key is NULL then comment will be written above group_name. If both key and group_name are NULL, then comment will be -written above the first group in the file.

    +written above the first group in the file. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key +a key

    list :

    an array of double values +an array of double values

    length :

    number of double values in list +number of double values in list
    - - - - - @@ -2101,28 +2140,29 @@ written above the first group in the file.


    g_key_file_remove_group ()

    -
    gboolean            g_key_file_remove_group             (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         GError **error);
    +
    gboolean            g_key_file_remove_group             (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         GError **error);

    Removes the specified group, group_name, -from the key file.

    +from the key file. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name, or NULL +a group name, or NULL

    key :

    a key +a key

    comment :

    a comment +a comment

    error :

    return location for a GError +return location for a GError
    - - - @@ -2138,33 +2178,34 @@ from the key file.


    g_key_file_remove_key ()

    -
    gboolean            g_key_file_remove_key               (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gboolean            g_key_file_remove_key               (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    -Removes key in group_name from the key file.

    +Removes key in group_name from the key file. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    error :

    return location for a GError or NULL +return location for a GError or NULL
    - - - - @@ -2180,36 +2221,37 @@ Removes key in

    g_key_file_remove_comment ()

    -
    gboolean            g_key_file_remove_comment           (GKeyFile *key_file,
    -                                                         const gchar *group_name,
    -                                                         const gchar *key,
    -                                                         GError **error);
    +
    gboolean            g_key_file_remove_comment           (GKeyFile *key_file,
    +                                                         const gchar *group_name,
    +                                                         const gchar *key,
    +                                                         GError **error);

    Removes a comment above key from group_name. If key is NULL then comment will be removed above group_name. If both key and group_name are NULL, then comment will -be removed above the first group in the file.

    +be removed above the first group in the file. +

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name +a group name

    key :

    a key name to remove +a key name to remove

    error :

    return location for a GError or NULL +return location for a GError or NULL
    - - - - @@ -2509,6 +2551,6 @@ key for desktop entries representing directories. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Keyed-Data-Lists.html b/docs/reference/glib/html/glib-Keyed-Data-Lists.html index b55aca8..9ba60ea 100644 --- a/docs/reference/glib/html/glib-Keyed-Data-Lists.html +++ b/docs/reference/glib/html/glib-Keyed-Data-Lists.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    key_file :

    a GKeyFile +a GKeyFile

    group_name :

    a group name, or NULL +a group name, or NULL

    key :

    a key +a key

    error :

    return location for a GError +return location for a GError
    @@ -62,34 +42,45 @@ #include <glib.h> GData; -void g_datalist_init (GData **datalist); +void g_datalist_init (GData **datalist); -#define g_datalist_id_set_data (dl, q, d) -void g_datalist_id_set_data_full (GData **datalist, - GQuark key_id, - gpointer data, - GDestroyNotify destroy_func); -gpointer g_datalist_id_get_data (GData **datalist, - GQuark key_id); -#define g_datalist_id_remove_data (dl, q) -gpointer g_datalist_id_remove_no_notify (GData **datalist, - GQuark key_id); +#define g_datalist_id_set_data (dl, + q, + d) +void g_datalist_id_set_data_full (GData **datalist, + GQuark key_id, + gpointer data, + GDestroyNotify destroy_func); +gpointer g_datalist_id_get_data (GData **datalist, + GQuark key_id); +#define g_datalist_id_remove_data (dl, + q) +gpointer g_datalist_id_remove_no_notify (GData **datalist, + GQuark key_id); -#define g_datalist_set_data (dl, k, d) -#define g_datalist_set_data_full (dl, k, d, f) -#define g_datalist_get_data (dl, k) -#define g_datalist_remove_data (dl, k) -#define g_datalist_remove_no_notify (dl, k) +#define g_datalist_set_data (dl, + k, + d) +#define g_datalist_set_data_full (dl, + k, + d, + f) +#define g_datalist_get_data (dl, + k) +#define g_datalist_remove_data (dl, + k) +#define g_datalist_remove_no_notify (dl, + k) -void g_datalist_foreach (GData **datalist, - GDataForeachFunc func, - gpointer user_data); -void g_datalist_clear (GData **datalist); -void g_datalist_set_flags (GData **datalist, - guint flags); -void g_datalist_unset_flags (GData **datalist, - guint flags); -guint g_datalist_get_flags (GData **datalist); +void g_datalist_foreach (GData **datalist, + GDataForeachFunc func, + gpointer user_data); +void g_datalist_clear (GData **datalist); +void g_datalist_set_flags (GData **datalist, + guint flags); +void g_datalist_unset_flags (GData **datalist, + guint flags); +guint g_datalist_get_flags (GData **datalist); #define G_DATALIST_FLAGS_MASK @@ -105,8 +96,8 @@ The GQuarks anyway.

    -Data lists are used for associating arbitrary data with GObjects, -using g_object_set_data() and related functions. +Data lists are used for associating arbitrary data with GObjects, +using g_object_set_data() and related functions.

    To create a datalist, use g_datalist_init(). @@ -129,7 +120,8 @@ To remove data elements from a datalist use g_datalist_id_remove_data() and g_datalist_remove_data().

    -To remove all data elements from a datalist, use g_datalist_clear().

    +To remove all data elements from a datalist, use g_datalist_clear(). +

    Details

    @@ -138,20 +130,22 @@ To remove all data elements from a datalist, use typedef struct _GData GData;

    The GData struct is an opaque data structure to represent a Keyed Data List. It should -only be accessed via the following functions.

    +only be accessed via the following functions. +


    g_datalist_init ()

    -
    void                g_datalist_init                     (GData **datalist);
    +
    void                g_datalist_init                     (GData **datalist);

    Resets the datalist to NULL. It does not free any memory or call -any destroy functions.

    +any destroy functions. +

    -

    datalist :

    a pointer to a pointer to a datalist. +a pointer to a pointer to a datalist.
    @@ -163,23 +157,24 @@ any destroy functions.

    Sets the data corresponding to the given GQuark id. Any previous data with the same key is removed, and its destroy function is -called.

    +called. +

    - - - @@ -189,37 +184,38 @@ called.


    g_datalist_id_set_data_full ()

    -
    void                g_datalist_id_set_data_full         (GData **datalist,
    -                                                         GQuark key_id,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy_func);
    +
    void                g_datalist_id_set_data_full         (GData **datalist,
    +                                                         GQuark key_id,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy_func);

    Sets the data corresponding to the given GQuark id, and the function to be called when the element is removed from the datalist. Any previous data with the same key is removed, and its destroy -function is called.

    +function is called. +

    dl :

    a datalist. +a datalist.

    q :

    the GQuark to identify the data element. +the GQuark to identify the data element.

    d :

    the data element, or NULL to remove any previous element +the data element, or NULL to remove any previous element corresponding to q.
    - - - -

    datalist :

    a datalist. +a datalist.

    key_id :

    the GQuark to identify the data element. +the GQuark to identify the data element.

    data :

    the data element or NULL to remove any previous element +the data element or NULL to remove any previous element corresponding to key_id.

    destroy_func :

    the function to call when the data element is +the function to call when the data element is removed. This function will be called with the data element and can be used to free any memory allocated for it. If data is NULL, then destroy_func must @@ -232,26 +228,27 @@ function is called.


    g_datalist_id_get_data ()

    -
    gpointer            g_datalist_id_get_data              (GData **datalist,
    -                                                         GQuark key_id);
    +
    gpointer            g_datalist_id_get_data              (GData **datalist,
    +                                                         GQuark key_id);

    -Retrieves the data element corresponding to key_id.

    +Retrieves the data element corresponding to key_id. +

    - - - @@ -262,18 +259,19 @@ Retrieves the data element corresponding to key_id

    g_datalist_id_remove_data()

    #define             g_datalist_id_remove_data(dl, q)

    -Removes an element, using its GQuark identifier.

    +Removes an element, using its GQuark identifier. +

    datalist :

    a datalist. +a datalist.

    key_id :

    the GQuark identifying a data element. +the GQuark identifying a data element.

    Returns :

    the data element, or NULL if it is not found. +the data element, or NULL if it is not found.
    - - @@ -282,27 +280,28 @@ Removes an element, using its

    g_datalist_id_remove_no_notify ()

    -
    gpointer            g_datalist_id_remove_no_notify      (GData **datalist,
    -                                                         GQuark key_id);
    +
    gpointer            g_datalist_id_remove_no_notify      (GData **datalist,
    +                                                         GQuark key_id);

    Removes an element, without calling its destroy notification -function.

    +function. +

    dl :

    a datalist. +a datalist.

    q :

    the GQuark identifying the data element. +the GQuark identifying the data element.
    - - - @@ -313,23 +312,24 @@ function.

    g_datalist_set_data()

    #define             g_datalist_set_data(dl, k, d)

    -Sets the data element corresponding to the given string identifier.

    +Sets the data element corresponding to the given string identifier. +

    datalist :

    a datalist. +a datalist.

    key_id :

    the GQuark identifying a data element. +the GQuark identifying a data element.

    Returns :

    the data previously stored at key_id, or NULL if none. +the data previously stored at key_id, or NULL if none.
    - - - @@ -342,29 +342,30 @@ Sets the data element corresponding to the given string identifier.

    #define             g_datalist_set_data_full(dl, k, d, f)

    Sets the data element corresponding to the given string identifier, -and the function to be called when the data element is removed.

    +and the function to be called when the data element is removed. +

    dl :

    a datalist. +a datalist.

    k :

    the string to identify the data element. +the string to identify the data element.

    d :

    the data element, or NULL to remove any previous element +the data element, or NULL to remove any previous element corresponding to k.
    - - - -

    dl :

    a datalist. +a datalist.

    k :

    the string to identify the data element. +the string to identify the data element.

    d :

    the data element, or NULL to remove any previous element +the data element, or NULL to remove any previous element corresponding to k.

    f :

    the function to call when the data element is removed. This +the function to call when the data element is removed. This function will be called with the data element and can be used to free any memory allocated for it. If d is NULL, then f must also be NULL. @@ -380,23 +381,24 @@ and the function to be called when the data element is removed.

    Gets a data element, using its string identifer. This is slower than g_datalist_id_get_data() because the string is first converted to a -GQuark.

    +GQuark. +

    - - - @@ -408,18 +410,19 @@ Gets a data element, using its string identifer. This is slower than
    #define             g_datalist_remove_data(dl, k)

    Removes an element using its string identifier. The data element's -destroy function is called if it has been set.

    +destroy function is called if it has been set. +

    dl :

    a datalist. +a datalist.

    k :

    the string identifying a data element. +the string identifying a data element.

    Returns :

    the data element, or NULL if it is not found. +the data element, or NULL if it is not found.
    - - @@ -430,18 +433,19 @@ destroy function is called if it has been set.

    g_datalist_remove_no_notify()

    #define             g_datalist_remove_no_notify(dl, k)

    -Removes an element, without calling its destroy notifier.

    +Removes an element, without calling its destroy notifier. +

    dl :

    a datalist. +a datalist.

    k :

    the string identifying the data element. +the string identifying the data element.
    - - @@ -450,32 +454,33 @@ Removes an element, without calling its destroy notifier.


    g_datalist_foreach ()

    -
    void                g_datalist_foreach                  (GData **datalist,
    -                                                         GDataForeachFunc func,
    -                                                         gpointer user_data);
    +
    void                g_datalist_foreach                  (GData **datalist,
    +                                                         GDataForeachFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each data element of the datalist. The function is called with each data element's GQuark id and data, together with the given user_data parameter. Note that this function is NOT thread-safe. So unless datalist can be protected from any modifications during invocation of this function, it should -not be called.

    +not be called. +

    dl :

    a datalist. +a datalist.

    k :

    the string identifying the data element. +the string identifying the data element.
    - - - @@ -484,15 +489,16 @@ not be called.


    g_datalist_clear ()

    -
    void                g_datalist_clear                    (GData **datalist);
    +
    void                g_datalist_clear                    (GData **datalist);

    Frees all the data elements of the datalist. The data elements' -destroy functions are called if they have been set.

    +destroy functions are called if they have been set. +

    datalist :

    a datalist. +a datalist.

    func :

    the function to call for each data element. +the function to call for each data element.

    user_data :

    user data to pass to the function. +user data to pass to the function.
    -

    datalist :

    a datalist. +a datalist.
    @@ -500,26 +506,27 @@ destroy functions are called if they have been set.


    g_datalist_set_flags ()

    -
    void                g_datalist_set_flags                (GData **datalist,
    -                                                         guint flags);
    +
    void                g_datalist_set_flags                (GData **datalist,
    +                                                         guint flags);

    Turns on flag values for a data list. This function is used to keep a small number of boolean flags in an object with a data list without using any additional space. It is not generally useful except in circumstances where space -is very tight. (It is used in the base GObject type, for -example.)

    +is very tight. (It is used in the base GObject type, for +example.) +

    - -

    datalist :

    pointer to the location that holds a list +pointer to the location that holds a list

    flags :

    the flags to turn on. The values of the flags are +the flags to turn on. The values of the flags are restricted by G_DATALIST_FLAGS_MASK (currently 3; giving two possible boolean flags). A value for flags that doesn't fit within the mask is @@ -533,21 +540,22 @@ example.)


    g_datalist_unset_flags ()

    -
    void                g_datalist_unset_flags              (GData **datalist,
    -                                                         guint flags);
    +
    void                g_datalist_unset_flags              (GData **datalist,
    +                                                         guint flags);

    -Turns off flag values for a data list. See g_datalist_unset_flags()

    +Turns off flag values for a data list. See g_datalist_unset_flags() +

    - -

    datalist :

    pointer to the location that holds a list +pointer to the location that holds a list

    flags :

    the flags to turn off. The values of the flags are +the flags to turn off. The values of the flags are restricted by G_DATALIST_FLAGS_MASK (currently 3: giving two possible boolean flags). A value for flags that doesn't fit within the mask is @@ -561,16 +569,17 @@ Turns off flag values for a data list. See

    g_datalist_get_flags ()

    -
    guint               g_datalist_get_flags                (GData **datalist);
    +
    guint               g_datalist_get_flags                (GData **datalist);

    Gets flags values packed in together with the datalist. -See g_datalist_set_flags().

    +See g_datalist_set_flags(). +

    - @@ -591,12 +600,13 @@ See A bitmask that restricts the possible flags passed to g_datalist_set_flags(). Passing a flags value where -flags & ~G_DATALIST_FLAGS_MASK != 0 is an error.

    +flags & ~G_DATALIST_FLAGS_MASK != 0 is an error. +

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Lexical-Scanner.html b/docs/reference/glib/html/glib-Lexical-Scanner.html index cd555fc..162eb10 100644 --- a/docs/reference/glib/html/glib-Lexical-Scanner.html +++ b/docs/reference/glib/html/glib-Lexical-Scanner.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    datalist :

    pointer to the location that holds a list +pointer to the location that holds a list
    @@ -62,65 +42,70 @@ GScanner; GScannerConfig; -GScanner* g_scanner_new (const GScannerConfig *config_templ); -voidg_scanner_destroy (GScanner *scanner); +GScanner* g_scanner_new (const GScannerConfig *config_templ); +voidg_scanner_destroy (GScanner *scanner); -voidg_scanner_input_file (GScanner *scanner, - gint input_fd); -voidg_scanner_sync_file_offset (GScanner *scanner); -voidg_scanner_input_text (GScanner *scanner, - const gchar *text, - guint text_len); -GTokenTypeg_scanner_peek_next_token (GScanner *scanner); -GTokenTypeg_scanner_get_next_token (GScanner *scanner); -gbooleang_scanner_eof (GScanner *scanner); +voidg_scanner_input_file (GScanner *scanner, + gint input_fd); +voidg_scanner_sync_file_offset (GScanner *scanner); +voidg_scanner_input_text (GScanner *scanner, + const gchar *text, + guint text_len); +GTokenTypeg_scanner_peek_next_token (GScanner *scanner); +GTokenTypeg_scanner_get_next_token (GScanner *scanner); +gbooleang_scanner_eof (GScanner *scanner); -guintg_scanner_cur_line (GScanner *scanner); -guintg_scanner_cur_position (GScanner *scanner); -GTokenTypeg_scanner_cur_token (GScanner *scanner); -GTokenValueg_scanner_cur_value (GScanner *scanner); +guintg_scanner_cur_line (GScanner *scanner); +guintg_scanner_cur_position (GScanner *scanner); +GTokenTypeg_scanner_cur_token (GScanner *scanner); +GTokenValueg_scanner_cur_value (GScanner *scanner); -guintg_scanner_set_scope (GScanner *scanner, - guint scope_id); -voidg_scanner_scope_add_symbol (GScanner *scanner, - guint scope_id, - const gchar *symbol, - gpointer value); -voidg_scanner_scope_foreach_symbol (GScanner *scanner, - guint scope_id, - GHFunc func, - gpointer user_data); -gpointerg_scanner_scope_lookup_symbol (GScanner *scanner, - guint scope_id, - const gchar *symbol); -voidg_scanner_scope_remove_symbol (GScanner *scanner, - guint scope_id, - const gchar *symbol); -#define g_scanner_add_symbol ( scanner, symbol, value ) -#define g_scanner_remove_symbol ( scanner, symbol ) -#define g_scanner_foreach_symbol ( scanner, func, data ) +guintg_scanner_set_scope (GScanner *scanner, + guint scope_id); +voidg_scanner_scope_add_symbol (GScanner *scanner, + guint scope_id, + const gchar *symbol, + gpointer value); +voidg_scanner_scope_foreach_symbol (GScanner *scanner, + guint scope_id, + GHFunc func, + gpointer user_data); +gpointerg_scanner_scope_lookup_symbol (GScanner *scanner, + guint scope_id, + const gchar *symbol); +voidg_scanner_scope_remove_symbol (GScanner *scanner, + guint scope_id, + const gchar *symbol); +#define g_scanner_add_symbol (scanner, + symbol, + value) +#define g_scanner_remove_symbol (scanner, + symbol) +#define g_scanner_foreach_symbol (scanner, + func, + data) #define g_scanner_freeze_symbol_table (scanner) #define g_scanner_thaw_symbol_table (scanner) -gpointerg_scanner_lookup_symbol (GScanner *scanner, - const gchar *symbol); +gpointerg_scanner_lookup_symbol (GScanner *scanner, + const gchar *symbol); -voidg_scanner_warn (GScanner *scanner, - const gchar *format, - ...); -voidg_scanner_error (GScanner *scanner, - const gchar *format, - ...); -voidg_scanner_unexp_token (GScanner *scanner, - GTokenType expected_token, - const gchar *identifier_spec, - const gchar *symbol_spec, - const gchar *symbol_name, - const gchar *message, - gint is_error); -void (*GScannerMsgFunc) (GScanner *scanner, - gchar *message, - gboolean error); +voidg_scanner_warn (GScanner *scanner, + const gchar *format, + ...); +voidg_scanner_error (GScanner *scanner, + const gchar *format, + ...); +voidg_scanner_unexp_token (GScanner *scanner, + GTokenType expected_token, + const gchar *identifier_spec, + const gchar *symbol_spec, + const gchar *symbol_name, + const gchar *message, + gint is_error); +void (*GScannerMsgFunc) (GScanner *scanner, + gchar *message, + gboolean error); #define G_CSET_a_2_z #define G_CSET_A_2_Z @@ -474,7 +459,7 @@ is searched for in the default scope in addition to the current scope

    g_scanner_new ()

    -
    GScanner*           g_scanner_new                       (const GScannerConfig *config_templ);
    +
    GScanner*           g_scanner_new                       (const GScannerConfig *config_templ);

    Creates a new GScanner. The config_templ structure specifies the initial settings of the scanner, @@ -500,7 +485,7 @@ If you pass

    g_scanner_destroy ()

    -
    void                g_scanner_destroy                   (GScanner *scanner);
    +
    void                g_scanner_destroy                   (GScanner *scanner);

    Frees all memory used by the GScanner.

    @@ -516,8 +501,8 @@ Frees all memory used by the

    g_scanner_input_file ()

    -
    void                g_scanner_input_file                (GScanner *scanner,
    -                                                         gint input_fd);
    +
    void                g_scanner_input_file                (GScanner *scanner,
    +                                                         gint input_fd);

    Prepares to scan a file.

    @@ -540,7 +525,7 @@ Prepares to scan a file.

    g_scanner_sync_file_offset ()

    -
    void                g_scanner_sync_file_offset          (GScanner *scanner);
    +
    void                g_scanner_sync_file_offset          (GScanner *scanner);

    Rewinds the filedescriptor to the current buffer position and blows the file read ahead buffer. This is useful for third party uses of @@ -559,9 +544,9 @@ position.


    g_scanner_input_text ()

    -
    void                g_scanner_input_text                (GScanner *scanner,
    -                                                         const gchar *text,
    -                                                         guint text_len);
    +
    void                g_scanner_input_text                (GScanner *scanner,
    +                                                         const gchar *text,
    +                                                         guint text_len);

    Prepares to scan a text buffer.

    @@ -589,7 +574,7 @@ Prepares to scan a text buffer.

    g_scanner_peek_next_token ()

    -
    GTokenType          g_scanner_peek_next_token           (GScanner *scanner);
    +
    GTokenType          g_scanner_peek_next_token           (GScanner *scanner);

    Parses the next token, without removing it from the input stream. The token data is placed in the @@ -626,7 +611,7 @@ have been added or removed in the new scope.


    g_scanner_get_next_token ()

    -
    GTokenType          g_scanner_get_next_token            (GScanner *scanner);
    +
    GTokenType          g_scanner_get_next_token            (GScanner *scanner);

    Parses the next token just like g_scanner_peek_next_token() and also removes it from the input stream. @@ -655,7 +640,7 @@ The token data is placed in the


    g_scanner_eof ()

    -
    gboolean            g_scanner_eof                       (GScanner *scanner);
    +
    gboolean            g_scanner_eof                       (GScanner *scanner);

    Returns TRUE if the scanner has reached the end of the file or text buffer.

    @@ -679,7 +664,7 @@ Returns

    g_scanner_cur_line ()

    -
    guint               g_scanner_cur_line                  (GScanner *scanner);
    +
    guint               g_scanner_cur_line                  (GScanner *scanner);

    Returns the current line in the input stream (counting from 1). This is the line of the last token parsed via g_scanner_get_next_token(). @@ -703,7 +688,7 @@ This is the line of the last token parsed via

    g_scanner_cur_position ()

    -
    guint               g_scanner_cur_position              (GScanner *scanner);
    +
    guint               g_scanner_cur_position              (GScanner *scanner);

    Returns the current position in the current line (counting from 0). This is the position of the last token parsed via g_scanner_get_next_token(). @@ -727,7 +712,7 @@ This is the position of the last token parsed via

    g_scanner_cur_token ()

    -
    GTokenType          g_scanner_cur_token                 (GScanner *scanner);
    +
    GTokenType          g_scanner_cur_token                 (GScanner *scanner);

    Gets the current token type. This is simply the token field in the GScanner @@ -752,7 +737,7 @@ structure.


    g_scanner_cur_value ()

    -
    GTokenValue         g_scanner_cur_value                 (GScanner *scanner);
    +
    GTokenValue         g_scanner_cur_value                 (GScanner *scanner);

    Gets the current token value. This is simply the value field in the GScanner @@ -777,8 +762,8 @@ structure.


    g_scanner_set_scope ()

    -
    guint               g_scanner_set_scope                 (GScanner *scanner,
    -                                                         guint scope_id);
    +
    guint               g_scanner_set_scope                 (GScanner *scanner,
    +                                                         guint scope_id);

    Sets the current scope.

    @@ -806,10 +791,10 @@ Sets the current scope.

    g_scanner_scope_add_symbol ()

    -
    void                g_scanner_scope_add_symbol          (GScanner *scanner,
    -                                                         guint scope_id,
    -                                                         const gchar *symbol,
    -                                                         gpointer value);
    +
    void                g_scanner_scope_add_symbol          (GScanner *scanner,
    +                                                         guint scope_id,
    +                                                         const gchar *symbol,
    +                                                         gpointer value);

    Adds a symbol to the given scope.

    @@ -842,10 +827,10 @@ Adds a symbol to the given scope.

    g_scanner_scope_foreach_symbol ()

    -
    void                g_scanner_scope_foreach_symbol      (GScanner *scanner,
    -                                                         guint scope_id,
    -                                                         GHFunc func,
    -                                                         gpointer user_data);
    +
    void                g_scanner_scope_foreach_symbol      (GScanner *scanner,
    +                                                         guint scope_id,
    +                                                         GHFunc func,
    +                                                         gpointer user_data);

    Calls the given function for each of the symbol/value pairs in the given scope of the GScanner. The function is passed the symbol and @@ -880,9 +865,9 @@ value of each pair, and the given user_data

    g_scanner_scope_lookup_symbol ()

    -
    gpointer            g_scanner_scope_lookup_symbol       (GScanner *scanner,
    -                                                         guint scope_id,
    -                                                         const gchar *symbol);
    +
    gpointer            g_scanner_scope_lookup_symbol       (GScanner *scanner,
    +                                                         guint scope_id,
    +                                                         const gchar *symbol);

    Looks up a symbol in a scope and return its value. If the symbol is not bound in the scope, NULL is returned. @@ -917,9 +902,9 @@ if symbol is not bound in the given scop


    g_scanner_scope_remove_symbol ()

    -
    void                g_scanner_scope_remove_symbol       (GScanner *scanner,
    -                                                         guint scope_id,
    -                                                         const gchar *symbol);
    +
    void                g_scanner_scope_remove_symbol       (GScanner *scanner,
    +                                                         guint scope_id,
    +                                                         const gchar *symbol);

    Removes a symbol from a scope.

    @@ -1078,8 +1063,8 @@ There is no reason to use this macro, since it does nothing.

    g_scanner_lookup_symbol ()

    -
    gpointer            g_scanner_lookup_symbol             (GScanner *scanner,
    -                                                         const gchar *symbol);
    +
    gpointer            g_scanner_lookup_symbol             (GScanner *scanner,
    +                                                         const gchar *symbol);

    Looks up a symbol in the current scope and return its value. If the symbol is not bound in the current scope, NULL is returned. @@ -1109,9 +1094,9 @@ if symbol is not bound in the current sc


    g_scanner_warn ()

    -
    void                g_scanner_warn                      (GScanner *scanner,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_scanner_warn                      (GScanner *scanner,
    +                                                         const gchar *format,
    +                                                         ...);

    Outputs a warning message, via the GScanner message handler.

    @@ -1140,9 +1125,9 @@ documentation.

    g_scanner_error ()

    -
    void                g_scanner_error                     (GScanner *scanner,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_scanner_error                     (GScanner *scanner,
    +                                                         const gchar *format,
    +                                                         ...);

    Outputs an error message, via the GScanner message handler.

    @@ -1171,13 +1156,13 @@ documentation.

    g_scanner_unexp_token ()

    -
    void                g_scanner_unexp_token               (GScanner *scanner,
    -                                                         GTokenType expected_token,
    -                                                         const gchar *identifier_spec,
    -                                                         const gchar *symbol_spec,
    -                                                         const gchar *symbol_name,
    -                                                         const gchar *message,
    -                                                         gint is_error);
    +
    void                g_scanner_unexp_token               (GScanner *scanner,
    +                                                         GTokenType expected_token,
    +                                                         const gchar *identifier_spec,
    +                                                         const gchar *symbol_spec,
    +                                                         const gchar *symbol_name,
    +                                                         const gchar *message,
    +                                                         gint is_error);

    Outputs a message through the scanner's msg_handler, resulting from an unexpected token in the input stream. @@ -1239,9 +1224,9 @@ of the message.


    GScannerMsgFunc ()

    -
    void                (*GScannerMsgFunc)                  (GScanner *scanner,
    -                                                         gchar *message,
    -                                                         gboolean error);
    +
    void                (*GScannerMsgFunc)                  (GScanner *scanner,
    +                                                         gchar *message,
    +                                                         gboolean error);

    Specifies the type of the message handler function.

    @@ -1387,22 +1372,7 @@ The possible types of token returned from each

    union GTokenValue

    -
    union GTokenValue
    -{
    -  gpointer v_symbol;
    -  gchar		*v_identifier;
    -  gulong v_binary;
    -  gulong v_octal;
    -  gulong v_int;
    -  guint64       v_int64;
    -  gdouble v_float;
    -  gulong v_hex;
    -  gchar		*v_string;
    -  gchar		*v_comment;
    -  guchar v_char;
    -  guint		v_error;
    -};
    -
    +
    
     

    A union holding the value of the token.

    @@ -1476,6 +1446,6 @@ of
    - Generated by GTK-Doc V1.13
    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Limits-of-Basic-Types.html b/docs/reference/glib/html/glib-Limits-of-Basic-Types.html index 9a2cc2c..bf71ba9 100644 --- a/docs/reference/glib/html/glib-Limits-of-Basic-Types.html +++ b/docs/reference/glib/html/glib-Limits-of-Basic-Types.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -404,6 +384,6 @@ The maximum value which can be held in a
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Memory-Allocation.html b/docs/reference/glib/html/glib-Memory-Allocation.html index 4897010..5f8c563 100644 --- a/docs/reference/glib/html/glib-Memory-Allocation.html +++ b/docs/reference/glib/html/glib-Memory-Allocation.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -60,52 +40,63 @@
     #include <glib.h>
     
    -#define             g_new                               (struct_type, n_structs)
    -#define             g_new0                              (struct_type, n_structs)
    -#define             g_renew                             (struct_type, mem, n_structs)
    -#define             g_try_new                           (struct_type, n_structs)
    -#define             g_try_new0                          (struct_type, n_structs)
    -#define             g_try_renew                         (struct_type, mem, n_structs)
    +#define             g_new                               (struct_type,
    +                                                         n_structs)
    +#define             g_new0                              (struct_type,
    +                                                         n_structs)
    +#define             g_renew                             (struct_type,
    +                                                         mem,
    +                                                         n_structs)
    +#define             g_try_new                           (struct_type,
    +                                                         n_structs)
    +#define             g_try_new0                          (struct_type,
    +                                                         n_structs)
    +#define             g_try_renew                         (struct_type,
    +                                                         mem,
    +                                                         n_structs)
     
    -gpointer            g_malloc                            (gsize n_bytes);
    -gpointer            g_malloc0                           (gsize n_bytes);
    -gpointer            g_realloc                           (gpointer mem,
    -                                                         gsize n_bytes);
    -gpointer            g_try_malloc                        (gsize n_bytes);
    -gpointer            g_try_malloc0                       (gsize n_bytes);
    -gpointer            g_try_realloc                       (gpointer mem,
    -                                                         gsize n_bytes);
    -gpointer            g_malloc_n                          (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    -gpointer            g_malloc0_n                         (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    -gpointer            g_realloc_n                         (gpointer mem,
    -                                                         gsize n_blocks,
    -                                                         gsize n_block_bytes);
    -gpointer            g_try_malloc_n                      (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    -gpointer            g_try_malloc0_n                     (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    -gpointer            g_try_realloc_n                     (gpointer mem,
    -                                                         gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +gpointer            g_malloc                            (gsize n_bytes);
    +gpointer            g_malloc0                           (gsize n_bytes);
    +gpointer            g_realloc                           (gpointer mem,
    +                                                         gsize n_bytes);
    +gpointer            g_try_malloc                        (gsize n_bytes);
    +gpointer            g_try_malloc0                       (gsize n_bytes);
    +gpointer            g_try_realloc                       (gpointer mem,
    +                                                         gsize n_bytes);
    +gpointer            g_malloc_n                          (gsize n_blocks,
    +                                                         gsize n_block_bytes);
    +gpointer            g_malloc0_n                         (gsize n_blocks,
    +                                                         gsize n_block_bytes);
    +gpointer            g_realloc_n                         (gpointer mem,
    +                                                         gsize n_blocks,
    +                                                         gsize n_block_bytes);
    +gpointer            g_try_malloc_n                      (gsize n_blocks,
    +                                                         gsize n_block_bytes);
    +gpointer            g_try_malloc0_n                     (gsize n_blocks,
    +                                                         gsize n_block_bytes);
    +gpointer            g_try_realloc_n                     (gpointer mem,
    +                                                         gsize n_blocks,
    +                                                         gsize n_block_bytes);
     
    -void                g_free                              (gpointer mem);
    +void                g_free                              (gpointer mem);
     extern              gboolean g_mem_gc_friendly;
     
     #define             g_alloca                            (size)
    -#define             g_newa                              (struct_type, n_structs)
    +#define             g_newa                              (struct_type,
    +                                                         n_structs)
     
    -#define             g_memmove                           (dest,src,len)
    -gpointer            g_memdup                            (gconstpointer mem,
    -                                                         guint byte_size);
    +#define             g_memmove                           (dest,
    +                                                         src,
    +                                                         len)
    +gpointer            g_memdup                            (gconstpointer mem,
    +                                                         guint byte_size);
     
                         GMemVTable;
    -void                g_mem_set_vtable                    (GMemVTable *vtable);
    -gboolean            g_mem_is_system_malloc              (void);
    +void                g_mem_set_vtable                    (GMemVTable *vtable);
    +gboolean            g_mem_is_system_malloc              (void);
     
     extern              GMemVTable	*glib_mem_profiler_table;
    -void                g_mem_profile                       (void);
    +void                g_mem_profile                       (void);
     
    @@ -346,7 +337,7 @@ The function returns

    g_malloc ()

    -
    gpointer            g_malloc                            (gsize n_bytes);
    +
    gpointer            g_malloc                            (gsize n_bytes);

    Allocates n_bytes bytes of memory. If n_bytes is 0 it returns NULL. @@ -370,7 +361,7 @@ If n_bytes is 0 it returns

    g_malloc0 ()

    -
    gpointer            g_malloc0                           (gsize n_bytes);
    +
    gpointer            g_malloc0                           (gsize n_bytes);

    Allocates n_bytes bytes of memory, initialized to 0's. If n_bytes is 0 it returns NULL. @@ -394,8 +385,8 @@ If n_bytes is 0 it returns

    g_realloc ()

    -
    gpointer            g_realloc                           (gpointer mem,
    -                                                         gsize n_bytes);
    +
    gpointer            g_realloc                           (gpointer mem,
    +                                                         gsize n_bytes);

    Reallocates the memory pointed to by mem, so that it now has space for n_bytes bytes of memory. It returns the new address of the memory, which may @@ -427,7 +418,7 @@ and mem will be freed unless it is

    g_try_malloc ()

    -
    gpointer            g_try_malloc                        (gsize n_bytes);
    +
    gpointer            g_try_malloc                        (gsize n_bytes);

    Attempts to allocate n_bytes, and returns NULL on failure. Contrast with g_malloc(), which aborts the program on failure. @@ -451,7 +442,7 @@ Contrast with

    g_try_malloc0 ()

    -
    gpointer            g_try_malloc0                       (gsize n_bytes);
    +
    gpointer            g_try_malloc0                       (gsize n_bytes);

    Attempts to allocate n_bytes, initialized to 0's, and returns NULL on failure. Contrast with g_malloc0(), which aborts the program on failure. @@ -476,8 +467,8 @@ failure. Contrast with

    g_try_realloc ()

    -
    gpointer            g_try_realloc                       (gpointer mem,
    -                                                         gsize n_bytes);
    +
    gpointer            g_try_realloc                       (gpointer mem,
    +                                                         gsize n_bytes);

    Attempts to realloc mem to a new size, n_bytes, and returns NULL on failure. Contrast with g_realloc(), which aborts the program @@ -507,8 +498,8 @@ on failure. If mem is

    g_malloc_n ()

    -
    gpointer            g_malloc_n                          (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_malloc_n                          (gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_malloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -538,8 +529,8 @@ but care is taken to detect possible overflow during multiplication.


    g_malloc0_n ()

    -
    gpointer            g_malloc0_n                         (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_malloc0_n                         (gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_malloc0(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -569,9 +560,9 @@ but care is taken to detect possible overflow during multiplication.


    g_realloc_n ()

    -
    gpointer            g_realloc_n                         (gpointer mem,
    -                                                         gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_realloc_n                         (gpointer mem,
    +                                                         gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_realloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -606,8 +597,8 @@ but care is taken to detect possible overflow during multiplication.


    g_try_malloc_n ()

    -
    gpointer            g_try_malloc_n                      (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_try_malloc_n                      (gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_try_malloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -637,8 +628,8 @@ but care is taken to detect possible overflow during multiplication.


    g_try_malloc0_n ()

    -
    gpointer            g_try_malloc0_n                     (gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_try_malloc0_n                     (gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_try_malloc0(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -668,9 +659,9 @@ but care is taken to detect possible overflow during multiplication.


    g_try_realloc_n ()

    -
    gpointer            g_try_realloc_n                     (gpointer mem,
    -                                                         gsize n_blocks,
    -                                                         gsize n_block_bytes);
    +
    gpointer            g_try_realloc_n                     (gpointer mem,
    +                                                         gsize n_blocks,
    +                                                         gsize n_block_bytes);

    This function is similar to g_try_realloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. @@ -705,7 +696,7 @@ but care is taken to detect possible overflow during multiplication.


    g_free ()

    -
    void                g_free                              (gpointer mem);
    +
    void                g_free                              (gpointer mem);

    Frees the memory pointed to by mem. If mem is NULL it simply returns. @@ -842,23 +833,24 @@ The source and destination areas may overlap. In order to use this function, you must include string.h yourself, because this macro will typically simply resolve to memmove() and GLib does not include -string.h for you.

    +string.h for you. +

    - - - @@ -867,8 +859,8 @@ typically simply resolve to memmove() and GLib doe

    g_memdup ()

    -
    gpointer            g_memdup                            (gconstpointer mem,
    -                                                         guint byte_size);
    +
    gpointer            g_memdup                            (gconstpointer mem,
    +                                                         guint byte_size);

    Allocates byte_size bytes of memory, and copies byte_size bytes into it from mem. If mem is NULL it returns NULL. @@ -955,7 +947,7 @@ if it exists, should be prior to any use of GLib.


    g_mem_set_vtable ()

    -
    void                g_mem_set_vtable                    (GMemVTable *vtable);
    +
    void                g_mem_set_vtable                    (GMemVTable *vtable);

    Sets the GMemVTable to use for memory allocation. You can use this to provide custom memory allocation routines. This function must be called @@ -977,7 +969,7 @@ should return

    g_mem_is_system_malloc ()

    -
    gboolean            g_mem_is_system_malloc              (void);
    +
    gboolean            g_mem_is_system_malloc              (void);

    Checks whether the allocator used by g_malloc() is the system's malloc implementation. If it returns TRUE memory allocated with @@ -986,7 +978,8 @@ This function is useful for avoiding an extra copy of allocated memory returned by a non-GLib-based API.

    -A different allocator can be set using g_mem_set_vtable().

    +A different allocator can be set using g_mem_set_vtable(). +

    dest :

    the destination address to copy the bytes to. +the destination address to copy the bytes to.

    src :

    the source address to copy the bytes from. +the source address to copy the bytes from.

    len :

    the number of bytes to copy. +the number of bytes to copy.
    @@ -1011,7 +1004,7 @@ of your program.

    g_mem_profile ()

    -
    void                g_mem_profile                       (void);
    +
    void                g_mem_profile                       (void);

    Outputs a summary of memory usage.

    @@ -1031,6 +1024,6 @@ previously installed the
    - Generated by GTK-Doc V1.13
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Memory-Allocators.html b/docs/reference/glib/html/glib-Memory-Allocators.html index cb0863c..eef3e40 100644 --- a/docs/reference/glib/html/glib-Memory-Allocators.html +++ b/docs/reference/glib/html/glib-Memory-Allocators.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -62,9 +42,9 @@ #include <glib.h> GAllocator; -GAllocator* g_allocator_new (const gchar *name, - guint n_preallocs); -void g_allocator_free (GAllocator *allocator); +GAllocator* g_allocator_new (const gchar *name, + guint n_preallocs); +void g_allocator_free (GAllocator *allocator);
    @@ -74,7 +54,8 @@ Prior to 2.10, GList, GSList and GNode data structures. Since 2.10, it has been completely replaced by the slice allocator and -deprecated.

    +deprecated. +

    Details

    @@ -87,33 +68,35 @@ deprecated.

    The GAllocator struct contains private data. and should only be -accessed using the following functions.

    +accessed using the following functions. +


    g_allocator_new ()

    -
    GAllocator*         g_allocator_new                     (const gchar *name,
    -                                                         guint n_preallocs);
    +
    GAllocator*         g_allocator_new                     (const gchar *name,
    +                                                         guint n_preallocs);

    Warning

    g_allocator_new has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Creates a new GAllocator.

    +Creates a new GAllocator. +

    - - - @@ -131,19 +114,20 @@ Creates a new

    g_allocator_free ()

    -
    void                g_allocator_free                    (GAllocator *allocator);
    +
    void                g_allocator_free                    (GAllocator *allocator);

    Warning

    g_allocator_free has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Frees all of the memory allocated by the GAllocator.

    +Frees all of the memory allocated by the GAllocator. +

    name :

    the name of the GAllocator. This name is used to set the +the name of the GAllocator. This name is used to set the name of the GMemChunk used by the GAllocator, and is only used for debugging.

    n_preallocs :

    the number of elements in each block of memory +the number of elements in each block of memory allocated. Larger blocks mean less calls to g_malloc(), but some memory may be wasted. (GLib uses 128 elements per block by default.) The value must be @@ -122,7 +105,7 @@ Creates a new

    Returns :

    a new GAllocator. +a new GAllocator.
    -

    allocator :

    a GAllocator. +a GAllocator.
    @@ -152,6 +136,6 @@ Frees all of the memory allocated by the
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Memory-Chunks.html b/docs/reference/glib/html/glib-Memory-Chunks.html index c54a9b1..ddeb9f0 100644 --- a/docs/reference/glib/html/glib-Memory-Chunks.html +++ b/docs/reference/glib/html/glib-Memory-Chunks.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -65,27 +45,32 @@ #define G_ALLOC_AND_FREE #define G_ALLOC_ONLY -GMemChunk* g_mem_chunk_new (const gchar *name, - gint atom_size, - gsize area_size, - gint type); -gpointerg_mem_chunk_alloc (GMemChunk *mem_chunk); -gpointerg_mem_chunk_alloc0 (GMemChunk *mem_chunk); -voidg_mem_chunk_free (GMemChunk *mem_chunk, - gpointer mem); -voidg_mem_chunk_destroy (GMemChunk *mem_chunk); +GMemChunk* g_mem_chunk_new (const gchar *name, + gint atom_size, + gsize area_size, + gint type); +gpointerg_mem_chunk_alloc (GMemChunk *mem_chunk); +gpointerg_mem_chunk_alloc0 (GMemChunk *mem_chunk); +voidg_mem_chunk_free (GMemChunk *mem_chunk, + gpointer mem); +voidg_mem_chunk_destroy (GMemChunk *mem_chunk); -#define g_mem_chunk_create (type, pre_alloc, alloc_type) -#define g_chunk_new (type, chunk) -#define g_chunk_new0 (type, chunk) -#define g_chunk_free (mem, mem_chunk) +#define g_mem_chunk_create (type, + pre_alloc, + alloc_type) +#define g_chunk_new (type, + chunk) +#define g_chunk_new0 (type, + chunk) +#define g_chunk_free (mem, + mem_chunk) -voidg_mem_chunk_reset (GMemChunk *mem_chunk); -voidg_mem_chunk_clean (GMemChunk *mem_chunk); -voidg_blow_chunks (void); +voidg_mem_chunk_reset (GMemChunk *mem_chunk); +voidg_mem_chunk_clean (GMemChunk *mem_chunk); +voidg_blow_chunks (void); -voidg_mem_chunk_info (void); -voidg_mem_chunk_print (GMemChunk *mem_chunk); +voidg_mem_chunk_info (void); +voidg_mem_chunk_print (GMemChunk *mem_chunk);
    @@ -149,63 +134,121 @@ To help debug memory chunks, use -

    Example 17. Using a GMemChunk

    -
    -  GMemChunk *mem_chunk;
    -  gchar *mem[10000];
    -  gint i;
    +

    Example 17. Using a GMemChunk

    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    GMemChunk *mem_chunk;
    +gchar *mem[10000];
    +gint i;
    +
    +/* Create a GMemChunk with atoms 50 bytes long, and memory
    +   blocks holding 100 bytes. Note that this means that only 2 atoms
    +   fit into each memory block and so isn't very efficient. */
    +mem_chunk = g_mem_chunk_new ("test mem chunk", 50, 100, G_ALLOC_AND_FREE);
    +/* Now allocate 10000 atoms. */
    +for (i = 0; i < 10000; i++)
    +  {
    +    mem[i] = g_chunk_new (gchar, mem_chunk);
    +    /* Fill in the atom memory with some junk. */
    +    for (j = 0; j < 50; j++)
    +      mem[i][j] = i * j;
    +  }
    +/* Now free all of the atoms. Note that since we are going to
    +   destroy the GMemChunk, this wouldn't normally be used. */
    +for (i = 0; i < 10000; i++)
    +  {
    +    g_mem_chunk_free (mem_chunk, mem[i]);
    +  }
    +/* We are finished with the GMemChunk, so we destroy it. */
    +g_mem_chunk_destroy (mem_chunk);
    + - /* Create a GMemChunk with atoms 50 bytes long, and memory - blocks holding 100 bytes. Note that this means that only 2 atoms - fit into each memory block and so isn't very efficient. */ - mem_chunk = g_mem_chunk_new ("test mem chunk", 50, 100, G_ALLOC_AND_FREE); - /* Now allocate 10000 atoms. */ - for (i = 0; i < 10000; i++) - { - mem[i] = g_chunk_new (gchar, mem_chunk); - /* Fill in the atom memory with some junk. */ - for (j = 0; j < 50; j++) - mem[i][j] = i * j; - } - /* Now free all of the atoms. Note that since we are going to - destroy the GMemChunk, this wouldn't normally be used. */ - for (i = 0; i < 10000; i++) - { - g_mem_chunk_free (mem_chunk, mem[i]); - } - /* We are finished with the GMemChunk, so we destroy it. */ - g_mem_chunk_destroy (mem_chunk); -


    -

    Example 18. Using a GMemChunk with data structures

    -
    -   GMemChunk *array_mem_chunk;
    -   GRealArray *array;
    -   /* Create a GMemChunk to hold GRealArray structures, using
    -      the g_mem_chunk_create() convenience macro. We want 1024 atoms in each
    -      memory block, and we want to be able to free individual atoms. */
    -   array_mem_chunk = g_mem_chunk_create (GRealArray, 1024, G_ALLOC_AND_FREE);
    -   /* Allocate one atom, using the g_chunk_new() convenience macro. */
    -   array = g_chunk_new (GRealArray, array_mem_chunk);
    -   /* We can now use array just like a normal pointer to a structure. */
    -   array->data            = NULL;
    -   array->len             = 0;
    -   array->alloc           = 0;
    -   array->zero_terminated = (zero_terminated ? 1 : 0);
    -   array->clear           = (clear ? 1 : 0);
    -   array->elt_size        = elt_size;
    -   /* We can free the element, so it can be reused. */
    -   g_chunk_free (array, array_mem_chunk);
    -   /* We destroy the GMemChunk when we are finished with it. */
    -   g_mem_chunk_destroy (array_mem_chunk);
    - 
    -
    -


    +

    Example 18. Using a GMemChunk with data structures

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    GMemChunk *array_mem_chunk;
    +GRealArray *array;
    +/* Create a GMemChunk to hold GRealArray structures, using
    +   the g_mem_chunk_create() convenience macro. We want 1024 atoms in each
    +   memory block, and we want to be able to free individual atoms. */
    +array_mem_chunk = g_mem_chunk_create (GRealArray, 1024, G_ALLOC_AND_FREE);
    +/* Allocate one atom, using the g_chunk_new() convenience macro. */
    +array = g_chunk_new (GRealArray, array_mem_chunk);
    +/* We can now use array just like a normal pointer to a structure. */
    +array->data            = NULL;
    +array->len             = 0;
    +array->alloc           = 0;
    +array->zero_terminated = (zero_terminated ? 1 : 0);
    +array->clear           = (clear ? 1 : 0);
    +array->elt_size        = elt_size;
    +/* We can free the element, so it can be reused. */
    +g_chunk_free (array, array_mem_chunk);
    +/* We destroy the GMemChunk when we are finished with it. */
    +g_mem_chunk_destroy (array_mem_chunk);
    +
    + + +


    +

    Details

    @@ -219,7 +262,8 @@ To help debug memory chunks, use GMemChunk struct is an opaque data structure representing a memory chunk. It should be accessed only through the use of the -following functions.

    +following functions. +


    @@ -233,7 +277,8 @@ following functions.

    Specifies the type of a GMemChunk. Used in g_mem_chunk_new() and g_mem_chunk_create() to specify that atoms will be freed -individually.

    +individually. +


    @@ -247,46 +292,48 @@ individually.

    Specifies the type of a GMemChunk. Used in g_mem_chunk_new() and g_mem_chunk_create() to specify that atoms will never be freed -individually.

    +individually. +


    g_mem_chunk_new ()

    -
    GMemChunk*          g_mem_chunk_new                     (const gchar *name,
    -                                                         gint atom_size,
    -                                                         gsize area_size,
    -                                                         gint type);
    +
    GMemChunk*          g_mem_chunk_new                     (const gchar *name,
    +                                                         gint atom_size,
    +                                                         gsize area_size,
    +                                                         gint type);

    Warning

    g_mem_chunk_new has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Creates a new GMemChunk.

    +Creates a new GMemChunk. +

    - - - - - @@ -305,24 +352,25 @@ Creates a new

    g_mem_chunk_alloc ()

    -
    gpointer            g_mem_chunk_alloc                   (GMemChunk *mem_chunk);
    +
    gpointer            g_mem_chunk_alloc                   (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_alloc has been deprecated since version 2.10 and should not be used in newly-written code. Use g_slice_alloc() instead

    -Allocates an atom of memory from a GMemChunk.

    +Allocates an atom of memory from a GMemChunk. +

    name :

    a string to identify the GMemChunk. It is not copied so it +a string to identify the GMemChunk. It is not copied so it should be valid for the lifetime of the GMemChunk. It is only used in g_mem_chunk_print(), which is used for debugging.

    atom_size :

    the size, in bytes, of each element in the GMemChunk. +the size, in bytes, of each element in the GMemChunk.

    area_size :

    the size, in bytes, of each block of memory allocated to +the size, in bytes, of each block of memory allocated to contain the atoms.

    type :

    the type of the GMemChunk. G_ALLOC_AND_FREE is used if the +the type of the GMemChunk. G_ALLOC_AND_FREE is used if the atoms will be freed individually. G_ALLOC_ONLY should be used if atoms will never be freed individually. G_ALLOC_ONLY is quicker, since it does not need to track @@ -296,7 +343,7 @@ Creates a new Returns :

    the new GMemChunk. +the new GMemChunk.
    - - @@ -331,25 +379,26 @@ Allocates an atom of memory from a

    g_mem_chunk_alloc0 ()

    -
    gpointer            g_mem_chunk_alloc0                  (GMemChunk *mem_chunk);
    +
    gpointer            g_mem_chunk_alloc0                  (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_alloc0 has been deprecated since version 2.10 and should not be used in newly-written code. Use g_slice_alloc0() instead

    Allocates an atom of memory from a GMemChunk, setting the memory to -0.

    +0. +

    mem_chunk :

    a GMemChunk. +a GMemChunk.

    Returns :

    a pointer to the allocated atom. +a pointer to the allocated atom.
    - - @@ -358,8 +407,8 @@ Allocates an atom of memory from a

    g_mem_chunk_free ()

    -
    void                g_mem_chunk_free                    (GMemChunk *mem_chunk,
    -                                                         gpointer mem);
    +
    void                g_mem_chunk_free                    (GMemChunk *mem_chunk,
    +                                                         gpointer mem);

    Warning

    g_mem_chunk_free has been deprecated since version 2.10 and should not be used in newly-written code. Use g_slice_free1() instead

    @@ -367,18 +416,19 @@ Allocates an atom of memory from a GMemChunk. This should only be called if the GMemChunk was created with G_ALLOC_AND_FREE. Otherwise it will -simply return.

    +simply return. +

    mem_chunk :

    a GMemChunk. +a GMemChunk.

    Returns :

    a pointer to the allocated atom. +a pointer to the allocated atom.
    - - @@ -387,19 +437,20 @@ simply return.


    g_mem_chunk_destroy ()

    -
    void                g_mem_chunk_destroy                 (GMemChunk *mem_chunk);
    +
    void                g_mem_chunk_destroy                 (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_destroy has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Frees all of the memory allocated for a GMemChunk.

    +Frees all of the memory allocated for a GMemChunk. +

    mem_chunk :

    a GMemChunk. +a GMemChunk.

    mem :

    a pointer to the atom to free. +a pointer to the atom to free.
    -

    mem_chunk :

    a GMemChunk. +a GMemChunk.
    @@ -418,23 +469,24 @@ A convenience macro for creating a new g_mem_chunk_new(), using the given type to create the GMemChunk name. The atom size is determined using sizeof(), and the area size is calculated by -multiplying the pre_alloc parameter with the atom size.

    +multiplying the pre_alloc parameter with the atom size. +

    - - - - @@ -461,23 +513,24 @@ multiplying the pre_alloc parameter with

    A convenience macro to allocate an atom of memory from a GMemChunk. It calls g_mem_chunk_alloc() and casts the returned atom to a -pointer to the given type, avoiding a type cast in the source code.

    +pointer to the given type, avoiding a type cast in the source code. +

    type :

    the type of the atoms, typically a structure name. +the type of the atoms, typically a structure name.

    pre_alloc :

    the number of atoms to store in each block of memory. +the number of atoms to store in each block of memory.

    alloc_type :

    the type of the GMemChunk. G_ALLOC_AND_FREE is used +the type of the GMemChunk. G_ALLOC_AND_FREE is used if the atoms will be freed individually. G_ALLOC_ONLY should be used if atoms will never be freed individually. G_ALLOC_ONLY is quicker, since it does @@ -444,7 +496,7 @@ multiplying the pre_alloc parameter with

    Returns :

    the new GMemChunk. +the new GMemChunk.
    - - - @@ -495,23 +548,24 @@ pointer to the given type, avoiding a type cast in the source code.

    A convenience macro to allocate an atom of memory from a GMemChunk. It calls g_mem_chunk_alloc0() and casts the returned atom to a -pointer to the given type, avoiding a type cast in the source code.

    +pointer to the given type, avoiding a type cast in the source code. +

    type :

    the type of the GMemChunk atoms, typically a structure name. +the type of the GMemChunk atoms, typically a structure name.

    chunk :

    a GMemChunk. +a GMemChunk.

    Returns :

    a pointer to the allocated atom, cast to a pointer to +a pointer to the allocated atom, cast to a pointer to type.
    - - - @@ -530,18 +584,19 @@ pointer to the given type, avoiding a type cast in the source code.

    A convenience macro to free an atom of memory from a GMemChunk. It simply switches the arguments and calls g_mem_chunk_free() It is included simply to complement the other convenience macros, -g_chunk_new() and g_chunk_new0().

    +g_chunk_new() and g_chunk_new0(). +

    type :

    the type of the GMemChunk atoms, typically a structure name. +the type of the GMemChunk atoms, typically a structure name.

    chunk :

    a GMemChunk. +a GMemChunk.

    Returns :

    a pointer to the allocated atom, cast to a pointer to +a pointer to the allocated atom, cast to a pointer to type.
    - - @@ -550,7 +605,7 @@ included simply to complement the other convenience macros,

    g_mem_chunk_reset ()

    -
    void                g_mem_chunk_reset                   (GMemChunk *mem_chunk);
    +
    void                g_mem_chunk_reset                   (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_reset has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice @@ -558,12 +613,13 @@ included simply to complement the other convenience macros,

    Resets a GMemChunk to its initial state. It frees all of the -currently allocated blocks of memory.

    +currently allocated blocks of memory. +

    mem :

    a pointer to the atom to be freed. +a pointer to the atom to be freed.

    mem_chunk :

    a GMemChunk. +a GMemChunk.
    -

    mem_chunk :

    a GMemChunk. +a GMemChunk.
    @@ -571,19 +627,20 @@ currently allocated blocks of memory.


    g_mem_chunk_clean ()

    -
    void                g_mem_chunk_clean                   (GMemChunk *mem_chunk);
    +
    void                g_mem_chunk_clean                   (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_clean has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Frees any blocks in a GMemChunk which are no longer being used.

    +Frees any blocks in a GMemChunk which are no longer being used. +

    -

    mem_chunk :

    a GMemChunk. +a GMemChunk.
    @@ -591,19 +648,20 @@ Frees any blocks in a

    g_blow_chunks ()

    -
    void                g_blow_chunks                       (void);
    +
    void                g_blow_chunks                       (void);

    Warning

    g_blow_chunks has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice allocator instead

    -Calls g_mem_chunk_clean() on all GMemChunk objects.

    +Calls g_mem_chunk_clean() on all GMemChunk objects. +


    g_mem_chunk_info ()

    -
    void                g_mem_chunk_info                    (void);
    +
    void                g_mem_chunk_info                    (void);

    Warning

    g_mem_chunk_info has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice @@ -613,12 +671,13 @@ Calls GMemChunk objects currently in use. It outputs the number of GMemChunk objects currently allocated, and calls g_mem_chunk_print() to output information on -each one.

    +each one. +


    g_mem_chunk_print ()

    -
    void                g_mem_chunk_print                   (GMemChunk *mem_chunk);
    +
    void                g_mem_chunk_print                   (GMemChunk *mem_chunk);

    Warning

    g_mem_chunk_print has been deprecated since version 2.10 and should not be used in newly-written code. Use the slice @@ -627,12 +686,13 @@ each one.

    Outputs debugging information for a GMemChunk. It outputs the name of the GMemChunk (set with g_mem_chunk_new()), the number of bytes -used, and the number of blocks of memory allocated.

    +used, and the number of blocks of memory allocated. +

    -

    mem_chunk :

    a GMemChunk. +a GMemChunk.
    @@ -641,6 +701,6 @@ used, and the number of blocks of memory allocated.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Memory-Slices.html b/docs/reference/glib/html/glib-Memory-Slices.html index 331e314..ee35b8a 100644 --- a/docs/reference/glib/html/glib-Memory-Slices.html +++ b/docs/reference/glib/html/glib-Memory-Slices.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -60,21 +40,25 @@
     #include <glib.h>
     
    -gpointer            g_slice_alloc                       (gsize block_size);
    -gpointer            g_slice_alloc0                      (gsize block_size);
    -gpointer            g_slice_copy                        (gsize block_size,
    -                                                         gconstpointer mem_block);
    -void                g_slice_free1                       (gsize block_size,
    -                                                         gpointer mem_block);
    -void                g_slice_free_chain_with_offset      (gsize block_size,
    -                                                         gpointer mem_chain,
    -                                                         gsize next_offset);
    +gpointer            g_slice_alloc                       (gsize block_size);
    +gpointer            g_slice_alloc0                      (gsize block_size);
    +gpointer            g_slice_copy                        (gsize block_size,
    +                                                         gconstpointer mem_block);
    +void                g_slice_free1                       (gsize block_size,
    +                                                         gpointer mem_block);
    +void                g_slice_free_chain_with_offset      (gsize block_size,
    +                                                         gpointer mem_chain,
    +                                                         gsize next_offset);
     
     #define             g_slice_new                         (type)
     #define             g_slice_new0                        (type)
    -#define             g_slice_dup                         (type, mem)
    -#define             g_slice_free                        (type, mem)
    -#define             g_slice_free_chain                  (type, mem_chain, next)
    +#define             g_slice_dup                         (type,
    +                                                         mem)
    +#define             g_slice_free                        (type,
    +                                                         mem)
    +#define             g_slice_free_chain                  (type,
    +                                                         mem_chain,
    +                                                         next)
     
    @@ -88,7 +72,7 @@ memory-waste, scalability and performance problems.

    To achieve these goals, the slice allocator uses a sophisticated, layered design that has been inspired by Bonwick's slab allocator -[6]. +[6]. It uses posix_memalign() to optimize allocations of many equally-sized chunks, and has per-thread free lists (the so-called magazine layer) to quickly satisfy allocation requests of already known structure sizes. @@ -109,41 +93,82 @@ friends, as long as objects are not resized during their lifetime and the object size used at allocation time is still available when freeing.

    -

    Example 15. Using the slice allocator

    -
    -  gchar *mem[10000];
    -  gint i;
    -  /* Allocate 10000 blocks. */
    -  for (i = 0; i < 10000; i++)
    -    {
    -      mem[i] = g_slice_alloc (50);
    -      /* Fill in the memory with some junk. */
    -      for (j = 0; j < 50; j++)
    -	mem[i][j] = i * j;
    -    }
    -  /* Now free all of the blocks. */
    -  for (i = 0; i < 10000; i++)
    -    {
    -      g_slice_free1 (50, mem[i]);
    -    }
    -
    +

    Example 15. Using the slice allocator

    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    gchar *mem[10000];
    +gint i;
    +/* Allocate 10000 blocks. */
    +for (i = 0; i < 10000; i++)
    +  {
    +    mem[i] = g_slice_alloc (50);
    +    /* Fill in the memory with some junk. */
    +    for (j = 0; j < 50; j++)
    +    mem[i][j] = i * j;
    +  }
    +/* Now free all of the blocks. */
    +for (i = 0; i < 10000; i++)
    +  {
    +    g_slice_free1 (50, mem[i]);
    +  }
    +
    +

    -

    Example 16. Using the slice allocator with data structures

    -
    -  GRealArray *array;
    -  /* Allocate one block, using the g_slice_new() macro. */
    -  array = g_slice_new (GRealArray);
    -  /* We can now use array just like a normal pointer to a structure. */
    -  array->data            = NULL;
    -  array->len             = 0;
    -  array->alloc           = 0;
    -  array->zero_terminated = (zero_terminated ? 1 : 0);
    -  array->clear           = (clear ? 1 : 0);
    -  array->elt_size        = elt_size;
    -  /* We can free the block, so it can be reused. */
    -  g_slice_free (GRealArray, array);
    -
    +

    Example 16. Using the slice allocator with data structures

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    GRealArray *array;
    +/* Allocate one block, using the g_slice_new() macro. */
    +array = g_slice_new (GRealArray);
    +/* We can now use array just like a normal pointer to a structure. */
    +array->data            = NULL;
    +array->len             = 0;
    +array->alloc           = 0;
    +array->zero_terminated = (zero_terminated ? 1 : 0);
    +array->clear           = (clear ? 1 : 0);
    +array->elt_size        = elt_size;
    +/* We can free the block, so it can be reused. */
    +g_slice_free (GRealArray, array);
    +
    +

    @@ -151,7 +176,7 @@ object size used at allocation time is still available when freeing.

    Details

    g_slice_alloc ()

    -
    gpointer            g_slice_alloc                       (gsize block_size);
    +
    gpointer            g_slice_alloc                       (gsize block_size);

    Allocates a block of memory from the slice allocator. The block adress handed out can be expected to be aligned @@ -183,7 +208,7 @@ environment variable.


    g_slice_alloc0 ()

    -
    gpointer            g_slice_alloc0                      (gsize block_size);
    +
    gpointer            g_slice_alloc0                      (gsize block_size);

    Allocates a block of memory via g_slice_alloc() and initialize the returned memory to 0. @@ -211,8 +236,8 @@ environment variable.


    g_slice_copy ()

    -
    gpointer            g_slice_copy                        (gsize block_size,
    -                                                         gconstpointer mem_block);
    +
    gpointer            g_slice_copy                        (gsize block_size,
    +                                                         gconstpointer mem_block);

    Allocates a block of memory from the slice allocator and copies block_size bytes into it from mem_block. @@ -242,8 +267,8 @@ Allocates a block of memory from the slice allocator and copies


    g_slice_free1 ()

    -
    void                g_slice_free1                       (gsize block_size,
    -                                                         gpointer mem_block);
    +
    void                g_slice_free1                       (gsize block_size,
    +                                                         gpointer mem_block);

    Frees a block of memory. The memory must have been allocated via g_slice_alloc() or g_slice_alloc0() @@ -272,9 +297,9 @@ also see G_SLIC


    g_slice_free_chain_with_offset ()

    -
    void                g_slice_free_chain_with_offset      (gsize block_size,
    -                                                         gpointer mem_chain,
    -                                                         gsize next_offset);
    +
    void                g_slice_free_chain_with_offset      (gsize block_size,
    +                                                         gpointer mem_chain,
    +                                                         gsize next_offset);

    Frees a linked list of memory blocks of structure type type. The memory blocks must be equal-sized, allocated via @@ -470,7 +495,7 @@ also see G_SLIC



    -

    [6] +

    [6] [Bonwick94] Jeff Bonwick, The slab allocator: An object-caching kernel memory allocator. USENIX 1994, and [Bonwick01] Bonwick and Jonathan Adams, Magazines and vmem: Extending the @@ -480,6 +505,6 @@ slab allocator to many cpu's and arbitrary resources. USENIX 2001

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Message-Logging.html b/docs/reference/glib/html/glib-Message-Logging.html index d9cc9db..15550b3 100644 --- a/docs/reference/glib/html/glib-Message-Logging.html +++ b/docs/reference/glib/html/glib-Message-Logging.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -63,41 +43,41 @@ #define G_LOG_DOMAIN #define G_LOG_FATAL_MASK #define G_LOG_LEVEL_USER_SHIFT -void (*GLogFunc) (const gchar *log_domain, - GLogLevelFlags log_level, - const gchar *message, - gpointer user_data); +void (*GLogFunc) (const gchar *log_domain, + GLogLevelFlags log_level, + const gchar *message, + gpointer user_data); enum GLogLevelFlags; -voidg_log (const gchar *log_domain, - GLogLevelFlags log_level, - const gchar *format, - ...); -voidg_logv (const gchar *log_domain, - GLogLevelFlags log_level, - const gchar *format, - va_list args); +voidg_log (const gchar *log_domain, + GLogLevelFlags log_level, + const gchar *format, + ...); +voidg_logv (const gchar *log_domain, + GLogLevelFlags log_level, + const gchar *format, + va_list args); #define g_message (...) #define g_warning (...) #define g_critical (...) #define g_error (...) #define g_debug (...) -guintg_log_set_handler (const gchar *log_domain, - GLogLevelFlags log_levels, - GLogFunc log_func, - gpointer user_data); -voidg_log_remove_handler (const gchar *log_domain, - guint handler_id); -GLogLevelFlagsg_log_set_always_fatal (GLogLevelFlags fatal_mask); -GLogLevelFlagsg_log_set_fatal_mask (const gchar *log_domain, - GLogLevelFlags fatal_mask); -voidg_log_default_handler (const gchar *log_domain, - GLogLevelFlags log_level, - const gchar *message, - gpointer unused_data); -GLogFuncg_log_set_default_handler (GLogFunc log_func, - gpointer user_data); +guintg_log_set_handler (const gchar *log_domain, + GLogLevelFlags log_levels, + GLogFunc log_func, + gpointer user_data); +voidg_log_remove_handler (const gchar *log_domain, + guint handler_id); +GLogLevelFlagsg_log_set_always_fatal (GLogLevelFlags fatal_mask); +GLogLevelFlagsg_log_set_fatal_mask (const gchar *log_domain, + GLogLevelFlags fatal_mask); +voidg_log_default_handler (const gchar *log_domain, + GLogLevelFlags log_level, + const gchar *message, + gpointer unused_data); +GLogFuncg_log_set_default_handler (GLogFunc log_func, + gpointer user_data);
    @@ -127,9 +107,17 @@ But be careful not to define it in any public header files.

    For example, GTK+ uses this in its Makefile.am:

    -
    -INCLUDES = -DG_LOG_DOMAIN=\"Gtk\"
    -
    +
    +
    + + + + + + +
    1
    INCLUDES = -DG_LOG_DOMAIN=\"Gtk\"
    +
    +

    @@ -152,10 +140,10 @@ Log level shift offset for user defined log levels (0-7 are used by GLib).

    GLogFunc ()

    -
    void                (*GLogFunc)                         (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *message,
    -                                                         gpointer user_data);
    +
    void                (*GLogFunc)                         (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *message,
    +                                                         gpointer user_data);

    Specifies the prototype of log handler functions.

    @@ -268,10 +256,10 @@ and

    g_log ()

    -
    void                g_log                               (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_log                               (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *format,
    +                                                         ...);

    Logs an error or debugging message. If the log level has been set as fatal, the abort() @@ -307,10 +295,10 @@ documentation.


    g_logv ()

    -
    void                g_logv                              (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *format,
    -                                                         va_list args);
    +
    void                g_logv                              (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *format,
    +                                                         va_list args);

    Logs an error or debugging message. If the log level has been set as fatal, the abort() @@ -445,10 +433,10 @@ A convenience function/macro to log a debug message.


    g_log_set_handler ()

    -
    guint               g_log_set_handler                   (const gchar *log_domain,
    -                                                         GLogLevelFlags log_levels,
    -                                                         GLogFunc log_func,
    -                                                         gpointer user_data);
    +
    guint               g_log_set_handler                   (const gchar *log_domain,
    +                                                         GLogLevelFlags log_levels,
    +                                                         GLogFunc log_func,
    +                                                         gpointer user_data);

    Sets the log handler for a domain and a set of log levels. To handle fatal and recursive messages the log_levels parameter @@ -461,27 +449,54 @@ you want to set a handler for this log level you must combine it with G_LOG_FLAG_FATAL.

    -

    Example 12. Adding a log handler for all warning messages in the default +

    Example 12. Adding a log handler for all warning messages in the default (application) domain

    -
    -  g_log_set_handler (NULL, G_LOG_LEVEL_WARNING | G_LOG_FLAG_FATAL
    -                     | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    -
    +
    + + + + + + + +
    1
    +2
    g_log_set_handler (NULL, G_LOG_LEVEL_WARNING | G_LOG_FLAG_FATAL
    +                   | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    +
    +

    -

    Example 13. Adding a log handler for all critical messages from GTK+

    -
    -  g_log_set_handler ("Gtk", G_LOG_LEVEL_CRITICAL | G_LOG_FLAG_FATAL
    -                     | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    -
    +

    Example 13. Adding a log handler for all critical messages from GTK+

    +
    + + + + + + + +
    1
    +2
    g_log_set_handler ("Gtk", G_LOG_LEVEL_CRITICAL | G_LOG_FLAG_FATAL
    +                   | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    +
    +

    -

    Example 14. Adding a log handler for all messages from +

    Example 14. Adding a log handler for all messages from GLib

    -
    -  g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
    -                     | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    -
    +
    + + + + + + + +
    1
    +2
    g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
    +                   | G_LOG_FLAG_RECURSION, my_log_handler, NULL);
    +
    +

    @@ -519,8 +534,8 @@ and recursive messages as well, combine the log levels with the

    g_log_remove_handler ()

    -
    void                g_log_remove_handler                (const gchar *log_domain,
    -                                                         guint handler_id);
    +
    void                g_log_remove_handler                (const gchar *log_domain,
    +                                                         guint handler_id);

    Removes the log handler.

    @@ -543,7 +558,7 @@ Removes the log handler.

    g_log_set_always_fatal ()

    -
    GLogLevelFlags      g_log_set_always_fatal              (GLogLevelFlags fatal_mask);
    +
    GLogLevelFlags      g_log_set_always_fatal              (GLogLevelFlags fatal_mask);

    Sets the message levels which are always fatal, in any log domain. When a message with any of these levels is logged the program terminates. @@ -575,8 +590,8 @@ to be fatal.


    g_log_set_fatal_mask ()

    -
    GLogLevelFlags      g_log_set_fatal_mask                (const gchar *log_domain,
    -                                                         GLogLevelFlags fatal_mask);
    +
    GLogLevelFlags      g_log_set_fatal_mask                (const gchar *log_domain,
    +                                                         GLogLevelFlags fatal_mask);

    Sets the log levels which are fatal in the given domain. G_LOG_LEVEL_ERROR is always fatal. @@ -605,10 +620,10 @@ Sets the log levels which are fatal in the given domain.


    g_log_default_handler ()

    -
    void                g_log_default_handler               (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *message,
    -                                                         gpointer unused_data);
    +
    void                g_log_default_handler               (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *message,
    +                                                         gpointer unused_data);

    The default log handler set up by GLib; g_log_set_default_handler() allows to install an alternate default log handler. @@ -649,8 +664,8 @@ stderr is used for levels

    g_log_set_default_handler ()

    -
    GLogFunc            g_log_set_default_handler           (GLogFunc log_func,
    -                                                         gpointer user_data);
    +
    GLogFunc            g_log_set_default_handler           (GLogFunc log_func,
    +                                                         gpointer user_data);

    Installs a default log handler which is used if no log handler has been set for the particular log domain @@ -683,6 +698,6 @@ and log level combination. By default, GLib uses

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Miscellaneous-Macros.html b/docs/reference/glib/html/glib-Miscellaneous-Macros.html index 0eeb30e..ff8a2d0 100644 --- a/docs/reference/glib/html/glib-Miscellaneous-Macros.html +++ b/docs/reference/glib/html/glib-Miscellaneous-Macros.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -70,11 +50,14 @@ #define G_N_ELEMENTS (arr) -#define G_VA_COPY (ap1,ap2) +#define G_VA_COPY (ap1, + ap2) #define G_STRINGIFY (macro_or_string) -#define G_PASTE (identifier1,identifier2) -#define G_PASTE_ARGS (identifier1,identifier2) +#define G_PASTE (identifier1, + identifier2) +#define G_PASTE_ARGS (identifier1, + identifier2) #define G_STATIC_ASSERT (expr) #define G_GNUC_EXTENSION @@ -82,13 +65,16 @@ #define G_GNUC_PURE #define G_GNUC_MALLOC #define G_GNUC_ALLOC_SIZE (x) -#define G_GNUC_ALLOC_SIZE2 (x,y) +#define G_GNUC_ALLOC_SIZE2 (x, + y) #define G_GNUC_DEPRECATED #define G_GNUC_NORETURN #define G_GNUC_UNUSED -#define G_GNUC_PRINTF ( format_idx, arg_idx ) -#define G_GNUC_SCANF ( format_idx, arg_idx ) -#define G_GNUC_FORMAT ( arg_idx ) +#define G_GNUC_PRINTF (format_idx, + arg_idx) +#define G_GNUC_SCANF (format_idx, + arg_idx) +#define G_GNUC_FORMAT (arg_idx) #define G_GNUC_NULL_TERMINATED #define G_GNUC_WARN_UNUSED_RESULT #define G_GNUC_FUNCTION @@ -477,12 +463,23 @@ arguments, with the same syntax as -
    -gint g_snprintf (gchar  *string,
    -                 gulong       n,
    -                 gchar const *format,
    -                 ...) G_GNUC_PRINTF (3, 4);
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    gint g_snprintf (gchar  *string,
    +                 gulong       n,
    +                 gchar const *format,
    +                 ...) G_GNUC_PRINTF (3, 4);
    +
    +
    @@ -544,9 +541,17 @@ function (with the remaining arguments to the format function the same as they would have been for the unmodified string). See the GNU C documentation for details.

    -
    -gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2);
    -
    +
    +
    + + + + + + +
    1
    gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2);
    +
    +
    @@ -649,13 +654,25 @@ Note that for portability, the attribute should be placed before the function declaration. While GCC allows the macro after the declaration, Sun Studio does not.

    -
    -G_GNUC_INTERNAL
    -void _g_log_fallback_handler (const gchar    *log_domain,
    -                              GLogLevelFlags  log_level,
    -                              const gchar    *message,
    -                              gpointer        unused_data);
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    G_GNUC_INTERNAL
    +void _g_log_fallback_handler (const gchar    *log_domain,
    +                              GLogLevelFlags  log_level,
    +                              const gchar    *message,
    +                              gpointer        unused_data);
    +
    + Since: 2.6

    @@ -677,10 +694,19 @@ Since: 2.14
    Hints the compiler that the expression is likely to evaluate to a true value. The compiler may use this information for optimizations.

    -
    -if (G_LIKELY (random () != 1))
    -  g_print ("not one");
    -
    +
    + + + + + + + +
    1
    +2
    if (G_LIKELY (random () != 1))
    +  g_print ("not one");
    +
    +
    @@ -706,10 +732,19 @@ if (G_LIKELY (random () != 1)) Hints the compiler that the expression is unlikely to evaluate to a true value. The compiler may use this information for optimizations.

    -
    -if (G_UNLIKELY (random () == 1))
    -  g_print ("a random one");
    -
    +
    +
    + + + + + + +
    1
    +2
    if (G_UNLIKELY (random () == 1))
    +  g_print ("a random one");
    +
    +
    @@ -759,10 +794,19 @@ conversion specifier.

    The following example prints "0x7b";

    -
    -gint16 value = 123;
    -g_print ("%#" G_GINT16_MODIFIER "x", value);
    -
    +
    +
    + + + + + + +
    1
    +2
    gint16 value = 123;
    +g_print ("%#" G_GINT16_MODIFIER "x", value);
    +
    +

    Since 2.4

    @@ -780,13 +824,25 @@ modifiers between percent-sign and conversion specifier.

    -
    -gint16 in;
    -gint32 out;
    -sscanf ("42", "%" G_GINT16_FORMAT, &in)
    -out = in * 1000;
    -g_print ("%" G_GINT32_FORMAT, out);
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    gint16 in;
    +gint32 out;
    +sscanf ("42", "%" G_GINT16_FORMAT, &in)
    +out = in * 1000;
    +g_print ("%" G_GINT32_FORMAT, out);
    +
    +

    @@ -984,6 +1040,6 @@ printing values of type + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Miscellaneous-Utility-Functions.html b/docs/reference/glib/html/glib-Miscellaneous-Utility-Functions.html index ccd7458..ce3d05a 100644 --- a/docs/reference/glib/html/glib-Miscellaneous-Utility-Functions.html +++ b/docs/reference/glib/html/glib-Miscellaneous-Utility-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -60,74 +40,74 @@
     #include <glib.h>
     
    -const gchar*        g_get_application_name              (void);
    -void                g_set_application_name              (const gchar *application_name);
    -gchar*              g_get_prgname                       (void);
    -void                g_set_prgname                       (const gchar *prgname);
    -const gchar*        g_getenv                            (const gchar *variable);
    -gboolean            g_setenv                            (const gchar *variable,
    -                                                         const gchar *value,
    -                                                         gboolean overwrite);
    -void                g_unsetenv                          (const gchar *variable);
    -gchar**             g_listenv                           (void);
    -const gchar*        g_get_user_name                     (void);
    -const gchar*        g_get_real_name                     (void);
    -const gchar*        g_get_user_cache_dir                (void);
    -const gchar*        g_get_user_data_dir                 (void);
    -const gchar*        g_get_user_config_dir               (void);
    +const gchar*        g_get_application_name              (void);
    +void                g_set_application_name              (const gchar *application_name);
    +gchar*              g_get_prgname                       (void);
    +void                g_set_prgname                       (const gchar *prgname);
    +const gchar*        g_getenv                            (const gchar *variable);
    +gboolean            g_setenv                            (const gchar *variable,
    +                                                         const gchar *value,
    +                                                         gboolean overwrite);
    +void                g_unsetenv                          (const gchar *variable);
    +gchar**             g_listenv                           (void);
    +const gchar*        g_get_user_name                     (void);
    +const gchar*        g_get_real_name                     (void);
    +const gchar*        g_get_user_cache_dir                (void);
    +const gchar*        g_get_user_data_dir                 (void);
    +const gchar*        g_get_user_config_dir               (void);
     enum                GUserDirectory;
    -const gchar*        g_get_user_special_dir              (GUserDirectory directory);
    -const gchar* const * g_get_system_data_dirs             (void);
    -const gchar* const * g_get_system_config_dirs           (void);
    -void                g_reload_user_special_dirs_cache    (void);
    +const gchar*        g_get_user_special_dir              (GUserDirectory directory);
    +const gchar* const * g_get_system_data_dirs             (void);
    +const gchar* const * g_get_system_config_dirs           (void);
    +void                g_reload_user_special_dirs_cache    (void);
     
    -const gchar*        g_get_host_name                     (void);
    -const gchar*        g_get_home_dir                      (void);
    -const gchar*        g_get_tmp_dir                       (void);
    -gchar*              g_get_current_dir                   (void);
    -const gchar*        g_basename                          (const gchar *file_name);
    +const gchar*        g_get_host_name                     (void);
    +const gchar*        g_get_home_dir                      (void);
    +const gchar*        g_get_tmp_dir                       (void);
    +gchar*              g_get_current_dir                   (void);
    +const gchar*        g_basename                          (const gchar *file_name);
     #define             g_dirname
    -gboolean            g_path_is_absolute                  (const gchar *file_name);
    -const gchar*        g_path_skip_root                    (const gchar *file_name);
    -gchar*              g_path_get_basename                 (const gchar *file_name);
    -gchar*              g_path_get_dirname                  (const gchar *file_name);
    -gchar *             g_build_filename                    (const gchar *first_element,
    -                                                         ...);
    -gchar *             g_build_filenamev                   (gchar **args);
    -gchar *             g_build_path                        (const gchar *separator,
    -                                                         const gchar *first_element,
    -                                                         ...);
    -gchar *             g_build_pathv                       (const gchar *separator,
    -                                                         gchar **args);
    -char *              g_format_size_for_display           (goffset size);
    +gboolean            g_path_is_absolute                  (const gchar *file_name);
    +const gchar*        g_path_skip_root                    (const gchar *file_name);
    +gchar*              g_path_get_basename                 (const gchar *file_name);
    +gchar*              g_path_get_dirname                  (const gchar *file_name);
    +gchar *             g_build_filename                    (const gchar *first_element,
    +                                                         ...);
    +gchar *             g_build_filenamev                   (gchar **args);
    +gchar *             g_build_path                        (const gchar *separator,
    +                                                         const gchar *first_element,
    +                                                         ...);
    +gchar *             g_build_pathv                       (const gchar *separator,
    +                                                         gchar **args);
    +char *              g_format_size_for_display           (goffset size);
     
    -gchar*              g_find_program_in_path              (const gchar *program);
    +gchar*              g_find_program_in_path              (const gchar *program);
     
    -gint                g_bit_nth_lsf                       (gulong mask,
    -                                                         gint nth_bit);
    -gint                g_bit_nth_msf                       (gulong mask,
    -                                                         gint nth_bit);
    -guint               g_bit_storage                       (gulong number);
    +gint                g_bit_nth_lsf                       (gulong mask,
    +                                                         gint nth_bit);
    +gint                g_bit_nth_msf                       (gulong mask,
    +                                                         gint nth_bit);
    +guint               g_bit_storage                       (gulong number);
     
    -guint               g_spaced_primes_closest             (guint num);
    +guint               g_spaced_primes_closest             (guint num);
     
    -void                g_atexit                            (GVoidFunc func);
    +void                g_atexit                            (GVoidFunc func);
     
    -guint               g_parse_debug_string                (const gchar *string,
    -                                                         const GDebugKey *keys,
    -                                                         guint nkeys);
    +guint               g_parse_debug_string                (const gchar *string,
    +                                                         const GDebugKey *keys,
    +                                                         guint nkeys);
                         GDebugKey;
     
    -void                (*GVoidFunc)                        (void);
    -void                (*GFreeFunc)                        (gpointer data);
    +void                (*GVoidFunc)                        (void);
    +void                (*GFreeFunc)                        (gpointer data);
     
    -void                g_qsort_with_data                   (gconstpointer pbase,
    -                                                         gint total_elems,
    -                                                         gsize size,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +void                g_qsort_with_data                   (gconstpointer pbase,
    +                                                         gint total_elems,
    +                                                         gsize size,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);
     
    -void                g_nullify_pointer                   (gpointer *nullify_location);
    +void                g_nullify_pointer                   (gpointer *nullify_location);
     
    @@ -140,7 +120,7 @@ These are portable utility functions.

    Details

    g_get_application_name ()

    -
    const gchar*        g_get_application_name              (void);
    +
    const gchar*        g_get_application_name              (void);

    Gets a human-readable name for the application, as set by g_set_application_name(). This name should be localized if @@ -148,7 +128,8 @@ possible, and is intended for display to the user. Contrast with g_get_prgname(), which gets a non-localized name. If g_set_application_name() has not been called, returns the result of g_get_prgname() (which may be NULL if g_set_prgname() has also not -been called).

    +been called). +

    @@ -163,12 +144,12 @@ been called).


    g_set_application_name ()

    -
    void                g_set_application_name              (const gchar *application_name);
    +
    void                g_set_application_name              (const gchar *application_name);

    Sets a human-readable name for the application. This name should be localized if possible, and is intended for display to the user. Contrast with g_set_prgname(), which sets a non-localized name. -g_set_prgname() will be called automatically by gtk_init(), +g_set_prgname() will be called automatically by gtk_init(), but g_set_application_name() will not.

    @@ -177,12 +158,13 @@ be called once.

    The application name will be used in contexts such as error messages, -or when displaying an application's name in the task list.

    +or when displaying an application's name in the task list. +

    -

    application_name :

    localized name of the application +localized name of the application
    @@ -191,13 +173,14 @@ or when displaying an application's name in the task list.


    g_get_prgname ()

    -
    gchar*              g_get_prgname                       (void);
    +
    gchar*              g_get_prgname                       (void);

    Gets the name of the program. This name should not be localized, contrast with g_get_application_name(). -(If you are using GDK or GTK+ the program name is set in gdk_init(), -which is called by gtk_init(). The program name is found by taking -the last component of argv[0].)

    +(If you are using GDK or GTK+ the program name is set in gdk_init(), +which is called by gtk_init(). The program name is found by taking +the last component of argv[0].) +

    @@ -211,16 +194,17 @@ to GLib and must not be modified or freed.

    g_set_prgname ()

    -
    void                g_set_prgname                       (const gchar *prgname);
    +
    void                g_set_prgname                       (const gchar *prgname);

    Sets the name of the program. This name should not be localized, contrast with g_set_application_name(). Note that for -thread-safety reasons this function can only be called once.

    +thread-safety reasons this function can only be called once. +

    -

    prgname :

    the name of the program. +the name of the program.
    @@ -228,20 +212,21 @@ thread-safety reasons this function can only be called once.


    g_getenv ()

    -
    const gchar*        g_getenv                            (const gchar *variable);
    +
    const gchar*        g_getenv                            (const gchar *variable);

    Returns the value of an environment variable. The name and value are in the GLib file name encoding. On UNIX, this means the actual bytes which might or might not be in some consistent character set and encoding. On Windows, it is in UTF-8. On Windows, in case the environment variable's value contains references to other -environment variables, they are expanded.

    +environment variables, they are expanded. +

    - @@ -258,9 +243,9 @@ overwritten by the next call to

    g_setenv ()

    -
    gboolean            g_setenv                            (const gchar *variable,
    -                                                         const gchar *value,
    -                                                         gboolean overwrite);
    +
    gboolean            g_setenv                            (const gchar *variable,
    +                                                         const gchar *value,
    +                                                         gboolean overwrite);

    Sets an environment variable. Both the variable's name and value should be in the GLib file name encoding. On UNIX, this means that @@ -269,23 +254,24 @@ UTF-8.

    Note that on some systems, when variables are overwritten, the memory -used for the previous variables and its value isn't reclaimed.

    +used for the previous variables and its value isn't reclaimed. +

    variable :

    the environment variable to get, in the GLib file name encoding. +the environment variable to get, in the GLib file name encoding.
    - - - @@ -301,7 +287,7 @@ used for the previous variables and its value isn't reclaimed.


    g_unsetenv ()

    -
    void                g_unsetenv                          (const gchar *variable);
    +
    void                g_unsetenv                          (const gchar *variable);

    Removes an environment variable from the environment.

    @@ -309,12 +295,13 @@ Removes an environment variable from the environment. Note that on some systems, when variables are overwritten, the memory used for the previous variables and its value isn't reclaimed. Furthermore, this function can't be guaranteed to operate in a -threadsafe way.

    +threadsafe way. +

    variable :

    the environment variable to set, must not contain '='. +the environment variable to set, must not contain '='.

    value :

    the value for to set the variable to. +the value for to set the variable to.

    overwrite :

    whether to change the variable if it already exists. +whether to change the variable if it already exists.
    -

    variable :

    the environment variable to remove, must not contain '='. +the environment variable to remove, must not contain '='.
    @@ -323,9 +310,10 @@ threadsafe way.


    g_listenv ()

    -
    gchar**             g_listenv                           (void);
    +
    gchar**             g_listenv                           (void);

    -Gets the names of all variables set in the environment.

    +Gets the names of all variables set in the environment. +

    @@ -348,12 +336,13 @@ the UTF-8 encoding that this function and

    g_get_user_name ()

    -
    const gchar*        g_get_user_name                     (void);
    +
    const gchar*        g_get_user_name                     (void);

    Gets the user name of the current user. The encoding of the returned string is system-defined. On UNIX, it might be the preferred file name encoding, or something else, and there is no guarantee that it is even -consistent on a machine. On Windows, it is always UTF-8.

    +consistent on a machine. On Windows, it is always UTF-8. +

    @@ -366,13 +355,14 @@ consistent on a machine. On Windows, it is always UTF-8.


    g_get_real_name ()

    -
    const gchar*        g_get_real_name                     (void);
    +
    const gchar*        g_get_real_name                     (void);

    Gets the real name of the user. This usually comes from the user's entry in the passwd file. The encoding of the returned string is system-defined. (On Windows, it is, however, always UTF-8.) If the real user name cannot be determined, the string "Unknown" is -returned.

    +returned. +

    @@ -385,7 +375,7 @@ returned.


    g_get_user_cache_dir ()

    -
    const gchar*        g_get_user_cache_dir                (void);
    +
    const gchar*        g_get_user_cache_dir                (void);

    Returns a base directory in which to store non-essential, cached data specific to particular user. @@ -393,7 +383,8 @@ data specific to particular user.

    On UNIX platforms this is determined using the mechanisms described in the -XDG Base Directory Specification

    +XDG Base Directory Specification +

    @@ -408,7 +399,7 @@ XDG Base Directory Specification


    g_get_user_data_dir ()

    -
    const gchar*        g_get_user_data_dir                 (void);
    +
    const gchar*        g_get_user_data_dir                 (void);

    Returns a base directory in which to access application data such as icons that is customized for a particular user. @@ -416,7 +407,8 @@ as icons that is customized for a particular user.

    On UNIX platforms this is determined using the mechanisms described in the -XDG Base Directory Specification

    +XDG Base Directory Specification +

    @@ -431,7 +423,7 @@ XDG Base Directory Specification


    g_get_user_config_dir ()

    -
    const gchar*        g_get_user_config_dir               (void);
    +
    const gchar*        g_get_user_config_dir               (void);

    Returns a base directory in which to store user-specific application configuration information such as user preferences and settings. @@ -439,7 +431,8 @@ configuration information such as user preferences and settings.

    On UNIX platforms this is determined using the mechanisms described in the -XDG Base Directory Specification

    +XDG Base Directory Specification +

    @@ -475,53 +468,54 @@ to retrieve the full path associated to the logical id.

    The GUserDirectory enumeration can be extended at later date. Not every platform has a directory for every logical id in this -enumeration.

    +enumeration. +

    - - - - - - - - - @@ -531,7 +525,7 @@ enumeration.


    g_get_user_special_dir ()

    -
    const gchar*        g_get_user_special_dir              (GUserDirectory directory);
    +
    const gchar*        g_get_user_special_dir              (GUserDirectory directory);

    Returns the full path of a special directory using its logical id.

    @@ -544,13 +538,14 @@ user directories have not been set up.

    Depending on the platform, the user might be able to change the path of the special directory without requiring the session to restart; GLib -will not reflect any change once the special directories are loaded.

    +will not reflect any change once the special directories are loaded. +

    G_USER_DIRECTORY_DESKTOP

    the user's Desktop directory +the user's Desktop directory

    G_USER_DIRECTORY_DOCUMENTS

    the user's Documents directory +the user's Documents directory

    G_USER_DIRECTORY_DOWNLOAD

    the user's Downloads directory +the user's Downloads directory

    G_USER_DIRECTORY_MUSIC

    the user's Music directory +the user's Music directory

    G_USER_DIRECTORY_PICTURES

    the user's Pictures directory +the user's Pictures directory

    G_USER_DIRECTORY_PUBLIC_SHARE

    the user's shared directory +the user's shared directory

    G_USER_DIRECTORY_TEMPLATES

    the user's Templates directory +the user's Templates directory

    G_USER_DIRECTORY_VIDEOS

    the user's Movies directory +the user's Movies directory

    G_USER_N_DIRECTORIES

    the number of enum values +the number of enum values
    - @@ -568,7 +563,7 @@ will not reflect any change once the special directories are loaded.


    g_get_system_data_dirs ()

    -
    const gchar* const * g_get_system_data_dirs             (void);
    +
    const gchar* const * g_get_system_data_dirs             (void);

    Returns an ordered list of base directories in which to access system-wide application data. @@ -603,7 +598,8 @@ itself.

    Note that on Windows the returned list can vary depending on where -this function is called.

    +this function is called. +

    directory :

    the logical id of special directory +the logical id of special directory
    @@ -618,7 +614,7 @@ this function is called.


    g_get_system_config_dirs ()

    -
    const gchar* const * g_get_system_config_dirs           (void);
    +
    const gchar* const * g_get_system_config_dirs           (void);

    Returns an ordered list of base directories in which to access system-wide configuration information. @@ -626,7 +622,8 @@ system-wide configuration information.

    On UNIX platforms this is determined using the mechanisms described in the -XDG Base Directory Specification

    +XDG Base Directory Specification +

    @@ -641,7 +638,7 @@ XDG Base Directory Specification


    g_reload_user_special_dirs_cache ()

    -
    void                g_reload_user_special_dirs_cache    (void);
    +
    void                g_reload_user_special_dirs_cache    (void);

    Resets the cache used for g_get_user_special_dir(), so that the latest on-disk version is used. Call this only @@ -651,13 +648,14 @@ if you just changed the data on disk yourself. Due to threadsafety issues this may cause leaking of strings that were previously returned from g_get_user_special_dir() that can't be freed. We ensure to only leak the data for -the directories that actually changed value though.

    +the directories that actually changed value though. +

    Since 2.22


    g_get_host_name ()

    -
    const gchar*        g_get_host_name                     (void);
    +
    const gchar*        g_get_host_name                     (void);

    Return a name for the machine.

    @@ -671,7 +669,8 @@ of the machine is changed while an application is running, the return value from this function does not change. The returned string is owned by GLib and should not be modified or freed. If no name can be determined, a default fixed string "localhost" is -returned.

    +returned. +

    @@ -686,7 +685,7 @@ returned.


    g_get_home_dir ()

    -
    const gchar*        g_get_home_dir                      (void);
    +
    const gchar*        g_get_home_dir                      (void);

    Gets the current user's home directory as defined in the password database. @@ -713,11 +712,23 @@ to deal with these situations it was considered better to make return the real home directory for the user. If applications want to pay attention to HOME, they can do:

    -
    - const char *homedir = g_getenv ("HOME");
    -  if (!homedir)
    -     homedir = g_get_home_dir ();
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    const char *homedir = g_getenv ("HOME");
    + if (!homedir)
    +    homedir = g_get_home_dir ();
    +
    + +

    +

    @@ -730,14 +741,15 @@ want to pay attention to HOME, they can do:

    g_get_tmp_dir ()

    -
    const gchar*        g_get_tmp_dir                       (void);
    +
    const gchar*        g_get_tmp_dir                       (void);

    Gets the directory to use for temporary files. This is found from inspecting the environment variables TMPDIR, TMP, and TEMP in that order. If none of those are defined "/tmp" is returned on UNIX and "C:\" on Windows. The encoding of the returned string is system-defined. On Windows, -it is always UTF-8. The return value is never NULL.

    +it is always UTF-8. The return value is never NULL. +

    @@ -750,11 +762,12 @@ it is always UTF-8. The return value is never

    g_get_current_dir ()

    -
    gchar*              g_get_current_dir                   (void);
    +
    gchar*              g_get_current_dir                   (void);

    Gets the current directory. The returned string should be freed when no longer needed. The encoding -of the returned string is system defined. On Windows, it is always UTF-8.

    +of the returned string is system defined. On Windows, it is always UTF-8. +

    @@ -767,7 +780,7 @@ of the returned string is system defined. On Windows, it is always UTF-8.


    g_basename ()

    -
    const gchar*        g_basename                          (const gchar *file_name);
    +
    const gchar*        g_basename                          (const gchar *file_name);

    Warning

    g_basename has been deprecated since version 2.2 and should not be used in newly-written code. Use g_path_get_basename() instead, but notice that @@ -776,13 +789,14 @@ this function which returns a pointer into the argument.

    Gets the name of the file without any leading directory components. -It returns a pointer into the given file name string.

    +It returns a pointer into the given file name string. +

    - @@ -823,17 +837,18 @@ The returned string should be freed when no longer needed.

    g_path_is_absolute ()

    -
    gboolean            g_path_is_absolute                  (const gchar *file_name);
    +
    gboolean            g_path_is_absolute                  (const gchar *file_name);

    Returns TRUE if the given file_name is an absolute file name, i.e. it contains a full path from the root directory such as "/usr/local" -on UNIX or "C:\windows" on Windows systems.

    +on UNIX or "C:\windows" on Windows systems. +

    file_name :

    the name of the file. +the name of the file.
    - @@ -847,17 +862,18 @@ on UNIX or "C:\windows" on Windows systems.


    g_path_skip_root ()

    -
    const gchar*        g_path_skip_root                    (const gchar *file_name);
    +
    const gchar*        g_path_skip_root                    (const gchar *file_name);

    Returns a pointer into file_name after the root component, i.e. after the "/" in UNIX or "C:\" under Windows. If file_name is not an absolute -path it returns NULL.

    +path it returns NULL. +

    file_name :

    a file name. +a file name.
    - @@ -871,19 +887,20 @@ path it returns

    g_path_get_basename ()

    -
    gchar*              g_path_get_basename                 (const gchar *file_name);
    +
    gchar*              g_path_get_basename                 (const gchar *file_name);

    Gets the last component of the filename. If file_name ends with a directory separator it gets the component before the last slash. If file_name consists only of directory separators (and on Windows, possibly a drive letter), a single separator is returned. If -file_name is empty, it gets ".".

    +file_name is empty, it gets ".". +

    file_name :

    a file name. +a file name.
    - @@ -898,17 +915,18 @@ possibly a drive letter), a single separator is returned. If

    g_path_get_dirname ()

    -
    gchar*              g_path_get_dirname                  (const gchar *file_name);
    +
    gchar*              g_path_get_dirname                  (const gchar *file_name);

    Gets the directory components of a file name. If the file name has no directory components "." is returned. The returned string should be -freed when no longer needed.

    +freed when no longer needed. +

    file_name :

    the name of the file. +the name of the file.
    - @@ -922,8 +940,8 @@ freed when no longer needed.


    g_build_filename ()

    -
    gchar *             g_build_filename                    (const gchar *first_element,
    -                                                         ...);
    +
    gchar *             g_build_filename                    (const gchar *first_element,
    +                                                         ...);

    Creates a filename from a series of elements using the correct separator for filenames. @@ -943,18 +961,19 @@ is used.

    No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will -be a relative path.

    +be a relative path. +

    file_name :

    the name of the file. +the name of the file.
    - - @@ -968,17 +987,19 @@ be a relative path.


    g_build_filenamev ()

    -
    gchar *             g_build_filenamev                   (gchar **args);
    +
    gchar *             g_build_filenamev                   (gchar **args);

    Behaves exactly like g_build_filename(), but takes the path elements as a string array, instead of varargs. This function is mainly -meant for language bindings.

    +meant for language bindings. +

    first_element :

    the first element in the path +the first element in the path

    ... :

    remaining elements in path, terminated by NULL +remaining elements in path, terminated by NULL
    - @@ -994,9 +1015,9 @@ meant for language bindings.


    g_build_path ()

    -
    gchar *             g_build_path                        (const gchar *separator,
    -                                                         const gchar *first_element,
    -                                                         ...);
    +
    gchar *             g_build_path                        (const gchar *separator,
    +                                                         const gchar *first_element,
    +                                                         ...);

    Creates a path from a series of elements using separator as the separator between elements. At the boundary between two elements, @@ -1029,23 +1050,24 @@ of that element.

    Other than for determination of the number of leading and trailing copies of the separator, elements consisting only of copies -of the separator are ignored.

    +of the separator are ignored. +

    args :

    NULL-terminated array of strings containing the path elements. + +NULL-terminated array of strings containing the path elements.
    - - - @@ -1059,23 +1081,25 @@ of the separator are ignored.


    g_build_pathv ()

    -
    gchar *             g_build_pathv                       (const gchar *separator,
    -                                                         gchar **args);
    +
    gchar *             g_build_pathv                       (const gchar *separator,
    +                                                         gchar **args);

    Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of varargs. This function is mainly -meant for language bindings.

    +meant for language bindings. +

    separator :

    a string used to separator the elements of the path. +a string used to separator the elements of the path.

    first_element :

    the first element in the path +the first element in the path

    ... :

    remaining elements in path, terminated by NULL +remaining elements in path, terminated by NULL
    - - @@ -1091,7 +1115,7 @@ meant for language bindings.


    g_format_size_for_display ()

    -
    char *              g_format_size_for_display           (goffset size);
    +
    char *              g_format_size_for_display           (goffset size);

    Formats a size (for example the size of a file) into a human readable string. Sizes are rounded to the nearest size prefix (KB, MB, GB) and are displayed @@ -1102,13 +1126,14 @@ converted into the string "3.1 MB". The prefix units base is 1024 (i.e. 1 KB is 1024 bytes).

    -This string should be freed with g_free() when not needed any longer.

    +This string should be freed with g_free() when not needed any longer. +

    separator :

    a string used to separator the elements of the path. +a string used to separator the elements of the path.

    args :

    NULL-terminated array of strings containing the path elements. + +NULL-terminated array of strings containing the path elements.
    - @@ -1125,7 +1150,7 @@ This string should be freed with

    g_find_program_in_path ()

    -
    gchar*              g_find_program_in_path              (const gchar *program);
    +
    gchar*              g_find_program_in_path              (const gchar *program);

    Locates the first executable named program in the user's path, in the same way that execvp() would locate it. Returns an allocated string @@ -1144,13 +1169,14 @@ program was loaded from, then in the current directory, then in the Windows 32-bit system directory, then in the Windows directory, and finally in the directories in the PATH environment variable. If the program is found, the return value contains the -full name including the type suffix.

    +full name including the type suffix. +

    size :

    a size in bytes. +a size in bytes.
    - @@ -1164,8 +1190,8 @@ full name including the type suffix.


    g_bit_nth_lsf ()

    -
    gint                g_bit_nth_lsf                       (gulong mask,
    -                                                         gint nth_bit);
    +
    gint                g_bit_nth_lsf                       (gulong mask,
    +                                                         gint nth_bit);

    Find the position of the first bit set in mask, searching from (but not including) nth_bit upwards. Bits are numbered from 0 (least significant) @@ -1196,8 +1222,8 @@ to sizeof(

    g_bit_nth_msf ()

    -
    gint                g_bit_nth_msf                       (gulong mask,
    -                                                         gint nth_bit);
    +
    gint                g_bit_nth_msf                       (gulong mask,
    +                                                         gint nth_bit);

    Find the position of the first bit set in mask, searching from (but not including) nth_bit downwards. Bits are numbered from 0 (least significant) @@ -1228,7 +1254,7 @@ last bit, set nth_bit to -1 or GLIB_SIZE


    g_bit_storage ()

    -
    guint               g_bit_storage                       (gulong number);
    +
    guint               g_bit_storage                       (gulong number);

    Gets the number of bits used to hold number, e.g. if number is 4, 3 bits are needed. @@ -1252,7 +1278,7 @@ e.g. if number is 4, 3 bits are needed.


    g_spaced_primes_closest ()

    -
    guint               g_spaced_primes_closest             (guint num);
    +
    guint               g_spaced_primes_closest             (guint num);

    Gets the smallest prime number from a built-in array of primes which is larger than num. This is used within GLib to calculate the optimum @@ -1282,7 +1308,7 @@ larger than num.


    g_atexit ()

    -
    void                g_atexit                            (GVoidFunc func);
    +
    void                g_atexit                            (GVoidFunc func);

    Specifies a function to be called at normal program termination.

    @@ -1319,12 +1345,13 @@ resided. This is presumably the most robust approach.

    As can be seen from the above, for portability it's best to avoid calling g_atexit() (or atexit()) except in the main executable of a -program.

    +program. +

    program :

    a program name in the GLib file name encoding +a program name in the GLib file name encoding
    -

    func :

    the function to call on normal program termination. +the function to call on normal program termination.
    @@ -1332,9 +1359,9 @@ program.


    g_parse_debug_string ()

    -
    guint               g_parse_debug_string                (const gchar *string,
    -                                                         const GDebugKey *keys,
    -                                                         guint nkeys);
    +
    guint               g_parse_debug_string                (const gchar *string,
    +                                                         const GDebugKey *keys,
    +                                                         guint nkeys);

    Parses a string containing debugging options into a guint containing bit flags. This is used @@ -1344,25 +1371,26 @@ command line or through environment variables.

    If string is equal to "all", all flags are set. If string is equal to "help", all the available keys in keys are printed -out to standard error.

    +out to standard error. +

    - - - @@ -1404,7 +1432,7 @@ Used in

    GVoidFunc ()

    -
    void                (*GVoidFunc)                        (void);
    +
    void                (*GVoidFunc)                        (void);

    Declares a type of function which takes no arguments and has no return value. It is used to specify the type function passed to g_atexit(). @@ -1413,7 +1441,7 @@ It is used to specify the type function passed to

    GFreeFunc ()

    -
    void                (*GFreeFunc)                        (gpointer data);
    +
    void                (*GFreeFunc)                        (gpointer data);

    Declares a type of function which takes an arbitrary data pointer argument and has no return value. It is not currently used in GLib or GTK+. @@ -1430,40 +1458,41 @@ and has no return value. It is not currently used in GLib or GTK+.


    g_qsort_with_data ()

    -
    void                g_qsort_with_data                   (gconstpointer pbase,
    -                                                         gint total_elems,
    -                                                         gsize size,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +
    void                g_qsort_with_data                   (gconstpointer pbase,
    +                                                         gint total_elems,
    +                                                         gsize size,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);

    This is just like the standard C qsort() function, but -the comparison routine accepts a user data argument.

    +the comparison routine accepts a user data argument. +

    string :

    a list of debug options separated by colons, spaces, or +a list of debug options separated by colons, spaces, or commas, or NULL.

    keys :

    pointer to an array of GDebugKey which associate +pointer to an array of GDebugKey which associate strings with bit flags.

    nkeys :

    the number of GDebugKeys in the array. +the number of GDebugKeys in the array.
    - - - - - @@ -1472,14 +1501,15 @@ the comparison routine accepts a user data argument.


    g_nullify_pointer ()

    -
    void                g_nullify_pointer                   (gpointer *nullify_location);
    +
    void                g_nullify_pointer                   (gpointer *nullify_location);

    -Set the pointer at the specified location to NULL.

    +Set the pointer at the specified location to NULL. +

    pbase :

    start of array to sort +start of array to sort

    total_elems :

    elements in the array +elements in the array

    size :

    size of each element +size of each element

    compare_func :

    function to compare elements +function to compare elements

    user_data :

    data to pass to compare_func +data to pass to compare_func
    -

    nullify_location :

    the memory address of the pointer. +the memory address of the pointer.
    @@ -1488,6 +1518,6 @@ Set the pointer at the specified location to
    - Generated by GTK-Doc V1.13
    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-N-ary-Trees.html b/docs/reference/glib/html/glib-N-ary-Trees.html index 91d96be..c67d75d 100644 --- a/docs/reference/glib/html/glib-N-ary-Trees.html +++ b/docs/reference/glib/html/glib-N-ary-Trees.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,85 +41,92 @@ #include <glib.h> GNode; -GNode* g_node_new (gpointer data); -GNode* g_node_copy (GNode *node); -gpointer (*GCopyFunc) (gconstpointer src, - gpointer data); -GNode* g_node_copy_deep (GNode *node, - GCopyFunc copy_func, - gpointer data); +GNode* g_node_new (gpointer data); +GNode* g_node_copy (GNode *node); +gpointer (*GCopyFunc) (gconstpointer src, + gpointer data); +GNode* g_node_copy_deep (GNode *node, + GCopyFunc copy_func, + gpointer data); -GNode* g_node_insert (GNode *parent, - gint position, - GNode *node); -GNode* g_node_insert_before (GNode *parent, - GNode *sibling, - GNode *node); -GNode* g_node_insert_after (GNode *parent, - GNode *sibling, - GNode *node); -#define g_node_append (parent, node) -GNode* g_node_prepend (GNode *parent, - GNode *node); +GNode* g_node_insert (GNode *parent, + gint position, + GNode *node); +GNode* g_node_insert_before (GNode *parent, + GNode *sibling, + GNode *node); +GNode* g_node_insert_after (GNode *parent, + GNode *sibling, + GNode *node); +#define g_node_append (parent, + node) +GNode* g_node_prepend (GNode *parent, + GNode *node); -#define g_node_insert_data (parent, position, data) -#define g_node_insert_data_before (parent, sibling, data) -#define g_node_append_data (parent, data) -#define g_node_prepend_data (parent, data) +#define g_node_insert_data (parent, + position, + data) +#define g_node_insert_data_before (parent, + sibling, + data) +#define g_node_append_data (parent, + data) +#define g_node_prepend_data (parent, + data) -voidg_node_reverse_children (GNode *node); -voidg_node_traverse (GNode *root, - GTraverseType order, - GTraverseFlags flags, - gint max_depth, - GNodeTraverseFunc func, - gpointer data); +voidg_node_reverse_children (GNode *node); +voidg_node_traverse (GNode *root, + GTraverseType order, + GTraverseFlags flags, + gint max_depth, + GNodeTraverseFunc func, + gpointer data); enum GTraverseFlags; -gboolean (*GNodeTraverseFunc) (GNode *node, - gpointer data); -voidg_node_children_foreach (GNode *node, - GTraverseFlags flags, - GNodeForeachFunc func, - gpointer data); -void (*GNodeForeachFunc) (GNode *node, - gpointer data); +gboolean (*GNodeTraverseFunc) (GNode *node, + gpointer data); +voidg_node_children_foreach (GNode *node, + GTraverseFlags flags, + GNodeForeachFunc func, + gpointer data); +void (*GNodeForeachFunc) (GNode *node, + gpointer data); -GNode* g_node_get_root (GNode *node); -GNode* g_node_find (GNode *root, - GTraverseType order, - GTraverseFlags flags, - gpointer data); -GNode* g_node_find_child (GNode *node, - GTraverseFlags flags, - gpointer data); -gintg_node_child_index (GNode *node, - gpointer data); -gintg_node_child_position (GNode *node, - GNode *child); +GNode* g_node_get_root (GNode *node); +GNode* g_node_find (GNode *root, + GTraverseType order, + GTraverseFlags flags, + gpointer data); +GNode* g_node_find_child (GNode *node, + GTraverseFlags flags, + gpointer data); +gintg_node_child_index (GNode *node, + gpointer data); +gintg_node_child_position (GNode *node, + GNode *child); #define g_node_first_child (node) -GNode* g_node_last_child (GNode *node); -GNode* g_node_nth_child (GNode *node, - guint n); -GNode* g_node_first_sibling (GNode *node); +GNode* g_node_last_child (GNode *node); +GNode* g_node_nth_child (GNode *node, + guint n); +GNode* g_node_first_sibling (GNode *node); #define g_node_next_sibling (node) #define g_node_prev_sibling (node) -GNode* g_node_last_sibling (GNode *node); +GNode* g_node_last_sibling (GNode *node); #define G_NODE_IS_LEAF (node) #define G_NODE_IS_ROOT (node) -guintg_node_depth (GNode *node); -guintg_node_n_nodes (GNode *root, - GTraverseFlags flags); -guintg_node_n_children (GNode *node); -gbooleang_node_is_ancestor (GNode *node, - GNode *descendant); -guintg_node_max_height (GNode *root); +guintg_node_depth (GNode *node); +guintg_node_n_nodes (GNode *root, + GTraverseFlags flags); +guintg_node_n_children (GNode *node); +gbooleang_node_is_ancestor (GNode *node, + GNode *descendant); +guintg_node_max_height (GNode *root); -voidg_node_unlink (GNode *node); -voidg_node_destroy (GNode *root); +voidg_node_unlink (GNode *node); +voidg_node_destroy (GNode *root); -voidg_node_push_allocator (gpointer dummy); -voidg_node_pop_allocator (void); +voidg_node_push_allocator (gpointer dummy); +voidg_node_pop_allocator (void);

    Details

    @@ -197,35 +185,36 @@ To remove a node or subtree from a tree use GNode struct represents one node in a -N-ary Tree. fields

    +N-ary Tree. fields +

    - - - - - @@ -236,16 +225,17 @@ The

    g_node_new ()

    -
    GNode*              g_node_new                          (gpointer data);
    +
    GNode*              g_node_new                          (gpointer data);

    Creates a new GNode containing the given data. -Used to create the first node in a tree.

    +Used to create the first node in a tree. +

    gpointer data;

    contains the actual data of the node. +contains the actual data of the node.

    GNode *next;

    points to the node's next sibling (a sibling is another +points to the node's next sibling (a sibling is another GNode with the same parent).

    GNode *prev;

    points to the node's previous sibling. +points to the node's previous sibling.

    GNode *parent;

    points to the parent of the GNode, or is NULL if the +points to the parent of the GNode, or is NULL if the GNode is the root of the tree.

    GNode *children;

    points to the first child of the GNode. The other +points to the first child of the GNode. The other children are accessed by using the next pointer of each child.
    - @@ -259,16 +249,17 @@ Used to create the first node in a tree.


    g_node_copy ()

    -
    GNode*              g_node_copy                         (GNode *node);
    +
    GNode*              g_node_copy                         (GNode *node);

    Recursively copies a GNode (but does not deep-copy the data inside the -nodes, see g_node_copy_deep() if you need that).

    +nodes, see g_node_copy_deep() if you need that). +

    data :

    the data of the new node +the data of the new node
    - @@ -282,22 +273,23 @@ nodes, see

    GCopyFunc ()

    -
    gpointer            (*GCopyFunc)                        (gconstpointer src,
    -                                                         gpointer data);
    +
    gpointer            (*GCopyFunc)                        (gconstpointer src,
    +                                                         gpointer data);

    A function of this signature is used to copy the node data -when doing a deep-copy of a tree.

    +when doing a deep-copy of a tree. +

    node :

    a GNode +a GNode
    - - @@ -313,28 +305,29 @@ when doing a deep-copy of a tree.


    g_node_copy_deep ()

    -
    GNode*              g_node_copy_deep                    (GNode *node,
    -                                                         GCopyFunc copy_func,
    -                                                         gpointer data);
    +
    GNode*              g_node_copy_deep                    (GNode *node,
    +                                                         GCopyFunc copy_func,
    +                                                         gpointer data);

    -Recursively copies a GNode and its data.

    +Recursively copies a GNode and its data. +

    src :

    A pointer to the data which should be copied +A pointer to the data which should be copied

    data :

    Additional data +Additional data
    - - - @@ -350,28 +343,29 @@ Recursively copies a

    g_node_insert ()

    -
    GNode*              g_node_insert                       (GNode *parent,
    -                                                         gint position,
    -                                                         GNode *node);
    +
    GNode*              g_node_insert                       (GNode *parent,
    +                                                         gint position,
    +                                                         GNode *node);

    -Inserts a GNode beneath the parent at the given position.

    +Inserts a GNode beneath the parent at the given position. +

    node :

    a GNode +a GNode

    copy_func :

    the function which is called to copy the data inside each node, +the function which is called to copy the data inside each node, or NULL to use the original data.

    data :

    data to pass to copy_func +data to pass to copy_func
    - - - @@ -385,28 +379,29 @@ Inserts a

    g_node_insert_before ()

    -
    GNode*              g_node_insert_before                (GNode *parent,
    -                                                         GNode *sibling,
    -                                                         GNode *node);
    +
    GNode*              g_node_insert_before                (GNode *parent,
    +                                                         GNode *sibling,
    +                                                         GNode *node);

    -Inserts a GNode beneath the parent before the given sibling.

    +Inserts a GNode beneath the parent before the given sibling. +

    parent :

    the GNode to place node under +the GNode to place node under

    position :

    the position to place node at, with respect to its siblings +the position to place node at, with respect to its siblings If position is -1, node is inserted as the last child of parent

    node :

    the GNode to insert +the GNode to insert
    - - - @@ -420,28 +415,29 @@ Inserts a

    g_node_insert_after ()

    -
    GNode*              g_node_insert_after                 (GNode *parent,
    -                                                         GNode *sibling,
    -                                                         GNode *node);
    +
    GNode*              g_node_insert_after                 (GNode *parent,
    +                                                         GNode *sibling,
    +                                                         GNode *node);

    -Inserts a GNode beneath the parent after the given sibling.

    +Inserts a GNode beneath the parent after the given sibling. +

    parent :

    the GNode to place node under +the GNode to place node under

    sibling :

    the sibling GNode to place node before. +the sibling GNode to place node before. If sibling is NULL, the node is inserted as the last child of parent.

    node :

    the GNode to insert +the GNode to insert
    - - - @@ -457,18 +453,19 @@ Inserts a

    g_node_append()

    #define             g_node_append(parent, node)

    -Inserts a GNode as the last child of the given parent.

    +Inserts a GNode as the last child of the given parent. +

    parent :

    the GNode to place node under +the GNode to place node under

    sibling :

    the sibling GNode to place node after. +the sibling GNode to place node after. If sibling is NULL, the node is inserted as the first child of parent.

    node :

    the GNode to insert +the GNode to insert
    - - @@ -482,21 +479,22 @@ Inserts a

    g_node_prepend ()

    -
    GNode*              g_node_prepend                      (GNode *parent,
    -                                                         GNode *node);
    +
    GNode*              g_node_prepend                      (GNode *parent,
    +                                                         GNode *node);

    -Inserts a GNode as the first child of the given parent.

    +Inserts a GNode as the first child of the given parent. +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    node :

    the GNode to insert +the GNode to insert
    - - @@ -512,24 +510,25 @@ Inserts a

    g_node_insert_data()

    #define             g_node_insert_data(parent, position, data)

    -Inserts a new GNode at the given position.

    +Inserts a new GNode at the given position. +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    node :

    the GNode to insert +the GNode to insert
    - - - @@ -545,23 +544,24 @@ Inserts a new <

    g_node_insert_data_before()

    #define             g_node_insert_data_before(parent, sibling, data)

    -Inserts a new GNode before the given sibling.

    +Inserts a new GNode before the given sibling. +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    position :

    the position to place the new GNode at. If position is -1, +the position to place the new GNode at. If position is -1, the new GNode is inserted as the last child of parent

    data :

    the data for the new GNode +the data for the new GNode
    - - - @@ -577,18 +577,19 @@ Inserts a new <

    g_node_append_data()

    #define             g_node_append_data(parent, data)

    -Inserts a new GNode as the last child of the given parent.

    +Inserts a new GNode as the last child of the given parent. +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    sibling :

    the sibling GNode to place the new GNode before +the sibling GNode to place the new GNode before

    data :

    the data for the new GNode +the data for the new GNode
    - - @@ -604,18 +605,19 @@ Inserts a new <

    g_node_prepend_data()

    #define             g_node_prepend_data(parent, data)

    -Inserts a new GNode as the first child of the given parent.

    +Inserts a new GNode as the first child of the given parent. +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    data :

    the data for the new GNode +the data for the new GNode
    - - @@ -629,15 +631,16 @@ Inserts a new <

    g_node_reverse_children ()

    -
    void                g_node_reverse_children             (GNode *node);
    +
    void                g_node_reverse_children             (GNode *node);

    Reverses the order of the children of a GNode. -(It doesn't change the order of the grandchildren.)

    +(It doesn't change the order of the grandchildren.) +

    parent :

    the GNode to place the new GNode under +the GNode to place the new GNode under

    data :

    the data for the new GNode +the data for the new GNode
    -

    node :

    a GNode. +a GNode.
    @@ -645,39 +648,40 @@ Reverses the order of the children of a

    g_node_traverse ()

    -
    void                g_node_traverse                     (GNode *root,
    -                                                         GTraverseType order,
    -                                                         GTraverseFlags flags,
    -                                                         gint max_depth,
    -                                                         GNodeTraverseFunc func,
    -                                                         gpointer data);
    +
    void                g_node_traverse                     (GNode *root,
    +                                                         GTraverseType order,
    +                                                         GTraverseFlags flags,
    +                                                         gint max_depth,
    +                                                         GNodeTraverseFunc func,
    +                                                         gpointer data);

    Traverses a tree starting at the given root GNode. It calls the given function for each node visited. -The traversal can be halted at any point by returning TRUE from func.

    +The traversal can be halted at any point by returning TRUE from func. +

    - - - - - - @@ -711,42 +715,43 @@ The traversal can be halted at any point by returning g_node_traverse() and g_node_find().

    +functions, including g_node_traverse() and g_node_find(). +

    root :

    the root GNode of the tree to traverse +the root GNode of the tree to traverse

    order :

    the order in which nodes are visited - G_IN_ORDER, +the order in which nodes are visited - G_IN_ORDER, G_PRE_ORDER, G_POST_ORDER, or G_LEVEL_ORDER.

    flags :

    which types of children are to be visited, one of +which types of children are to be visited, one of G_TRAVERSE_ALL, G_TRAVERSE_LEAVES and G_TRAVERSE_NON_LEAVES

    max_depth :

    the maximum depth of the traversal. Nodes below this +the maximum depth of the traversal. Nodes below this depth will not be visited. If max_depth is -1 all nodes in the tree are visited. If depth is 1, only the root is visited. If depth is 2, the root and its children are visited. And so on. @@ -685,12 +689,12 @@ The traversal can be halted at any point by returning func :

    the function to call for each visited GNode +the function to call for each visited GNode

    data :

    user data to pass to the function +user data to pass to the function
    - - - - - - @@ -755,29 +760,31 @@ functions, including

    GNodeTraverseFunc ()

    -
    gboolean            (*GNodeTraverseFunc)                (GNode *node,
    -                                                         gpointer data);
    +
    gboolean            (*GNodeTraverseFunc)                (GNode *node,
    +                                                         gpointer data);

    Specifies the type of function passed to g_node_traverse(). The function is called with each of the nodes visited, together with the user data passed to g_node_traverse(). If the function returns -TRUE, then the traversal is stopped.

    +TRUE, then the traversal is stopped. +

    G_TRAVERSE_LEAVES

    only leaf nodes should be visited. This name has +only leaf nodes should be visited. This name has been introduced in 2.6, for older version use G_TRAVERSE_LEAFS.

    G_TRAVERSE_NON_LEAVES

    only non-leaf nodes should be visited. This +only non-leaf nodes should be visited. This name has been introduced in 2.6, for older version use G_TRAVERSE_NON_LEAFS.

    G_TRAVERSE_ALL

    all nodes should be visited. +all nodes should be visited.

    G_TRAVERSE_MASK

    a mask of all traverse flags. +a mask of all traverse flags.

    G_TRAVERSE_LEAFS

    identical to G_TRAVERSE_LEAVES. +identical to G_TRAVERSE_LEAVES.

    G_TRAVERSE_NON_LEAFS

    identical to G_TRAVERSE_NON_LEAVES. +identical to G_TRAVERSE_NON_LEAVES.
    - - - @@ -786,35 +793,36 @@ user data passed to

    g_node_children_foreach ()

    -
    void                g_node_children_foreach             (GNode *node,
    -                                                         GTraverseFlags flags,
    -                                                         GNodeForeachFunc func,
    -                                                         gpointer data);
    +
    void                g_node_children_foreach             (GNode *node,
    +                                                         GTraverseFlags flags,
    +                                                         GNodeForeachFunc func,
    +                                                         gpointer data);

    Calls a function for each of the children of a GNode. -Note that it doesn't descend beneath the child nodes.

    +Note that it doesn't descend beneath the child nodes. +

    node :

    a GNode. +a GNode.

    data :

    user data passed to g_node_traverse(). +user data passed to g_node_traverse().

    Returns :

    TRUE to stop the traversal. + +TRUE to stop the traversal.
    - - - - @@ -823,23 +831,24 @@ Note that it doesn't descend beneath the child nodes.


    GNodeForeachFunc ()

    -
    void                (*GNodeForeachFunc)                 (GNode *node,
    -                                                         gpointer data);
    +
    void                (*GNodeForeachFunc)                 (GNode *node,
    +                                                         gpointer data);

    Specifies the type of function passed to g_node_children_foreach(). The function is called with each child node, together with the user -data passed to g_node_children_foreach().

    +data passed to g_node_children_foreach(). +

    node :

    a GNode +a GNode

    flags :

    which types of children are to be visited, one of +which types of children are to be visited, one of G_TRAVERSE_ALL, G_TRAVERSE_LEAVES and G_TRAVERSE_NON_LEAVES

    func :

    the function to call for each visited node +the function to call for each visited node

    data :

    user data to pass to the function +user data to pass to the function
    - - @@ -848,15 +857,16 @@ data passed to

    g_node_get_root ()

    -
    GNode*              g_node_get_root                     (GNode *node);
    +
    GNode*              g_node_get_root                     (GNode *node);

    -Gets the root of a tree.

    +Gets the root of a tree. +

    node :

    a GNode. +a GNode.

    data :

    user data passed to g_node_children_foreach(). +user data passed to g_node_children_foreach().
    - @@ -870,35 +880,36 @@ Gets the root of a tree.


    g_node_find ()

    -
    GNode*              g_node_find                         (GNode *root,
    -                                                         GTraverseType order,
    -                                                         GTraverseFlags flags,
    -                                                         gpointer data);
    +
    GNode*              g_node_find                         (GNode *root,
    +                                                         GTraverseType order,
    +                                                         GTraverseFlags flags,
    +                                                         gpointer data);

    -Finds a GNode in a tree.

    +Finds a GNode in a tree. +

    node :

    a GNode +a GNode
    - - - - @@ -912,28 +923,29 @@ Finds a

    g_node_find_child ()

    -
    GNode*              g_node_find_child                   (GNode *node,
    -                                                         GTraverseFlags flags,
    -                                                         gpointer data);
    +
    GNode*              g_node_find_child                   (GNode *node,
    +                                                         GTraverseFlags flags,
    +                                                         gpointer data);

    -Finds the first child of a GNode with the given data.

    +Finds the first child of a GNode with the given data. +

    root :

    the root GNode of the tree to search +the root GNode of the tree to search

    order :

    the order in which nodes are visited - G_IN_ORDER, +the order in which nodes are visited - G_IN_ORDER, G_PRE_ORDER, G_POST_ORDER, or G_LEVEL_ORDER

    flags :

    which types of children are to be searched, one of +which types of children are to be searched, one of G_TRAVERSE_ALL, G_TRAVERSE_LEAVES and G_TRAVERSE_NON_LEAVES

    data :

    the data to find +the data to find
    - - - @@ -947,22 +959,23 @@ Finds the first child of a

    g_node_child_index ()

    -
    gint                g_node_child_index                  (GNode *node,
    -                                                         gpointer data);
    +
    gint                g_node_child_index                  (GNode *node,
    +                                                         gpointer data);

    Gets the position of the first child of a GNode -which contains the given data.

    +which contains the given data. +

    node :

    a GNode +a GNode

    flags :

    which types of children are to be searched, one of +which types of children are to be searched, one of G_TRAVERSE_ALL, G_TRAVERSE_LEAVES and G_TRAVERSE_NON_LEAVES

    data :

    the data to find +the data to find
    - - @@ -977,23 +990,24 @@ which contains the given data.


    g_node_child_position ()

    -
    gint                g_node_child_position               (GNode *node,
    -                                                         GNode *child);
    +
    gint                g_node_child_position               (GNode *node,
    +                                                         GNode *child);

    Gets the position of a GNode with respect to its siblings. child must be a child of node. The first child is numbered 0, -the second 1, and so on.

    +the second 1, and so on. +

    node :

    a GNode +a GNode

    data :

    the data to find +the data to find
    - - @@ -1009,13 +1023,14 @@ the second 1, and so on.

    g_node_first_child()

    #define             g_node_first_child(node)

    -Gets the first child of a GNode.

    +Gets the first child of a GNode. +

    node :

    a GNode +a GNode

    child :

    a child of node +a child of node
    - @@ -1030,15 +1045,16 @@ Gets the first child of a

    g_node_last_child ()

    -
    GNode*              g_node_last_child                   (GNode *node);
    +
    GNode*              g_node_last_child                   (GNode *node);

    -Gets the last child of a GNode.

    +Gets the last child of a GNode. +

    node :

    a GNode +a GNode
    - @@ -1052,23 +1068,24 @@ Gets the last child of a

    g_node_nth_child ()

    -
    GNode*              g_node_nth_child                    (GNode *node,
    -                                                         guint n);
    +
    GNode*              g_node_nth_child                    (GNode *node,
    +                                                         guint n);

    Gets a child of a GNode, using the given index. The first child is at index 0. If the index is -too big, NULL is returned.

    +too big, NULL is returned. +

    node :

    a GNode (must not be NULL) +a GNode (must not be NULL)
    - - @@ -1082,16 +1099,17 @@ too big,

    g_node_first_sibling ()

    -
    GNode*              g_node_first_sibling                (GNode *node);
    +
    GNode*              g_node_first_sibling                (GNode *node);

    Gets the first sibling of a GNode. -This could possibly be the node itself.

    +This could possibly be the node itself. +

    node :

    a GNode +a GNode

    n :

    the index of the desired child +the index of the desired child
    - @@ -1107,13 +1125,14 @@ This could possibly be the node itself.

    g_node_next_sibling()

    #define             g_node_next_sibling(node)

    -Gets the next sibling of a GNode.

    +Gets the next sibling of a GNode. +

    node :

    a GNode +a GNode
    - @@ -1129,13 +1148,14 @@ Gets the next sibling of a

    g_node_prev_sibling()

    #define             g_node_prev_sibling(node)

    -Gets the previous sibling of a GNode.

    +Gets the previous sibling of a GNode. +

    node :

    a GNode +a GNode
    - @@ -1149,16 +1169,17 @@ Gets the previous sibling of a

    g_node_last_sibling ()

    -
    GNode*              g_node_last_sibling                 (GNode *node);
    +
    GNode*              g_node_last_sibling                 (GNode *node);

    Gets the last sibling of a GNode. -This could possibly be the node itself.

    +This could possibly be the node itself. +

    node :

    a GNode +a GNode
    - @@ -1175,13 +1196,14 @@ This could possibly be the node itself.

    #define	 G_NODE_IS_LEAF(node) (((GNode*) (node))->children == NULL)
     

    -Returns TRUE if a GNode is a leaf node.

    +Returns TRUE if a GNode is a leaf node. +

    node :

    a GNode +a GNode
    - @@ -1198,13 +1220,14 @@ Returns

    G_NODE_IS_ROOT()

    #define             G_NODE_IS_ROOT(node)

    -Returns TRUE if a GNode is the root of a tree.

    +Returns TRUE if a GNode is the root of a tree. +

    node :

    a GNode +a GNode
    - @@ -1219,19 +1242,20 @@ Returns

    g_node_depth ()

    -
    guint               g_node_depth                        (GNode *node);
    +
    guint               g_node_depth                        (GNode *node);

    Gets the depth of a GNode.

    If node is NULL the depth is 0. The root node has a depth of 1. -For the children of the root node the depth is 2. And so on.

    +For the children of the root node the depth is 2. And so on. +

    node :

    a GNode +a GNode
    - @@ -1245,21 +1269,22 @@ For the children of the root node the depth is 2. And so on.


    g_node_n_nodes ()

    -
    guint               g_node_n_nodes                      (GNode *root,
    -                                                         GTraverseFlags flags);
    +
    guint               g_node_n_nodes                      (GNode *root,
    +                                                         GTraverseFlags flags);

    -Gets the number of nodes in a tree.

    +Gets the number of nodes in a tree. +

    node :

    a GNode +a GNode
    - - @@ -1274,15 +1299,16 @@ Gets the number of nodes in a tree.


    g_node_n_children ()

    -
    guint               g_node_n_children                   (GNode *node);
    +
    guint               g_node_n_children                   (GNode *node);

    -Gets the number of children of a GNode.

    +Gets the number of children of a GNode. +

    root :

    a GNode +a GNode

    flags :

    which types of children are to be counted, one of +which types of children are to be counted, one of G_TRAVERSE_ALL, G_TRAVERSE_LEAVES and G_TRAVERSE_NON_LEAVES
    - @@ -1296,23 +1322,24 @@ Gets the number of children of a

    g_node_is_ancestor ()

    -
    gboolean            g_node_is_ancestor                  (GNode *node,
    -                                                         GNode *descendant);
    +
    gboolean            g_node_is_ancestor                  (GNode *node,
    +                                                         GNode *descendant);

    Returns TRUE if node is an ancestor of descendant. This is true if node is the parent of descendant, -or if node is the grandparent of descendant etc.

    +or if node is the grandparent of descendant etc. +

    node :

    a GNode +a GNode
    - - @@ -1326,20 +1353,21 @@ or if node is the grandparent of descendant

    g_node_max_height ()

    -
    guint               g_node_max_height                   (GNode *root);
    +
    guint               g_node_max_height                   (GNode *root);

    Gets the maximum height of all branches beneath a GNode. This is the maximum distance from the GNode to all leaf nodes.

    If root is NULL, 0 is returned. If root has no children, -1 is returned. If root has children, 2 is returned. And so on.

    +1 is returned. If root has children, 2 is returned. And so on. +

    node :

    a GNode +a GNode

    descendant :

    a GNode +a GNode
    - @@ -1353,14 +1381,15 @@ If root is

    g_node_unlink ()

    -
    void                g_node_unlink                       (GNode *node);
    +
    void                g_node_unlink                       (GNode *node);

    -Unlinks a GNode from a tree, resulting in two separate trees.

    +Unlinks a GNode from a tree, resulting in two separate trees. +

    root :

    a GNode +a GNode
    -

    node :

    the GNode to unlink, which becomes the root of a new tree +the GNode to unlink, which becomes the root of a new tree
    @@ -1368,15 +1397,16 @@ Unlinks a

    g_node_destroy ()

    -
    void                g_node_destroy                      (GNode *root);
    +
    void                g_node_destroy                      (GNode *root);

    Removes root and its children from the tree, freeing any memory -allocated.

    +allocated. +

    -

    root :

    the root of the tree/subtree to destroy +the root of the tree/subtree to destroy
    @@ -1384,7 +1414,7 @@ allocated.


    g_node_push_allocator ()

    -
    void                g_node_push_allocator               (gpointer dummy);
    +
    void                g_node_push_allocator               (gpointer dummy);

    Warning

    g_node_push_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GNode has been converted to @@ -1397,12 +1427,13 @@ Sets the allocator to use to allocate --disable-mem-pools

    +with --disable-mem-pools +

    -

    dummy :

    the GAllocator to use when allocating GNode elements. +the GAllocator to use when allocating GNode elements.
    @@ -1410,7 +1441,7 @@ with --disable-mem-pools


    g_node_pop_allocator ()

    -
    void                g_node_pop_allocator                (void);
    +
    void                g_node_pop_allocator                (void);

    Warning

    g_node_pop_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GNode has been converted to @@ -1423,12 +1454,13 @@ elements.

    Note that this function is not available if GLib has been compiled -with --disable-mem-pools

    +with --disable-mem-pools +

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Numerical-Definitions.html b/docs/reference/glib/html/glib-Numerical-Definitions.html index e9d5ba6..42e28fe 100644 --- a/docs/reference/glib/html/glib-Numerical-Definitions.html +++ b/docs/reference/glib/html/glib-Numerical-Definitions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -113,16 +93,7 @@ See

    union GFloatIEEE754

    -
    union GFloatIEEE754
    -{
    -  gfloat v_float;
    -  struct {
    -    guint mantissa : 23;
    -    guint biased_exponent : 8;
    -    guint sign : 1;
    -  } mpn;
    -};
    -
    +

    The GFloatIEEE754 and GDoubleIEEE754 unions are used to access the sign, mantissa and exponent of IEEE floats and doubles. These @@ -135,17 +106,7 @@ The

    union GDoubleIEEE754

    -
    union GDoubleIEEE754
    -{
    -  gdouble v_double;
    -  struct {
    -    guint mantissa_low : 32;
    -    guint mantissa_high : 20;
    -    guint biased_exponent : 11;
    -    guint sign : 1;
    -  } mpn;
    -};
    -
    +

    The GFloatIEEE754 and GDoubleIEEE754 unions are used to access the sign, mantissa and exponent of IEEE floats and doubles. These @@ -238,6 +199,6 @@ Used for fooling around with float formats, see

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html b/docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html index 07af546..f817c75 100644 --- a/docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html +++ b/docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -65,112 +45,112 @@ enum GRegexCompileFlags; enum GRegexMatchFlags; GRegex; -gboolean (*GRegexEvalCallback) (const GMatchInfo *match_info, - GString *result, - gpointer user_data); -GRegex * g_regex_new (const gchar *pattern, - GRegexCompileFlags compile_options, - GRegexMatchFlags match_options, - GError **error); -GRegex * g_regex_ref (GRegex *regex); -voidg_regex_unref (GRegex *regex); -const gchar * g_regex_get_pattern (const GRegex *regex); -gintg_regex_get_max_backref (const GRegex *regex); -gintg_regex_get_capture_count (const GRegex *regex); -gintg_regex_get_string_number (const GRegex *regex, - const gchar *name); -gchar * g_regex_escape_string (const gchar *string, - gint length); -gbooleang_regex_match_simple (const gchar *pattern, - const gchar *string, - GRegexCompileFlags compile_options, - GRegexMatchFlags match_options); -gbooleang_regex_match (const GRegex *regex, - const gchar *string, - GRegexMatchFlags match_options, - GMatchInfo **match_info); -gbooleang_regex_match_full (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - GRegexMatchFlags match_options, - GMatchInfo **match_info, - GError **error); -gbooleang_regex_match_all (const GRegex *regex, - const gchar *string, - GRegexMatchFlags match_options, - GMatchInfo **match_info); -gbooleang_regex_match_all_full (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - GRegexMatchFlags match_options, - GMatchInfo **match_info, - GError **error); -gchar ** g_regex_split_simple (const gchar *pattern, - const gchar *string, - GRegexCompileFlags compile_options, - GRegexMatchFlags match_options); -gchar ** g_regex_split (const GRegex *regex, - const gchar *string, - GRegexMatchFlags match_options); -gchar ** g_regex_split_full (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - GRegexMatchFlags match_options, - gint max_tokens, - GError **error); -gchar * g_regex_replace (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - const gchar *replacement, - GRegexMatchFlags match_options, - GError **error); -gchar * g_regex_replace_literal (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - const gchar *replacement, - GRegexMatchFlags match_options, - GError **error); -gchar * g_regex_replace_eval (const GRegex *regex, - const gchar *string, - gssize string_len, - gint start_position, - GRegexMatchFlags match_options, - GRegexEvalCallback eval, - gpointer user_data, - GError **error); -gbooleang_regex_check_replacement (const gchar *replacement, - gboolean *has_references, - GError **error); +gboolean (*GRegexEvalCallback) (const GMatchInfo *match_info, + GString *result, + gpointer user_data); +GRegex * g_regex_new (const gchar *pattern, + GRegexCompileFlags compile_options, + GRegexMatchFlags match_options, + GError **error); +GRegex * g_regex_ref (GRegex *regex); +voidg_regex_unref (GRegex *regex); +const gchar * g_regex_get_pattern (const GRegex *regex); +gintg_regex_get_max_backref (const GRegex *regex); +gintg_regex_get_capture_count (const GRegex *regex); +gintg_regex_get_string_number (const GRegex *regex, + const gchar *name); +gchar * g_regex_escape_string (const gchar *string, + gint length); +gbooleang_regex_match_simple (const gchar *pattern, + const gchar *string, + GRegexCompileFlags compile_options, + GRegexMatchFlags match_options); +gbooleang_regex_match (const GRegex *regex, + const gchar *string, + GRegexMatchFlags match_options, + GMatchInfo **match_info); +gbooleang_regex_match_full (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + GRegexMatchFlags match_options, + GMatchInfo **match_info, + GError **error); +gbooleang_regex_match_all (const GRegex *regex, + const gchar *string, + GRegexMatchFlags match_options, + GMatchInfo **match_info); +gbooleang_regex_match_all_full (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + GRegexMatchFlags match_options, + GMatchInfo **match_info, + GError **error); +gchar ** g_regex_split_simple (const gchar *pattern, + const gchar *string, + GRegexCompileFlags compile_options, + GRegexMatchFlags match_options); +gchar ** g_regex_split (const GRegex *regex, + const gchar *string, + GRegexMatchFlags match_options); +gchar ** g_regex_split_full (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + GRegexMatchFlags match_options, + gint max_tokens, + GError **error); +gchar * g_regex_replace (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + const gchar *replacement, + GRegexMatchFlags match_options, + GError **error); +gchar * g_regex_replace_literal (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + const gchar *replacement, + GRegexMatchFlags match_options, + GError **error); +gchar * g_regex_replace_eval (const GRegex *regex, + const gchar *string, + gssize string_len, + gint start_position, + GRegexMatchFlags match_options, + GRegexEvalCallback eval, + gpointer user_data, + GError **error); +gbooleang_regex_check_replacement (const gchar *replacement, + gboolean *has_references, + GError **error); GMatchInfo; -GRegex * g_match_info_get_regex (const GMatchInfo *match_info); -const gchar * g_match_info_get_string (const GMatchInfo *match_info); -voidg_match_info_free (GMatchInfo *match_info); -gbooleang_match_info_matches (const GMatchInfo *match_info); -gbooleang_match_info_next (GMatchInfo *match_info, - GError **error); -gintg_match_info_get_match_count (const GMatchInfo *match_info); -gbooleang_match_info_is_partial_match (const GMatchInfo *match_info); -gchar * g_match_info_expand_references (const GMatchInfo *match_info, - const gchar *string_to_expand, - GError **error); -gchar * g_match_info_fetch (const GMatchInfo *match_info, - gint match_num); -gbooleang_match_info_fetch_pos (const GMatchInfo *match_info, - gint match_num, - gint *start_pos, - gint *end_pos); -gchar * g_match_info_fetch_named (const GMatchInfo *match_info, - const gchar *name); -gbooleang_match_info_fetch_named_pos (const GMatchInfo *match_info, - const gchar *name, - gint *start_pos, - gint *end_pos); -gchar ** g_match_info_fetch_all (const GMatchInfo *match_info); +GRegex * g_match_info_get_regex (const GMatchInfo *match_info); +const gchar * g_match_info_get_string (const GMatchInfo *match_info); +voidg_match_info_free (GMatchInfo *match_info); +gbooleang_match_info_matches (const GMatchInfo *match_info); +gbooleang_match_info_next (GMatchInfo *match_info, + GError **error); +gintg_match_info_get_match_count (const GMatchInfo *match_info); +gbooleang_match_info_is_partial_match (const GMatchInfo *match_info); +gchar * g_match_info_expand_references (const GMatchInfo *match_info, + const gchar *string_to_expand, + GError **error); +gchar * g_match_info_fetch (const GMatchInfo *match_info, + gint match_num); +gbooleang_match_info_fetch_pos (const GMatchInfo *match_info, + gint match_num, + gint *start_pos, + gint *end_pos); +gchar * g_match_info_fetch_named (const GMatchInfo *match_info, + const gchar *name); +gbooleang_match_info_fetch_named_pos (const GMatchInfo *match_info, + const gchar *name, + gint *start_pos, + gint *end_pos); +gchar ** g_match_info_fetch_all (const GMatchInfo *match_info);
    @@ -767,9 +747,9 @@ structure is opaque and its fields cannot be accessed directly.

    GRegexEvalCallback ()

    -
    gboolean            (*GRegexEvalCallback)               (const GMatchInfo *match_info,
    -                                                         GString *result,
    -                                                         gpointer user_data);
    +
    gboolean            (*GRegexEvalCallback)               (const GMatchInfo *match_info,
    +                                                         GString *result,
    +                                                         gpointer user_data);

    Specifies the type of the function passed to g_regex_replace_eval(). It is called for each occurance of the pattern in the string passed @@ -809,34 +789,35 @@ need the

    g_regex_new ()

    -
    GRegex *            g_regex_new                         (const gchar *pattern,
    -                                                         GRegexCompileFlags compile_options,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GError **error);
    +
    GRegex *            g_regex_new                         (const gchar *pattern,
    +                                                         GRegexCompileFlags compile_options,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GError **error);

    Compiles the regular expression to an internal form, and does -the initial setup of the GRegex structure.

    +the initial setup of the GRegex structure. +

    - - - - @@ -853,15 +834,16 @@ the initial setup of the

    g_regex_ref ()

    -
    GRegex *            g_regex_ref                         (GRegex *regex);
    +
    GRegex *            g_regex_ref                         (GRegex *regex);

    -Increases reference count of regex by 1.

    +Increases reference count of regex by 1. +

    pattern :

    the regular expression +the regular expression

    compile_options :

    compile options for the regular expression, or 0 +compile options for the regular expression, or 0

    match_options :

    match options for the regular expression, or 0 +match options for the regular expression, or 0

    error :

    return location for a GError +return location for a GError
    - @@ -877,15 +859,16 @@ Increases reference count of regex by 1.

    g_regex_unref ()

    -
    void                g_regex_unref                       (GRegex *regex);
    +
    void                g_regex_unref                       (GRegex *regex);

    Decreases reference count of regex by 1. When reference count drops -to zero, it frees all the memory associated with the regex structure.

    +to zero, it frees all the memory associated with the regex structure. +

    regex :

    a GRegex +a GRegex
    -

    regex :

    a GRegex +a GRegex
    @@ -894,16 +877,17 @@ to zero, it frees all the memory associated with the regex structure.


    g_regex_get_pattern ()

    -
    const gchar *       g_regex_get_pattern                 (const GRegex *regex);
    +
    const gchar *       g_regex_get_pattern                 (const GRegex *regex);

    Gets the pattern string associated with regex, i.e. a copy of -the string passed to g_regex_new().

    +the string passed to g_regex_new(). +

    - @@ -919,17 +903,18 @@ the string passed to

    g_regex_get_max_backref ()

    -
    gint                g_regex_get_max_backref             (const GRegex *regex);
    +
    gint                g_regex_get_max_backref             (const GRegex *regex);

    Returns the number of the highest back reference in the pattern, or 0 if the pattern does not contain -back references.

    +back references. +

    regex :

    a GRegex structure +a GRegex structure
    - @@ -945,15 +930,16 @@ back references.


    g_regex_get_capture_count ()

    -
    gint                g_regex_get_capture_count           (const GRegex *regex);
    +
    gint                g_regex_get_capture_count           (const GRegex *regex);

    -Returns the number of capturing subpatterns in the pattern.

    +Returns the number of capturing subpatterns in the pattern. +

    regex :

    a GRegex +a GRegex
    - @@ -969,21 +955,23 @@ Returns the number of capturing subpatterns in the pattern.


    g_regex_get_string_number ()

    -
    gint                g_regex_get_string_number           (const GRegex *regex,
    -                                                         const gchar *name);
    +
    gint                g_regex_get_string_number           (const GRegex *regex,
    +                                                         const gchar *name);

    -Retrieves the number of the subexpression named name.

    +Retrieves the number of the subexpression named name. +

    regex :

    a GRegex +a GRegex
    - - @@ -1000,8 +988,8 @@ Retrieves the number of the subexpression named name

    g_regex_escape_string ()

    -
    gchar *             g_regex_escape_string               (const gchar *string,
    -                                                         gint length);
    +
    gchar *             g_regex_escape_string               (const gchar *string,
    +                                                         gint length);

    Escapes the special characters used for regular expressions in string, for instance "a.b*c" becomes "a\.b\*c". This @@ -1010,18 +998,19 @@ function is useful to dynamically generate regular expressions.

    string can contain nul characters that are replaced with "\0", in this case remember to specify the correct length of string -in length.

    +in length. +

    regex :

    GRegex structure + +GRegex structure

    name :

    name of the subexpression +name of the subexpression
    - - @@ -1037,10 +1026,10 @@ in length.


    g_regex_match_simple ()

    -
    gboolean            g_regex_match_simple                (const gchar *pattern,
    -                                                         const gchar *string,
    -                                                         GRegexCompileFlags compile_options,
    -                                                         GRegexMatchFlags match_options);
    +
    gboolean            g_regex_match_simple                (const gchar *pattern,
    +                                                         const gchar *string,
    +                                                         GRegexCompileFlags compile_options,
    +                                                         GRegexMatchFlags match_options);

    Scans for a match in string for pattern.

    @@ -1053,28 +1042,29 @@ substrings, capture counts, and so on.

    If this function is to be called on the same pattern more than once, it's more efficient to compile the pattern once with -g_regex_new() and then use g_regex_match().

    +g_regex_new() and then use g_regex_match(). +

    string :

    the string to escape +the string to escape

    length :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated
    - - - - @@ -1090,10 +1080,10 @@ once, it's more efficient to compile the pattern once with
    +
    +

    pattern :

    the regular expression +the regular expression

    string :

    the string to scan for matches +the string to scan for matches

    compile_options :

    compile options for the regular expression, or 0 +compile options for the regular expression, or 0

    match_options :

    match options, or 0 +match options, or 0
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    static void
    +print_uppercase_words (const gchar *string)
    +{
    +  /* Print all uppercase-only words. */
    +  GRegex *regex;
    +  GMatchInfo *match_info;
    +   
    +  regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
    +  g_regex_match (regex, string, 0, &match_info);
    +  while (g_match_info_matches (match_info))
    +    {
    +      gchar *word = g_match_info_fetch (match_info, 0);
    +      g_print ("Found: %s\n", word);
    +      g_free (word);
    +      g_match_info_next (match_info, NULL);
    +    }
    +  g_match_info_free (match_info);
    +  g_regex_unref (regex);
    +}
    +
    +

    string is not copied and is used in GMatchInfo internally. If you use any GMatchInfo method (except g_match_info_free()) after -freeing or modifying string then the behaviour is undefined.

    +freeing or modifying string then the behaviour is undefined. +

    - - - - @@ -1176,13 +1193,13 @@ freeing or modifying string then the beh
    +
    +

    regex :

    a GRegex structure from g_regex_new() +a GRegex structure from g_regex_new()

    string :

    the string to scan for matches +the string to scan for matches

    match_options :

    match options +match options

    match_info :

    pointer to location where to store the GMatchInfo, +pointer to location where to store the GMatchInfo, or NULL if you do not need it
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    static void
    +print_uppercase_words (const gchar *string)
    +{
    +  /* Print all uppercase-only words. */
    +  GRegex *regex;
    +  GMatchInfo *match_info;
    +  GError *error = NULL;
    +   
    +  regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
    +  g_regex_match_full (regex, string, -1, 0, 0, &match_info, &error);
    +  while (g_match_info_matches (match_info))
    +    {
    +      gchar *word = g_match_info_fetch (match_info, 0);
    +      g_print ("Found: %s\n", word);
    +      g_free (word);
    +      g_match_info_next (match_info, &error);
    +    }
    +  g_match_info_free (match_info);
    +  g_regex_unref (regex);
    +  if (error != NULL)
    +    {
    +      g_printerr ("Error while matching: %s\n", error->message);
    +      g_error_free (error);
    +    }
    +}
    +
    + +

    +

    - - - - - - - @@ -1291,10 +1342,10 @@ print_uppercase_words (const gchar *string)

    g_regex_match_all ()

    -
    gboolean            g_regex_match_all                   (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GMatchInfo **match_info);
    +
    gboolean            g_regex_match_all                   (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GMatchInfo **match_info);

    Using the standard algorithm for regular expression matching only the longest match in the string is retrieved. This function uses @@ -1311,28 +1362,29 @@ matched.

    string is not copied and is used in GMatchInfo internally. If you use any GMatchInfo method (except g_match_info_free()) after -freeing or modifying string then the behaviour is undefined.

    +freeing or modifying string then the behaviour is undefined. +

    regex :

    a GRegex structure from g_regex_new() +a GRegex structure from g_regex_new()

    string :

    the string to scan for matches +the string to scan for matches

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    match_options :

    match options +match options

    match_info :

    pointer to location where to store the GMatchInfo, +pointer to location where to store the GMatchInfo, or NULL if you do not need it

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - - - - @@ -1349,13 +1401,13 @@ freeing or modifying string then the beh

    g_regex_match_all_full ()

    -
    gboolean            g_regex_match_all_full              (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         gssize string_len,
    -                                                         gint start_position,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GMatchInfo **match_info,
    -                                                         GError **error);
    +
    gboolean            g_regex_match_all_full              (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         gssize string_len,
    +                                                         gint start_position,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GMatchInfo **match_info,
    +                                                         GError **error);

    Using the standard algorithm for regular expression matching only the longest match in the string is retrieved, it is not possibile @@ -1398,44 +1450,45 @@ matched.

    string is not copied and is used in GMatchInfo internally. If you use any GMatchInfo method (except g_match_info_free()) after -freeing or modifying string then the behaviour is undefined.

    +freeing or modifying string then the behaviour is undefined. +

    regex :

    a GRegex structure from g_regex_new() +a GRegex structure from g_regex_new()

    string :

    the string to scan for matches +the string to scan for matches

    match_options :

    match options +match options

    match_info :

    pointer to location where to store the GMatchInfo, +pointer to location where to store the GMatchInfo, or NULL if you do not need it
    - - - - - - - @@ -1451,10 +1504,10 @@ freeing or modifying string then the beh

    g_regex_split_simple ()

    -
    gchar **            g_regex_split_simple                (const gchar *pattern,
    -                                                         const gchar *string,
    -                                                         GRegexCompileFlags compile_options,
    -                                                         GRegexMatchFlags match_options);
    +
    gchar **            g_regex_split_simple                (const gchar *pattern,
    +                                                         const gchar *string,
    +                                                         GRegexCompileFlags compile_options,
    +                                                         GRegexMatchFlags match_options);

    Breaks the string on the pattern, and returns an array of the tokens. If the pattern contains capturing parentheses, @@ -1486,28 +1539,29 @@ function. A pattern that can match empty strings splits string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator -"\s*", you will get "a", "b" and "c".

    +"\s*", you will get "a", "b" and "c". +

    regex :

    a GRegex structure from g_regex_new() +a GRegex structure from g_regex_new()

    string :

    the string to scan for matches +the string to scan for matches

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    match_options :

    match options +match options

    match_info :

    pointer to location where to store the GMatchInfo, +pointer to location where to store the GMatchInfo, or NULL if you do not need it

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - - - - @@ -1523,9 +1577,9 @@ characters. For example splitting "ab c" using as a separator

    g_regex_split ()

    -
    gchar **            g_regex_split                       (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         GRegexMatchFlags match_options);
    +
    gchar **            g_regex_split                       (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         GRegexMatchFlags match_options);

    Breaks the string on the pattern, and returns an array of the tokens. If the pattern contains capturing parentheses, then the text for each @@ -1545,23 +1599,24 @@ empty string before calling this function. A pattern that can match empty strings splits string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get -"a", "b" and "c".

    +"a", "b" and "c". +

    pattern :

    the regular expression +the regular expression

    string :

    the string to scan for matches +the string to scan for matches

    compile_options :

    compile options for the regular expression, or 0 +compile options for the regular expression, or 0

    match_options :

    match options, or 0 +match options, or 0
    - - - @@ -1577,13 +1632,13 @@ For example splitting "ab c" using as a separator "\s*", you will get

    g_regex_split_full ()

    -
    gchar **            g_regex_split_full                  (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         gssize string_len,
    -                                                         gint start_position,
    -                                                         GRegexMatchFlags match_options,
    -                                                         gint max_tokens,
    -                                                         GError **error);
    +
    gchar **            g_regex_split_full                  (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         gssize string_len,
    +                                                         gint start_position,
    +                                                         GRegexMatchFlags match_options,
    +                                                         gint max_tokens,
    +                                                         GError **error);

    Breaks the string on the pattern, and returns an array of the tokens. If the pattern contains capturing parentheses, then the text for each @@ -1608,44 +1663,45 @@ For example splitting "ab c" using as a separator "\s*", you will get

    Setting start_position differs from just passing over a shortened string and setting G_REGEX_MATCH_NOTBOL in the case of a pattern -that begins with any kind of lookbehind assertion, such as "\b".

    +that begins with any kind of lookbehind assertion, such as "\b". +

    regex :

    a GRegex structure +a GRegex structure

    string :

    the string to split with the pattern +the string to split with the pattern

    match_options :

    match time option flags +match time option flags
    - - - - - - - @@ -1661,13 +1717,13 @@ that begins with any kind of lookbehind assertion, such as "\b".


    g_regex_replace ()

    -
    gchar *             g_regex_replace                     (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         gssize string_len,
    -                                                         gint start_position,
    -                                                         const gchar *replacement,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GError **error);
    +
    gchar *             g_regex_replace                     (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         gssize string_len,
    +                                                         gint start_position,
    +                                                         const gchar *replacement,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GError **error);

    Replaces all occurrences of the pattern in regex with the replacement text. Backreferences of the form '\number' or @@ -1718,43 +1774,44 @@ you can use start_position differs from just passing over a shortened string and setting G_REGEX_MATCH_NOTBOL in the case of a pattern that -begins with any kind of lookbehind assertion, such as "\b".

    +begins with any kind of lookbehind assertion, such as "\b". +

    regex :

    a GRegex structure +a GRegex structure

    string :

    the string to split with the pattern +the string to split with the pattern

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    match_options :

    match time option flags +match time option flags

    max_tokens :

    the maximum number of tokens to split string into. +the maximum number of tokens to split string into. If this is less than 1, the string is split completely

    error :

    return location for a GError +return location for a GError
    - - - - - - - @@ -1770,13 +1827,13 @@ begins with any kind of lookbehind assertion, such as "\b".


    g_regex_replace_literal ()

    -
    gchar *             g_regex_replace_literal             (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         gssize string_len,
    -                                                         gint start_position,
    -                                                         const gchar *replacement,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GError **error);
    +
    gchar *             g_regex_replace_literal             (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         gssize string_len,
    +                                                         gint start_position,
    +                                                         const gchar *replacement,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GError **error);

    Replaces all occurrences of the pattern in regex with the replacement text. replacement is replaced literally, to @@ -1786,43 +1843,44 @@ include backreferences use start_position differs from just passing over a shortened string and setting G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind -assertion, such as "\b".

    +assertion, such as "\b". +

    regex :

    a GRegex structure +a GRegex structure

    string :

    the string to perform matches against +the string to perform matches against

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    replacement :

    text to replace each match with +text to replace each match with

    match_options :

    options for the match +options for the match

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - - - - - - - @@ -1838,14 +1896,14 @@ assertion, such as "\b".


    g_regex_replace_eval ()

    -
    gchar *             g_regex_replace_eval                (const GRegex *regex,
    -                                                         const gchar *string,
    -                                                         gssize string_len,
    -                                                         gint start_position,
    -                                                         GRegexMatchFlags match_options,
    -                                                         GRegexEvalCallback eval,
    -                                                         gpointer user_data,
    -                                                         GError **error);
    +
    gchar *             g_regex_replace_eval                (const GRegex *regex,
    +                                                         const gchar *string,
    +                                                         gssize string_len,
    +                                                         gint start_position,
    +                                                         GRegexMatchFlags match_options,
    +                                                         GRegexEvalCallback eval,
    +                                                         gpointer user_data,
    +                                                         GError **error);

    Replaces occurrences of the pattern in regex with the output of eval for that occurrence. @@ -1859,83 +1917,126 @@ that begins with any kind of lookbehind assertion, such as "\b". The following example uses g_regex_replace_eval() to replace multiple strings at once:

    -
    -static gboolean 
    -eval_cb (const GMatchInfo *info,          
    -         GString          *res,
    -         gpointer          data)
    -{
    -  gchar *match;
    -  gchar *r;
    +
    +

    regex :

    a GRegex structure +a GRegex structure

    string :

    the string to perform matches against +the string to perform matches against

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    replacement :

    text to replace each match with +text to replace each match with

    match_options :

    options for the match +options for the match

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    static gboolean 
    +eval_cb (const GMatchInfo *info,          
    +         GString          *res,
    +         gpointer          data)
    +{
    +  gchar *match;
    +  gchar *r;
     
    -   match = g_match_info_fetch (info, 0);
    -   r = g_hash_table_lookup ((GHashTable *)data, match);
    -   g_string_append (res, r);
    -   g_free (match);
    +   match = g_match_info_fetch (info, 0);
    +   r = g_hash_table_lookup ((GHashTable *)data, match);
    +   g_string_append (res, r);
    +   g_free (match);
     
    -   return FALSE;
    -}
    +   return FALSE;
    +}
     
    -/* ... */
    +/* ... */
     
    -GRegex *reg;
    -GHashTable *h;
    -gchar *res;
    +GRegex *reg;
    +GHashTable *h;
    +gchar *res;
     
    -h = g_hash_table_new (g_str_hash, g_str_equal);
    +h = g_hash_table_new (g_str_hash, g_str_equal);
     
    -g_hash_table_insert (h, "1", "ONE");
    -g_hash_table_insert (h, "2", "TWO");
    -g_hash_table_insert (h, "3", "THREE");
    -g_hash_table_insert (h, "4", "FOUR");
    +g_hash_table_insert (h, "1", "ONE");
    +g_hash_table_insert (h, "2", "TWO");
    +g_hash_table_insert (h, "3", "THREE");
    +g_hash_table_insert (h, "4", "FOUR");
     
    -reg = g_regex_new ("1|2|3|4", 0, 0, NULL);
    -res = g_regex_replace_eval (reg, text, -1, 0, 0, eval_cb, h, NULL);
    -g_hash_table_destroy (h);
    +reg = g_regex_new ("1|2|3|4", 0, 0, NULL);
    +res = g_regex_replace_eval (reg, text, -1, 0, 0, eval_cb, h, NULL);
    +g_hash_table_destroy (h);
     
    -/* ... */
    -
    +/* ... */
    +
    + +

    +

    - - - - - - - - @@ -1951,9 +2052,9 @@ g_hash_table_destroy (h);

    g_regex_check_replacement ()

    -
    gboolean            g_regex_check_replacement           (const gchar *replacement,
    -                                                         gboolean *has_references,
    -                                                         GError **error);
    +
    gboolean            g_regex_check_replacement           (const gchar *replacement,
    +                                                         gboolean *has_references,
    +                                                         GError **error);

    Checks whether replacement is a valid replacement string (see g_regex_replace()), i.e. that all escape sequences in @@ -1964,24 +2065,25 @@ If has_references is not GMatchInfo object.

    +subpattern) requires valid GMatchInfo object. +

    regex :

    a GRegex structure from g_regex_new() +a GRegex structure from g_regex_new()

    string :

    string to perform matches against +string to perform matches against

    string_len :

    the length of string, or -1 if string is nul-terminated +the length of string, or -1 if string is nul-terminated

    start_position :

    starting index of the string to match +starting index of the string to match

    match_options :

    options for the match +options for the match

    eval :

    a function to call for each match +a function to call for each match

    user_data :

    user data to pass to the function +user data to pass to the function

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - - - @@ -2008,17 +2110,18 @@ This structure is opaque and its fields cannot be accessed directly.

    g_match_info_get_regex ()

    -
    GRegex *            g_match_info_get_regex              (const GMatchInfo *match_info);
    +
    GRegex *            g_match_info_get_regex              (const GMatchInfo *match_info);

    Returns GRegex object used in match_info. It belongs to Glib and must not be freed. Use g_regex_ref() if you need to keep it -after you free match_info object.

    +after you free match_info object. +

    replacement :

    the replacement string +the replacement string

    has_references :

    location to store information about +location to store information about references in replacement or NULL

    error :

    location to store error +location to store error
    - @@ -2034,17 +2137,18 @@ after you free match_info object.


    g_match_info_get_string ()

    -
    const gchar *       g_match_info_get_string             (const GMatchInfo *match_info);
    +
    const gchar *       g_match_info_get_string             (const GMatchInfo *match_info);

    Returns the string searched with match_info. This is the string passed to g_regex_match() or g_regex_replace() so -you may not free it before calling this function.

    +you may not free it before calling this function. +

    match_info :

    a GMatchInfo +a GMatchInfo
    - @@ -2060,14 +2164,15 @@ you may not free it before calling this function.


    g_match_info_free ()

    -
    void                g_match_info_free                   (GMatchInfo *match_info);
    +
    void                g_match_info_free                   (GMatchInfo *match_info);

    -Frees all the memory associated with the GMatchInfo structure.

    +Frees all the memory associated with the GMatchInfo structure. +

    match_info :

    a GMatchInfo +a GMatchInfo
    -

    match_info :

    a GMatchInfo +a GMatchInfo
    @@ -2076,15 +2181,16 @@ Frees all the memory associated with the

    g_match_info_matches ()

    -
    gboolean            g_match_info_matches                (const GMatchInfo *match_info);
    +
    gboolean            g_match_info_matches                (const GMatchInfo *match_info);

    -Returns whether the previous match operation succeeded.

    +Returns whether the previous match operation succeeded. +

    - @@ -2101,8 +2207,8 @@ Returns whether the previous match operation succeeded.


    g_match_info_next ()

    -
    gboolean            g_match_info_next                   (GMatchInfo *match_info,
    -                                                         GError **error);
    +
    gboolean            g_match_info_next                   (GMatchInfo *match_info,
    +                                                         GError **error);

    Scans for the next match using the same parameters of the previous call to g_regex_match_full() or g_regex_match() that returned @@ -2110,18 +2216,19 @@ call to

    match_info :

    a GMatchInfo structure +a GMatchInfo structure
    - - @@ -2137,7 +2244,7 @@ cannot free it before calling this function.


    g_match_info_get_match_count ()

    -
    gint                g_match_info_get_match_count        (const GMatchInfo *match_info);
    +
    gint                g_match_info_get_match_count        (const GMatchInfo *match_info);

    Retrieves the number of matched substrings (including substring 0, that is the whole matched text), so 1 is returned if the pattern @@ -2147,13 +2254,14 @@ has no substrings in it and 0 is returned if the match failed. If the last match was obtained using the DFA algorithm, that is using g_regex_match_all() or g_regex_match_all_full(), the retrieved count is not that of the number of capturing parentheses but that of -the number of matched substrings.

    +the number of matched substrings. +

    match_info :

    a GMatchInfo structure +a GMatchInfo structure

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - @@ -2169,7 +2277,7 @@ the number of matched substrings.


    g_match_info_is_partial_match ()

    -
    gboolean            g_match_info_is_partial_match       (const GMatchInfo *match_info);
    +
    gboolean            g_match_info_is_partial_match       (const GMatchInfo *match_info);

    Usually if the string passed to g_regex_match*() matches as far as it goes, but is too short to match the entire pattern, FALSE is @@ -2206,13 +2314,14 @@ of occurrences is greater than one. Optional items such as "\d?" are permitted after parentheses, so the invalid examples above can be coded thus "(a){2,4}" and "(\d)+". If G_REGEX_MATCH_PARTIAL is set for a pattern that does not conform to the restrictions, matching -functions return an error.

    +functions return an error. +

    match_info :

    a GMatchInfo structure +a GMatchInfo structure
    - @@ -2228,9 +2337,9 @@ functions return an error.


    g_match_info_expand_references ()

    -
    gchar *             g_match_info_expand_references      (const GMatchInfo *match_info,
    -                                                         const gchar *string_to_expand,
    -                                                         GError **error);
    +
    gchar *             g_match_info_expand_references      (const GMatchInfo *match_info,
    +                                                         const gchar *string_to_expand,
    +                                                         GError **error);

    Returns a new string containing the text in string_to_expand with references and escape sequences expanded. References refer to the last @@ -2251,23 +2360,24 @@ contain references. For instance "foo\n" does not refer to an actual pattern and '\n' merely will be replaced with \n character, while to expand "\0" (whole match) one needs the result of a match. Use g_regex_check_replacement() to find out whether string_to_expand -contains references.

    +contains references. +

    match_info :

    a GMatchInfo structure +a GMatchInfo structure
    - - - @@ -2283,8 +2393,8 @@ contains references.


    g_match_info_fetch ()

    -
    gchar *             g_match_info_fetch                  (const GMatchInfo *match_info,
    -                                                         gint match_num);
    +
    gchar *             g_match_info_fetch                  (const GMatchInfo *match_info,
    +                                                         gint match_num);

    Retrieves the text matching the match_num'th capturing parentheses. 0 is the full text of the match, 1 is the first paren @@ -2304,18 +2414,20 @@ substring. Substrings are matched in reverse order of length, so

    The string is fetched from the string passed to the match function, -so you cannot call this function after freeing the string.

    +so you cannot call this function after freeing the string. +

    match_info :

    a GMatchInfo or NULL +a GMatchInfo or NULL

    string_to_expand :

    the string to expand +the string to expand

    error :

    location to store the error occuring, or NULL to ignore errors +location to store the error occuring, or NULL to ignore errors
    - - @@ -2332,10 +2444,10 @@ so you cannot call this function after freeing the string.


    g_match_info_fetch_pos ()

    -
    gboolean            g_match_info_fetch_pos              (const GMatchInfo *match_info,
    -                                                         gint match_num,
    -                                                         gint *start_pos,
    -                                                         gint *end_pos);
    +
    gboolean            g_match_info_fetch_pos              (const GMatchInfo *match_info,
    +                                                         gint match_num,
    +                                                         gint *start_pos,
    +                                                         gint *end_pos);

    Retrieves the position in bytes of the match_num'th capturing parentheses. 0 is the full text of the match, 1 is the first @@ -2351,28 +2463,30 @@ If the match was obtained using the DFA algorithm, that is using g_regex_match_all() or g_regex_match_all_full(), the retrieved position is not that of a set of parentheses but that of a matched substring. Substrings are matched in reverse order of length, so -0 is the longest match.

    +0 is the longest match. +

    match_info :

    GMatchInfo structure + +GMatchInfo structure

    match_num :

    number of the sub expression +number of the sub expression
    - - - - @@ -2390,8 +2504,8 @@ substring. Substrings are matched in reverse order of length, so

    g_match_info_fetch_named ()

    -
    gchar *             g_match_info_fetch_named            (const GMatchInfo *match_info,
    -                                                         const gchar *name);
    +
    gchar *             g_match_info_fetch_named            (const GMatchInfo *match_info,
    +                                                         const gchar *name);

    Retrieves the text matching the capturing parentheses named name.

    @@ -2402,18 +2516,20 @@ then an empty string is returned.

    The string is fetched from the string passed to the match function, -so you cannot call this function after freeing the string.

    +so you cannot call this function after freeing the string. +

    match_info :

    GMatchInfo structure + +GMatchInfo structure

    match_num :

    number of the sub expression +number of the sub expression

    start_pos :

    pointer to location where to store the start position +pointer to location where to store the start position

    end_pos :

    pointer to location where to store the end position +pointer to location where to store the end position
    - - @@ -2430,38 +2546,40 @@ so you cannot call this function after freeing the string.


    g_match_info_fetch_named_pos ()

    -
    gboolean            g_match_info_fetch_named_pos        (const GMatchInfo *match_info,
    -                                                         const gchar *name,
    -                                                         gint *start_pos,
    -                                                         gint *end_pos);
    +
    gboolean            g_match_info_fetch_named_pos        (const GMatchInfo *match_info,
    +                                                         const gchar *name,
    +                                                         gint *start_pos,
    +                                                         gint *end_pos);

    Retrieves the position in bytes of the capturing parentheses named name.

    If name is a valid sub pattern name but it didn't match anything (e.g. sub pattern "X", matching "b" against "(?P<X>a)?b") -then start_pos and end_pos are set to -1 and TRUE is returned.

    +then start_pos and end_pos are set to -1 and TRUE is returned. +

    match_info :

    GMatchInfo structure + +GMatchInfo structure

    name :

    name of the subexpression +name of the subexpression
    - - - - @@ -2479,7 +2597,7 @@ then start_pos and

    g_match_info_fetch_all ()

    -
    gchar **            g_match_info_fetch_all              (const GMatchInfo *match_info);
    +
    gchar **            g_match_info_fetch_all              (const GMatchInfo *match_info);

    Bundles up pointers to each of the matching substrings from a match and stores them in an array of gchar pointers. The first element in @@ -2499,13 +2617,14 @@ so the first one is the longest match.

    The strings are fetched from the string passed to the match function, -so you cannot call this function after freeing the string.

    +so you cannot call this function after freeing the string. +

    match_info :

    GMatchInfo structure + +GMatchInfo structure

    name :

    name of the subexpression +name of the subexpression

    start_pos :

    pointer to location where to store the start position +pointer to location where to store the start position

    end_pos :

    pointer to location where to store the end position +pointer to location where to store the end position
    - @@ -2524,6 +2643,6 @@ so you cannot call this function after freeing the string.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Pointer-Arrays.html b/docs/reference/glib/html/glib-Pointer-Arrays.html index f775b35..f6e725a 100644 --- a/docs/reference/glib/html/glib-Pointer-Arrays.html +++ b/docs/reference/glib/html/glib-Pointer-Arrays.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    match_info :

    a GMatchInfo structure +a GMatchInfo structure
    @@ -62,39 +42,40 @@ #include <glib.h> GPtrArray; -GPtrArray* g_ptr_array_new (void); -GPtrArray* g_ptr_array_sized_new (guint reserved_size); -GPtrArray* g_ptr_array_new_with_free_func (GDestroyNotify element_free_func); -void g_ptr_array_set_free_func (GPtrArray *array, - GDestroyNotify element_free_func); -GPtrArray* g_ptr_array_ref (GPtrArray *array); -void g_ptr_array_unref (GPtrArray *array); -void g_ptr_array_add (GPtrArray *array, - gpointer data); -gboolean g_ptr_array_remove (GPtrArray *array, - gpointer data); -gpointer g_ptr_array_remove_index (GPtrArray *array, - guint index_); -gboolean g_ptr_array_remove_fast (GPtrArray *array, - gpointer data); -gpointer g_ptr_array_remove_index_fast (GPtrArray *array, - guint index_); -void g_ptr_array_remove_range (GPtrArray *array, - guint index_, - guint length); -void g_ptr_array_sort (GPtrArray *array, - GCompareFunc compare_func); -void g_ptr_array_sort_with_data (GPtrArray *array, - GCompareDataFunc compare_func, - gpointer user_data); -void g_ptr_array_set_size (GPtrArray *array, - gint length); -#define g_ptr_array_index (array,index_) -gpointer* g_ptr_array_free (GPtrArray *array, - gboolean free_seg); -void g_ptr_array_foreach (GPtrArray *array, - GFunc func, - gpointer user_data); +GPtrArray* g_ptr_array_new (void); +GPtrArray* g_ptr_array_sized_new (guint reserved_size); +GPtrArray* g_ptr_array_new_with_free_func (GDestroyNotify element_free_func); +void g_ptr_array_set_free_func (GPtrArray *array, + GDestroyNotify element_free_func); +GPtrArray* g_ptr_array_ref (GPtrArray *array); +void g_ptr_array_unref (GPtrArray *array); +void g_ptr_array_add (GPtrArray *array, + gpointer data); +gboolean g_ptr_array_remove (GPtrArray *array, + gpointer data); +gpointer g_ptr_array_remove_index (GPtrArray *array, + guint index_); +gboolean g_ptr_array_remove_fast (GPtrArray *array, + gpointer data); +gpointer g_ptr_array_remove_index_fast (GPtrArray *array, + guint index_); +void g_ptr_array_remove_range (GPtrArray *array, + guint index_, + guint length); +void g_ptr_array_sort (GPtrArray *array, + GCompareFunc compare_func); +void g_ptr_array_sort_with_data (GPtrArray *array, + GCompareDataFunc compare_func, + gpointer user_data); +void g_ptr_array_set_size (GPtrArray *array, + gint length); +#define g_ptr_array_index (array, + index_) +gpointer* g_ptr_array_free (GPtrArray *array, + gboolean free_seg); +void g_ptr_array_foreach (GPtrArray *array, + GFunc func, + gpointer user_data);
    @@ -137,24 +118,45 @@ To free a pointer array, use -

    Example 21. Using a GPtrArray

    -
    -  GPtrArray *gparray;
    -  gchar *string1 = "one", *string2 = "two", *string3 = "three";
    +

    Example 21. Using a GPtrArray

    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    GPtrArray *gparray;
    +gchar *string1 = "one", *string2 = "two", *string3 = "three";
     
    -  gparray = g_ptr_array_new ();
    -  g_ptr_array_add (gparray, (gpointer) string1);
    -  g_ptr_array_add (gparray, (gpointer) string2);
    -  g_ptr_array_add (gparray, (gpointer) string3);
    +gparray = g_ptr_array_new ();
    +g_ptr_array_add (gparray, (gpointer) string1);
    +g_ptr_array_add (gparray, (gpointer) string2);
    +g_ptr_array_add (gparray, (gpointer) string3);
     
    -  if (g_ptr_array_index (gparray, 0) != (gpointer) string1)
    -    g_print ("ERROR: got %p instead of %p\n",
    -             g_ptr_array_index (gparray, 0), string1);
    +if (g_ptr_array_index (gparray, 0) != (gpointer) string1)
    +  g_print ("ERROR: got %p instead of %p\n",
    +           g_ptr_array_index (gparray, 0), string1);
     
    -  g_ptr_array_free (gparray, TRUE);
    - 
    +g_ptr_array_free (gparray, TRUE);
    -


    + +
    +


    +

    @@ -202,23 +206,24 @@ Creates a new

    g_ptr_array_sized_new ()

    -
    GPtrArray*          g_ptr_array_sized_new               (guint reserved_size);
    +
    GPtrArray*          g_ptr_array_sized_new               (guint reserved_size);

    Creates a new GPtrArray with reserved_size pointers preallocated and a reference count of 1. This avoids frequent reallocation, if you are going to add many pointers to the array. Note however that -the size of the array is still 0.

    +the size of the array is still 0. +

    - - @@ -227,18 +232,19 @@ the size of the array is still 0.


    g_ptr_array_new_with_free_func ()

    -
    GPtrArray*          g_ptr_array_new_with_free_func      (GDestroyNotify element_free_func);
    +
    GPtrArray*          g_ptr_array_new_with_free_func      (GDestroyNotify element_free_func);

    Creates a new GPtrArray with a reference count of 1 and use element_free_func for freeing each element when the array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with free_segment -set to TRUE or when removing elements.

    +set to TRUE or when removing elements. +

    reserved_size :

    number of pointers preallocated. +number of pointers preallocated.

    Returns :

    the new GPtrArray. +the new GPtrArray.
    - @@ -254,23 +260,24 @@ set to <

    g_ptr_array_set_free_func ()

    -
    void                g_ptr_array_set_free_func           (GPtrArray *array,
    -                                                         GDestroyNotify element_free_func);
    +
    void                g_ptr_array_set_free_func           (GPtrArray *array,
    +                                                         GDestroyNotify element_free_func);

    Sets a function for freeing each element when array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called -with free_segment set to TRUE or when removing elements.

    +with free_segment set to TRUE or when removing elements. +

    element_free_func :

    A function to free elements with destroy array or NULL. +A function to free elements with destroy array or NULL.
    - - @@ -280,16 +287,17 @@ with free_segment set to

    g_ptr_array_ref ()

    -
    GPtrArray*          g_ptr_array_ref                     (GPtrArray *array);
    +
    GPtrArray*          g_ptr_array_ref                     (GPtrArray *array);

    Atomically increments the reference count of array by one. This -function is MT-safe and may be called from any thread.

    +function is MT-safe and may be called from any thread. +

    array :

    A GPtrArray. +A GPtrArray.

    element_free_func :

    A function to free elements with destroy array or NULL. +A function to free elements with destroy array or NULL.
    - @@ -305,17 +313,18 @@ function is MT-safe and may be called from any thread.


    g_ptr_array_unref ()

    -
    void                g_ptr_array_unref                   (GPtrArray *array);
    +
    void                g_ptr_array_unref                   (GPtrArray *array);

    Atomically decrements the reference count of array by one. If the reference count drops to 0, the effect is the same as calling g_ptr_array_free() with free_segment set to TRUE. This function -is MT-safe and may be called from any thread.

    +is MT-safe and may be called from any thread. +

    array :

    A GArray. +A GArray.
    -

    array :

    A GPtrArray. +A GPtrArray.
    @@ -324,22 +333,23 @@ is MT-safe and may be called from any thread.


    g_ptr_array_add ()

    -
    void                g_ptr_array_add                     (GPtrArray *array,
    -                                                         gpointer data);
    +
    void                g_ptr_array_add                     (GPtrArray *array,
    +                                                         gpointer data);

    Adds a pointer to the end of the pointer array. The array will grow -in size automatically if necessary.

    +in size automatically if necessary. +

    - - @@ -348,8 +358,8 @@ in size automatically if necessary.


    g_ptr_array_remove ()

    -
    gboolean            g_ptr_array_remove                  (GPtrArray *array,
    -                                                         gpointer data);
    +
    gboolean            g_ptr_array_remove                  (GPtrArray *array,
    +                                                         gpointer data);

    Removes the first occurrence of the given pointer from the pointer array. The following elements are moved down one place. If array @@ -358,23 +368,25 @@ removed element.

    It returns TRUE if the pointer was removed, or FALSE if the -pointer was not found.

    +pointer was not found. +

    array :

    a GPtrArray. +a GPtrArray.

    data :

    the pointer to add. +the pointer to add.
    - - - @@ -384,29 +396,30 @@ pointer was not found.


    g_ptr_array_remove_index ()

    -
    gpointer            g_ptr_array_remove_index            (GPtrArray *array,
    -                                                         guint index_);
    +
    gpointer            g_ptr_array_remove_index            (GPtrArray *array,
    +                                                         guint index_);

    Removes the pointer at the given index from the pointer array. The following elements are moved down one place. If array has a non-NULL GDestroyNotify function it is called for the removed -element.

    +element. +

    array :

    a GPtrArray. +a GPtrArray.

    data :

    the pointer to remove. +the pointer to remove.

    Returns :

    TRUE if the pointer is removed. FALSE if the pointer is + +TRUE if the pointer is removed. FALSE if the pointer is not found in the array.
    - - - @@ -415,8 +428,8 @@ element.


    g_ptr_array_remove_fast ()

    -
    gboolean            g_ptr_array_remove_fast             (GPtrArray *array,
    -                                                         gpointer data);
    +
    gboolean            g_ptr_array_remove_fast             (GPtrArray *array,
    +                                                         gpointer data);

    Removes the first occurrence of the given pointer from the pointer array. The last element in the array is used to fill in the space, @@ -426,23 +439,25 @@ faster than

    It returns TRUE if the pointer was removed, or FALSE if the -pointer was not found.

    +pointer was not found. +

    array :

    a GPtrArray. +a GPtrArray.

    index_ :

    the index of the pointer to remove. +the index of the pointer to remove.

    Returns :

    the pointer which was removed. +the pointer which was removed.
    - - - @@ -451,30 +466,31 @@ pointer was not found.


    g_ptr_array_remove_index_fast ()

    -
    gpointer            g_ptr_array_remove_index_fast       (GPtrArray *array,
    -                                                         guint index_);
    +
    gpointer            g_ptr_array_remove_index_fast       (GPtrArray *array,
    +                                                         guint index_);

    Removes the pointer at the given index from the pointer array. The last element in the array is used to fill in the space, so this function does not preserve the order of the array. But it is faster than g_ptr_array_remove_index(). If array has a non-NULL -GDestroyNotify function it is called for the removed element.

    +GDestroyNotify function it is called for the removed element. +

    array :

    a GPtrArray. +a GPtrArray.

    data :

    the pointer to remove. +the pointer to remove.

    Returns :

    TRUE if the pointer was found in the array. + +TRUE if the pointer was found in the array.
    - - - @@ -483,30 +499,31 @@ than

    g_ptr_array_remove_range ()

    -
    void                g_ptr_array_remove_range            (GPtrArray *array,
    -                                                         guint index_,
    -                                                         guint length);
    +
    void                g_ptr_array_remove_range            (GPtrArray *array,
    +                                                         guint index_,
    +                                                         guint length);

    Removes the given number of pointers starting at the given index from a GPtrArray. The following elements are moved to close the gap. If array has a non-NULL GDestroyNotify function it is called -for the removed elements.

    +for the removed elements. +

    array :

    a GPtrArray. +a GPtrArray.

    index_ :

    the index of the pointer to remove. +the index of the pointer to remove.

    Returns :

    the pointer which was removed. +the pointer which was removed.
    - - - @@ -516,8 +533,8 @@ for the removed elements.


    g_ptr_array_sort ()

    -
    void                g_ptr_array_sort                    (GPtrArray *array,
    -                                                         GCompareFunc compare_func);
    +
    void                g_ptr_array_sort                    (GPtrArray *array,
    +                                                         GCompareFunc compare_func);

    Sorts the array, using compare_func which should be a qsort()-style comparison function (returns less than zero for first arg is less @@ -536,17 +553,19 @@ is undefined. take the pointers from the array as arguments, it takes pointers to the pointers in the array.

    +

    +

    array :

    a GPtrArray. +a GPtrArray.

    index_ :

    the index of the first pointer to remove. +the index of the first pointer to remove.

    length :

    the number of pointers to remove. +the number of pointers to remove.
    - - @@ -555,9 +574,9 @@ the pointers in the array.


    g_ptr_array_sort_with_data ()

    -
    void                g_ptr_array_sort_with_data          (GPtrArray *array,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +
    void                g_ptr_array_sort_with_data          (GPtrArray *array,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);

    Like g_ptr_array_sort(), but the comparison function has an extra user data argument. @@ -570,22 +589,24 @@ user data argument. doesn't take the pointers from the array as arguments, it takes pointers to the pointers in the array.

    +

    +

    array :

    a GPtrArray. +a GPtrArray.

    compare_func :

    comparison function. +comparison function.
    - - - @@ -594,24 +615,25 @@ pointers to the pointers in the array.


    g_ptr_array_set_size ()

    -
    void                g_ptr_array_set_size                (GPtrArray *array,
    -                                                         gint length);
    +
    void                g_ptr_array_set_size                (GPtrArray *array,
    +                                                         gint length);

    Sets the size of the array. When making the array larger, newly-added elements will be set to NULL. When making it smaller, if array has a non-NULL GDestroyNotify function then it will be -called for the removed elements.

    +called for the removed elements. +

    array :

    a GPtrArray. +a GPtrArray.

    compare_func :

    comparison function. +comparison function.

    user_data :

    data to pass to compare_func. +data to pass to compare_func.
    - - @@ -622,23 +644,24 @@ called for the removed elements.

    g_ptr_array_index()

    #define             g_ptr_array_index(array,index_)

    -Returns the pointer at the given index of the pointer array.

    +Returns the pointer at the given index of the pointer array. +

    array :

    a GPtrArray. +a GPtrArray.

    length :

    the new length of the pointer array. +the new length of the pointer array.
    - - - @@ -647,8 +670,8 @@ Returns the pointer at the given index of the pointer array.


    g_ptr_array_free ()

    -
    gpointer*           g_ptr_array_free                    (GPtrArray *array,
    -                                                         gboolean free_seg);
    +
    gpointer*           g_ptr_array_free                    (GPtrArray *array,
    +                                                         gboolean free_seg);

    Frees the memory allocated for the GPtrArray. If free_seg is TRUE it frees the memory block holding the elements as well. Pass FALSE @@ -665,22 +688,24 @@ size of array will be set to zero. memory, they should be freed separately if free_seg is TRUE and no GDestroyNotify function has been set for array.

    +

    +

    array :

    a GPtrArray. +a GPtrArray.

    index_ :

    the index of the pointer to return. +the index of the pointer to return.

    Returns :

    the pointer at the given index. +the pointer at the given index.
    - - - @@ -690,27 +715,28 @@ memory, they should be freed separately if free_seg<

    g_ptr_array_foreach ()

    -
    void                g_ptr_array_foreach                 (GPtrArray *array,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_ptr_array_foreach                 (GPtrArray *array,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    -Calls a function for each element of a GPtrArray.

    +Calls a function for each element of a GPtrArray. +

    array :

    a GPtrArray. +a GPtrArray.

    free_seg :

    if TRUE the actual pointer array is freed as well. +if TRUE the actual pointer array is freed as well.

    Returns :

    the pointer array if free_seg is FALSE, otherwise NULL. +the pointer array if free_seg is FALSE, otherwise NULL. The pointer array should be freed using g_free().
    - - - @@ -721,6 +747,6 @@ Calls a function for each element of a
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Quarks.html b/docs/reference/glib/html/glib-Quarks.html index cfb9a03..d79724a 100644 --- a/docs/reference/glib/html/glib-Quarks.html +++ b/docs/reference/glib/html/glib-Quarks.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    array :

    a GPtrArray +a GPtrArray

    func :

    the function to call for each array element +the function to call for each array element

    user_data :

    user data to pass to the function +user data to pass to the function
    @@ -62,12 +42,12 @@ #include <glib.h> typedef GQuark; -GQuark g_quark_from_string (const gchar *string); -GQuark g_quark_from_static_string (const gchar *string); -const gchar* g_quark_to_string (GQuark quark); -GQuark g_quark_try_string (const gchar *string); -const gchar* g_intern_string (const gchar *string); -const gchar* g_intern_static_string (const gchar *string); +GQuark g_quark_from_string (const gchar *string); +GQuark g_quark_from_static_string (const gchar *string); +const gchar* g_quark_to_string (GQuark quark); +GQuark g_quark_try_string (const gchar *string); +const gchar* g_intern_string (const gchar *string); +const gchar* g_intern_static_string (const gchar *string);
    @@ -98,7 +78,8 @@ is string interning, using g_intern_static_string(). An interned string is a canonical representation for a string. One important advantage of interned strings is that they can be compared for equality by a simple -pointer comparision, rather than using strcmp().

    +pointer comparision, rather than using strcmp(). +

    Details

    @@ -108,27 +89,29 @@ pointer comparision, rather than using strcmp().

    A GQuark is a non-zero integer which uniquely identifies a -particular string. A GQuark value of zero is associated to NULL.

    +particular string. A GQuark value of zero is associated to NULL. +


    g_quark_from_string ()

    -
    GQuark              g_quark_from_string                 (const gchar *string);
    +
    GQuark              g_quark_from_string                 (const gchar *string);

    Gets the GQuark identifying the given string. If the string does not currently have an associated GQuark, a new GQuark is created, -using a copy of the string.

    +using a copy of the string. +

    - - @@ -138,7 +121,7 @@ using a copy of the string.


    g_quark_from_static_string ()

    -
    GQuark              g_quark_from_static_string          (const gchar *string);
    +
    GQuark              g_quark_from_static_string          (const gchar *string);

    Gets the GQuark identifying the given (static) string. If the string does not currently have an associated GQuark, a new GQuark @@ -152,18 +135,19 @@ will always exist. It can be used with statically allocated strings in the main program, but not with statically allocated memory in dynamically loaded modules, if you expect to ever unload the module again (e.g. do not use this -function in GTK+ theme engines).

    +function in GTK+ theme engines). +

    string :

    a string. +a string.

    Returns :

    the GQuark identifying the string, or 0 if string is +the GQuark identifying the string, or 0 if string is NULL.
    - - @@ -173,20 +157,21 @@ function in GTK+ theme engines).


    g_quark_to_string ()

    -
    const gchar*        g_quark_to_string                   (GQuark quark);
    +
    const gchar*        g_quark_to_string                   (GQuark quark);

    -Gets the string associated with the given GQuark.

    +Gets the string associated with the given GQuark. +

    string :

    a string. +a string.

    Returns :

    the GQuark identifying the string, or 0 if string is +the GQuark identifying the string, or 0 if string is NULL.
    - - @@ -195,25 +180,26 @@ Gets the string associated with the given

    g_quark_try_string ()

    -
    GQuark              g_quark_try_string                  (const gchar *string);
    +
    GQuark              g_quark_try_string                  (const gchar *string);

    Gets the GQuark associated with the given string, or 0 if string is NULL or it has no associated GQuark.

    If you want the GQuark to be created if it doesn't already exist, -use g_quark_from_string() or g_quark_from_static_string().

    +use g_quark_from_string() or g_quark_from_static_string(). +

    quark :

    a GQuark. +a GQuark.

    Returns :

    the string associated with the GQuark. +the string associated with the GQuark.
    - - @@ -223,16 +209,17 @@ use

    g_intern_string ()

    -
    const gchar*        g_intern_string                     (const gchar *string);
    +
    const gchar*        g_intern_string                     (const gchar *string);

    Returns a canonical representation for string. Interned strings can -be compared for equality by comparing the pointers, instead of using strcmp().

    +be compared for equality by comparing the pointers, instead of using strcmp(). +

    string :

    a string. +a string.

    Returns :

    the GQuark associated with the string, or 0 if string is +the GQuark associated with the string, or 0 if string is NULL or there is no GQuark associated with it.
    - @@ -248,18 +235,19 @@ be compared for equality by comparing the pointers, instead of using

    g_intern_static_string ()

    -
    const gchar*        g_intern_static_string              (const gchar *string);
    +
    const gchar*        g_intern_static_string              (const gchar *string);

    Returns a canonical representation for string. Interned strings can be compared for equality by comparing the pointers, instead of using strcmp(). g_intern_static_string() does not copy the string, therefore string must -not be freed or modified.

    +not be freed or modified. +

    string :

    a string +a string
    - @@ -276,6 +264,6 @@ not be freed or modified.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Random-Numbers.html b/docs/reference/glib/html/glib-Random-Numbers.html index 3aba9aa..685bdc8 100644 --- a/docs/reference/glib/html/glib-Random-Numbers.html +++ b/docs/reference/glib/html/glib-Random-Numbers.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    string :

    a static string +a static string
    @@ -61,34 +41,34 @@ #include <glib.h> GRand; -GRand* g_rand_new_with_seed (guint32 seed); -GRand* g_rand_new_with_seed_array (const guint32 *seed, - guint seed_length); -GRand* g_rand_new (void); -GRand* g_rand_copy (GRand *rand_); -void g_rand_free (GRand *rand_); -void g_rand_set_seed (GRand *rand_, - guint32 seed); -void g_rand_set_seed_array (GRand *rand_, - const guint32 *seed, - guint seed_length); +GRand* g_rand_new_with_seed (guint32 seed); +GRand* g_rand_new_with_seed_array (const guint32 *seed, + guint seed_length); +GRand* g_rand_new (void); +GRand* g_rand_copy (GRand *rand_); +void g_rand_free (GRand *rand_); +void g_rand_set_seed (GRand *rand_, + guint32 seed); +void g_rand_set_seed_array (GRand *rand_, + const guint32 *seed, + guint seed_length); #define g_rand_boolean (rand_) -guint32 g_rand_int (GRand *rand_); -gint32 g_rand_int_range (GRand *rand_, - gint32 begin, - gint32 end); -gdouble g_rand_double (GRand *rand_); -gdouble g_rand_double_range (GRand *rand_, - gdouble begin, - gdouble end); -void g_random_set_seed (guint32 seed); -#define g_random_boolean () -guint32 g_random_int (void); -gint32 g_random_int_range (gint32 begin, - gint32 end); -gdouble g_random_double (void); -gdouble g_random_double_range (gdouble begin, - gdouble end); +guint32 g_rand_int (GRand *rand_); +gint32 g_rand_int_range (GRand *rand_, + gint32 begin, + gint32 end); +gdouble g_rand_double (GRand *rand_); +gdouble g_rand_double_range (GRand *rand_, + gdouble begin, + gdouble end); +void g_random_set_seed (guint32 seed); +#define g_random_boolean +guint32 g_random_int (void); +gint32 g_random_int_range (gint32 begin, + gint32 end); +gdouble g_random_double (void); +gdouble g_random_double_range (gdouble begin, + gdouble end);
    @@ -133,7 +113,8 @@ The original seeding and generation algorithms, as found in GLib 2.0.x, can be used instead of the new ones by setting the environment variable G_RANDOM_VERSION to the value of '2.0'. Use the GLib-2.0 algorithms only if you have sequences of -numbers generated with Glib-2.0 that you need to reproduce exactly.

    +numbers generated with Glib-2.0 that you need to reproduce exactly. +

    Details

    @@ -142,20 +123,22 @@ numbers generated with Glib-2.0 that you need to reproduce exactly.

    typedef struct _GRand GRand;

    The GRand struct is an opaque data structure. It should only be -accessed through the g_rand_* functions.

    +accessed through the g_rand_* functions. +


    g_rand_new_with_seed ()

    -
    GRand*              g_rand_new_with_seed                (guint32 seed);
    +
    GRand*              g_rand_new_with_seed                (guint32 seed);

    -Creates a new random number generator initialized with seed.

    +Creates a new random number generator initialized with seed. +

    - @@ -169,21 +152,22 @@ Creates a new random number generator initialized with

    g_rand_new_with_seed_array ()

    -
    GRand*              g_rand_new_with_seed_array          (const guint32 *seed,
    -                                                         guint seed_length);
    +
    GRand*              g_rand_new_with_seed_array          (const guint32 *seed,
    +                                                         guint seed_length);

    -Creates a new random number generator initialized with seed.

    +Creates a new random number generator initialized with seed. +

    seed :

    a value to initialize the random number generator. +a value to initialize the random number generator.
    - - @@ -199,11 +183,12 @@ Creates a new random number generator initialized with

    g_rand_new ()

    -
    GRand*              g_rand_new                          (void);
    +
    GRand*              g_rand_new                          (void);

    Creates a new random number generator initialized with a seed taken either from /dev/urandom (if existing) or from -the current time (as a fallback).

    +the current time (as a fallback). +

    seed :

    an array of seeds to initialize the random number generator. +an array of seeds to initialize the random number generator.

    seed_length :

    an array of seeds to initialize the random number generator. +an array of seeds to initialize the random number generator.
    @@ -216,17 +201,18 @@ the current time (as a fallback).


    g_rand_copy ()

    -
    GRand*              g_rand_copy                         (GRand *rand_);
    +
    GRand*              g_rand_copy                         (GRand *rand_);

    Copies a GRand into a new one with the same exact state as before. This way you can take a snapshot of the random number generator for -replaying later.

    +replaying later. +

    - @@ -242,14 +228,15 @@ replaying later.


    g_rand_free ()

    -
    void                g_rand_free                         (GRand *rand_);
    +
    void                g_rand_free                         (GRand *rand_);

    -Frees the memory allocated for the GRand.

    +Frees the memory allocated for the GRand. +

    rand_ :

    a GRand. +a GRand.
    -

    rand_ :

    a GRand. +a GRand.
    @@ -257,21 +244,22 @@ Frees the memory allocated for the

    g_rand_set_seed ()

    -
    void                g_rand_set_seed                     (GRand *rand_,
    -                                                         guint32 seed);
    +
    void                g_rand_set_seed                     (GRand *rand_,
    +                                                         guint32 seed);

    -Sets the seed for the random number generator GRand to seed.

    +Sets the seed for the random number generator GRand to seed. +

    - - @@ -280,31 +268,32 @@ Sets the seed for the random number generator

    g_rand_set_seed_array ()

    -
    void                g_rand_set_seed_array               (GRand *rand_,
    -                                                         const guint32 *seed,
    -                                                         guint seed_length);
    +
    void                g_rand_set_seed_array               (GRand *rand_,
    +                                                         const guint32 *seed,
    +                                                         guint seed_length);

    Initializes the random number generator by an array of longs. Array can be of arbitrary size, though only the first 624 values are taken. This function is useful if you have many low entropy seeds, or if you require more then -32bits of actual entropy for your application.

    +32bits of actual entropy for your application. +

    rand_ :

    a GRand. +a GRand.

    seed :

    a value to reinitialize the random number generator. +a value to reinitialize the random number generator.
    - - - @@ -317,18 +306,19 @@ if you have many low entropy seeds, or if you require more then
    #define             g_rand_boolean(rand_)

    Returns a random gboolean from rand_. This corresponds to a -unbiased coin toss.

    +unbiased coin toss. +

    rand_ :

    a GRand. +a GRand.

    seed :

    array to initialize with +array to initialize with

    seed_length :

    length of array +length of array
    - - @@ -337,16 +327,17 @@ unbiased coin toss.


    g_rand_int ()

    -
    guint32             g_rand_int                          (GRand *rand_);
    +
    guint32             g_rand_int                          (GRand *rand_);

    Returns the next random guint32 from rand_ equally distributed over -the range [0..2^32-1].

    +the range [0..2^32-1]. +

    rand_ :

    a GRand. +a GRand.

    Returns :

    a random gboolean. +a random gboolean.
    - @@ -360,28 +351,29 @@ the range [0..2^32-1].


    g_rand_int_range ()

    -
    gint32              g_rand_int_range                    (GRand *rand_,
    -                                                         gint32 begin,
    -                                                         gint32 end);
    +
    gint32              g_rand_int_range                    (GRand *rand_,
    +                                                         gint32 begin,
    +                                                         gint32 end);

    Returns the next random gint32 from rand_ equally distributed over -the range [begin..end-1].

    +the range [begin..end-1]. +

    rand_ :

    a GRand. +a GRand.
    - - - @@ -395,16 +387,17 @@ the range [begin..

    g_rand_double ()

    -
    gdouble             g_rand_double                       (GRand *rand_);
    +
    gdouble             g_rand_double                       (GRand *rand_);

    Returns the next random gdouble from rand_ equally distributed over -the range [0..1).

    +the range [0..1). +

    rand_ :

    a GRand. +a GRand.

    begin :

    lower closed bound of the interval. +lower closed bound of the interval.

    end :

    upper open bound of the interval. +upper open bound of the interval.
    - @@ -418,28 +411,29 @@ the range [0..1).


    g_rand_double_range ()

    -
    gdouble             g_rand_double_range                 (GRand *rand_,
    -                                                         gdouble begin,
    -                                                         gdouble end);
    +
    gdouble             g_rand_double_range                 (GRand *rand_,
    +                                                         gdouble begin,
    +                                                         gdouble end);

    Returns the next random gdouble from rand_ equally distributed over -the range [begin..end).

    +the range [begin..end). +

    rand_ :

    a GRand. +a GRand.
    - - - @@ -453,30 +447,32 @@ the range [begin..

    g_random_set_seed ()

    -
    void                g_random_set_seed                   (guint32 seed);
    +
    void                g_random_set_seed                   (guint32 seed);

    Sets the seed for the global random number generator, which is used -by the g_random_* functions, to seed.

    +by the g_random_* functions, to seed. +

    rand_ :

    a GRand. +a GRand.

    begin :

    lower closed bound of the interval. +lower closed bound of the interval.

    end :

    upper open bound of the interval. +upper open bound of the interval.
    -

    seed :

    a value to reinitialize the global random number generator. +a value to reinitialize the global random number generator.

    -
    -

    g_random_boolean()

    +
    +

    g_random_boolean

    #define             g_random_boolean()

    -Returns a random gboolean. This corresponds to a unbiased coin toss.

    +Returns a random gboolean. This corresponds to a unbiased coin toss. +

    -

    Returns :

    a random gboolean. +a random gboolean.
    @@ -484,10 +480,11 @@ Returns a random

    g_random_int ()

    -
    guint32             g_random_int                        (void);
    +
    guint32             g_random_int                        (void);

    Return a random guint32 equally distributed over the range -[0..2^32-1].

    +[0..2^32-1]. +

    @@ -500,22 +497,23 @@ Return a random

    g_random_int_range ()

    -
    gint32              g_random_int_range                  (gint32 begin,
    -                                                         gint32 end);
    +
    gint32              g_random_int_range                  (gint32 begin,
    +                                                         gint32 end);

    Returns a random gint32 equally distributed over the range -[begin..end-1].

    +[begin..end-1]. +

    - - @@ -529,9 +527,10 @@ Returns a random

    g_random_double ()

    -
    gdouble             g_random_double                     (void);
    +
    gdouble             g_random_double                     (void);

    -Returns a random gdouble equally distributed over the range [0..1).

    +Returns a random gdouble equally distributed over the range [0..1). +

    begin :

    lower closed bound of the interval. +lower closed bound of the interval.

    end :

    upper open bound of the interval. +upper open bound of the interval.
    @@ -544,21 +543,22 @@ Returns a random

    g_random_double_range ()

    -
    gdouble             g_random_double_range               (gdouble begin,
    -                                                         gdouble end);
    +
    gdouble             g_random_double_range               (gdouble begin,
    +                                                         gdouble end);

    -Returns a random gdouble equally distributed over the range [begin..end).

    +Returns a random gdouble equally distributed over the range [begin..end). +

    - - @@ -573,6 +573,6 @@ Returns a random
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Relations-and-Tuples.html b/docs/reference/glib/html/glib-Relations-and-Tuples.html index 9c874d6..1e676c3 100644 --- a/docs/reference/glib/html/glib-Relations-and-Tuples.html +++ b/docs/reference/glib/html/glib-Relations-and-Tuples.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    begin :

    lower closed bound of the interval. +lower closed bound of the interval.

    end :

    upper open bound of the interval. +upper open bound of the interval.
    @@ -62,33 +42,33 @@ #include <glib.h> GRelation; -GRelation* g_relation_new (gint fields); -voidg_relation_index (GRelation *relation, - gint field, - GHashFunc hash_func, - GEqualFunc key_equal_func); -voidg_relation_insert (GRelation *relation, - ...); -gbooleang_relation_exists (GRelation *relation, - ...); -gintg_relation_count (GRelation *relation, - gconstpointer key, - gint field); -GTuples* g_relation_select (GRelation *relation, - gconstpointer key, - gint field); -gintg_relation_delete (GRelation *relation, - gconstpointer key, - gint field); -voidg_relation_destroy (GRelation *relation); +GRelation* g_relation_new (gint fields); +voidg_relation_index (GRelation *relation, + gint field, + GHashFunc hash_func, + GEqualFunc key_equal_func); +voidg_relation_insert (GRelation *relation, + ...); +gbooleang_relation_exists (GRelation *relation, + ...); +gintg_relation_count (GRelation *relation, + gconstpointer key, + gint field); +GTuples* g_relation_select (GRelation *relation, + gconstpointer key, + gint field); +gintg_relation_delete (GRelation *relation, + gconstpointer key, + gint field); +voidg_relation_destroy (GRelation *relation); -voidg_relation_print (GRelation *relation); +voidg_relation_print (GRelation *relation); GTuples; -voidg_tuples_destroy (GTuples *tuples); -gpointerg_tuples_index (GTuples *tuples, - gint index_, - gint field); +voidg_tuples_destroy (GTuples *tuples); +gpointerg_tuples_index (GTuples *tuples, + gint index_, + gint field);
    @@ -138,7 +118,8 @@ field, use GRelation, use g_relation_destroy().

    -To help debug GRelation objects, use g_relation_print().

    +To help debug GRelation objects, use g_relation_print(). +

    Details

    @@ -148,26 +129,28 @@ To help debug The GRelation struct is an opaque data structure to represent a Relation. It should -only be accessed via the following functions.

    +only be accessed via the following functions. +


    g_relation_new ()

    -
    GRelation*          g_relation_new                      (gint fields);
    +
    GRelation*          g_relation_new                      (gint fields);

    Creates a new GRelation with the given number of fields. Note that -currently the number of fields must be 2.

    +currently the number of fields must be 2. +

    - - @@ -176,34 +159,35 @@ currently the number of fields must be 2.


    g_relation_index ()

    -
    void                g_relation_index                    (GRelation *relation,
    -                                                         gint field,
    -                                                         GHashFunc hash_func,
    -                                                         GEqualFunc key_equal_func);
    +
    void                g_relation_index                    (GRelation *relation,
    +                                                         gint field,
    +                                                         GHashFunc hash_func,
    +                                                         GEqualFunc key_equal_func);

    Creates an index on the given field. Note that this must be called -before any records are added to the GRelation.

    +before any records are added to the GRelation. +

    fields :

    the number of fields. +the number of fields.

    Returns :

    a new GRelation. +a new GRelation.
    - - - - @@ -212,21 +196,22 @@ before any records are added to the

    g_relation_insert ()

    -
    void                g_relation_insert                   (GRelation *relation,
    -                                                         ...);
    +
    void                g_relation_insert                   (GRelation *relation,
    +                                                         ...);

    -Inserts a record into a GRelation.

    +Inserts a record into a GRelation. +

    relation :

    a GRelation. +a GRelation.

    field :

    the field to index, counting from 0. +the field to index, counting from 0.

    hash_func :

    a function to produce a hash value from the field data. +a function to produce a hash value from the field data.

    key_equal_func :

    a function to compare two values of the given field. +a function to compare two values of the given field.
    - - @@ -237,29 +222,31 @@ Inserts a record into a

    g_relation_exists ()

    -
    gboolean            g_relation_exists                   (GRelation *relation,
    -                                                         ...);
    +
    gboolean            g_relation_exists                   (GRelation *relation,
    +                                                         ...);

    Returns TRUE if a record with the given values exists in a GRelation. Note that the values are compared directly, so that, for -example, two copies of the same string will not match.

    +example, two copies of the same string will not match. +

    relation :

    a GRelation. +a GRelation.

    ... :

    the fields of the record to add. These must match the +the fields of the record to add. These must match the number of fields in the GRelation, and of type gpointer or gconstpointer.
    - - - @@ -268,33 +255,34 @@ example, two copies of the same string will not match.


    g_relation_count ()

    -
    gint                g_relation_count                    (GRelation *relation,
    -                                                         gconstpointer key,
    -                                                         gint field);
    +
    gint                g_relation_count                    (GRelation *relation,
    +                                                         gconstpointer key,
    +                                                         gint field);

    Returns the number of tuples in a GRelation that have the given -value in the given field.

    +value in the given field. +

    relation :

    a GRelation. +a GRelation.

    ... :

    the fields of the record to compare. The number must match +the fields of the record to compare. The number must match the number of fields in the GRelation.

    Returns :

    TRUE if a record matches. + +TRUE if a record matches.
    - - - - @@ -303,34 +291,35 @@ value in the given field.


    g_relation_select ()

    -
    GTuples*            g_relation_select                   (GRelation *relation,
    -                                                         gconstpointer key,
    -                                                         gint field);
    +
    GTuples*            g_relation_select                   (GRelation *relation,
    +                                                         gconstpointer key,
    +                                                         gint field);

    Returns all of the tuples which have the given key in the given field. Use g_tuples_index() to access the returned records. The -returned records should be freed with g_tuples_destroy().

    +returned records should be freed with g_tuples_destroy(). +

    relation :

    a GRelation. +a GRelation.

    key :

    the value to compare with. +the value to compare with.

    field :

    the field of each record to match. +the field of each record to match.

    Returns :

    the number of matches. +the number of matches.
    - - - - @@ -339,33 +328,34 @@ returned records should be freed with

    g_relation_delete ()

    -
    gint                g_relation_delete                   (GRelation *relation,
    -                                                         gconstpointer key,
    -                                                         gint field);
    +
    gint                g_relation_delete                   (GRelation *relation,
    +                                                         gconstpointer key,
    +                                                         gint field);

    Deletes any records from a GRelation that have the given key value -in the given field.

    +in the given field. +

    relation :

    a GRelation. +a GRelation.

    key :

    the value to compare with. +the value to compare with.

    field :

    the field of each record to match. +the field of each record to match.

    Returns :

    the records (tuples) that matched. +the records (tuples) that matched.
    - - - - @@ -374,16 +364,17 @@ in the given field.


    g_relation_destroy ()

    -
    void                g_relation_destroy                  (GRelation *relation);
    +
    void                g_relation_destroy                  (GRelation *relation);

    Destroys the GRelation, freeing all memory allocated. However, it does not free memory allocated for the tuple data, so you should -free that first if appropriate.

    +free that first if appropriate. +

    relation :

    a GRelation. +a GRelation.

    key :

    the value to compare with. +the value to compare with.

    field :

    the field of each record to match. +the field of each record to match.

    Returns :

    the number of records deleted. +the number of records deleted.
    -

    relation :

    a GRelation. +a GRelation.
    @@ -391,15 +382,16 @@ free that first if appropriate.


    g_relation_print ()

    -
    void                g_relation_print                    (GRelation *relation);
    +
    void                g_relation_print                    (GRelation *relation);

    Outputs information about all records in a GRelation, as well as -the indexes. It is for debugging.

    +the indexes. It is for debugging. +

    -

    relation :

    a GRelation. +a GRelation.
    @@ -415,12 +407,13 @@ the indexes. It is for debugging.

    The GTuples struct is used to return records (or tuples) from the GRelation by g_relation_select(). It only contains one public member - the number of records that matched. To access the matched -records, you must use g_tuples_index().

    +records, you must use g_tuples_index(). +

    -

    guint len;

    the number of records that matched. +the number of records that matched.
    @@ -428,17 +421,18 @@ records, you must use

    g_tuples_destroy ()

    -
    void                g_tuples_destroy                    (GTuples *tuples);
    +
    void                g_tuples_destroy                    (GTuples *tuples);

    Frees the records which were returned by g_relation_select(). This should always be called after g_relation_select() when you are finished with the records. The records are not removed from the -GRelation.

    +GRelation. +

    -

    tuples :

    the tuple data to free. +the tuple data to free.
    @@ -446,34 +440,35 @@ finished with the records. The records are not removed from the

    g_tuples_index ()

    -
    gpointer            g_tuples_index                      (GTuples *tuples,
    -                                                         gint index_,
    -                                                         gint field);
    +
    gpointer            g_tuples_index                      (GTuples *tuples,
    +                                                         gint index_,
    +                                                         gint field);

    Gets a field from the records returned by g_relation_select(). It returns the given field of the record at the given index. The -returned value should not be changed.

    +returned value should not be changed. +

    - - - - @@ -483,6 +478,6 @@ returned value should not be changed.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Sequences.html b/docs/reference/glib/html/glib-Sequences.html index ae9da6d..5271236 100644 --- a/docs/reference/glib/html/glib-Sequences.html +++ b/docs/reference/glib/html/glib-Sequences.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    tuples :

    the tuple data, returned by g_relation_select(). +the tuple data, returned by g_relation_select().

    index_ :

    the index of the record. +the index of the record.

    field :

    the field to return. +the field to return.

    Returns :

    the field of the record. +the field of the record.
    @@ -62,87 +42,87 @@ GSequence; typedef GSequenceIter; -gint (*GSequenceIterCompareFunc) (GSequenceIter *a, - GSequenceIter *b, - gpointer data); +gint (*GSequenceIterCompareFunc) (GSequenceIter *a, + GSequenceIter *b, + gpointer data); -GSequence * g_sequence_new (GDestroyNotify data_destroy); -voidg_sequence_free (GSequence *seq); -gintg_sequence_get_length (GSequence *seq); -voidg_sequence_foreach (GSequence *seq, - GFunc func, - gpointer user_data); -voidg_sequence_foreach_range (GSequenceIter *begin, - GSequenceIter *end, - GFunc func, - gpointer user_data); -voidg_sequence_sort (GSequence *seq, - GCompareDataFunc cmp_func, - gpointer cmp_data); -voidg_sequence_sort_iter (GSequence *seq, - GSequenceIterCompareFunc cmp_func, - gpointer cmp_data); +GSequence * g_sequence_new (GDestroyNotify data_destroy); +voidg_sequence_free (GSequence *seq); +gintg_sequence_get_length (GSequence *seq); +voidg_sequence_foreach (GSequence *seq, + GFunc func, + gpointer user_data); +voidg_sequence_foreach_range (GSequenceIter *begin, + GSequenceIter *end, + GFunc func, + gpointer user_data); +voidg_sequence_sort (GSequence *seq, + GCompareDataFunc cmp_func, + gpointer cmp_data); +voidg_sequence_sort_iter (GSequence *seq, + GSequenceIterCompareFunc cmp_func, + gpointer cmp_data); -GSequenceIter * g_sequence_get_begin_iter (GSequence *seq); -GSequenceIter * g_sequence_get_end_iter (GSequence *seq); -GSequenceIter * g_sequence_get_iter_at_pos (GSequence *seq, - gint pos); -GSequenceIter * g_sequence_append (GSequence *seq, - gpointer data); -GSequenceIter * g_sequence_prepend (GSequence *seq, - gpointer data); -GSequenceIter * g_sequence_insert_before (GSequenceIter *iter, - gpointer data); -voidg_sequence_move (GSequenceIter *src, - GSequenceIter *dest); -voidg_sequence_swap (GSequenceIter *a, - GSequenceIter *b); -GSequenceIter * g_sequence_insert_sorted (GSequence *seq, - gpointer data, - GCompareDataFunc cmp_func, - gpointer cmp_data); -GSequenceIter * g_sequence_insert_sorted_iter (GSequence *seq, - gpointer data, - GSequenceIterCompareFunc iter_cmp, - gpointer cmp_data); -voidg_sequence_sort_changed (GSequenceIter *iter, - GCompareDataFunc cmp_func, - gpointer cmp_data); -voidg_sequence_sort_changed_iter (GSequenceIter *iter, - GSequenceIterCompareFunc iter_cmp, - gpointer cmp_data); -voidg_sequence_remove (GSequenceIter *iter); -voidg_sequence_remove_range (GSequenceIter *begin, - GSequenceIter *end); -voidg_sequence_move_range (GSequenceIter *dest, - GSequenceIter *begin, - GSequenceIter *end); -GSequenceIter * g_sequence_search (GSequence *seq, - gpointer data, - GCompareDataFunc cmp_func, - gpointer cmp_data); -GSequenceIter * g_sequence_search_iter (GSequence *seq, - gpointer data, - GSequenceIterCompareFunc iter_cmp, - gpointer cmp_data); +GSequenceIter * g_sequence_get_begin_iter (GSequence *seq); +GSequenceIter * g_sequence_get_end_iter (GSequence *seq); +GSequenceIter * g_sequence_get_iter_at_pos (GSequence *seq, + gint pos); +GSequenceIter * g_sequence_append (GSequence *seq, + gpointer data); +GSequenceIter * g_sequence_prepend (GSequence *seq, + gpointer data); +GSequenceIter * g_sequence_insert_before (GSequenceIter *iter, + gpointer data); +voidg_sequence_move (GSequenceIter *src, + GSequenceIter *dest); +voidg_sequence_swap (GSequenceIter *a, + GSequenceIter *b); +GSequenceIter * g_sequence_insert_sorted (GSequence *seq, + gpointer data, + GCompareDataFunc cmp_func, + gpointer cmp_data); +GSequenceIter * g_sequence_insert_sorted_iter (GSequence *seq, + gpointer data, + GSequenceIterCompareFunc iter_cmp, + gpointer cmp_data); +voidg_sequence_sort_changed (GSequenceIter *iter, + GCompareDataFunc cmp_func, + gpointer cmp_data); +voidg_sequence_sort_changed_iter (GSequenceIter *iter, + GSequenceIterCompareFunc iter_cmp, + gpointer cmp_data); +voidg_sequence_remove (GSequenceIter *iter); +voidg_sequence_remove_range (GSequenceIter *begin, + GSequenceIter *end); +voidg_sequence_move_range (GSequenceIter *dest, + GSequenceIter *begin, + GSequenceIter *end); +GSequenceIter * g_sequence_search (GSequence *seq, + gpointer data, + GCompareDataFunc cmp_func, + gpointer cmp_data); +GSequenceIter * g_sequence_search_iter (GSequence *seq, + gpointer data, + GSequenceIterCompareFunc iter_cmp, + gpointer cmp_data); -gpointerg_sequence_get (GSequenceIter *iter); -voidg_sequence_set (GSequenceIter *iter, - gpointer data); +gpointerg_sequence_get (GSequenceIter *iter); +voidg_sequence_set (GSequenceIter *iter, + gpointer data); -gbooleang_sequence_iter_is_begin (GSequenceIter *iter); -gbooleang_sequence_iter_is_end (GSequenceIter *iter); -GSequenceIter * g_sequence_iter_next (GSequenceIter *iter); -GSequenceIter * g_sequence_iter_prev (GSequenceIter *iter); -gintg_sequence_iter_get_position (GSequenceIter *iter); -GSequenceIter * g_sequence_iter_move (GSequenceIter *iter, - gint delta); -GSequence * g_sequence_iter_get_sequence (GSequenceIter *iter); +gbooleang_sequence_iter_is_begin (GSequenceIter *iter); +gbooleang_sequence_iter_is_end (GSequenceIter *iter); +GSequenceIter * g_sequence_iter_next (GSequenceIter *iter); +GSequenceIter * g_sequence_iter_prev (GSequenceIter *iter); +gintg_sequence_iter_get_position (GSequenceIter *iter); +GSequenceIter * g_sequence_iter_move (GSequenceIter *iter, + gint delta); +GSequence * g_sequence_iter_get_sequence (GSequenceIter *iter); -gintg_sequence_iter_compare (GSequenceIter *a, - GSequenceIter *b); -GSequenceIter * g_sequence_range_get_midpoint (GSequenceIter *begin, - GSequenceIter *end); +gintg_sequence_iter_compare (GSequenceIter *a, + GSequenceIter *b); +GSequenceIter * g_sequence_range_get_midpoint (GSequenceIter *begin, + GSequenceIter *end);
    @@ -185,7 +165,8 @@ continue to point to that element even after the sequence is sorted. Even moving an element to another sequence using for example g_sequence_move_range() will not invalidate the iterators pointing to it. The only operation that will invalidate an iterator is when -the element it points to is removed from any sequence.

    +the element it points to is removed from any sequence. +

    Details

    @@ -194,7 +175,8 @@ the element it points to is removed from any sequence.

    typedef struct _GSequence GSequence;

    The GSequence struct is an opaque data type representing a -Sequence data type.

    +Sequence data type. +


    @@ -203,39 +185,41 @@ The

    The GSequenceIter struct is an opaque data type representing an -iterator pointing into a GSequence.

    +iterator pointing into a GSequence. +


    GSequenceIterCompareFunc ()

    -
    gint                (*GSequenceIterCompareFunc)         (GSequenceIter *a,
    -                                                         GSequenceIter *b,
    -                                                         gpointer data);
    +
    gint                (*GSequenceIterCompareFunc)         (GSequenceIter *a,
    +                                                         GSequenceIter *b,
    +                                                         gpointer data);

    A GSequenceIterCompareFunc is a function used to compare iterators. It must return zero if the iterators compare equal, a negative value -if a comes before b, and a positive value if b comes before a.

    +if a comes before b, and a positive value if b comes before a. +

    - - - - @@ -246,17 +230,18 @@ if a comes before

    g_sequence_new ()

    -
    GSequence *         g_sequence_new                      (GDestroyNotify data_destroy);
    +
    GSequence *         g_sequence_new                      (GDestroyNotify data_destroy);

    Creates a new GSequence. The data_destroy function, if non-NULL will be called on all items when the sequence is destroyed and on items that -are removed from the sequence.

    +are removed from the sequence. +

    a :

    a GSequenceIter +a GSequenceIter

    b :

    a GSequenceIter +a GSequenceIter

    data :

    user data +user data

    Returns :

    zero if the iterators are equal, a negative value if a +zero if the iterators are equal, a negative value if a comes before b, and a positive value if b comes before a.
    - @@ -272,16 +257,17 @@ are removed from the sequence.


    g_sequence_free ()

    -
    void                g_sequence_free                     (GSequence *seq);
    +
    void                g_sequence_free                     (GSequence *seq);

    Frees the memory allocated for seq. If seq has a data destroy function associated with it, that function is called on all items in -seq.

    +seq. +

    data_destroy :

    a GDestroyNotify function, or NULL +a GDestroyNotify function, or NULL
    -

    seq :

    a GSequence +a GSequence
    @@ -290,15 +276,16 @@ function associated with it, that function is called on all items in

    g_sequence_get_length ()

    -
    gint                g_sequence_get_length               (GSequence *seq);
    +
    gint                g_sequence_get_length               (GSequence *seq);

    -Returns the length of seq

    +Returns the length of seq +

    - @@ -314,28 +301,29 @@ Returns the length of seq


    g_sequence_foreach ()

    -
    void                g_sequence_foreach                  (GSequence *seq,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_sequence_foreach                  (GSequence *seq,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    Calls func for each item in the sequence passing user_data -to the function.

    +to the function. +

    seq :

    a GSequence +a GSequence
    - - - @@ -345,34 +333,35 @@ to the function.


    g_sequence_foreach_range ()

    -
    void                g_sequence_foreach_range            (GSequenceIter *begin,
    -                                                         GSequenceIter *end,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_sequence_foreach_range            (GSequenceIter *begin,
    +                                                         GSequenceIter *end,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    Calls func for each item in the range (begin, end) passing -user_data to the function.

    +user_data to the function. +

    seq :

    a GSequence +a GSequence

    func :

    the function to call for each item in seq +the function to call for each item in seq

    user_data :

    user data passed to func +user data passed to func
    - - - - @@ -382,22 +371,23 @@ Calls func for each item in the range (<

    g_sequence_sort ()

    -
    void                g_sequence_sort                     (GSequence *seq,
    -                                                         GCompareDataFunc cmp_func,
    -                                                         gpointer cmp_data);
    +
    void                g_sequence_sort                     (GSequence *seq,
    +                                                         GCompareDataFunc cmp_func,
    +                                                         gpointer cmp_data);

    -Sorts seq using cmp_func.

    +Sorts seq using cmp_func. +

    begin :

    a GSequenceIter +a GSequenceIter

    end :

    a GSequenceIter +a GSequenceIter

    func :

    a GFunc +a GFunc

    user_data :

    user data passed to func +user data passed to func
    - - - @@ -415,23 +405,24 @@ Sorts seq using

    g_sequence_sort_iter ()

    -
    void                g_sequence_sort_iter                (GSequence *seq,
    -                                                         GSequenceIterCompareFunc cmp_func,
    -                                                         gpointer cmp_data);
    +
    void                g_sequence_sort_iter                (GSequence *seq,
    +                                                         GSequenceIterCompareFunc cmp_func,
    +                                                         gpointer cmp_data);

    Like g_sequence_sort(), but uses a GSequenceIterCompareFunc instead -of a GCompareDataFunc as the compare function

    +of a GCompareDataFunc as the compare function +

    seq :

    a GSequence +a GSequence

    cmp_func :

    the GCompareDataFunc used to sort seq. This function is +the GCompareDataFunc used to sort seq. This function is passed two items of seq and should return 0 if they are equal, a negative value if the first comes before the second, and a positive value if the second comes before the first. @@ -405,7 +395,7 @@ Sorts seq using

    cmp_data :

    user data passed to cmp_func +user data passed to cmp_func
    - - - @@ -450,15 +441,16 @@ of a GCompareDataFunc as the compare function


    g_sequence_get_begin_iter ()

    -
    GSequenceIter *     g_sequence_get_begin_iter           (GSequence *seq);
    +
    GSequenceIter *     g_sequence_get_begin_iter           (GSequence *seq);

    -Returns the begin iterator for seq.

    +Returns the begin iterator for seq. +

    seq :

    a GSequence +a GSequence

    cmp_func :

    the GSequenceItercompare used to compare iterators in the +the GSequenceItercompare used to compare iterators in the sequence. It is called with two iterators pointing into seq. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second @@ -440,7 +431,7 @@ of a GCompareDataFunc as the compare function

    cmp_data :

    user data passed to cmp_func +user data passed to cmp_func
    - @@ -474,15 +466,16 @@ Returns the begin iterator for seq.


    g_sequence_get_end_iter ()

    -
    GSequenceIter *     g_sequence_get_end_iter             (GSequence *seq);
    +
    GSequenceIter *     g_sequence_get_end_iter             (GSequence *seq);

    -Returns the end iterator for seg

    +Returns the end iterator for seg +

    seq :

    a GSequence +a GSequence
    - @@ -498,22 +491,23 @@ Returns the end iterator for seg


    g_sequence_get_iter_at_pos ()

    -
    GSequenceIter *     g_sequence_get_iter_at_pos          (GSequence *seq,
    -                                                         gint pos);
    +
    GSequenceIter *     g_sequence_get_iter_at_pos          (GSequence *seq,
    +                                                         gint pos);

    Returns the iterator at position pos. If pos is negative or larger -than the number of items in seq, the end iterator is returned.

    +than the number of items in seq, the end iterator is returned. +

    seq :

    a GSequence +a GSequence
    - - @@ -529,21 +523,22 @@ than the number of items in seq, the end

    g_sequence_append ()

    -
    GSequenceIter *     g_sequence_append                   (GSequence *seq,
    -                                                         gpointer data);
    +
    GSequenceIter *     g_sequence_append                   (GSequence *seq,
    +                                                         gpointer data);

    -Adds a new item to the end of seq.

    +Adds a new item to the end of seq. +

    seq :

    a GSequence +a GSequence

    pos :

    a position in seq, or -1 for the end. +a position in seq, or -1 for the end.
    - - @@ -559,21 +554,22 @@ Adds a new item to the end of seq.


    g_sequence_prepend ()

    -
    GSequenceIter *     g_sequence_prepend                  (GSequence *seq,
    -                                                         gpointer data);
    +
    GSequenceIter *     g_sequence_prepend                  (GSequence *seq,
    +                                                         gpointer data);

    -Adds a new item to the front of seq

    +Adds a new item to the front of seq +

    seq :

    a GSequencePointer +a GSequencePointer

    data :

    the data for the new item +the data for the new item
    - - @@ -589,21 +585,22 @@ Adds a new item to the front of seq


    g_sequence_insert_before ()

    -
    GSequenceIter *     g_sequence_insert_before            (GSequenceIter *iter,
    -                                                         gpointer data);
    +
    GSequenceIter *     g_sequence_insert_before            (GSequenceIter *iter,
    +                                                         gpointer data);

    -Inserts a new item just before the item pointed to by iter.

    +Inserts a new item just before the item pointed to by iter. +

    seq :

    a GSequence +a GSequence

    data :

    the data for the new item +the data for the new item
    - - @@ -619,24 +616,25 @@ Inserts a new item just before the item pointed to by

    g_sequence_move ()

    -
    void                g_sequence_move                     (GSequenceIter *src,
    -                                                         GSequenceIter *dest);
    +
    void                g_sequence_move                     (GSequenceIter *src,
    +                                                         GSequenceIter *dest);

    Moves the item pointed to by src to the position indicated by dest. After calling this function dest will point to the position immediately after src. It is allowed for src and dest to point into different -sequences.

    +sequences. +

    iter :

    a GSequenceIter +a GSequenceIter

    data :

    the data for the new item +the data for the new item
    - - @@ -647,22 +645,23 @@ sequences.


    g_sequence_swap ()

    -
    void                g_sequence_swap                     (GSequenceIter *a,
    -                                                         GSequenceIter *b);
    +
    void                g_sequence_swap                     (GSequenceIter *a,
    +                                                         GSequenceIter *b);

    Swaps the items pointed to by a and b. It is allowed for a and b -to point into difference sequences.

    +to point into difference sequences. +

    src :

    a GSequenceIter pointing to the item to move +a GSequenceIter pointing to the item to move

    dest :

    a GSequenceIter pointing to the position to which +a GSequenceIter pointing to the position to which the item is moved.
    - - @@ -672,30 +671,31 @@ to point into difference sequences.


    g_sequence_insert_sorted ()

    -
    GSequenceIter *     g_sequence_insert_sorted            (GSequence *seq,
    -                                                         gpointer data,
    -                                                         GCompareDataFunc cmp_func,
    -                                                         gpointer cmp_data);
    +
    GSequenceIter *     g_sequence_insert_sorted            (GSequence *seq,
    +                                                         gpointer data,
    +                                                         GCompareDataFunc cmp_func,
    +                                                         gpointer cmp_data);

    Inserts data into sequence using func to determine the new position. The sequence must already be sorted according to cmp_func; otherwise the -new position of data is undefined.

    +new position of data is undefined. +

    a :

    a GSequenceIter +a GSequenceIter

    b :

    a GSequenceIter +a GSequenceIter
    - - - - @@ -720,30 +720,31 @@ new position of data is undefined.


    g_sequence_insert_sorted_iter ()

    -
    GSequenceIter *     g_sequence_insert_sorted_iter       (GSequence *seq,
    -                                                         gpointer data,
    -                                                         GSequenceIterCompareFunc iter_cmp,
    -                                                         gpointer cmp_data);
    +
    GSequenceIter *     g_sequence_insert_sorted_iter       (GSequence *seq,
    +                                                         gpointer data,
    +                                                         GSequenceIterCompareFunc iter_cmp,
    +                                                         gpointer cmp_data);

    Like g_sequence_insert_sorted(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as -the compare function.

    +the compare function. +

    seq :

    a GSequence +a GSequence

    data :

    the data to insert +the data to insert

    cmp_func :

    the GCompareDataFunc used to compare items in the sequence. It +the GCompareDataFunc used to compare items in the sequence. It is called with two items of the seq and user_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second @@ -704,7 +704,7 @@ new position of data is undefined.

    cmp_data :

    user data passed to cmp_func. +user data passed to cmp_func.
    - - - - @@ -768,25 +769,26 @@ the compare function.


    g_sequence_sort_changed ()

    -
    void                g_sequence_sort_changed             (GSequenceIter *iter,
    -                                                         GCompareDataFunc cmp_func,
    -                                                         gpointer cmp_data);
    +
    void                g_sequence_sort_changed             (GSequenceIter *iter,
    +                                                         GCompareDataFunc cmp_func,
    +                                                         gpointer cmp_data);

    Moves the data pointed to a new position as indicated by cmp_func. This function should be called for items in a sequence already sorted according to cmp_func whenever some aspect of an item changes so that cmp_func -may return different values for that item.

    +may return different values for that item. +

    seq :

    a GSequence +a GSequence

    data :

    data for the new item +data for the new item

    iter_cmp :

    the GSequenceItercompare used to compare iterators in the +the GSequenceItercompare used to compare iterators in the sequence. It is called with two iterators pointing into seq. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second @@ -752,7 +753,7 @@ the compare function.

    cmp_data :

    user data passed to cmp_func +user data passed to cmp_func
    - - - @@ -805,24 +807,25 @@ may return different values for that item.


    g_sequence_sort_changed_iter ()

    -
    void                g_sequence_sort_changed_iter        (GSequenceIter *iter,
    -                                                         GSequenceIterCompareFunc iter_cmp,
    -                                                         gpointer cmp_data);
    +
    void                g_sequence_sort_changed_iter        (GSequenceIter *iter,
    +                                                         GSequenceIterCompareFunc iter_cmp,
    +                                                         gpointer cmp_data);

    Like g_sequence_sort_changed(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as -the compare function.

    +the compare function. +

    iter :

    A GSequenceIter +A GSequenceIter

    cmp_func :

    the GCompareDataFunc used to compare items in the sequence. It +the GCompareDataFunc used to compare items in the sequence. It is called with two items of the seq and user_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second @@ -795,7 +797,7 @@ may return different values for that item.

    cmp_data :

    user data passed to cmp_func. +user data passed to cmp_func.
    - - - @@ -841,19 +844,20 @@ the compare function.


    g_sequence_remove ()

    -
    void                g_sequence_remove                   (GSequenceIter *iter);
    +
    void                g_sequence_remove                   (GSequenceIter *iter);

    Removes the item pointed to by iter. It is an error to pass the end iterator to this function.

    If the sequnce has a data destroy function associated with it, this -function is called on the data for the removed item.

    +function is called on the data for the removed item. +

    iter :

    a GSequenceIter +a GSequenceIter

    iter_cmp :

    the GSequenceItercompare used to compare iterators in the +the GSequenceItercompare used to compare iterators in the sequence. It is called with two iterators pointing into seq. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second @@ -831,7 +834,7 @@ the compare function.

    cmp_data :

    user data passed to cmp_func +user data passed to cmp_func
    -

    iter :

    a GSequenceIter +a GSequenceIter
    @@ -862,25 +866,26 @@ function is called on the data for the removed item.


    g_sequence_remove_range ()

    -
    void                g_sequence_remove_range             (GSequenceIter *begin,
    -                                                         GSequenceIter *end);
    +
    void                g_sequence_remove_range             (GSequenceIter *begin,
    +                                                         GSequenceIter *end);

    Removes all items in the (begin, end) range.

    If the sequence has a data destroy function associated with it, this -function is called on the data for the removed items.

    +function is called on the data for the removed items. +

    - - @@ -890,9 +895,9 @@ function is called on the data for the removed items.


    g_sequence_move_range ()

    -
    void                g_sequence_move_range               (GSequenceIter *dest,
    -                                                         GSequenceIter *begin,
    -                                                         GSequenceIter *end);
    +
    void                g_sequence_move_range               (GSequenceIter *dest,
    +                                                         GSequenceIter *begin,
    +                                                         GSequenceIter *end);

    Inserts the (begin, end) range at the destination pointed to by ptr. The begin and end iters must point into the same sequence. It is @@ -902,23 +907,24 @@ into by begin and

    If dest is NULL, the range indicated by begin and end is removed from the sequence. If dest iter points to a place within -the (begin, end) range, the range does not move.

    +the (begin, end) range, the range does not move. +

    begin :

    a GSequenceIter +a GSequenceIter

    end :

    a GSequenceIter +a GSequenceIter
    - - - @@ -928,29 +934,30 @@ the (begin,

    g_sequence_search ()

    -
    GSequenceIter *     g_sequence_search                   (GSequence *seq,
    -                                                         gpointer data,
    -                                                         GCompareDataFunc cmp_func,
    -                                                         gpointer cmp_data);
    +
    GSequenceIter *     g_sequence_search                   (GSequence *seq,
    +                                                         gpointer data,
    +                                                         GCompareDataFunc cmp_func,
    +                                                         gpointer cmp_data);

    Returns an iterator pointing to the position where data would -be inserted according to cmp_func and cmp_data.

    +be inserted according to cmp_func and cmp_data. +

    dest :

    a GSequenceIter +a GSequenceIter

    begin :

    a GSequenceIter +a GSequenceIter

    end :

    a GSequenceIter +a GSequenceIter
    - - - - @@ -976,30 +983,31 @@ would have been inserted according to cmp_func

    g_sequence_search_iter ()

    -
    GSequenceIter *     g_sequence_search_iter              (GSequence *seq,
    -                                                         gpointer data,
    -                                                         GSequenceIterCompareFunc iter_cmp,
    -                                                         gpointer cmp_data);
    +
    GSequenceIter *     g_sequence_search_iter              (GSequence *seq,
    +                                                         gpointer data,
    +                                                         GSequenceIterCompareFunc iter_cmp,
    +                                                         gpointer cmp_data);

    Like g_sequence_search(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as -the compare function.

    +the compare function. +

    seq :

    a GSequence +a GSequence

    data :

    data for the new item +data for the new item

    cmp_func :

    the GCompareDataFunc used to compare items in the sequence. It +the GCompareDataFunc used to compare items in the sequence. It is called with two items of the seq and user_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second @@ -959,7 +966,7 @@ be inserted according to cmp_func and

    cmp_data :

    user data passed to cmp_func. +user data passed to cmp_func.
    - - - - @@ -1025,15 +1033,16 @@ where data would have been inserted acco

    g_sequence_get ()

    -
    gpointer            g_sequence_get                      (GSequenceIter *iter);
    +
    gpointer            g_sequence_get                      (GSequenceIter *iter);

    -Returns the data that iter points to.

    +Returns the data that iter points to. +

    seq :

    a GSequence +a GSequence

    data :

    data for the new item +data for the new item

    iter_cmp :

    the GSequenceIterCompare function used to compare iterators +the GSequenceIterCompare function used to compare iterators in the sequence. It is called with two iterators pointing into seq. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the @@ -1008,7 +1016,7 @@ the compare function.

    cmp_data :

    user data passed to iter_cmp +user data passed to iter_cmp
    - @@ -1049,23 +1058,24 @@ Returns the data that iter points to.

    g_sequence_set ()

    -
    void                g_sequence_set                      (GSequenceIter *iter,
    -                                                         gpointer data);
    +
    void                g_sequence_set                      (GSequenceIter *iter,
    +                                                         gpointer data);

    Changes the data for the item pointed to by iter to be data. If the sequence has a data destroy function associated with it, that -function is called on the existing data that iter pointed to.

    +function is called on the existing data that iter pointed to. +

    iter :

    a GSequenceIter +a GSequenceIter
    - - @@ -1075,15 +1085,16 @@ function is called on the existing data that iter

    g_sequence_iter_is_begin ()

    -
    gboolean            g_sequence_iter_is_begin            (GSequenceIter *iter);
    +
    gboolean            g_sequence_iter_is_begin            (GSequenceIter *iter);

    -Returns whether iter is the begin iterator

    +Returns whether iter is the begin iterator +

    iter :

    a GSequenceIter +a GSequenceIter

    data :

    new data for the item +new data for the item
    - @@ -1099,15 +1110,16 @@ Returns whether iter is the begin iterat

    g_sequence_iter_is_end ()

    -
    gboolean            g_sequence_iter_is_end              (GSequenceIter *iter);
    +
    gboolean            g_sequence_iter_is_end              (GSequenceIter *iter);

    -Returns whether iter is the end iterator

    +Returns whether iter is the end iterator +

    iter :

    a GSequenceIter +a GSequenceIter
    - @@ -1123,16 +1135,17 @@ Returns whether iter is the end iterator

    g_sequence_iter_next ()

    -
    GSequenceIter *     g_sequence_iter_next                (GSequenceIter *iter);
    +
    GSequenceIter *     g_sequence_iter_next                (GSequenceIter *iter);

    Returns an iterator pointing to the next position after iter. If -iter is the end iterator, the end iterator is returned.

    +iter is the end iterator, the end iterator is returned. +

    iter :

    a GSequenceIter +a GSequenceIter
    - @@ -1148,16 +1161,17 @@ Returns an iterator pointing to the next position after

    g_sequence_iter_prev ()

    -
    GSequenceIter *     g_sequence_iter_prev                (GSequenceIter *iter);
    +
    GSequenceIter *     g_sequence_iter_prev                (GSequenceIter *iter);

    Returns an iterator pointing to the previous position before iter. If -iter is the begin iterator, the begin iterator is returned.

    +iter is the begin iterator, the begin iterator is returned. +

    iter :

    a GSequenceIter +a GSequenceIter
    - @@ -1174,15 +1188,16 @@ Returns an iterator pointing to the previous position before

    g_sequence_iter_get_position ()

    -
    gint                g_sequence_iter_get_position        (GSequenceIter *iter);
    +
    gint                g_sequence_iter_get_position        (GSequenceIter *iter);

    -Returns the position of iter

    +Returns the position of iter +

    iter :

    a GSequenceIter +a GSequenceIter
    - @@ -1198,24 +1213,25 @@ Returns the position of iter


    g_sequence_iter_move ()

    -
    GSequenceIter *     g_sequence_iter_move                (GSequenceIter *iter,
    -                                                         gint delta);
    +
    GSequenceIter *     g_sequence_iter_move                (GSequenceIter *iter,
    +                                                         gint delta);

    Returns the GSequenceIter which is delta positions away from iter. If iter is closer than -delta positions to the beginning of the sequence, the begin iterator is returned. If iter is closer than delta positions -to the end of the sequence, the end iterator is returned.

    +to the end of the sequence, the end iterator is returned. +

    iter :

    a GSequenceIter +a GSequenceIter
    - - @@ -1232,15 +1248,16 @@ to the end of the sequence, the end iterator is returned.


    g_sequence_iter_get_sequence ()

    -
    GSequence *         g_sequence_iter_get_sequence        (GSequenceIter *iter);
    +
    GSequence *         g_sequence_iter_get_sequence        (GSequenceIter *iter);

    -Returns the GSequence that iter points into.

    +Returns the GSequence that iter points into. +

    iter :

    a GSequenceIter +a GSequenceIter

    delta :

    A positive or negative number indicating how many positions away +A positive or negative number indicating how many positions away from iter the returned GSequenceIter will be.
    - @@ -1256,25 +1273,26 @@ Returns the

    g_sequence_iter_compare ()

    -
    gint                g_sequence_iter_compare             (GSequenceIter *a,
    -                                                         GSequenceIter *b);
    +
    gint                g_sequence_iter_compare             (GSequenceIter *a,
    +                                                         GSequenceIter *b);

    Returns a negative number if a comes before b, 0 if they are equal, and a positive number if a comes after b.

    -The a and b iterators must point into the same sequence.

    +The a and b iterators must point into the same sequence. +

    iter :

    a GSequenceIter +a GSequenceIter
    - - @@ -1291,8 +1309,8 @@ equal, and a positive number if a comes

    g_sequence_range_get_midpoint ()

    -
    GSequenceIter *     g_sequence_range_get_midpoint       (GSequenceIter *begin,
    -                                                         GSequenceIter *end);
    +
    GSequenceIter *     g_sequence_range_get_midpoint       (GSequenceIter *begin,
    +                                                         GSequenceIter *end);

    Finds an iterator somewhere in the range (begin, end). This iterator will be close to the middle of the range, but is not @@ -1300,18 +1318,19 @@ guaranteed to be exactly in the middle.

    The begin and end iterators must both point to the same sequence and -begin must come before or be equal to end in the sequence.

    +begin must come before or be equal to end in the sequence. +

    a :

    a GSequenceIter +a GSequenceIter

    b :

    a GSequenceIter +a GSequenceIter
    - - @@ -1329,6 +1348,6 @@ The begin and + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Shell-related-Utilities.html b/docs/reference/glib/html/glib-Shell-related-Utilities.html index f01a3e9..de33583 100644 --- a/docs/reference/glib/html/glib-Shell-related-Utilities.html +++ b/docs/reference/glib/html/glib-Shell-related-Utilities.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    begin :

    a GSequenceIter +a GSequenceIter

    end :

    a GSequenceIter +a GSequenceIter
    @@ -62,13 +42,13 @@ enum GShellError; #define G_SHELL_ERROR -gboolean g_shell_parse_argv (const gchar *command_line, - gint *argcp, - gchar ***argvp, - GError **error); -gchar* g_shell_quote (const gchar *unquoted_string); -gchar* g_shell_unquote (const gchar *quoted_string, - GError **error); +gboolean g_shell_parse_argv (const gchar *command_line, + gint *argcp, + gchar ***argvp, + GError **error); +gchar* g_shell_quote (const gchar *unquoted_string); +gchar* g_shell_unquote (const gchar *quoted_string, + GError **error);
    @@ -88,23 +68,24 @@ enum
    - - - @@ -118,15 +99,16 @@ Error codes returned by shell functions.

    Error domain for shell functions. Errors in this domain will be from the GShellError enumeration. See GError for information on error -domains.

    +domains. +


    g_shell_parse_argv ()

    -
    gboolean            g_shell_parse_argv                  (const gchar *command_line,
    -                                                         gint *argcp,
    -                                                         gchar ***argvp,
    -                                                         GError **error);
    +
    gboolean            g_shell_parse_argv                  (const gchar *command_line,
    +                                                         gint *argcp,
    +                                                         gchar ***argvp,
    +                                                         GError **error);

    Parses a command line into an argument vector, in much the same way the shell would, but without many of the expansions the shell would @@ -136,28 +118,29 @@ those you would get from a UNIX98 /bin/sh, as long as the input contains none of the unsupported shell expansions. If the input does contain such expansions, they are passed through literally. Possible errors are those from the G_SHELL_ERROR -domain. Free the returned vector with g_strfreev().

    +domain. Free the returned vector with g_strfreev(). +

    G_SHELL_ERROR_BAD_QUOTING

    Mismatched or otherwise mangled quoting. +Mismatched or otherwise mangled quoting.

    G_SHELL_ERROR_EMPTY_STRING

    String to be parsed was empty. +String to be parsed was empty.

    G_SHELL_ERROR_FAILED

    Some other error. +Some other error.
    - - - - @@ -171,20 +154,21 @@ domain. Free the returned vector with

    g_shell_quote ()

    -
    gchar*              g_shell_quote                       (const gchar *unquoted_string);
    +
    gchar*              g_shell_quote                       (const gchar *unquoted_string);

    Quotes a string so that the shell (/bin/sh) will interpret the quoted string to mean unquoted_string. If you pass a filename to the shell, for example, you should first quote it with this function. The return value must be freed with g_free(). The quoting style used is undefined (single or double quotes may be -used).

    +used). +

    command_line :

    command line to parse +command line to parse

    argcp :

    return location for number of args +return location for number of args

    argvp :

    return location for array of args +return location for array of args

    error :

    return location for error +return location for error
    - @@ -198,8 +182,8 @@ used).


    g_shell_unquote ()

    -
    gchar*              g_shell_unquote                     (const gchar *quoted_string,
    -                                                         GError **error);
    +
    gchar*              g_shell_unquote                     (const gchar *quoted_string,
    +                                                         GError **error);

    Unquotes a string as the shell (/bin/sh) would. Only handles quotes; if a string contains file globs, arithmetic operators, @@ -222,18 +206,19 @@ literal string exactly. escape sequences are not allowed; not even \' - if you want a ' in the quoted text, you have to do something like 'foo'\''bar'. Double quotes allow $, `, ", \, and newline to be escaped with backslash. Otherwise double quotes preserve things -literally.

    +literally. +

    unquoted_string :

    a literal string +a literal string
    - - @@ -248,6 +233,6 @@ literally.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Simple-XML-Subset-Parser.html b/docs/reference/glib/html/glib-Simple-XML-Subset-Parser.html index e61d604..2a5eee9 100644 --- a/docs/reference/glib/html/glib-Simple-XML-Subset-Parser.html +++ b/docs/reference/glib/html/glib-Simple-XML-Subset-Parser.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    quoted_string :

    shell-quoted string +shell-quoted string

    error :

    error return location or NULL +error return location or NULL
    @@ -65,44 +45,44 @@ enum GMarkupParseFlags; GMarkupParseContext; GMarkupParser; -gchar* g_markup_escape_text (const gchar *text, - gssize length); -gchar * g_markup_printf_escaped (const char *format, - ...); -gchar * g_markup_vprintf_escaped (const char *format, - va_list args); -gboolean g_markup_parse_context_end_parse (GMarkupParseContext *context, - GError **error); -void g_markup_parse_context_free (GMarkupParseContext *context); -void g_markup_parse_context_get_position (GMarkupParseContext *context, - gint *line_number, - gint *char_number); -const gchar * g_markup_parse_context_get_element (GMarkupParseContext *context); +gchar* g_markup_escape_text (const gchar *text, + gssize length); +gchar * g_markup_printf_escaped (const char *format, + ...); +gchar * g_markup_vprintf_escaped (const char *format, + va_list args); +gboolean g_markup_parse_context_end_parse (GMarkupParseContext *context, + GError **error); +void g_markup_parse_context_free (GMarkupParseContext *context); +void g_markup_parse_context_get_position (GMarkupParseContext *context, + gint *line_number, + gint *char_number); +const gchar * g_markup_parse_context_get_element (GMarkupParseContext *context); const GSList * g_markup_parse_context_get_element_stack - (GMarkupParseContext *context); + (GMarkupParseContext *context); gpointer g_markup_parse_context_get_user_data - (GMarkupParseContext *context); -GMarkupParseContext * g_markup_parse_context_new (const GMarkupParser *parser, - GMarkupParseFlags flags, - gpointer user_data, - GDestroyNotify user_data_dnotify); -gboolean g_markup_parse_context_parse (GMarkupParseContext *context, - const gchar *text, - gssize text_len, - GError **error); -void g_markup_parse_context_push (GMarkupParseContext *context, - GMarkupParser *parser, - gpointer user_data); -gpointer g_markup_parse_context_pop (GMarkupParseContext *context); + (GMarkupParseContext *context); +GMarkupParseContext * g_markup_parse_context_new (const GMarkupParser *parser, + GMarkupParseFlags flags, + gpointer user_data, + GDestroyNotify user_data_dnotify); +gboolean g_markup_parse_context_parse (GMarkupParseContext *context, + const gchar *text, + gssize text_len, + GError **error); +void g_markup_parse_context_push (GMarkupParseContext *context, + GMarkupParser *parser, + gpointer user_data); +gpointer g_markup_parse_context_pop (GMarkupParseContext *context); enum GMarkupCollectType; -gboolean g_markup_collect_attributes (const gchar *element_name, - const gchar **attribute_names, - const gchar **attribute_values, - GError **error, - GMarkupCollectType first_type, - const gchar *first_attr, - ...); +gboolean g_markup_collect_attributes (const gchar *element_name, + const gchar **attribute_names, + const gchar **attribute_values, + GError **error, + GMarkupCollectType first_type, + const gchar *first_attr, + ...);
    @@ -390,8 +370,8 @@ from these callbacks. If you set an error from a callback,

    g_markup_escape_text ()

    -
    gchar*              g_markup_escape_text                (const gchar *text,
    -                                                         gssize length);
    +
    gchar*              g_markup_escape_text                (const gchar *text,
    +                                                         gssize length);

    Escapes text so that the markup parser will parse it verbatim. Less than, greater than, ampersand, etc. are replaced with the @@ -409,18 +389,19 @@ will produce character references in the range of &x1x1f; for all control sequences except for tabstop, newline and carriage return. The character references in this range are not valid XML 1.0, but they are valid XML 1.1 and will be accepted -by the GMarkup parser.

    +by the GMarkup parser. +

    - - @@ -434,8 +415,8 @@ by the GMarkup parser.


    g_markup_printf_escaped ()

    -
    gchar *             g_markup_printf_escaped             (const char *format,
    -                                                         ...);
    +
    gchar *             g_markup_printf_escaped             (const char *format,
    +                                                         ...);

    Formats arguments according to format, escaping all string and character arguments in the fashion @@ -446,28 +427,46 @@ might themselves contain markup.

    -
    -const char *store = "Fortnum & Mason";
    -const char *item = "Tea";
    -char *output;
    - 
    -output = g_markup_printf_escaped ("<purchase>"
    -                                  "<store>%s</store>"
    -                                  "<item>%s</item>"
    -                                  "</purchase>",
    -                                  store, item);
    -
    +
    +

    text :

    some valid UTF-8 text +some valid UTF-8 text

    length :

    length of text in bytes, or -1 if the text is nul-terminated +length of text in bytes, or -1 if the text is nul-terminated
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    const char *store = "Fortnum & Mason";
    +const char *item = "Tea";
    +char *output;
    + 
    +output = g_markup_printf_escaped ("<purchase>"
    +                                  "<store>%s</store>"
    +                                  "<item>%s</item>"
    +                                  "</purchase>",
    +                                  store, item);
    +
    + +

    +

    - - @@ -484,23 +483,24 @@ output = g_markup_printf_escaped ("<purchase>"

    g_markup_vprintf_escaped ()

    -
    gchar *             g_markup_vprintf_escaped            (const char *format,
    -                                                         va_list args);
    +
    gchar *             g_markup_vprintf_escaped            (const char *format,
    +                                                         va_list args);

    Formats the data in args according to format, escaping all string and character arguments in the fashion -of g_markup_escape_text(). See g_markup_printf_escaped().

    +of g_markup_escape_text(). See g_markup_printf_escaped(). +

    format :

    printf() style format string +printf() style format string

    ... :

    the arguments to insert in the format string +the arguments to insert in the format string
    - - @@ -517,24 +517,25 @@ of

    g_markup_parse_context_end_parse ()

    -
    gboolean            g_markup_parse_context_end_parse    (GMarkupParseContext *context,
    -                                                         GError **error);
    +
    gboolean            g_markup_parse_context_end_parse    (GMarkupParseContext *context,
    +                                                         GError **error);

    Signals to the GMarkupParseContext that all data has been fed into the parse context with g_markup_parse_context_parse(). This function reports an error if the document isn't complete, -for example if elements are still open.

    +for example if elements are still open. +

    format :

    printf() style format string +printf() style format string

    args :

    variable argument list, similar to vprintf() +variable argument list, similar to vprintf()
    - - @@ -548,16 +549,17 @@ for example if elements are still open.


    g_markup_parse_context_free ()

    -
    void                g_markup_parse_context_free         (GMarkupParseContext *context);
    +
    void                g_markup_parse_context_free         (GMarkupParseContext *context);

    Frees a GMarkupParseContext. Can't be called from inside one of the GMarkupParser functions. Can't be called while -a subparser is pushed.

    +a subparser is pushed. +

    context :

    a GMarkupParseContext +a GMarkupParseContext

    error :

    return location for a GError +return location for a GError
    -

    context :

    a GMarkupParseContext +a GMarkupParseContext
    @@ -565,30 +567,31 @@ a subparser is pushed.


    g_markup_parse_context_get_position ()

    -
    void                g_markup_parse_context_get_position (GMarkupParseContext *context,
    -                                                         gint *line_number,
    -                                                         gint *char_number);
    +
    void                g_markup_parse_context_get_position (GMarkupParseContext *context,
    +                                                         gint *line_number,
    +                                                         gint *char_number);

    Retrieves the current line number and the number of the character on that line. Intended for use in error messages; there are no strict semantics for what constitutes the "current" line number other than -"the best number we could come up with for error messages."

    +"the best number we could come up with for error messages." +

    - - - @@ -597,25 +600,26 @@ semantics for what constitutes the "current" line number other than

    g_markup_parse_context_get_element ()

    -
    const gchar *       g_markup_parse_context_get_element  (GMarkupParseContext *context);
    +
    const gchar *       g_markup_parse_context_get_element  (GMarkupParseContext *context);

    Retrieves the name of the currently open element.

    If called from the start_element or end_element handlers this will give the element_name as passed to those functions. For the parent -elements, see g_markup_parse_context_get_element_stack().

    +elements, see g_markup_parse_context_get_element_stack(). +

    context :

    a GMarkupParseContext +a GMarkupParseContext

    line_number :

    return location for a line number, or NULL +return location for a line number, or NULL

    char_number :

    return location for a char-on-line number, or NULL +return location for a char-on-line number, or NULL
    - - @@ -626,7 +630,7 @@ elements, see

    g_markup_parse_context_get_element_stack ()

    const GSList *      g_markup_parse_context_get_element_stack
    -                                                        (GMarkupParseContext *context);
    + (GMarkupParseContext *context);

    Retrieves the element stack from the internal state of the parser. The returned GSList is a list of strings where the first item is @@ -638,13 +642,14 @@ immediate parent. This function is intended to be used in the start_element and end_element handlers where g_markup_parse_context_get_element() would merely return the name of the element that is being -processed.

    +processed. +

    context :

    a GMarkupParseContext +a GMarkupParseContext

    Returns :

    the name of the currently open element, or NULL +the name of the currently open element, or NULL
    - @@ -661,17 +666,18 @@ processed.

    g_markup_parse_context_get_user_data ()

    gpointer            g_markup_parse_context_get_user_data
    -                                                        (GMarkupParseContext *context);
    + (GMarkupParseContext *context);

    Returns the user_data associated with context. This will either be the user_data that was provided to g_markup_parse_context_new() -or to the most recent call of g_markup_parse_context_push().

    +or to the most recent call of g_markup_parse_context_push(). +

    context :

    a GMarkupParseContext +a GMarkupParseContext
    - @@ -689,37 +695,38 @@ or to the most recent call of

    g_markup_parse_context_new ()

    -
    GMarkupParseContext * g_markup_parse_context_new        (const GMarkupParser *parser,
    -                                                         GMarkupParseFlags flags,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify user_data_dnotify);
    +
    GMarkupParseContext * g_markup_parse_context_new        (const GMarkupParser *parser,
    +                                                         GMarkupParseFlags flags,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify user_data_dnotify);

    Creates a new parse context. A parse context is used to parse marked-up documents. You can feed any number of documents into a context, as long as no errors occur; once an error occurs, the parse context can't continue to parse text (you have to free it -and create a new parse context).

    +and create a new parse context). +

    context :

    a GMarkupParseContext +a GMarkupParseContext
    - - - - @@ -733,10 +740,10 @@ and create a new parse context).


    g_markup_parse_context_parse ()

    -
    gboolean            g_markup_parse_context_parse        (GMarkupParseContext *context,
    -                                                         const gchar *text,
    -                                                         gssize text_len,
    -                                                         GError **error);
    +
    gboolean            g_markup_parse_context_parse        (GMarkupParseContext *context,
    +                                                         const gchar *text,
    +                                                         gssize text_len,
    +                                                         GError **error);

    Feed some data to the GMarkupParseContext. The data need not be valid UTF-8; an error will be signaled if it's invalid. @@ -745,28 +752,29 @@ into the parser incrementally, via multiple calls to this function. Typically, as you receive data from a network connection or file, you feed each received chunk of data into this function, aborting the process if an error occurs. Once an error is reported, no further -data may be fed to the GMarkupParseContext; all errors are fatal.

    +data may be fed to the GMarkupParseContext; all errors are fatal. +

    parser :

    a GMarkupParser +a GMarkupParser

    flags :

    one or more GMarkupParseFlags +one or more GMarkupParseFlags

    user_data :

    user data to pass to GMarkupParser functions +user data to pass to GMarkupParser functions

    user_data_dnotify :

    user data destroy notifier called when the parse context is freed +user data destroy notifier called when the parse context is freed
    - - - - @@ -780,9 +788,9 @@ data may be fed to the

    g_markup_parse_context_push ()

    -
    void                g_markup_parse_context_push         (GMarkupParseContext *context,
    -                                                         GMarkupParser *parser,
    -                                                         gpointer user_data);
    +
    void                g_markup_parse_context_push         (GMarkupParseContext *context,
    +                                                         GMarkupParser *parser,
    +                                                         gpointer user_data);

    Temporarily redirects markup data to a sub-parser.

    @@ -821,44 +829,87 @@ parser that counts the number of tags encountered.

    -
    -typedef struct
    -{
    -  gint tag_count;
    -} CounterData;
    +
    +

    context :

    a GMarkupParseContext +a GMarkupParseContext

    text :

    chunk of text to parse +chunk of text to parse

    text_len :

    length of text in bytes +length of text in bytes

    error :

    return location for a GError +return location for a GError
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    +35
    +36
    typedef struct
    +{
    +  gint tag_count;
    +} CounterData;
     
    -static void
    -counter_start_element (GMarkupParseContext  *context,
    -                       const gchar          *element_name,
    -                       const gchar         **attribute_names,
    -                       const gchar         **attribute_values,
    -                       gpointer              user_data,
    -                       GError              **error)
    -{
    -  CounterData *data = user_data;
    +static void
    +counter_start_element (GMarkupParseContext  *context,
    +                       const gchar          *element_name,
    +                       const gchar         **attribute_names,
    +                       const gchar         **attribute_values,
    +                       gpointer              user_data,
    +                       GError              **error)
    +{
    +  CounterData *data = user_data;
     
    -  data->tag_count++;
    -}
    +  data->tag_count++;
    +}
     
    -static void
    -counter_error (GMarkupParseContext *context,
    -               GError              *error,
    -               gpointer             user_data)
    -{
    -  CounterData *data = user_data;
    +static void
    +counter_error (GMarkupParseContext *context,
    +               GError              *error,
    +               gpointer             user_data)
    +{
    +  CounterData *data = user_data;
     
    -  g_slice_free (CounterData, data);
    -}
    +  g_slice_free (CounterData, data);
    +}
    +
    +static GMarkupParser counter_subparser =
    +{
    +  counter_start_element,
    +  NULL,
    +  NULL,
    +  NULL,
    +  counter_error
    +};
    +
    -static GMarkupParser counter_subparser = -{ - counter_start_element, - NULL, - NULL, - NULL, - counter_error -}; -

    @@ -867,28 +918,55 @@ following interface is provided:

    -
    -void
    -start_counting (GMarkupParseContext *context)
    -{
    -  CounterData *data = g_slice_new (CounterData);
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    void
    +start_counting (GMarkupParseContext *context)
    +{
    +  CounterData *data = g_slice_new (CounterData);
     
    -  data->tag_count = 0;
    -  g_markup_parse_context_push (context, &counter_subparser, data);
    -}
    +  data->tag_count = 0;
    +  g_markup_parse_context_push (context, &counter_subparser, data);
    +}
     
    -gint
    -end_counting (GMarkupParseContext *context)
    -{
    -  CounterData *data = g_markup_parse_context_pop (context);
    -  int result;
    +gint
    +end_counting (GMarkupParseContext *context)
    +{
    +  CounterData *data = g_markup_parse_context_pop (context);
    +  int result;
     
    -  result = data->tag_count;
    -  g_slice_free (CounterData, data);
    +  result = data->tag_count;
    +  g_slice_free (CounterData, data);
    +
    +  return result;
    +}
    +
    - return result; -} -

    @@ -896,39 +974,63 @@ The subparser would then be used as follows:

    -
    -static void start_element (context, element_name, ...)
    -{
    -  if (strcmp (element_name, "count-these") == 0)
    -    start_counting (context);
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    static void start_element (context, element_name, ...)
    +{
    +  if (strcmp (element_name, "count-these") == 0)
    +    start_counting (context);
     
    -  /* else, handle other tags... */
    -}
    +  /* else, handle other tags... */
    +}
     
    -static void end_element (context, element_name, ...)
    -{
    -  if (strcmp (element_name, "count-these") == 0)
    -    g_print ("Counted %d tags\n", end_counting (context));
    +static void end_element (context, element_name, ...)
    +{
    +  if (strcmp (element_name, "count-these") == 0)
    +    g_print ("Counted %d tags\n", end_counting (context));
     
    -  /* else, handle other tags... */
    -}
    -
    + /* else, handle other tags... */ +}
    +
    + +

    +

    - - - @@ -938,7 +1040,7 @@ static void end_element (context, element_name, ...)

    g_markup_parse_context_pop ()

    -
    gpointer            g_markup_parse_context_pop          (GMarkupParseContext *context);
    +
    gpointer            g_markup_parse_context_pop          (GMarkupParseContext *context);

    Completes the process of a temporary sub-parser redirection.

    @@ -954,13 +1056,14 @@ must not call this function from the error callback -- the This function is not intended to be directly called by users interested in invoking subparsers. Instead, it is intended to be used by the subparsers themselves to implement a higher-level -interface.

    +interface. +

    context :

    a GMarkupParseContext +a GMarkupParseContext

    parser :

    a GMarkupParser +a GMarkupParser

    user_data :

    user data to pass to GMarkupParser functions +user data to pass to GMarkupParser functions
    - @@ -995,19 +1098,20 @@ optionally bitwise OR the type with the flag

    It is likely that this enum will be extended in the future to -support other types.

    +support other types. +

    context :

    a GMarkupParseContext +a GMarkupParseContext
    - - - - - -

    G_MARKUP_COLLECT_INVALID

    used to terminate the list of attributes +used to terminate the list of attributes to collect.

    G_MARKUP_COLLECT_STRING

    collect the string pointer directly from +collect the string pointer directly from the attribute_values[] array. Expects a parameter of type (const char **). If G_MARKUP_COLLECT_OPTIONAL is specified @@ -1017,7 +1121,7 @@ support other types.

    G_MARKUP_COLLECT_STRDUP

    as with G_MARKUP_COLLECT_STRING, but +as with G_MARKUP_COLLECT_STRING, but expects a parameter of type (char **) and g_strdup()s the returned pointer. The pointer must be freed with g_free(). @@ -1025,7 +1129,7 @@ support other types.

    G_MARKUP_COLLECT_BOOLEAN

    expects a parameter of type (gboolean *) +expects a parameter of type (gboolean *) and parses the attribute value as a boolean. Sets FALSE if the attribute isn't present. Valid boolean values @@ -1036,7 +1140,7 @@ support other types.

    G_MARKUP_COLLECT_TRISTATE

    as with G_MARKUP_COLLECT_BOOLEAN, but +as with G_MARKUP_COLLECT_BOOLEAN, but in the case of a missing attribute a value is set that compares equal to neither FALSE nor TRUE. @@ -1045,7 +1149,7 @@ support other types.

    G_MARKUP_COLLECT_OPTIONAL

    can be bitwise ORed with the other +can be bitwise ORed with the other fields. If present, allows the attribute not to appear. A default value is set depending on what value @@ -1058,13 +1162,13 @@ support other types.


    g_markup_collect_attributes ()

    -
    gboolean            g_markup_collect_attributes         (const gchar *element_name,
    -                                                         const gchar **attribute_names,
    -                                                         const gchar **attribute_values,
    -                                                         GError **error,
    -                                                         GMarkupCollectType first_type,
    -                                                         const gchar *first_attr,
    -                                                         ...);
    +
    gboolean            g_markup_collect_attributes         (const gchar *element_name,
    +                                                         const gchar **attribute_names,
    +                                                         const gchar **attribute_values,
    +                                                         GError **error,
    +                                                         GMarkupCollectType first_type,
    +                                                         const gchar *first_attr,
    +                                                         ...);

    Collects the attributes of the element from the data passed to the GMarkupParser start_element @@ -1112,44 +1216,45 @@ This function deals with issuing errors for missing attributes attributes (of type G_MARKUP_ERROR_INVALID_CONTENT) as well as parse errors for boolean-valued attributes (again of type G_MARKUP_ERROR_INVALID_CONTENT). In all of these cases FALSE -will be returned and error will be set as appropriate.

    +will be returned and error will be set as appropriate. +

    - - - - - - -

    element_name :

    the current tag name +the current tag name

    attribute_names :

    the attribute names +the attribute names

    attribute_values :

    the attribute values +the attribute values

    error :

    a pointer to a GError or NULL +a pointer to a GError or NULL

    first_type :

    the GMarkupCollectType of the +the GMarkupCollectType of the first attribute

    first_attr :

    the name of the first attribute +the name of the first attribute

    ... :

    a pointer to the storage location of the +a pointer to the storage location of the first attribute (or NULL), followed by more types names and pointers, ending with G_MARKUP_COLLECT_INVALID. @@ -1173,6 +1278,6 @@ will be returned and error will be set a + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Singly-Linked-Lists.html b/docs/reference/glib/html/glib-Singly-Linked-Lists.html index 0bfbde9..eff776b 100644 --- a/docs/reference/glib/html/glib-Singly-Linked-Lists.html +++ b/docs/reference/glib/html/glib-Singly-Linked-Lists.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -64,69 +44,69 @@ GSList; -GSList* g_slist_alloc (void); -GSList* g_slist_append (GSList *list, - gpointer data); -GSList* g_slist_prepend (GSList *list, - gpointer data); -GSList* g_slist_insert (GSList *list, - gpointer data, - gint position); -GSList* g_slist_insert_before (GSList *slist, - GSList *sibling, - gpointer data); -GSList* g_slist_insert_sorted (GSList *list, - gpointer data, - GCompareFunc func); -GSList* g_slist_remove (GSList *list, - gconstpointer data); -GSList* g_slist_remove_link (GSList *list, - GSList *link_); -GSList* g_slist_delete_link (GSList *list, - GSList *link_); -GSList* g_slist_remove_all (GSList *list, - gconstpointer data); -voidg_slist_free (GSList *list); -voidg_slist_free_1 (GSList *list); +GSList* g_slist_alloc (void); +GSList* g_slist_append (GSList *list, + gpointer data); +GSList* g_slist_prepend (GSList *list, + gpointer data); +GSList* g_slist_insert (GSList *list, + gpointer data, + gint position); +GSList* g_slist_insert_before (GSList *slist, + GSList *sibling, + gpointer data); +GSList* g_slist_insert_sorted (GSList *list, + gpointer data, + GCompareFunc func); +GSList* g_slist_remove (GSList *list, + gconstpointer data); +GSList* g_slist_remove_link (GSList *list, + GSList *link_); +GSList* g_slist_delete_link (GSList *list, + GSList *link_); +GSList* g_slist_remove_all (GSList *list, + gconstpointer data); +voidg_slist_free (GSList *list); +voidg_slist_free_1 (GSList *list); #define g_slist_free1 -guintg_slist_length (GSList *list); -GSList* g_slist_copy (GSList *list); -GSList* g_slist_reverse (GSList *list); -GSList* g_slist_insert_sorted_with_data (GSList *list, - gpointer data, - GCompareDataFunc func, - gpointer user_data); -GSList* g_slist_sort (GSList *list, - GCompareFunc compare_func); -GSList* g_slist_sort_with_data (GSList *list, - GCompareDataFunc compare_func, - gpointer user_data); -GSList* g_slist_concat (GSList *list1, - GSList *list2); -voidg_slist_foreach (GSList *list, - GFunc func, - gpointer user_data); +guintg_slist_length (GSList *list); +GSList* g_slist_copy (GSList *list); +GSList* g_slist_reverse (GSList *list); +GSList* g_slist_insert_sorted_with_data (GSList *list, + gpointer data, + GCompareDataFunc func, + gpointer user_data); +GSList* g_slist_sort (GSList *list, + GCompareFunc compare_func); +GSList* g_slist_sort_with_data (GSList *list, + GCompareDataFunc compare_func, + gpointer user_data); +GSList* g_slist_concat (GSList *list1, + GSList *list2); +voidg_slist_foreach (GSList *list, + GFunc func, + gpointer user_data); -GSList* g_slist_last (GSList *list); +GSList* g_slist_last (GSList *list); #define g_slist_next (slist) -GSList* g_slist_nth (GSList *list, - guint n); -gpointerg_slist_nth_data (GSList *list, - guint n); +GSList* g_slist_nth (GSList *list, + guint n); +gpointerg_slist_nth_data (GSList *list, + guint n); -GSList* g_slist_find (GSList *list, - gconstpointer data); -GSList* g_slist_find_custom (GSList *list, - gconstpointer data, - GCompareFunc func); -gintg_slist_position (GSList *list, - GSList *llink); -gintg_slist_index (GSList *list, - gconstpointer data); +GSList* g_slist_find (GSList *list, + gconstpointer data); +GSList* g_slist_find_custom (GSList *list, + gconstpointer data, + GCompareFunc func); +gintg_slist_position (GSList *list, + GSList *llink); +gintg_slist_index (GSList *list, + gconstpointer data); -voidg_slist_push_allocator (gpointer dummy); -voidg_slist_pop_allocator (void); +voidg_slist_push_allocator (gpointer dummy); +voidg_slist_pop_allocator (void);
    @@ -181,7 +161,8 @@ To call a function for each element in the list use g_slist_foreach().

    -To free the entire list, use g_slist_free().

    +To free the entire list, use g_slist_free(). +

    Details

    @@ -194,20 +175,21 @@ To free the entire list, use GSList struct is used for each element in the singly-linked -list.

    +list. +

    - - @@ -216,16 +198,17 @@ list.


    g_slist_alloc ()

    -
    GSList*             g_slist_alloc                       (void);
    +
    GSList*             g_slist_alloc                       (void);

    Allocates space for one GSList element. It is called by the g_slist_append(), g_slist_prepend(), g_slist_insert() and -g_slist_insert_sorted() functions and so is rarely used on its own.

    +g_slist_insert_sorted() functions and so is rarely used on its own. +

    gpointer data;

    holds the element's data, which can be a pointer to any kind +holds the element's data, which can be a pointer to any kind of data, or any integer value using the Type Conversion Macros.

    GSList *next;

    contains the link to the next element in the list. +contains the link to the next element in the list.
    -

    Returns :

    a pointer to the newly-allocated GSList element. +a pointer to the newly-allocated GSList element.
    @@ -233,8 +216,8 @@ Allocates space for one

    g_slist_append ()

    -
    GSList*             g_slist_append                      (GSList *list,
    -                                                         gpointer data);
    +
    GSList*             g_slist_append                      (GSList *list,
    +                                                         gpointer data);

    Adds a new element on to the end of the list.

    @@ -264,29 +247,48 @@ the elements and reverse the list when all elements have been added.

    -
    -/* Notice that these are initialized to the empty list. */
    -GSList *list = NULL, *number_list = NULL;
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    /* Notice that these are initialized to the empty list. */
    +GSList *list = NULL, *number_list = NULL;
     
    -/* This is a list of strings. */
    -list = g_slist_append (list, "first");
    -list = g_slist_append (list, "second");
    +/* This is a list of strings. */
    +list = g_slist_append (list, "first");
    +list = g_slist_append (list, "second");
     
    -/* This is a list of integers. */
    -number_list = g_slist_append (number_list, GINT_TO_POINTER (27));
    -number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
    -
    +/* This is a list of integers. */ +number_list = g_slist_append (number_list, GINT_TO_POINTER (27)); +number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
    +
    + +

    +

    - - @@ -300,8 +302,8 @@ number_list = g_slist_append (number_list, GINT_TO_POINTER (14));

    g_slist_prepend ()

    -
    GSList*             g_slist_prepend                     (GSList *list,
    -                                                         gpointer data);
    +
    GSList*             g_slist_prepend                     (GSList *list,
    +                                                         gpointer data);

    Adds a new element on to the start of the list.

    @@ -318,23 +320,36 @@ may have changed, so make sure you store the new value.

    -
    -/* Notice that it is initialized to the empty list. */
    -GSList *list = NULL;
    -list = g_slist_prepend (list, "last");
    -list = g_slist_prepend (list, "first");
    -
    +
    +

    list :

    a GSList +a GSList

    data :

    the data for the new element +the data for the new element
    + + + + + + +
    1
    +2
    +3
    +4
    /* Notice that it is initialized to the empty list. */
    +GSList *list = NULL;
    +list = g_slist_prepend (list, "last");
    +list = g_slist_prepend (list, "first");
    +
    + +

    +

    - - @@ -348,27 +363,28 @@ list = g_slist_prepend (list, "first");

    g_slist_insert ()

    -
    GSList*             g_slist_insert                      (GSList *list,
    -                                                         gpointer data,
    -                                                         gint position);
    +
    GSList*             g_slist_insert                      (GSList *list,
    +                                                         gpointer data,
    +                                                         gint position);

    -Inserts a new element into the list at the given position.

    +Inserts a new element into the list at the given position. +

    list :

    a GSList +a GSList

    data :

    the data for the new element +the data for the new element
    - - -

    list :

    a GSList +a GSList

    data :

    the data for the new element +the data for the new element

    position :

    the position to insert the element. +the position to insert the element. If this is negative, or is larger than the number of elements in the list, the new element is added on to the end of the list. @@ -385,27 +401,28 @@ Inserts a new element into the list at the given position.


    g_slist_insert_before ()

    -
    GSList*             g_slist_insert_before               (GSList *slist,
    -                                                         GSList *sibling,
    -                                                         gpointer data);
    +
    GSList*             g_slist_insert_before               (GSList *slist,
    +                                                         GSList *sibling,
    +                                                         gpointer data);

    -Inserts a node before sibling containing data.

    +Inserts a node before sibling containing data. +

    - - - @@ -419,28 +436,29 @@ Inserts a node before sibling containing

    g_slist_insert_sorted ()

    -
    GSList*             g_slist_insert_sorted               (GSList *list,
    -                                                         gpointer data,
    -                                                         GCompareFunc func);
    +
    GSList*             g_slist_insert_sorted               (GSList *list,
    +                                                         gpointer data,
    +                                                         GCompareFunc func);

    Inserts a new element into the list, using the given -comparison function to determine its position.

    +comparison function to determine its position. +

    slist :

    a GSList +a GSList

    sibling :

    node to insert data before +node to insert data before

    data :

    data to put in the newly-inserted node +data to put in the newly-inserted node
    - - - @@ -456,23 +474,24 @@ comparison function to determine its position.


    g_slist_remove ()

    -
    GSList*             g_slist_remove                      (GSList *list,
    -                                                         gconstpointer data);
    +
    GSList*             g_slist_remove                      (GSList *list,
    +                                                         gconstpointer data);

    Removes an element from a GSList. If two elements contain the same data, only the first is removed. -If none of the elements contain the data, the GSList is unchanged.

    +If none of the elements contain the data, the GSList is unchanged. +

    list :

    a GSList +a GSList

    data :

    the data for the new element +the data for the new element

    func :

    the function to compare elements in the list. +the function to compare elements in the list. It should return a number > 0 if the first parameter comes after the second parameter in the sort order.
    - - @@ -486,24 +505,25 @@ If none of the elements contain the data, the

    g_slist_remove_link ()

    -
    GSList*             g_slist_remove_link                 (GSList *list,
    -                                                         GSList *link_);
    +
    GSList*             g_slist_remove_link                 (GSList *list,
    +                                                         GSList *link_);

    Removes an element from a GSList, without freeing the element. The removed element's next link is set to NULL, so that it becomes a -self-contained list with one element.

    +self-contained list with one element. +

    list :

    a GSList +a GSList

    data :

    the data of the element to remove +the data of the element to remove
    - - @@ -517,23 +537,24 @@ self-contained list with one element.


    g_slist_delete_link ()

    -
    GSList*             g_slist_delete_link                 (GSList *list,
    -                                                         GSList *link_);
    +
    GSList*             g_slist_delete_link                 (GSList *list,
    +                                                         GSList *link_);

    Removes the node link_ from the list and frees it. Compare this to g_slist_remove_link() which removes the node -without freeing it.

    +without freeing it. +

    list :

    a GSList +a GSList

    link_ :

    an element in the GSList +an element in the GSList
    - - @@ -547,24 +568,25 @@ without freeing it.


    g_slist_remove_all ()

    -
    GSList*             g_slist_remove_all                  (GSList *list,
    -                                                         gconstpointer data);
    +
    GSList*             g_slist_remove_all                  (GSList *list,
    +                                                         gconstpointer data);

    Removes all list nodes with data equal to data. Returns the new head of the list. Contrast with g_slist_remove() which removes only the first node -matching the given data.

    +matching the given data. +

    list :

    a GSList +a GSList

    link_ :

    node to delete +node to delete
    - - @@ -578,15 +600,16 @@ matching the given data.


    g_slist_free ()

    -
    void                g_slist_free                        (GSList *list);
    +
    void                g_slist_free                        (GSList *list);

    Frees all of the memory used by a GSList. -The freed elements are returned to the slice allocator.

    +The freed elements are returned to the slice allocator. +

    list :

    a GSList +a GSList

    data :

    data to remove +data to remove
    -

    list :

    a GSList +a GSList
    @@ -594,15 +617,16 @@ The freed elements are returned to the slice allocator.


    g_slist_free_1 ()

    -
    void                g_slist_free_1                      (GSList *list);
    +
    void                g_slist_free_1                      (GSList *list);

    Frees one GSList element. -It is usually used after g_slist_remove_link().

    +It is usually used after g_slist_remove_link(). +

    -

    list :

    a GSList element +a GSList element
    @@ -612,13 +636,14 @@ It is usually used after

    g_slist_free1

    #define             g_slist_free1

    -A macro which does the same as g_slist_free_1().

    +A macro which does the same as g_slist_free_1(). +

    Since 2.10


    g_slist_length ()

    -
    guint               g_slist_length                      (GSList *list);
    +
    guint               g_slist_length                      (GSList *list);

    Gets the number of elements in a GSList.

    @@ -631,12 +656,14 @@ This function iterates over the whole list to count its elements.

    +

    +

    - @@ -650,7 +677,7 @@ count its elements.

    g_slist_copy ()

    -
    GSList*             g_slist_copy                        (GSList *list);
    +
    GSList*             g_slist_copy                        (GSList *list);

    Copies a GSList.

    @@ -664,12 +691,14 @@ consist of pointers to data, the pointers are copied but the actual data isn't.

    +

    +

    list :

    a GSList +a GSList
    - @@ -683,15 +712,16 @@ the actual data isn't.

    g_slist_reverse ()

    -
    GSList*             g_slist_reverse                     (GSList *list);
    +
    GSList*             g_slist_reverse                     (GSList *list);

    -Reverses a GSList.

    +Reverses a GSList. +

    list :

    a GSList +a GSList
    - @@ -705,36 +735,37 @@ Reverses a

    g_slist_insert_sorted_with_data ()

    -
    GSList*             g_slist_insert_sorted_with_data     (GSList *list,
    -                                                         gpointer data,
    -                                                         GCompareDataFunc func,
    -                                                         gpointer user_data);
    +
    GSList*             g_slist_insert_sorted_with_data     (GSList *list,
    +                                                         gpointer data,
    +                                                         GCompareDataFunc func,
    +                                                         gpointer user_data);

    Inserts a new element into the list, using the given -comparison function to determine its position.

    +comparison function to determine its position. +

    list :

    a GSList +a GSList
    - - - - @@ -750,21 +781,22 @@ comparison function to determine its position.


    g_slist_sort ()

    -
    GSList*             g_slist_sort                        (GSList *list,
    -                                                         GCompareFunc compare_func);
    +
    GSList*             g_slist_sort                        (GSList *list,
    +                                                         GCompareFunc compare_func);

    -Sorts a GSList using the given comparison function.

    +Sorts a GSList using the given comparison function. +

    list :

    a GSList +a GSList

    data :

    the data for the new element +the data for the new element

    func :

    the function to compare elements in the list. +the function to compare elements in the list. It should return a number > 0 if the first parameter comes after the second parameter in the sort order.

    user_data :

    data to pass to comparison function +data to pass to comparison function
    - -

    list :

    a GSList +a GSList

    compare_func :

    the comparison function used to sort the GSList. +the comparison function used to sort the GSList. This function is passed the data from 2 elements of the GSList and should return 0 if they are equal, a negative value if the first element comes before the second, or a positive value if @@ -782,27 +814,28 @@ Sorts a

    g_slist_sort_with_data ()

    -
    GSList*             g_slist_sort_with_data              (GSList *list,
    -                                                         GCompareDataFunc compare_func,
    -                                                         gpointer user_data);
    +
    GSList*             g_slist_sort_with_data              (GSList *list,
    +                                                         GCompareDataFunc compare_func,
    +                                                         gpointer user_data);

    -Like g_slist_sort(), but the sort function accepts a user data argument.

    +Like g_slist_sort(), but the sort function accepts a user data argument. +

    - - - @@ -816,23 +849,24 @@ Like

    g_slist_concat ()

    -
    GSList*             g_slist_concat                      (GSList *list1,
    -                                                         GSList *list2);
    +
    GSList*             g_slist_concat                      (GSList *list1,
    +                                                         GSList *list2);

    Adds the second GSList onto the end of the first GSList. Note that the elements of the second GSList are not copied. -They are used directly.

    +They are used directly. +

    list :

    a GSList +a GSList

    compare_func :

    comparison function +comparison function

    user_data :

    data to pass to comparison function +data to pass to comparison function
    - - @@ -846,27 +880,28 @@ They are used directly.


    g_slist_foreach ()

    -
    void                g_slist_foreach                     (GSList *list,
    -                                                         GFunc func,
    -                                                         gpointer user_data);
    +
    void                g_slist_foreach                     (GSList *list,
    +                                                         GFunc func,
    +                                                         gpointer user_data);

    -Calls a function for each element of a GSList.

    +Calls a function for each element of a GSList. +

    list1 :

    a GSList +a GSList

    list2 :

    the GSList to add to the end of the first GSList +the GSList to add to the end of the first GSList
    - - - @@ -875,7 +910,7 @@ Calls a function for each element of a

    g_slist_last ()

    -
    GSList*             g_slist_last                        (GSList *list);
    +
    GSList*             g_slist_last                        (GSList *list);

    Gets the last element in a GSList. @@ -886,12 +921,14 @@ Gets the last element in a

    list :

    a GSList +a GSList

    func :

    the function to call with each element's data +the function to call with each element's data

    user_data :

    user data to pass to the function +user data to pass to the function
    - @@ -908,18 +945,19 @@ This function iterates over the whole list.

    g_slist_next()

    #define             g_slist_next(slist)

    -A convenience macro to get the next element in a GSList.

    +A convenience macro to get the next element in a GSList. +

    list :

    a GSList +a GSList
    - - @@ -928,21 +966,22 @@ A convenience macro to get the next element in a

    g_slist_nth ()

    -
    GSList*             g_slist_nth                         (GSList *list,
    -                                                         guint n);
    +
    GSList*             g_slist_nth                         (GSList *list,
    +                                                         guint n);

    -Gets the element at the given position in a GSList.

    +Gets the element at the given position in a GSList. +

    slist :

    an element in a GSList. +an element in a GSList.

    Returns :

    the next element, or NULL if there are no more elements. +the next element, or NULL if there are no more elements.
    - - @@ -957,21 +996,22 @@ Gets the element at the given position in a

    g_slist_nth_data ()

    -
    gpointer            g_slist_nth_data                    (GSList *list,
    -                                                         guint n);
    +
    gpointer            g_slist_nth_data                    (GSList *list,
    +                                                         guint n);

    -Gets the data of the element at the given position.

    +Gets the data of the element at the given position. +

    list :

    a GSList +a GSList

    n :

    the position of the element, counting from 0 +the position of the element, counting from 0
    - - @@ -986,22 +1026,23 @@ Gets the data of the element at the given position.


    g_slist_find ()

    -
    GSList*             g_slist_find                        (GSList *list,
    -                                                         gconstpointer data);
    +
    GSList*             g_slist_find                        (GSList *list,
    +                                                         gconstpointer data);

    Finds the element in a GSList which -contains the given data.

    +contains the given data. +

    list :

    a GSList +a GSList

    n :

    the position of the element +the position of the element
    - - @@ -1016,32 +1057,33 @@ contains the given data.


    g_slist_find_custom ()

    -
    GSList*             g_slist_find_custom                 (GSList *list,
    -                                                         gconstpointer data,
    -                                                         GCompareFunc func);
    +
    GSList*             g_slist_find_custom                 (GSList *list,
    +                                                         gconstpointer data,
    +                                                         GCompareFunc func);

    Finds an element in a GSList, using a supplied function to find the desired element. It iterates over the list, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the GSList element's data as the first argument and the -given user data.

    +given user data. +

    list :

    a GSList +a GSList

    data :

    the element data to find +the element data to find
    - - - @@ -1056,22 +1098,23 @@ given user data.


    g_slist_position ()

    -
    gint                g_slist_position                    (GSList *list,
    -                                                         GSList *llink);
    +
    gint                g_slist_position                    (GSList *list,
    +                                                         GSList *llink);

    Gets the position of the given element -in the GSList (starting from 0).

    +in the GSList (starting from 0). +

    list :

    a GSList +a GSList

    data :

    user data passed to the function +user data passed to the function

    func :

    the function to call for each element. +the function to call for each element. It should return 0 when the desired element is found
    - - @@ -1086,22 +1129,23 @@ in the

    g_slist_index ()

    -
    gint                g_slist_index                       (GSList *list,
    -                                                         gconstpointer data);
    +
    gint                g_slist_index                       (GSList *list,
    +                                                         gconstpointer data);

    Gets the position of the element containing -the given data (starting from 0).

    +the given data (starting from 0). +

    list :

    a GSList +a GSList

    llink :

    an element in the GSList +an element in the GSList
    - - @@ -1116,7 +1160,7 @@ the given data (starting from 0).


    g_slist_push_allocator ()

    -
    void                g_slist_push_allocator              (gpointer dummy);
    +
    void                g_slist_push_allocator              (gpointer dummy);

    Warning

    g_slist_push_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GSList has been converted @@ -1129,12 +1173,13 @@ Sets the allocator to use to allocate --disable-mem-pools

    +with --disable-mem-pools +

    list :

    a GSList +a GSList

    data :

    the data to find +the data to find
    -

    dummy :

    the GAllocator to use when allocating GSList elements. +the GAllocator to use when allocating GSList elements.
    @@ -1142,7 +1187,7 @@ with --disable-mem-pools


    g_slist_pop_allocator ()

    -
    void                g_slist_pop_allocator               (void);
    +
    void                g_slist_pop_allocator               (void);

    Warning

    g_slist_pop_allocator has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since GSList has been converted @@ -1155,12 +1200,13 @@ elements.

    Note that this function is not available if GLib has been compiled -with --disable-mem-pools

    +with --disable-mem-pools +

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Spawning-Processes.html b/docs/reference/glib/html/glib-Spawning-Processes.html index aa1d6b1..5b511db 100644 --- a/docs/reference/glib/html/glib-Spawning-Processes.html +++ b/docs/reference/glib/html/glib-Spawning-Processes.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -63,44 +43,44 @@ enum GSpawnError; #define G_SPAWN_ERROR enum GSpawnFlags; -void (*GSpawnChildSetupFunc) (gpointer user_data); -gbooleang_spawn_async_with_pipes (const gchar *working_directory, - gchar **argv, - gchar **envp, - GSpawnFlags flags, - GSpawnChildSetupFunc child_setup, - gpointer user_data, - GPid *child_pid, - gint *standard_input, - gint *standard_output, - gint *standard_error, - GError **error); -gbooleang_spawn_async (const gchar *working_directory, - gchar **argv, - gchar **envp, - GSpawnFlags flags, - GSpawnChildSetupFunc child_setup, - gpointer user_data, - GPid *child_pid, - GError **error); -gbooleang_spawn_sync (const gchar *working_directory, - gchar **argv, - gchar **envp, - GSpawnFlags flags, - GSpawnChildSetupFunc child_setup, - gpointer user_data, - gchar **standard_output, - gchar **standard_error, - gint *exit_status, - GError **error); -gbooleang_spawn_command_line_async (const gchar *command_line, - GError **error); -gbooleang_spawn_command_line_sync (const gchar *command_line, - gchar **standard_output, - gchar **standard_error, - gint *exit_status, - GError **error); -voidg_spawn_close_pid (GPid pid); +void (*GSpawnChildSetupFunc) (gpointer user_data); +gbooleang_spawn_async_with_pipes (const gchar *working_directory, + gchar **argv, + gchar **envp, + GSpawnFlags flags, + GSpawnChildSetupFunc child_setup, + gpointer user_data, + GPid *child_pid, + gint *standard_input, + gint *standard_output, + gint *standard_error, + GError **error); +gbooleang_spawn_async (const gchar *working_directory, + gchar **argv, + gchar **envp, + GSpawnFlags flags, + GSpawnChildSetupFunc child_setup, + gpointer user_data, + GPid *child_pid, + GError **error); +gbooleang_spawn_sync (const gchar *working_directory, + gchar **argv, + gchar **envp, + GSpawnFlags flags, + GSpawnChildSetupFunc child_setup, + gpointer user_data, + gchar **standard_output, + gchar **standard_error, + gint *exit_status, + GError **error); +gbooleang_spawn_command_line_async (const gchar *command_line, + GError **error); +gbooleang_spawn_command_line_sync (const gchar *command_line, + gchar **standard_output, + gchar **standard_error, + gint *exit_status, + GError **error); +voidg_spawn_close_pid (GPid pid);
    @@ -334,7 +314,7 @@ Flags passed to

    GSpawnChildSetupFunc ()

    -
    void                (*GSpawnChildSetupFunc)             (gpointer user_data);
    +
    void                (*GSpawnChildSetupFunc)             (gpointer user_data);

    Specifies the type of the setup function passed to g_spawn_async(), g_spawn_sync() and g_spawn_async_with_pipes(). On POSIX platforms it @@ -371,17 +351,17 @@ functions.


    g_spawn_async_with_pipes ()

    -
    gboolean            g_spawn_async_with_pipes            (const gchar *working_directory,
    -                                                         gchar **argv,
    -                                                         gchar **envp,
    -                                                         GSpawnFlags flags,
    -                                                         GSpawnChildSetupFunc child_setup,
    -                                                         gpointer user_data,
    -                                                         GPid *child_pid,
    -                                                         gint *standard_input,
    -                                                         gint *standard_output,
    -                                                         gint *standard_error,
    -                                                         GError **error);
    +
    gboolean            g_spawn_async_with_pipes            (const gchar *working_directory,
    +                                                         gchar **argv,
    +                                                         gchar **envp,
    +                                                         GSpawnFlags flags,
    +                                                         GSpawnChildSetupFunc child_setup,
    +                                                         gpointer user_data,
    +                                                         GPid *child_pid,
    +                                                         gint *standard_input,
    +                                                         gint *standard_output,
    +                                                         gint *standard_error,
    +                                                         GError **error);

    Executes a child program asynchronously (your program will not block waiting for the child to exit). The child program is @@ -549,66 +529,68 @@ process reference must be closed using gdk_spawn_on_screen_with_pipes() instead to ensure that +want to use gdk_spawn_on_screen_with_pipes() instead to ensure that the spawned program opens its windows on the right screen.

    +

    +

    - - - - - - - - - - - @@ -622,14 +604,14 @@ the spawned program opens its windows on the right screen.

    g_spawn_async ()

    -
    gboolean            g_spawn_async                       (const gchar *working_directory,
    -                                                         gchar **argv,
    -                                                         gchar **envp,
    -                                                         GSpawnFlags flags,
    -                                                         GSpawnChildSetupFunc child_setup,
    -                                                         gpointer user_data,
    -                                                         GPid *child_pid,
    -                                                         GError **error);
    +
    gboolean            g_spawn_async                       (const gchar *working_directory,
    +                                                         gchar **argv,
    +                                                         gchar **envp,
    +                                                         GSpawnFlags flags,
    +                                                         GSpawnChildSetupFunc child_setup,
    +                                                         gpointer user_data,
    +                                                         GPid *child_pid,
    +                                                         GError **error);

    See g_spawn_async_with_pipes() for a full description; this function simply calls the g_spawn_async_with_pipes() without any pipes. @@ -645,7 +627,7 @@ reference when you don't need it any more.

    If you are writing a GTK+ application, and the program you are spawning is a graphical application, too, then you may -want to use gdk_spawn_on_screen() instead to ensure that +want to use gdk_spawn_on_screen() instead to ensure that the spawned program opens its windows on the right screen.

    @@ -660,47 +642,49 @@ handle to the child process and not its identifier. Process handles and process identifiers are different concepts on Windows.

    +

    +

    working_directory :

    child's current working directory, or NULL to inherit parent's, in the GLib file name encoding +child's current working directory, or NULL to inherit parent's, in the GLib file name encoding

    argv :

    child's argument vector, in the GLib file name encoding +child's argument vector, in the GLib file name encoding

    envp :

    child's environment, or NULL to inherit parent's, in the GLib file name encoding +child's environment, or NULL to inherit parent's, in the GLib file name encoding

    flags :

    flags from GSpawnFlags +flags from GSpawnFlags

    child_setup :

    function to run in the child just before exec() +function to run in the child just before exec()

    user_data :

    user data for child_setup +user data for child_setup

    child_pid :

    return location for child process ID, or NULL +return location for child process ID, or NULL

    standard_input :

    return location for file descriptor to write to child's stdin, or NULL +return location for file descriptor to write to child's stdin, or NULL

    standard_output :

    return location for file descriptor to read child's stdout, or NULL +return location for file descriptor to read child's stdout, or NULL

    standard_error :

    return location for file descriptor to read child's stderr, or NULL +return location for file descriptor to read child's stderr, or NULL

    error :

    return location for error +return location for error
    - - - - - - - - @@ -714,16 +698,16 @@ and process identifiers are different concepts on Windows.

    g_spawn_sync ()

    -
    gboolean            g_spawn_sync                        (const gchar *working_directory,
    -                                                         gchar **argv,
    -                                                         gchar **envp,
    -                                                         GSpawnFlags flags,
    -                                                         GSpawnChildSetupFunc child_setup,
    -                                                         gpointer user_data,
    -                                                         gchar **standard_output,
    -                                                         gchar **standard_error,
    -                                                         gint *exit_status,
    -                                                         GError **error);
    +
    gboolean            g_spawn_sync                        (const gchar *working_directory,
    +                                                         gchar **argv,
    +                                                         gchar **envp,
    +                                                         GSpawnFlags flags,
    +                                                         GSpawnChildSetupFunc child_setup,
    +                                                         gpointer user_data,
    +                                                         gchar **standard_output,
    +                                                         gchar **standard_error,
    +                                                         gint *exit_status,
    +                                                         GError **error);

    Executes a child synchronously (waits for the child to exit before returning). All output from the child is stored in standard_output and standard_error, @@ -741,58 +725,59 @@ If an error occurs, no data is returned in standard_

    This function calls g_spawn_async_with_pipes() internally; see that function for full details on the other parameters and details on -how these functions work on Windows.

    +how these functions work on Windows. +

    working_directory :

    child's current working directory, or NULL to inherit parent's +child's current working directory, or NULL to inherit parent's

    argv :

    child's argument vector +child's argument vector

    envp :

    child's environment, or NULL to inherit parent's +child's environment, or NULL to inherit parent's

    flags :

    flags from GSpawnFlags +flags from GSpawnFlags

    child_setup :

    function to run in the child just before exec() +function to run in the child just before exec()

    user_data :

    user data for child_setup +user data for child_setup

    child_pid :

    return location for child process reference, or NULL +return location for child process reference, or NULL

    error :

    return location for error +return location for error
    - - - - - - - - - - @@ -806,8 +791,8 @@ how these functions work on Windows.


    g_spawn_command_line_async ()

    -
    gboolean            g_spawn_command_line_async          (const gchar *command_line,
    -                                                         GError **error);
    +
    gboolean            g_spawn_command_line_async          (const gchar *command_line,
    +                                                         GError **error);

    A simple version of g_spawn_async() that parses a command line with g_shell_parse_argv() and passes it to g_spawn_async(). Runs a @@ -818,18 +803,19 @@ consider using g_shell_parse_argv() and g_spawn_async().

    -The same concerns on Windows apply as for g_spawn_command_line_sync().

    +The same concerns on Windows apply as for g_spawn_command_line_sync(). +

    working_directory :

    child's current working directory, or NULL to inherit parent's +child's current working directory, or NULL to inherit parent's

    argv :

    child's argument vector +child's argument vector

    envp :

    child's environment, or NULL to inherit parent's +child's environment, or NULL to inherit parent's

    flags :

    flags from GSpawnFlags +flags from GSpawnFlags

    child_setup :

    function to run in the child just before exec() +function to run in the child just before exec()

    user_data :

    user data for child_setup +user data for child_setup

    standard_output :

    return location for child output, or NULL +return location for child output, or NULL

    standard_error :

    return location for child error messages, or NULL +return location for child error messages, or NULL

    exit_status :

    return location for child exit status, as returned by waitpid(), or NULL +return location for child exit status, as returned by waitpid(), or NULL

    error :

    return location for error, or NULL +return location for error, or NULL
    - - @@ -843,11 +829,11 @@ The same concerns on Windows apply as for

    g_spawn_command_line_sync ()

    -
    gboolean            g_spawn_command_line_sync           (const gchar *command_line,
    -                                                         gchar **standard_output,
    -                                                         gchar **standard_error,
    -                                                         gint *exit_status,
    -                                                         GError **error);
    +
    gboolean            g_spawn_command_line_sync           (const gchar *command_line,
    +                                                         gchar **standard_output,
    +                                                         gchar **standard_error,
    +                                                         gint *exit_status,
    +                                                         GError **error);

    A simple version of g_spawn_sync() with little-used parameters removed, taking a command line instead of an argument vector. See @@ -872,33 +858,34 @@ special. Thus you cannot simply pass a command_line< canonical Windows paths, like "c:\\program files\\app\\app.exe", as the backslashes will be eaten, and the space will act as a separator. You need to enclose such paths with single quotes, like -"'c:\\program files\\app\\app.exe' 'e:\\folder\\argument.txt'".

    +"'c:\\program files\\app\\app.exe' 'e:\\folder\\argument.txt'". +

    command_line :

    a command line +a command line

    error :

    return location for errors +return location for errors
    - - - - - @@ -912,17 +899,18 @@ separator. You need to enclose such paths with single quotes, like

    g_spawn_close_pid ()

    -
    void                g_spawn_close_pid                   (GPid pid);
    +
    void                g_spawn_close_pid                   (GPid pid);

    On some platforms, notably Windows, the GPid type represents a resource which must be closed to prevent resource leaking. g_spawn_close_pid() is provided for this purpose. It should be used on all platforms, even -though it doesn't do anything under UNIX.

    +though it doesn't do anything under UNIX. +

    command_line :

    a command line +a command line

    standard_output :

    return location for child output +return location for child output

    standard_error :

    return location for child errors +return location for child errors

    exit_status :

    return location for child exit status, as returned by waitpid() +return location for child exit status, as returned by waitpid()

    error :

    return location for errors +return location for errors
    -

    pid :

    The process reference to close +The process reference to close
    @@ -931,6 +919,6 @@ though it doesn't do anything under UNIX.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Standard-Macros.html b/docs/reference/glib/html/glib-Standard-Macros.html index 6dc2cc9..007e504 100644 --- a/docs/reference/glib/html/glib-Standard-Macros.html +++ b/docs/reference/glib/html/glib-Standard-Macros.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -75,15 +55,23 @@ #define NULL -#define MIN (a, b) -#define MAX (a, b) +#define MIN (a, + b) +#define MAX (a, + b) #define ABS (a) -#define CLAMP (x, low, high) +#define CLAMP (x, + low, + high) -#define G_STRUCT_MEMBER (member_type, struct_p, struct_offset) -#define G_STRUCT_MEMBER_P (struct_p, struct_offset) -#define G_STRUCT_OFFSET (struct_type, member) +#define G_STRUCT_MEMBER (member_type, + struct_p, + struct_offset) +#define G_STRUCT_MEMBER_P (struct_p, + struct_offset) +#define G_STRUCT_OFFSET (struct_type, + member) #define G_MEM_ALIGN @@ -473,6 +461,6 @@ turn it off. This macro should only be used for return values and for + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-String-Chunks.html b/docs/reference/glib/html/glib-String-Chunks.html index 0cb070f..898dcea 100644 --- a/docs/reference/glib/html/glib-String-Chunks.html +++ b/docs/reference/glib/html/glib-String-Chunks.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,16 +41,16 @@ #include <glib.h> GStringChunk; -GStringChunk* g_string_chunk_new (gsize size); -gchar* g_string_chunk_insert (GStringChunk *chunk, - const gchar *string); -gchar* g_string_chunk_insert_const (GStringChunk *chunk, - const gchar *string); -gchar* g_string_chunk_insert_len (GStringChunk *chunk, - const gchar *string, - gssize len); -voidg_string_chunk_clear (GStringChunk *chunk); -voidg_string_chunk_free (GStringChunk *chunk); +GStringChunk* g_string_chunk_new (gsize size); +gchar* g_string_chunk_insert (GStringChunk *chunk, + const gchar *string); +gchar* g_string_chunk_insert_const (GStringChunk *chunk, + const gchar *string); +gchar* g_string_chunk_insert_len (GStringChunk *chunk, + const gchar *string, + gssize len); +voidg_string_chunk_clear (GStringChunk *chunk); +voidg_string_chunk_free (GStringChunk *chunk);
    @@ -103,7 +83,8 @@ which are already in the GStringChunk use g_string_chunk_free(). It is -not possible to free individual strings.

    +not possible to free individual strings. +

    Details

    @@ -112,20 +93,22 @@ not possible to free individual strings.

    typedef struct _GStringChunk GStringChunk;

    An opaque data structure representing String Chunks. It should only -be accessed by using the following functions.

    +be accessed by using the following functions. +


    g_string_chunk_new ()

    -
    GStringChunk*       g_string_chunk_new                  (gsize size);
    +
    GStringChunk*       g_string_chunk_new                  (gsize size);

    -Creates a new GStringChunk.

    +Creates a new GStringChunk. +

    -

    size :

    the default size of the blocks of memory which are +the default size of the blocks of memory which are allocated to store the strings. If a particular string is larger than this default size, a larger block of memory will be allocated for it. @@ -142,8 +125,8 @@ Creates a new

    g_string_chunk_insert ()

    -
    gchar*              g_string_chunk_insert               (GStringChunk *chunk,
    -                                                         const gchar *string);
    +
    gchar*              g_string_chunk_insert               (GStringChunk *chunk,
    +                                                         const gchar *string);

    Adds a copy of string to the GStringChunk. It returns a pointer to the new copy of the string @@ -156,18 +139,19 @@ Unlike g_string_chunk_insert() will not be searched by g_string_chunk_insert_const() when looking for -duplicates.

    +duplicates. +

    - - @@ -182,8 +166,8 @@ duplicates.


    g_string_chunk_insert_const ()

    -
    gchar*              g_string_chunk_insert_const         (GStringChunk *chunk,
    -                                                         const gchar *string);
    +
    gchar*              g_string_chunk_insert_const         (GStringChunk *chunk,
    +                                                         const gchar *string);

    Adds a copy of string to the GStringChunk, unless the same string has already been added to the GStringChunk with @@ -199,18 +183,19 @@ should be done very carefully.

    Note that g_string_chunk_insert_const() will not return a pointer to a string added with g_string_chunk_insert(), even -if they do match.

    +if they do match. +

    chunk :

    a GStringChunk +a GStringChunk

    string :

    the string to add +the string to add
    - - @@ -225,9 +210,9 @@ if they do match.


    g_string_chunk_insert_len ()

    -
    gchar*              g_string_chunk_insert_len           (GStringChunk *chunk,
    -                                                         const gchar *string,
    -                                                         gssize len);
    +
    gchar*              g_string_chunk_insert_len           (GStringChunk *chunk,
    +                                                         const gchar *string,
    +                                                         gssize len);

    Adds a copy of the first len bytes of string to the GStringChunk. The copy is nul-terminated. @@ -239,23 +224,24 @@ bytes.

    The characters in the returned string can be changed, if necessary, -though you should not change anything after the end of the string.

    +though you should not change anything after the end of the string. +

    chunk :

    a GStringChunk +a GStringChunk

    string :

    the string to add +the string to add
    - - - @@ -272,16 +258,17 @@ though you should not change anything after the end of the string.


    g_string_chunk_clear ()

    -
    void                g_string_chunk_clear                (GStringChunk *chunk);
    +
    void                g_string_chunk_clear                (GStringChunk *chunk);

    Frees all strings contained within the GStringChunk. After calling g_string_chunk_clear() it is not safe to -access any of the strings which were contained within it.

    +access any of the strings which were contained within it. +

    chunk :

    a GStringChunk +a GStringChunk

    string :

    bytes to insert +bytes to insert

    len :

    number of bytes of string to insert, or -1 to insert a +number of bytes of string to insert, or -1 to insert a nul-terminated string
    -

    chunk :

    a GStringChunk +a GStringChunk
    @@ -290,16 +277,17 @@ access any of the strings which were contained within it.


    g_string_chunk_free ()

    -
    void                g_string_chunk_free                 (GStringChunk *chunk);
    +
    void                g_string_chunk_free                 (GStringChunk *chunk);

    Frees all memory allocated by the GStringChunk. After calling g_string_chunk_free() it is not safe to -access any of the strings which were contained within it.

    +access any of the strings which were contained within it. +

    -

    chunk :

    a GStringChunk +a GStringChunk
    @@ -308,6 +296,6 @@ access any of the strings which were contained within it.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-String-Utility-Functions.html b/docs/reference/glib/html/glib-String-Utility-Functions.html index 373b94a..e43497b 100644 --- a/docs/reference/glib/html/glib-String-Utility-Functions.html +++ b/docs/reference/glib/html/glib-String-Utility-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,163 +41,163 @@ #include <glib.h> #include <glib/gprintf.h> -gchar* g_strdup (const gchar *str); -gchar* g_strndup (const gchar *str, - gsize n); -gchar** g_strdupv (gchar **str_array); -gchar* g_strnfill (gsize length, - gchar fill_char); -gchar* g_stpcpy (gchar *dest, - const char *src); -gchar * g_strstr_len (const gchar *haystack, - gssize haystack_len, - const gchar *needle); -gchar * g_strrstr (const gchar *haystack, - const gchar *needle); -gchar * g_strrstr_len (const gchar *haystack, - gssize haystack_len, - const gchar *needle); -gbooleang_str_has_prefix (const gchar *str, - const gchar *prefix); -gbooleang_str_has_suffix (const gchar *str, - const gchar *suffix); -intg_strcmp0 (const char *str1, - const char *str2); +gchar* g_strdup (const gchar *str); +gchar* g_strndup (const gchar *str, + gsize n); +gchar** g_strdupv (gchar **str_array); +gchar* g_strnfill (gsize length, + gchar fill_char); +gchar* g_stpcpy (gchar *dest, + const char *src); +gchar * g_strstr_len (const gchar *haystack, + gssize haystack_len, + const gchar *needle); +gchar * g_strrstr (const gchar *haystack, + const gchar *needle); +gchar * g_strrstr_len (const gchar *haystack, + gssize haystack_len, + const gchar *needle); +gbooleang_str_has_prefix (const gchar *str, + const gchar *prefix); +gbooleang_str_has_suffix (const gchar *str, + const gchar *suffix); +intg_strcmp0 (const char *str1, + const char *str2); -gsizeg_strlcpy (gchar *dest, - const gchar *src, - gsize dest_size); -gsizeg_strlcat (gchar *dest, - const gchar *src, - gsize dest_size); +gsizeg_strlcpy (gchar *dest, + const gchar *src, + gsize dest_size); +gsizeg_strlcat (gchar *dest, + const gchar *src, + gsize dest_size); -gchar* g_strdup_printf (const gchar *format, - ...); -gchar* g_strdup_vprintf (const gchar *format, - va_list args); -gintg_printf (gchar const *format, - ...); -gintg_vprintf (gchar const *format, - va_list args); -gintg_fprintf (FILE *file, - gchar const *format, - ...); -gintg_vfprintf (FILE *file, - gchar const *format, - va_list args); -gintg_sprintf (gchar *string, - gchar const *format, - ...); -gintg_vsprintf (gchar *string, - gchar const *format, - va_list args); -gintg_snprintf (gchar *string, - gulong n, - gchar const *format, - ...); -gintg_vsnprintf (gchar *string, - gulong n, - gchar const *format, - va_list args); -gintg_vasprintf (gchar **string, - gchar const *format, - va_list args); -gsizeg_printf_string_upper_bound (const gchar *format, - va_list args); +gchar* g_strdup_printf (const gchar *format, + ...); +gchar* g_strdup_vprintf (const gchar *format, + va_list args); +gintg_printf (gchar const *format, + ...); +gintg_vprintf (gchar const *format, + va_list args); +gintg_fprintf (FILE *file, + gchar const *format, + ...); +gintg_vfprintf (FILE *file, + gchar const *format, + va_list args); +gintg_sprintf (gchar *string, + gchar const *format, + ...); +gintg_vsprintf (gchar *string, + gchar const *format, + va_list args); +gintg_snprintf (gchar *string, + gulong n, + gchar const *format, + ...); +gintg_vsnprintf (gchar *string, + gulong n, + gchar const *format, + va_list args); +gintg_vasprintf (gchar **string, + gchar const *format, + va_list args); +gsizeg_printf_string_upper_bound (const gchar *format, + va_list args); -gbooleang_ascii_isalnum (gchar c); -gbooleang_ascii_isalpha (gchar c); -gbooleang_ascii_iscntrl (gchar c); -gbooleang_ascii_isdigit (gchar c); -gbooleang_ascii_isgraph (gchar c); -gbooleang_ascii_islower (gchar c); -gbooleang_ascii_isprint (gchar c); -gbooleang_ascii_ispunct (gchar c); -gbooleang_ascii_isspace (gchar c); -gbooleang_ascii_isupper (gchar c); -gbooleang_ascii_isxdigit (gchar c); +gbooleang_ascii_isalnum (gchar c); +gbooleang_ascii_isalpha (gchar c); +gbooleang_ascii_iscntrl (gchar c); +gbooleang_ascii_isdigit (gchar c); +gbooleang_ascii_isgraph (gchar c); +gbooleang_ascii_islower (gchar c); +gbooleang_ascii_isprint (gchar c); +gbooleang_ascii_ispunct (gchar c); +gbooleang_ascii_isspace (gchar c); +gbooleang_ascii_isupper (gchar c); +gbooleang_ascii_isxdigit (gchar c); -gintg_ascii_digit_value (gchar c); -gintg_ascii_xdigit_value (gchar c); +gintg_ascii_digit_value (gchar c); +gintg_ascii_xdigit_value (gchar c); -gintg_ascii_strcasecmp (const gchar *s1, - const gchar *s2); -gintg_ascii_strncasecmp (const gchar *s1, - const gchar *s2, - gsize n); +gintg_ascii_strcasecmp (const gchar *s1, + const gchar *s2); +gintg_ascii_strncasecmp (const gchar *s1, + const gchar *s2, + gsize n); -gchar* g_ascii_strup (const gchar *str, - gssize len); -gchar* g_ascii_strdown (const gchar *str, - gssize len); +gchar* g_ascii_strup (const gchar *str, + gssize len); +gchar* g_ascii_strdown (const gchar *str, + gssize len); -gcharg_ascii_tolower (gchar c); -gcharg_ascii_toupper (gchar c); +gcharg_ascii_tolower (gchar c); +gcharg_ascii_toupper (gchar c); -GString* g_string_ascii_up (GString *string); -GString* g_string_ascii_down (GString *string); +GString* g_string_ascii_up (GString *string); +GString* g_string_ascii_down (GString *string); -gchar* g_strup (gchar *string); -gchar* g_strdown (gchar *string); +gchar* g_strup (gchar *string); +gchar* g_strdown (gchar *string); -gintg_strcasecmp (const gchar *s1, - const gchar *s2); -gintg_strncasecmp (const gchar *s1, - const gchar *s2, - guint n); +gintg_strcasecmp (const gchar *s1, + const gchar *s2); +gintg_strncasecmp (const gchar *s1, + const gchar *s2, + guint n); -gchar* g_strreverse (gchar *string); +gchar* g_strreverse (gchar *string); -gint64g_ascii_strtoll (const gchar *nptr, - gchar **endptr, - guint base); -guint64g_ascii_strtoull (const gchar *nptr, - gchar **endptr, - guint base); +gint64g_ascii_strtoll (const gchar *nptr, + gchar **endptr, + guint base); +guint64g_ascii_strtoull (const gchar *nptr, + gchar **endptr, + guint base); #define G_ASCII_DTOSTR_BUF_SIZE -gdoubleg_ascii_strtod (const gchar *nptr, - gchar **endptr); -gchar * g_ascii_dtostr (gchar *buffer, - gint buf_len, - gdouble d); -gchar * g_ascii_formatd (gchar *buffer, - gint buf_len, - const gchar *format, - gdouble d); -gdoubleg_strtod (const gchar *nptr, - gchar **endptr); +gdoubleg_ascii_strtod (const gchar *nptr, + gchar **endptr); +gchar * g_ascii_dtostr (gchar *buffer, + gint buf_len, + gdouble d); +gchar * g_ascii_formatd (gchar *buffer, + gint buf_len, + const gchar *format, + gdouble d); +gdoubleg_strtod (const gchar *nptr, + gchar **endptr); -gchar* g_strchug (gchar *string); -gchar* g_strchomp (gchar *string); -#define g_strstrip ( string ) +gchar* g_strchug (gchar *string); +gchar* g_strchomp (gchar *string); +#define g_strstrip (string) -gchar* g_strdelimit (gchar *string, - const gchar *delimiters, - gchar new_delimiter); +gchar* g_strdelimit (gchar *string, + const gchar *delimiters, + gchar new_delimiter); #define G_STR_DELIMITERS -gchar* g_strescape (const gchar *source, - const gchar *exceptions); -gchar* g_strcompress (const gchar *source); -gchar* g_strcanon (gchar *string, - const gchar *valid_chars, - gchar substitutor); -gchar** g_strsplit (const gchar *string, - const gchar *delimiter, - gint max_tokens); -gchar ** g_strsplit_set (const gchar *string, - const gchar *delimiters, - gint max_tokens); -voidg_strfreev (gchar **str_array); -gchar* g_strconcat (const gchar *string1, - ...); -gchar* g_strjoin (const gchar *separator, - ...); -gchar* g_strjoinv (const gchar *separator, - gchar **str_array); -guintg_strv_length (gchar **str_array); +gchar* g_strescape (const gchar *source, + const gchar *exceptions); +gchar* g_strcompress (const gchar *source); +gchar* g_strcanon (gchar *string, + const gchar *valid_chars, + gchar substitutor); +gchar** g_strsplit (const gchar *string, + const gchar *delimiter, + gint max_tokens); +gchar ** g_strsplit_set (const gchar *string, + const gchar *delimiters, + gint max_tokens); +voidg_strfreev (gchar **str_array); +gchar* g_strconcat (const gchar *string1, + ...); +gchar* g_strjoin (const gchar *separator, + ...); +gchar* g_strjoinv (const gchar *separator, + gchar **str_array); +guintg_strv_length (gchar **str_array); -const gchar* g_strerror (gint errnum); -const gchar* g_strsignal (gint signum); +const gchar* g_strerror (gint errnum); +const gchar* g_strsignal (gint signum);
    @@ -253,17 +233,18 @@ wide characters (see

    Details

    g_strdup ()

    -
    gchar*              g_strdup                            (const gchar *str);
    +
    gchar*              g_strdup                            (const gchar *str);

    Duplicates a string. If str is NULL it returns NULL. The returned string should be freed with g_free() -when no longer needed.

    +when no longer needed. +

    - @@ -277,8 +258,8 @@ when no longer needed.


    g_strndup ()

    -
    gchar*              g_strndup                           (const gchar *str,
    -                                                         gsize n);
    +
    gchar*              g_strndup                           (const gchar *str,
    +                                                         gsize n);

    Duplicates the first n bytes of a string, returning a newly-allocated buffer n + 1 bytes long which will always be nul-terminated. @@ -295,17 +276,19 @@ To copy a number of characters from a UTF-8 encoded string, use g_utf8_strncpy() instead.

    +

    +

    str :

    the string to duplicate +the string to duplicate
    - - @@ -320,18 +303,20 @@ To copy a number of characters from a UTF-8 encoded string, use

    g_strdupv ()

    -
    gchar**             g_strdupv                           (gchar **str_array);
    +
    gchar**             g_strdupv                           (gchar **str_array);

    Copies NULL-terminated array of strings. The copy is a deep copy; the new array should be freed by first freeing each string, then the array itself. g_strfreev() does this for you. If called -on a NULL value, g_strdupv() simply returns NULL.

    +on a NULL value, g_strdupv() simply returns NULL. +

    str :

    the string to duplicate +the string to duplicate

    n :

    the maximum number of bytes to copy from str +the maximum number of bytes to copy from str
    - @@ -345,22 +330,23 @@ on a

    g_strnfill ()

    -
    gchar*              g_strnfill                          (gsize length,
    -                                                         gchar fill_char);
    +
    gchar*              g_strnfill                          (gsize length,
    +                                                         gchar fill_char);

    Creates a new string length bytes long filled with fill_char. -The returned string should be freed when no longer needed.

    +The returned string should be freed when no longer needed. +

    str_array :

    NULL-terminated array of strings. + +NULL-terminated array of strings.
    - - @@ -374,24 +360,25 @@ The returned string should be freed when no longer needed.


    g_stpcpy ()

    -
    gchar*              g_stpcpy                            (gchar *dest,
    -                                                         const char *src);
    +
    gchar*              g_stpcpy                            (gchar *dest,
    +                                                         const char *src);

    Copies a nul-terminated string into the dest buffer, include the trailing nul, and return a pointer to the trailing nul byte. This is useful for concatenating multiple strings together -without having to repeatedly scan for the end.

    +without having to repeatedly scan for the end. +

    length :

    the length of the new string +the length of the new string

    fill_char :

    the byte to fill the string with +the byte to fill the string with
    - - @@ -405,31 +392,32 @@ without having to repeatedly scan for the end.


    g_strstr_len ()

    -
    gchar *             g_strstr_len                        (const gchar *haystack,
    -                                                         gssize haystack_len,
    -                                                         const gchar *needle);
    +
    gchar *             g_strstr_len                        (const gchar *haystack,
    +                                                         gssize haystack_len,
    +                                                         const gchar *needle);

    Searches the string haystack for the first occurrence of the string needle, limiting the length of the search -to haystack_len.

    +to haystack_len. +

    dest :

    destination buffer. +destination buffer.

    src :

    source string. +source string.
    - - - @@ -444,22 +432,23 @@ search through the whole string.

    g_strrstr ()

    -
    gchar *             g_strrstr                           (const gchar *haystack,
    -                                                         const gchar *needle);
    +
    gchar *             g_strrstr                           (const gchar *haystack,
    +                                                         const gchar *needle);

    Searches the string haystack for the last occurrence -of the string needle.

    +of the string needle. +

    haystack :

    a string. +a string.

    haystack_len :

    the maximum length of haystack. Note that -1 is +the maximum length of haystack. Note that -1 is a valid length, if haystack is nul-terminated, meaning it will search through the whole string.

    needle :

    the string to search for. +the string to search for.
    - - @@ -474,29 +463,30 @@ of the string needle.


    g_strrstr_len ()

    -
    gchar *             g_strrstr_len                       (const gchar *haystack,
    -                                                         gssize haystack_len,
    -                                                         const gchar *needle);
    +
    gchar *             g_strrstr_len                       (const gchar *haystack,
    +                                                         gssize haystack_len,
    +                                                         const gchar *needle);

    Searches the string haystack for the last occurrence of the string needle, limiting the length of the search -to haystack_len.

    +to haystack_len. +

    haystack :

    a nul-terminated string. +a nul-terminated string.

    needle :

    the nul-terminated string to search for. +the nul-terminated string to search for.
    - - - @@ -511,21 +501,22 @@ to haystack_len.


    g_str_has_prefix ()

    -
    gboolean            g_str_has_prefix                    (const gchar *str,
    -                                                         const gchar *prefix);
    +
    gboolean            g_str_has_prefix                    (const gchar *str,
    +                                                         const gchar *prefix);

    -Looks whether the string str begins with prefix.

    +Looks whether the string str begins with prefix. +

    haystack :

    a nul-terminated string. +a nul-terminated string.

    haystack_len :

    the maximum length of haystack. +the maximum length of haystack.

    needle :

    the nul-terminated string to search for. +the nul-terminated string to search for.
    - - @@ -541,21 +532,22 @@ Looks whether the string str begins with

    g_str_has_suffix ()

    -
    gboolean            g_str_has_suffix                    (const gchar *str,
    -                                                         const gchar *suffix);
    +
    gboolean            g_str_has_suffix                    (const gchar *str,
    +                                                         const gchar *suffix);

    -Looks whether the string str ends with suffix.

    +Looks whether the string str ends with suffix. +

    str :

    a nul-terminated string. +a nul-terminated string.

    prefix :

    the nul-terminated prefix to look for. +the nul-terminated prefix to look for.
    - - @@ -571,22 +563,23 @@ Looks whether the string str ends with <

    g_strcmp0 ()

    -
    int                 g_strcmp0                           (const char *str1,
    -                                                         const char *str2);
    +
    int                 g_strcmp0                           (const char *str1,
    +                                                         const char *str2);

    Compares str1 and str2 like strcmp(). Handles NULL -gracefully by sorting it before non-NULL strings.

    +gracefully by sorting it before non-NULL strings. +

    str :

    a nul-terminated string. +a nul-terminated string.

    suffix :

    the nul-terminated suffix to look for. +the nul-terminated suffix to look for.
    - - @@ -602,9 +595,9 @@ gracefully by sorting it before non-

    g_strlcpy ()

    -
    gsize               g_strlcpy                           (gchar *dest,
    -                                                         const gchar *src,
    -                                                         gsize dest_size);
    +
    gsize               g_strlcpy                           (gchar *dest,
    +                                                         const gchar *src,
    +                                                         gsize dest_size);

    Portability wrapper that calls strlcpy() on systems which have it, and emulates strlcpy() otherwise. Copies src to dest; dest is @@ -626,22 +619,24 @@ strlen (src), so if retval >= strcpy() or strncpy(), but if you really want to avoid screwups, g_strdup() is an even better idea.

    +

    +

    str1 :

    a C string or NULL +a C string or NULL

    str2 :

    another C string or NULL +another C string or NULL
    - - - @@ -655,9 +650,9 @@ strlen (src), so if retval >=

    g_strlcat ()

    -
    gsize               g_strlcat                           (gchar *dest,
    -                                                         const gchar *src,
    -                                                         gsize dest_size);
    +
    gsize               g_strlcat                           (gchar *dest,
    +                                                         const gchar *src,
    +                                                         gsize dest_size);

    Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise. Appends nul-terminated src string to dest, @@ -679,22 +674,24 @@ in the dest_size characters of dest to start with). strcat() or strncat(), but for real security g_strconcat() is harder to mess up.

    +

    +

    dest :

    destination buffer +destination buffer

    src :

    source buffer +source buffer

    dest_size :

    length of dest in bytes +length of dest in bytes
    - - - @@ -711,25 +708,26 @@ so if retval >= dest_size, truncation occurred.

    g_strdup_printf ()

    -
    gchar*              g_strdup_printf                     (const gchar *format,
    -                                                         ...);
    +
    gchar*              g_strdup_printf                     (const gchar *format,
    +                                                         ...);

    Similar to the standard C sprintf() function but safer, since it calculates the maximum space required and allocates memory to hold the result. The returned string should be freed with g_free() when no -longer needed.

    +longer needed. +

    dest :

    destination buffer, already containing one nul-terminated string +destination buffer, already containing one nul-terminated string

    src :

    source buffer +source buffer

    dest_size :

    length of dest buffer in bytes (not length of existing string +length of dest buffer in bytes (not length of existing string inside dest)
    - - @@ -743,8 +741,8 @@ longer needed.


    g_strdup_vprintf ()

    -
    gchar*              g_strdup_vprintf                    (const gchar *format,
    -                                                         va_list args);
    +
    gchar*              g_strdup_vprintf                    (const gchar *format,
    +                                                         va_list args);

    Similar to the standard C vsprintf() function but safer, since it calculates the maximum space required and allocates memory to hold @@ -753,19 +751,20 @@ no longer needed.

    See also g_vasprintf(), which offers the same functionality, but -additionally returns the length of the allocated string.

    +additionally returns the length of the allocated string. +

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls

    ... :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - @@ -779,23 +778,24 @@ additionally returns the length of the allocated string.


    g_printf ()

    -
    gint                g_printf                            (gchar const *format,
    -                                                         ...);
    +
    gint                g_printf                            (gchar const *format,
    +                                                         ...);

    An implementation of the standard printf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls

    args :

    the list of parameters to insert into the format string +the list of parameters to insert into the format string
    - - @@ -811,23 +811,24 @@ positional parameters, as specified in the Single Unix Specification.


    g_vprintf ()

    -
    gint                g_vprintf                           (gchar const *format,
    -                                                         va_list args);
    +
    gint                g_vprintf                           (gchar const *format,
    +                                                         va_list args);

    An implementation of the standard vprintf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    ... :

    the arguments to insert in the output. +the arguments to insert in the output.
    - - @@ -843,29 +844,30 @@ positional parameters, as specified in the Single Unix Specification.


    g_fprintf ()

    -
    gint                g_fprintf                           (FILE *file,
    -                                                         gchar const *format,
    -                                                         ...);
    +
    gint                g_fprintf                           (FILE *file,
    +                                                         gchar const *format,
    +                                                         ...);

    An implementation of the standard fprintf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    args :

    the list of arguments to insert in the output. +the list of arguments to insert in the output.
    - - - @@ -881,29 +883,30 @@ positional parameters, as specified in the Single Unix Specification.


    g_vfprintf ()

    -
    gint                g_vfprintf                          (FILE *file,
    -                                                         gchar const *format,
    -                                                         va_list args);
    +
    gint                g_vfprintf                          (FILE *file,
    +                                                         gchar const *format,
    +                                                         va_list args);

    An implementation of the standard fprintf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    file :

    the stream to write to. +the stream to write to.

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    ... :

    the arguments to insert in the output. +the arguments to insert in the output.
    - - - @@ -919,31 +922,32 @@ positional parameters, as specified in the Single Unix Specification.


    g_sprintf ()

    -
    gint                g_sprintf                           (gchar *string,
    -                                                         gchar const *format,
    -                                                         ...);
    +
    gint                g_sprintf                           (gchar *string,
    +                                                         gchar const *format,
    +                                                         ...);

    An implementation of the standard sprintf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    file :

    the stream to write to. +the stream to write to.

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    args :

    the list of arguments to insert in the output. +the list of arguments to insert in the output.
    - - - @@ -959,29 +963,30 @@ positional parameters, as specified in the Single Unix Specification.


    g_vsprintf ()

    -
    gint                g_vsprintf                          (gchar *string,
    -                                                         gchar const *format,
    -                                                         va_list args);
    +
    gint                g_vsprintf                          (gchar *string,
    +                                                         gchar const *format,
    +                                                         va_list args);

    An implementation of the standard vsprintf() function which supports -positional parameters, as specified in the Single Unix Specification.

    +positional parameters, as specified in the Single Unix Specification. +

    string :

    A pointer to a memory buffer to contain the resulting string. It +A pointer to a memory buffer to contain the resulting string. It is up to the caller to ensure that the allocated buffer is large enough to hold the formatted result

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    ... :

    the arguments to insert in the output. +the arguments to insert in the output.
    - - - @@ -997,10 +1002,10 @@ positional parameters, as specified in the Single Unix Specification.


    g_snprintf ()

    -
    gint                g_snprintf                          (gchar *string,
    -                                                         gulong n,
    -                                                         gchar const *format,
    -                                                         ...);
    +
    gint                g_snprintf                          (gchar *string,
    +                                                         gulong n,
    +                                                         gchar const *format,
    +                                                         ...);

    A safer form of the standard sprintf() function. The output is guaranteed to not exceed n characters (including the terminating nul character), so @@ -1022,30 +1027,31 @@ traditional snprintf(), which returns the length o

    The format string may contain positional parameters, as specified in -the Single Unix Specification.

    +the Single Unix Specification. +

    string :

    the buffer to hold the output. +the buffer to hold the output.

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    args :

    the list of arguments to insert in the output. +the list of arguments to insert in the output.
    - - - - @@ -1060,10 +1066,10 @@ the Single Unix Specification.


    g_vsnprintf ()

    -
    gint                g_vsnprintf                         (gchar *string,
    -                                                         gulong n,
    -                                                         gchar const *format,
    -                                                         va_list args);
    +
    gint                g_vsnprintf                         (gchar *string,
    +                                                         gulong n,
    +                                                         gchar const *format,
    +                                                         va_list args);

    A safer form of the standard vsprintf() function. The output is guaranteed to not exceed n characters (including the terminating nul character), so @@ -1085,30 +1091,31 @@ as standardized in ISO C99. Note that this is different from traditional

    The format string may contain positional parameters, as specified in -the Single Unix Specification.

    +the Single Unix Specification. +

    string :

    the buffer to hold the output. +the buffer to hold the output.

    n :

    the maximum number of bytes to produce (including the +the maximum number of bytes to produce (including the terminating nul character).

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    ... :

    the arguments to insert in the output. +the arguments to insert in the output.
    - - - - @@ -1123,32 +1130,33 @@ the Single Unix Specification.


    g_vasprintf ()

    -
    gint                g_vasprintf                         (gchar **string,
    -                                                         gchar const *format,
    -                                                         va_list args);
    +
    gint                g_vasprintf                         (gchar **string,
    +                                                         gchar const *format,
    +                                                         va_list args);

    An implementation of the GNU vasprintf() function which supports positional parameters, as specified in the Single Unix Specification. This function is similar to g_vsprintf(), except that it allocates a string to hold the output, instead of putting the output in a buffer -you allocate in advance.

    +you allocate in advance. +

    string :

    the buffer to hold the output. +the buffer to hold the output.

    n :

    the maximum number of bytes to produce (including the +the maximum number of bytes to produce (including the terminating nul character).

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    args :

    the list of arguments to insert in the output. +the list of arguments to insert in the output.
    - - - @@ -1164,8 +1172,8 @@ you allocate in advance.


    g_printf_string_upper_bound ()

    -
    gsize               g_printf_string_upper_bound         (const gchar *format,
    -                                                         va_list args);
    +
    gsize               g_printf_string_upper_bound         (const gchar *format,
    +                                                         va_list args);

    Calculates the maximum space needed to store the output of the sprintf() function. @@ -1194,7 +1202,7 @@ function.


    g_ascii_isalnum ()

    -
    gboolean            g_ascii_isalnum                     (gchar c);
    +
    gboolean            g_ascii_isalnum                     (gchar c);

    Determines whether a character is alphanumeric.

    @@ -1226,7 +1234,7 @@ possibly non-ASCII character in.

    g_ascii_isalpha ()

    -
    gboolean            g_ascii_isalpha                     (gchar c);
    +
    gboolean            g_ascii_isalpha                     (gchar c);

    Determines whether a character is alphabetic (i.e. a letter).

    @@ -1258,7 +1266,7 @@ possibly non-ASCII character in.

    g_ascii_iscntrl ()

    -
    gboolean            g_ascii_iscntrl                     (gchar c);
    +
    gboolean            g_ascii_iscntrl                     (gchar c);

    Determines whether a character is a control character.

    @@ -1290,7 +1298,7 @@ possibly non-ASCII character in.

    g_ascii_isdigit ()

    -
    gboolean            g_ascii_isdigit                     (gchar c);
    +
    gboolean            g_ascii_isdigit                     (gchar c);

    Determines whether a character is digit (0-9).

    @@ -1320,7 +1328,7 @@ non-ASCII character in.

    g_ascii_isgraph ()

    -
    gboolean            g_ascii_isgraph                     (gchar c);
    +
    gboolean            g_ascii_isgraph                     (gchar c);

    Determines whether a character is a printing character and not a space.

    @@ -1352,7 +1360,7 @@ possibly non-ASCII character in.

    g_ascii_islower ()

    -
    gboolean            g_ascii_islower                     (gchar c);
    +
    gboolean            g_ascii_islower                     (gchar c);

    Determines whether a character is an ASCII lower case letter.

    @@ -1384,7 +1392,7 @@ before passing a possibly non-ASCII character in.

    g_ascii_isprint ()

    -
    gboolean            g_ascii_isprint                     (gchar c);
    +
    gboolean            g_ascii_isprint                     (gchar c);

    Determines whether a character is a printing character.

    @@ -1416,7 +1424,7 @@ possibly non-ASCII character in.

    g_ascii_ispunct ()

    -
    gboolean            g_ascii_ispunct                     (gchar c);
    +
    gboolean            g_ascii_ispunct                     (gchar c);

    Determines whether a character is a punctuation character.

    @@ -1448,7 +1456,7 @@ possibly non-ASCII character in.

    g_ascii_isspace ()

    -
    gboolean            g_ascii_isspace                     (gchar c);
    +
    gboolean            g_ascii_isspace                     (gchar c);

    Determines whether a character is a white-space character.

    @@ -1480,7 +1488,7 @@ possibly non-ASCII character in.

    g_ascii_isupper ()

    -
    gboolean            g_ascii_isupper                     (gchar c);
    +
    gboolean            g_ascii_isupper                     (gchar c);

    Determines whether a character is an ASCII upper case letter.

    @@ -1512,7 +1520,7 @@ before passing a possibly non-ASCII character in.

    g_ascii_isxdigit ()

    -
    gboolean            g_ascii_isxdigit                    (gchar c);
    +
    gboolean            g_ascii_isxdigit                    (gchar c);

    Determines whether a character is a hexadecimal-digit character.

    @@ -1542,18 +1550,19 @@ possibly non-ASCII character in.

    g_ascii_digit_value ()

    -
    gint                g_ascii_digit_value                 (gchar c);
    +
    gint                g_ascii_digit_value                 (gchar c);

    Determines the numeric value of a character as a decimal digit. Differs from g_unichar_digit_value() because it takes a char, so there's no worry about sign extension if characters -are signed.

    +are signed. +

    string :

    the return location for the newly-allocated string. +the return location for the newly-allocated string.

    format :

    a standard printf() format string, but notice +a standard printf() format string, but notice string precision pitfalls.

    args :

    the list of arguments to insert in the output. +the list of arguments to insert in the output.
    - @@ -1568,18 +1577,19 @@ are signed.


    g_ascii_xdigit_value ()

    -
    gint                g_ascii_xdigit_value                (gchar c);
    +
    gint                g_ascii_xdigit_value                (gchar c);

    Determines the numeric value of a character as a hexidecimal digit. Differs from g_unichar_xdigit_value() because it takes a char, so there's no worry about sign extension if characters -are signed.

    +are signed. +

    c :

    an ASCII character. +an ASCII character.
    - @@ -1594,8 +1604,8 @@ are signed.


    g_ascii_strcasecmp ()

    -
    gint                g_ascii_strcasecmp                  (const gchar *s1,
    -                                                         const gchar *s2);
    +
    gint                g_ascii_strcasecmp                  (const gchar *s1,
    +                                                         const gchar *s2);

    Compare two strings, ignoring the case of ASCII characters.

    @@ -1611,18 +1621,19 @@ represent themselves. This includes UTF-8 and the ISO-8859-* charsets, but not for instance double-byte encodings like the Windows Codepage 932, where the trailing bytes of double-byte characters include all ASCII letters. If you compare two CP932 -strings using this function, you will get false matches.

    +strings using this function, you will get false matches. +

    c :

    an ASCII character. +an ASCII character.
    - - @@ -1637,9 +1648,9 @@ strings using this function, you will get false matches.


    g_ascii_strncasecmp ()

    -
    gint                g_ascii_strncasecmp                 (const gchar *s1,
    -                                                         const gchar *s2,
    -                                                         gsize n);
    +
    gint                g_ascii_strncasecmp                 (const gchar *s1,
    +                                                         const gchar *s2,
    +                                                         gsize n);

    Compare s1 and s2, ignoring the case of ASCII characters and any characters after the first n in each string. @@ -1652,23 +1663,24 @@ characters as if they are not letters.

    The same warning as in g_ascii_strcasecmp() applies: Use this function only on strings known to be in encodings where bytes -corresponding to ASCII letters always represent themselves.

    +corresponding to ASCII letters always represent themselves. +

    s1 :

    string to compare with s2. +string to compare with s2.

    s2 :

    string to compare with s1. +string to compare with s1.
    - - - @@ -1683,21 +1695,22 @@ corresponding to ASCII letters always represent themselves.


    g_ascii_strup ()

    -
    gchar*              g_ascii_strup                       (const gchar *str,
    -                                                         gssize len);
    +
    gchar*              g_ascii_strup                       (const gchar *str,
    +                                                         gssize len);

    -Converts all lower case ASCII letters to upper case ASCII letters.

    +Converts all lower case ASCII letters to upper case ASCII letters. +

    s1 :

    string to compare with s2. +string to compare with s2.

    s2 :

    string to compare with s1. +string to compare with s1.

    n :

    number of characters to compare. +number of characters to compare.
    - - @@ -1715,21 +1728,22 @@ Converts all lower case ASCII letters to upper case ASCII letters.


    g_ascii_strdown ()

    -
    gchar*              g_ascii_strdown                     (const gchar *str,
    -                                                         gssize len);
    +
    gchar*              g_ascii_strdown                     (const gchar *str,
    +                                                         gssize len);

    -Converts all upper case ASCII letters to lower case ASCII letters.

    +Converts all upper case ASCII letters to lower case ASCII letters. +

    str :

    a string. +a string.

    len :

    length of str in bytes, or -1 if str is nul-terminated. +length of str in bytes, or -1 if str is nul-terminated.
    - - @@ -1747,7 +1761,7 @@ Converts all upper case ASCII letters to lower case ASCII letters.


    g_ascii_tolower ()

    -
    gchar               g_ascii_tolower                     (gchar c);
    +
    gchar               g_ascii_tolower                     (gchar c);

    Convert a character to ASCII lower case.

    @@ -1758,13 +1772,14 @@ all non-ASCII characters unchanged, even if they are lower case letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on EOF but no need to worry about casting to guchar -before passing a possibly non-ASCII character in.

    +before passing a possibly non-ASCII character in. +

    str :

    a string. +a string.

    len :

    length of str in bytes, or -1 if str is nul-terminated. +length of str in bytes, or -1 if str is nul-terminated.
    - @@ -1780,7 +1795,7 @@ before passing a possibly non-ASCII character in.


    g_ascii_toupper ()

    -
    gchar               g_ascii_toupper                     (gchar c);
    +
    gchar               g_ascii_toupper                     (gchar c);

    Convert a character to ASCII upper case.

    @@ -1791,13 +1806,14 @@ all non-ASCII characters unchanged, even if they are upper case letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on EOF but no need to worry about casting to guchar -before passing a possibly non-ASCII character in.

    +before passing a possibly non-ASCII character in. +

    c :

    any character. +any character.
    - @@ -1813,15 +1829,16 @@ before passing a possibly non-ASCII character in.


    g_string_ascii_up ()

    -
    GString*            g_string_ascii_up                   (GString *string);
    +
    GString*            g_string_ascii_up                   (GString *string);

    -Converts all lower case ASCII letters to upper case ASCII letters.

    +Converts all lower case ASCII letters to upper case ASCII letters. +

    c :

    any character. +any character.
    - @@ -1837,15 +1854,16 @@ Converts all lower case ASCII letters to upper case ASCII letters.


    g_string_ascii_down ()

    -
    GString*            g_string_ascii_down                 (GString *string);
    +
    GString*            g_string_ascii_down                 (GString *string);

    -Converts all upper case ASCII letters to lower case ASCII letters.

    +Converts all upper case ASCII letters to lower case ASCII letters. +

    string :

    a GString +a GString
    - @@ -1861,20 +1879,21 @@ Converts all upper case ASCII letters to lower case ASCII letters.


    g_strup ()

    -
    gchar*              g_strup                             (gchar *string);
    +
    gchar*              g_strup                             (gchar *string);

    Warning

    g_strup has been deprecated since version 2.2 and should not be used in newly-written code. This function is totally broken for the reasons discussed in the g_strncasecmp() docs - use g_ascii_strup() or g_utf8_strup() instead.

    -Converts a string to upper case.

    +Converts a string to upper case. +

    string :

    a GString +a GString
    - @@ -1889,7 +1908,7 @@ Converts a string to upper case.


    g_strdown ()

    -
    gchar*              g_strdown                           (gchar *string);
    +
    gchar*              g_strdown                           (gchar *string);

    Warning

    g_strdown has been deprecated since version 2.2 and should not be used in newly-written code. This function is totally broken for the reasons discussed @@ -1897,13 +1916,14 @@ in the

    -Converts a string to lower case.

    +Converts a string to lower case. +

    string :

    the string to convert. +the string to convert.
    - @@ -1918,8 +1938,8 @@ Converts a string to lower case.


    g_strcasecmp ()

    -
    gint                g_strcasecmp                        (const gchar *s1,
    -                                                         const gchar *s2);
    +
    gint                g_strcasecmp                        (const gchar *s1,
    +                                                         const gchar *s2);

    Warning

    g_strcasecmp has been deprecated since version 2.2 and should not be used in newly-written code. See g_strncasecmp() for a discussion of why this function @@ -1927,18 +1947,19 @@ Converts a string to lower case.

    A case-insensitive string comparison, corresponding to the standard -strcasecmp() function on platforms which support it.

    +strcasecmp() function on platforms which support it. +

    string :

    the string to convert. +the string to convert.
    - - @@ -1954,9 +1975,9 @@ A case-insensitive string comparison, corresponding to the standard

    g_strncasecmp ()

    -
    gint                g_strncasecmp                       (const gchar *s1,
    -                                                         const gchar *s2,
    -                                                         guint n);
    +
    gint                g_strncasecmp                       (const gchar *s1,
    +                                                         const gchar *s2,
    +                                                         guint n);

    Warning

    g_strncasecmp has been deprecated since version 2.2 and should not be used in newly-written code. The problem with g_strncasecmp() is that it does the @@ -1978,23 +1999,24 @@ which only works on ASCII and is not locale-sensitive, and A case-insensitive string comparison, corresponding to the standard strncasecmp() function on platforms which support it. It is similar to g_strcasecmp() except it only compares the first n -characters of the strings.

    +characters of the strings. +

    s1 :

    a string. +a string.

    s2 :

    a string to compare with s1. +a string to compare with s1.
    - - - @@ -2010,7 +2032,7 @@ characters of the strings.


    g_strreverse ()

    -
    gchar*              g_strreverse                        (gchar *string);
    +
    gchar*              g_strreverse                        (gchar *string);

    Reverses all of the bytes in a string. For example, g_strreverse ("abcdef") will result @@ -2019,13 +2041,14 @@ in "fedcba".

    Note that g_strreverse() doesn't work on UTF-8 strings containing multibyte characters. For that purpose, use -g_utf8_strreverse().

    +g_utf8_strreverse(). +

    s1 :

    a string. +a string.

    s2 :

    a string to compare with s1. +a string to compare with s1.

    n :

    the maximum number of characters to compare. +the maximum number of characters to compare.
    - @@ -2039,9 +2062,9 @@ containing multibyte characters. For that purpose, use

    g_ascii_strtoll ()

    -
    gint64              g_ascii_strtoll                     (const gchar *nptr,
    -                                                         gchar **endptr,
    -                                                         guint base);
    +
    gint64              g_ascii_strtoll                     (const gchar *nptr,
    +                                                         gchar **endptr,
    +                                                         guint base);

    Converts a string to a gint64 value. This function behaves like the standard strtoll() function @@ -2060,24 +2083,25 @@ If the correct value would cause overflow, ERANGE is stored in errno. If the base is outside the valid range, zero is returned, and EINVAL is stored in errno. If the string conversion fails, zero is returned, and -endptr returns nptr (if endptr is non-NULL).

    +endptr returns nptr (if endptr is non-NULL). +

    string :

    the string to reverse +the string to reverse
    - - - @@ -2093,9 +2117,9 @@ in errno. If the string conversion fails, zero is

    g_ascii_strtoull ()

    -
    guint64             g_ascii_strtoull                    (const gchar *nptr,
    -                                                         gchar **endptr,
    -                                                         guint base);
    +
    guint64             g_ascii_strtoull                    (const gchar *nptr,
    +                                                         gchar **endptr,
    +                                                         guint base);

    Converts a string to a guint64 value. This function behaves like the standard strtoull() function @@ -2114,24 +2138,25 @@ If the correct value would cause overflow, ERANGE is stored in errno. If the base is outside the valid range, zero is returned, and EINVAL is stored in errno. If the string conversion fails, zero is returned, and -endptr returns nptr (if endptr is non-NULL).

    +endptr returns nptr (if endptr is non-NULL). +

    nptr :

    the string to convert to a numeric value. +the string to convert to a numeric value.

    endptr :

    if non-NULL, it returns the character after +if non-NULL, it returns the character after the last character used in the conversion.

    base :

    to be used for the conversion, 2..36 or 0 +to be used for the conversion, 2..36 or 0
    - - - @@ -2157,18 +2182,27 @@ It is guaranteed to be enough for all output of that function on systems with

    The typical usage would be something like:

    -
    -  char buf[G_ASCII_DTOSTR_BUF_SIZE];
    -  fprintf (out, "value=%s\n", g_ascii_dtostr (buf, sizeof (buf), value));
    -
    +
    +

    nptr :

    the string to convert to a numeric value. +the string to convert to a numeric value.

    endptr :

    if non-NULL, it returns the character after +if non-NULL, it returns the character after the last character used in the conversion.

    base :

    to be used for the conversion, 2..36 or 0 +to be used for the conversion, 2..36 or 0
    + + + + + + +
    1
    +2
    char buf[G_ASCII_DTOSTR_BUF_SIZE];
    +fprintf (out, "value=%s\n", g_ascii_dtostr (buf, sizeof (buf), value));
    + +


    g_ascii_strtod ()

    -
    gdouble             g_ascii_strtod                      (const gchar *nptr,
    -                                                         gchar **endptr);
    +
    gdouble             g_ascii_strtod                      (const gchar *nptr,
    +                                                         gchar **endptr);

    Converts a string to a gdouble value.

    @@ -2197,18 +2231,19 @@ zero is returned and ERANGE is stored in

    This function resets errno before calling strtod() so that -you can reliably detect overflow and underflow.

    +you can reliably detect overflow and underflow. +

    - - @@ -2223,9 +2258,9 @@ you can reliably detect overflow and underflow.


    g_ascii_dtostr ()

    -
    gchar *             g_ascii_dtostr                      (gchar *buffer,
    -                                                         gint buf_len,
    -                                                         gdouble d);
    +
    gchar *             g_ascii_dtostr                      (gchar *buffer,
    +                                                         gint buf_len,
    +                                                         gdouble d);

    Converts a gdouble to a string, using the '.' as decimal point. @@ -2235,23 +2270,24 @@ This functions generates enough precision that converting the string back using g_ascii_strtod() gives the same machine-number (on machines with IEEE compatible 64bit doubles). It is guaranteed that the size of the resulting string will never -be larger than G_ASCII_DTOSTR_BUF_SIZE bytes.

    +be larger than G_ASCII_DTOSTR_BUF_SIZE bytes. +

    nptr :

    the string to convert to a numeric value. +the string to convert to a numeric value.

    endptr :

    if non-NULL, it returns the character after +if non-NULL, it returns the character after the last character used in the conversion.
    - - - @@ -2265,10 +2301,10 @@ be larger than G_ASCII_DTOSTR_BUF_SIZE b

    g_ascii_formatd ()

    -
    gchar *             g_ascii_formatd                     (gchar *buffer,
    -                                                         gint buf_len,
    -                                                         const gchar *format,
    -                                                         gdouble d);
    +
    gchar *             g_ascii_formatd                     (gchar *buffer,
    +                                                         gint buf_len,
    +                                                         const gchar *format,
    +                                                         gdouble d);

    Converts a gdouble to a string, using the '.' as decimal point. To format the number you pass in @@ -2277,29 +2313,30 @@ specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.

    If you just want to want to serialize the value into a -string, use g_ascii_dtostr().

    +string, use g_ascii_dtostr(). +

    buffer :

    A buffer to place the resulting string in +A buffer to place the resulting string in

    buf_len :

    The length of the buffer. +The length of the buffer.

    d :

    The gdouble to convert +The gdouble to convert
    - - - - @@ -2313,8 +2350,8 @@ string, use

    g_strtod ()

    -
    gdouble             g_strtod                            (const gchar *nptr,
    -                                                         gchar **endptr);
    +
    gdouble             g_strtod                            (const gchar *nptr,
    +                                                         gchar **endptr);

    Converts a string to a gdouble value. It calls the standard strtod() function to handle the conversion, but @@ -2327,18 +2364,19 @@ numbers not for human consumption is to use

    buffer :

    A buffer to place the resulting string in +A buffer to place the resulting string in

    buf_len :

    The length of the buffer. +The length of the buffer.

    format :

    The printf()-style format to use for the +The printf()-style format to use for the code to use for converting.

    d :

    The gdouble to convert +The gdouble to convert
    - - @@ -2353,7 +2391,7 @@ point in some locales, causing unexpected results.


    g_strchug ()

    -
    gchar*              g_strchug                           (gchar *string);
    +
    gchar*              g_strchug                           (gchar *string);

    Removes leading whitespace from a string, by moving the rest of the characters forward. @@ -2385,7 +2423,7 @@ Also see

    g_strchomp ()

    -
    gchar*              g_strchomp                          (gchar *string);
    +
    gchar*              g_strchomp                          (gchar *string);

    Removes trailing whitespace from a string.

    @@ -2433,9 +2471,9 @@ Removes leading and trailing whitespace from a string. See

    g_strdelimit ()

    -
    gchar*              g_strdelimit                        (gchar *string,
    -                                                         const gchar *delimiters,
    -                                                         gchar new_delimiter);
    +
    gchar*              g_strdelimit                        (gchar *string,
    +                                                         const gchar *delimiters,
    +                                                         gchar new_delimiter);

    Converts any delimiter characters in string to new_delimiter. Any characters in string which are found in delimiters are changed @@ -2483,8 +2521,8 @@ The standard delimiters, used in

    g_strescape ()

    -
    gchar*              g_strescape                         (const gchar *source,
    -                                                         const gchar *exceptions);
    +
    gchar*              g_strescape                         (const gchar *source,
    +                                                         const gchar *exceptions);

    Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\' and '"' in the string source by inserting a '\' before @@ -2521,7 +2559,7 @@ characters escaped. See above.


    g_strcompress ()

    -
    gchar*              g_strcompress                       (const gchar *source);
    +
    gchar*              g_strcompress                       (const gchar *source);

    Replaces all escaped characters with their one byte equivalent. It does the reverse conversion of g_strescape(). @@ -2546,9 +2584,9 @@ character compressed.


    g_strcanon ()

    -
    gchar*              g_strcanon                          (gchar *string,
    -                                                         const gchar *valid_chars,
    -                                                         gchar substitutor);
    +
    gchar*              g_strcanon                          (gchar *string,
    +                                                         const gchar *valid_chars,
    +                                                         gchar substitutor);

    For each character in string, if the character is not in valid_chars, replaces the character with substitutor. Modifies string in place, @@ -2585,9 +2623,9 @@ nesting such as g_ascii_strup (g_strcanon (str, "abc", '?'


    g_strsplit ()

    -
    gchar**             g_strsplit                          (const gchar *string,
    -                                                         const gchar *delimiter,
    -                                                         gint max_tokens);
    +
    gchar**             g_strsplit                          (const gchar *string,
    +                                                         const gchar *delimiter,
    +                                                         gint max_tokens);

    Splits a string into a maximum of max_tokens pieces, using the given delimiter. If max_tokens is reached, the remainder of string is appended @@ -2599,25 +2637,26 @@ vector, not a vector containing a single string. The reason for this special case is that being able to represent a empty vector is typically more useful than consistent handling of empty elements. If you do need to represent empty elements, you'll need to check for the empty string -before calling g_strsplit().

    +before calling g_strsplit(). +

    nptr :

    the string to convert to a numeric value. +the string to convert to a numeric value.

    endptr :

    if non-NULL, it returns the character after +if non-NULL, it returns the character after the last character used in the conversion.
    - - - @@ -2633,9 +2672,9 @@ before calling

    g_strsplit_set ()

    -
    gchar **            g_strsplit_set                      (const gchar *string,
    -                                                         const gchar *delimiters,
    -                                                         gint max_tokens);
    +
    gchar **            g_strsplit_set                      (const gchar *string,
    +                                                         const gchar *delimiters,
    +                                                         gint max_tokens);

    Splits string into a number of tokens not containing any of the characters in delimiter. A token is the (possibly empty) longest string that does not @@ -2661,24 +2700,25 @@ before calling

    string :

    a string to split. +a string to split.

    delimiter :

    a string which specifies the places at which to split the string. +a string which specifies the places at which to split the string. The delimiter is not included in any of the resulting strings, unless max_tokens is reached.

    max_tokens :

    the maximum number of pieces to split string into. If this is +the maximum number of pieces to split string into. If this is less than 1, the string is split completely.
    - - - @@ -2696,15 +2736,16 @@ to delimit UTF-8 strings for anything but ASCII characters.


    g_strfreev ()

    -
    void                g_strfreev                          (gchar **str_array);
    +
    void                g_strfreev                          (gchar **str_array);

    Frees a NULL-terminated array of strings, and the array itself. -If called on a NULL value, g_strfreev() simply returns.

    +If called on a NULL value, g_strfreev() simply returns. +

    string :

    The string to be tokenized +The string to be tokenized

    delimiters :

    A nul-terminated string containing bytes that are used +A nul-terminated string containing bytes that are used to split the string.

    max_tokens :

    The maximum number of tokens to split string into. +The maximum number of tokens to split string into. If this is less than 1, the string is split completely
    -

    str_array :

    a NULL-terminated array of strings to free. +a NULL-terminated array of strings to free.
    @@ -2712,8 +2753,8 @@ If called on a

    g_strconcat ()

    -
    gchar*              g_strconcat                         (const gchar *string1,
    -                                                         ...);
    +
    gchar*              g_strconcat                         (const gchar *string1,
    +                                                         ...);

    Concatenates all of the given strings into one long string. The returned string should be freed with g_free() when no longer needed. @@ -2726,17 +2767,19 @@ The returned string should be freed with NULL. If you forget the NULL, g_strconcat() will start appending random memory junk to your string.

    +

    +

    - - @@ -2750,23 +2793,24 @@ random memory junk to your string.


    g_strjoin ()

    -
    gchar*              g_strjoin                           (const gchar *separator,
    -                                                         ...);
    +
    gchar*              g_strjoin                           (const gchar *separator,
    +                                                         ...);

    Joins a number of strings together to form one long string, with the optional separator inserted between each of them. The returned string -should be freed with g_free().

    +should be freed with g_free(). +

    string1 :

    the first string to add, which must not be NULL +the first string to add, which must not be NULL

    ... :

    a NULL-terminated list of strings to append to the string +a NULL-terminated list of strings to append to the string
    - - @@ -2781,23 +2825,24 @@ should be freed with

    g_strjoinv ()

    -
    gchar*              g_strjoinv                          (const gchar *separator,
    -                                                         gchar **str_array);
    +
    gchar*              g_strjoinv                          (const gchar *separator,
    +                                                         gchar **str_array);

    Joins a number of strings together to form one long string, with the optional separator inserted between each of them. The returned string -should be freed with g_free().

    +should be freed with g_free(). +

    separator :

    a string to insert between each of the strings, or NULL +a string to insert between each of the strings, or NULL

    ... :

    a NULL-terminated list of strings to join +a NULL-terminated list of strings to join
    - - @@ -2812,16 +2857,17 @@ should be freed with

    g_strv_length ()

    -
    guint               g_strv_length                       (gchar **str_array);
    +
    guint               g_strv_length                       (gchar **str_array);

    Returns the length of the given NULL-terminated -string array str_array.

    +string array str_array. +

    separator :

    a string to insert between each of the strings, or NULL +a string to insert between each of the strings, or NULL

    str_array :

    a NULL-terminated array of strings to join +a NULL-terminated array of strings to join
    - @@ -2837,18 +2883,19 @@ string array str_array.


    g_strerror ()

    -
    const gchar*        g_strerror                          (gint errnum);
    +
    const gchar*        g_strerror                          (gint errnum);

    Returns a string corresponding to the given error code, e.g. "no such process". You should use this function in preference to strerror(), because it returns a string in UTF-8 encoding, and since -not all platforms support the strerror() function.

    +not all platforms support the strerror() function. +

    str_array :

    a NULL-terminated array of strings. +a NULL-terminated array of strings.
    - @@ -2865,18 +2912,19 @@ not all platforms support the strerror() function.

    g_strsignal ()

    -
    const gchar*        g_strsignal                         (gint signum);
    +
    const gchar*        g_strsignal                         (gint signum);

    Returns a string describing the given signal, e.g. "Segmentation fault". You should use this function in preference to strsignal(), because it returns a string in UTF-8 encoding, and since not all platforms support -the strsignal() function.

    +the strsignal() function. +

    errnum :

    the system error number. See the standard C errno +the system error number. See the standard C errno documentation
    - @@ -2894,6 +2942,6 @@ the strsignal() function.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Strings.html b/docs/reference/glib/html/glib-Strings.html index 05a20c9..f239856 100644 --- a/docs/reference/glib/html/glib-Strings.html +++ b/docs/reference/glib/html/glib-Strings.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    signum :

    the signal number. See the signal +the signal number. See the signal documentation
    @@ -61,84 +41,84 @@ #include <glib.h> GString; -GString* g_string_new (const gchar *init); -GString* g_string_new_len (const gchar *init, - gssize len); -GString* g_string_sized_new (gsize dfl_size); -GString* g_string_assign (GString *string, - const gchar *rval); +GString* g_string_new (const gchar *init); +GString* g_string_new_len (const gchar *init, + gssize len); +GString* g_string_sized_new (gsize dfl_size); +GString* g_string_assign (GString *string, + const gchar *rval); #define g_string_sprintf #define g_string_sprintfa -voidg_string_vprintf (GString *string, - const gchar *format, - va_list args); -voidg_string_append_vprintf (GString *string, - const gchar *format, - va_list args); -voidg_string_printf (GString *string, - const gchar *format, - ...); -voidg_string_append_printf (GString *string, - const gchar *format, - ...); -GString* g_string_append (GString *string, - const gchar *val); -GString* g_string_append_c (GString *string, - gchar c); -GString* g_string_append_unichar (GString *string, - gunichar wc); -GString* g_string_append_len (GString *string, - const gchar *val, - gssize len); -GString * g_string_append_uri_escaped (GString *string, - const char *unescaped, - const char *reserved_chars_allowed, - gboolean allow_utf8); -GString* g_string_prepend (GString *string, - const gchar *val); -GString* g_string_prepend_c (GString *string, - gchar c); -GString* g_string_prepend_unichar (GString *string, - gunichar wc); -GString* g_string_prepend_len (GString *string, - const gchar *val, - gssize len); -GString* g_string_insert (GString *string, - gssize pos, - const gchar *val); -GString* g_string_insert_c (GString *string, - gssize pos, - gchar c); -GString* g_string_insert_unichar (GString *string, - gssize pos, - gunichar wc); -GString* g_string_insert_len (GString *string, - gssize pos, - const gchar *val, - gssize len); -GString* g_string_overwrite (GString *string, - gsize pos, - const gchar *val); -GString* g_string_overwrite_len (GString *string, - gsize pos, - const gchar *val, - gssize len); -GString* g_string_erase (GString *string, - gssize pos, - gssize len); -GString* g_string_truncate (GString *string, - gsize len); -GString* g_string_set_size (GString *string, - gsize len); -gchar* g_string_free (GString *string, - gboolean free_segment); +voidg_string_vprintf (GString *string, + const gchar *format, + va_list args); +voidg_string_append_vprintf (GString *string, + const gchar *format, + va_list args); +voidg_string_printf (GString *string, + const gchar *format, + ...); +voidg_string_append_printf (GString *string, + const gchar *format, + ...); +GString* g_string_append (GString *string, + const gchar *val); +GString* g_string_append_c (GString *string, + gchar c); +GString* g_string_append_unichar (GString *string, + gunichar wc); +GString* g_string_append_len (GString *string, + const gchar *val, + gssize len); +GString * g_string_append_uri_escaped (GString *string, + const char *unescaped, + const char *reserved_chars_allowed, + gboolean allow_utf8); +GString* g_string_prepend (GString *string, + const gchar *val); +GString* g_string_prepend_c (GString *string, + gchar c); +GString* g_string_prepend_unichar (GString *string, + gunichar wc); +GString* g_string_prepend_len (GString *string, + const gchar *val, + gssize len); +GString* g_string_insert (GString *string, + gssize pos, + const gchar *val); +GString* g_string_insert_c (GString *string, + gssize pos, + gchar c); +GString* g_string_insert_unichar (GString *string, + gssize pos, + gunichar wc); +GString* g_string_insert_len (GString *string, + gssize pos, + const gchar *val, + gssize len); +GString* g_string_overwrite (GString *string, + gsize pos, + const gchar *val); +GString* g_string_overwrite_len (GString *string, + gsize pos, + const gchar *val, + gssize len); +GString* g_string_erase (GString *string, + gssize pos, + gssize len); +GString* g_string_truncate (GString *string, + gsize len); +GString* g_string_set_size (GString *string, + gsize len); +gchar* g_string_free (GString *string, + gboolean free_segment); -GString* g_string_up (GString *string); -GString* g_string_down (GString *string); +GString* g_string_up (GString *string); +GString* g_string_down (GString *string); -guintg_string_hash (const GString *str); -gbooleang_string_equal (const GString *v, - const GString *v2); +guintg_string_hash (const GString *str); +gbooleang_string_equal (const GString *v, + const GString *v2);
    @@ -191,15 +171,16 @@ The

    g_string_new ()

    -
    GString*            g_string_new                        (const gchar *init);
    +
    GString*            g_string_new                        (const gchar *init);

    -Creates a new GString, initialized with the given string.

    +Creates a new GString, initialized with the given string. +

    - @@ -213,8 +194,8 @@ Creates a new <

    g_string_new_len ()

    -
    GString*            g_string_new_len                    (const gchar *init,
    -                                                         gssize len);
    +
    GString*            g_string_new_len                    (const gchar *init,
    +                                                         gssize len);

    Creates a new GString with len bytes of the init buffer. Because a length is provided, init need not be nul-terminated, @@ -223,18 +204,19 @@ and can contain embedded nul bytes.

    Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that init has at least len addressable -bytes.

    +bytes. +

    init :

    the initial text to copy into the string +the initial text to copy into the string
    - - @@ -248,18 +230,19 @@ bytes.


    g_string_sized_new ()

    -
    GString*            g_string_sized_new                  (gsize dfl_size);
    +
    GString*            g_string_sized_new                  (gsize dfl_size);

    Creates a new GString, with enough space for dfl_size bytes. This is useful if you are going to add a lot of text to the string and don't want it to be reallocated -too often.

    +too often. +

    init :

    initial contents of the string +initial contents of the string

    len :

    length of init to use +length of init to use
    - @@ -274,25 +257,26 @@ too often.


    g_string_assign ()

    -
    GString*            g_string_assign                     (GString *string,
    -                                                         const gchar *rval);
    +
    GString*            g_string_assign                     (GString *string,
    +                                                         const gchar *rval);

    Copies the bytes from a string into a GString, destroying any previous contents. It is rather like the standard strcpy() function, except that you do not -have to worry about having enough space to copy the string.

    +have to worry about having enough space to copy the string. +

    dfl_size :

    the default size of the space allocated to +the default size of the space allocated to hold the string
    - - @@ -316,23 +300,24 @@ Writes a formatted string into a sprintf() function, except that the GString buffer automatically expands to contain the results. The previous contents of the -GString are destroyed.

    +GString are destroyed. +

    string :

    the destination GString. Its current contents +the destination GString. Its current contents are destroyed.

    rval :

    the string to copy into string +the string to copy into string
    - - - @@ -349,23 +334,24 @@ to contain the results. The previous contents of the

    Appends a formatted string onto the end of a GString. This function is similar to g_string_sprintf() except that -the text is appended to the GString.

    +the text is appended to the GString. +

    string :

    a GString +a GString

    format :

    the string format. See the sprintf() documentation +the string format. See the sprintf() documentation

    ... :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - - @@ -374,29 +360,30 @@ the text is appended to the

    g_string_vprintf ()

    -
    void                g_string_vprintf                    (GString *string,
    -                                                         const gchar *format,
    -                                                         va_list args);
    +
    void                g_string_vprintf                    (GString *string,
    +                                                         const gchar *format,
    +                                                         va_list args);

    Writes a formatted string into a GString. This function is similar to g_string_printf() except that -the arguments to the format string are passed as a va_list.

    +the arguments to the format string are passed as a va_list. +

    string :

    a GString +a GString

    format :

    the string format. See the sprintf() documentation +the string format. See the sprintf() documentation

    ... :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - - @@ -406,30 +393,31 @@ the arguments to the format string are passed as a va_list.


    g_string_append_vprintf ()

    -
    void                g_string_append_vprintf             (GString *string,
    -                                                         const gchar *format,
    -                                                         va_list args);
    +
    void                g_string_append_vprintf             (GString *string,
    +                                                         const gchar *format,
    +                                                         va_list args);

    Appends a formatted string onto the end of a GString. This function is similar to g_string_append_printf() except that the arguments to the format string are passed -as a va_list.

    +as a va_list. +

    string :

    a GString +a GString

    format :

    the string format. See the printf() documentation +the string format. See the printf() documentation

    args :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - - @@ -439,31 +427,32 @@ as a va_list.


    g_string_printf ()

    -
    void                g_string_printf                     (GString *string,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_string_printf                     (GString *string,
    +                                                         const gchar *format,
    +                                                         ...);

    Writes a formatted string into a GString. This is similar to the standard sprintf() function, except that the GString buffer automatically expands to contain the results. The previous contents of the -GString are destroyed.

    +GString are destroyed. +

    string :

    a GString +a GString

    format :

    the string format. See the printf() documentation +the string format. See the printf() documentation

    args :

    the list of arguments to insert in the output +the list of arguments to insert in the output
    - - - @@ -472,29 +461,30 @@ to contain the results. The previous contents of the

    g_string_append_printf ()

    -
    void                g_string_append_printf              (GString *string,
    -                                                         const gchar *format,
    -                                                         ...);
    +
    void                g_string_append_printf              (GString *string,
    +                                                         const gchar *format,
    +                                                         ...);

    Appends a formatted string onto the end of a GString. This function is similar to g_string_printf() except -that the text is appended to the GString.

    +that the text is appended to the GString. +

    string :

    a GString +a GString

    format :

    the string format. See the printf() documentation +the string format. See the printf() documentation

    ... :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - - @@ -503,22 +493,23 @@ that the text is appended to the

    g_string_append ()

    -
    GString*            g_string_append                     (GString *string,
    -                                                         const gchar *val);
    +
    GString*            g_string_append                     (GString *string,
    +                                                         const gchar *val);

    Adds a string onto the end of a GString, expanding -it if necessary.

    +it if necessary. +

    string :

    a GString +a GString

    format :

    the string format. See the printf() documentation +the string format. See the printf() documentation

    ... :

    the parameters to insert into the format string +the parameters to insert into the format string
    - - @@ -532,22 +523,23 @@ it if necessary.


    g_string_append_c ()

    -
    GString*            g_string_append_c                   (GString *string,
    -                                                         gchar c);
    +
    GString*            g_string_append_c                   (GString *string,
    +                                                         gchar c);

    Adds a byte onto the end of a GString, expanding -it if necessary.

    +it if necessary. +

    string :

    a GString +a GString

    val :

    the string to append onto the end of string +the string to append onto the end of string
    - - @@ -561,22 +553,23 @@ it if necessary.


    g_string_append_unichar ()

    -
    GString*            g_string_append_unichar             (GString *string,
    -                                                         gunichar wc);
    +
    GString*            g_string_append_unichar             (GString *string,
    +                                                         gunichar wc);

    Converts a Unicode character into UTF-8, and appends it -to the string.

    +to the string. +

    string :

    a GString +a GString

    c :

    the byte to append onto the end of string +the byte to append onto the end of string
    - - @@ -590,9 +583,9 @@ to the string.


    g_string_append_len ()

    -
    GString*            g_string_append_len                 (GString *string,
    -                                                         const gchar *val,
    -                                                         gssize len);
    +
    GString*            g_string_append_len                 (GString *string,
    +                                                         const gchar *val,
    +                                                         gssize len);

    Appends len bytes of val to string. Because len is provided, val may contain embedded nuls and need not @@ -601,23 +594,24 @@ be nul-terminated.

    Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that val has at -least len addressable bytes.

    +least len addressable bytes. +

    string :

    a GString +a GString

    wc :

    a Unicode character +a Unicode character
    - - - @@ -631,34 +625,35 @@ least len addressable bytes.


    g_string_append_uri_escaped ()

    -
    GString *           g_string_append_uri_escaped         (GString *string,
    -                                                         const char *unescaped,
    -                                                         const char *reserved_chars_allowed,
    -                                                         gboolean allow_utf8);
    +
    GString *           g_string_append_uri_escaped         (GString *string,
    +                                                         const char *unescaped,
    +                                                         const char *reserved_chars_allowed,
    +                                                         gboolean allow_utf8);

    Appends unescaped to string, escaped any characters that -are reserved in URIs using URI-style escape sequences.

    +are reserved in URIs using URI-style escape sequences. +

    string :

    a GString +a GString

    val :

    bytes to append +bytes to append

    len :

    number of bytes of val to use +number of bytes of val to use
    - - - - @@ -674,22 +669,23 @@ are reserved in URIs using URI-style escape sequences.


    g_string_prepend ()

    -
    GString*            g_string_prepend                    (GString *string,
    -                                                         const gchar *val);
    +
    GString*            g_string_prepend                    (GString *string,
    +                                                         const gchar *val);

    Adds a string on to the start of a GString, -expanding it if necessary.

    +expanding it if necessary. +

    string :

    a GString +a GString

    unescaped :

    a string +a string

    reserved_chars_allowed :

    a string of reserved characters allowed to be used +a string of reserved characters allowed to be used

    allow_utf8 :

    set TRUE if the escaped string may include UTF8 characters +set TRUE if the escaped string may include UTF8 characters
    - - @@ -703,22 +699,23 @@ expanding it if necessary.


    g_string_prepend_c ()

    -
    GString*            g_string_prepend_c                  (GString *string,
    -                                                         gchar c);
    +
    GString*            g_string_prepend_c                  (GString *string,
    +                                                         gchar c);

    Adds a byte onto the start of a GString, -expanding it if necessary.

    +expanding it if necessary. +

    string :

    a GString +a GString

    val :

    the string to prepend on the start of string +the string to prepend on the start of string
    - - @@ -732,22 +729,23 @@ expanding it if necessary.


    g_string_prepend_unichar ()

    -
    GString*            g_string_prepend_unichar            (GString *string,
    -                                                         gunichar wc);
    +
    GString*            g_string_prepend_unichar            (GString *string,
    +                                                         gunichar wc);

    Converts a Unicode character into UTF-8, and prepends it -to the string.

    +to the string. +

    string :

    a GString +a GString

    c :

    the byte to prepend on the start of the GString +the byte to prepend on the start of the GString
    - - @@ -761,9 +759,9 @@ to the string.


    g_string_prepend_len ()

    -
    GString*            g_string_prepend_len                (GString *string,
    -                                                         const gchar *val,
    -                                                         gssize len);
    +
    GString*            g_string_prepend_len                (GString *string,
    +                                                         const gchar *val,
    +                                                         gssize len);

    Prepends len bytes of val to string. Because len is provided, val may contain @@ -772,23 +770,24 @@ embedded nuls and need not be nul-terminated.

    Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that -val has at least len addressable bytes.

    +val has at least len addressable bytes. +

    string :

    a GString +a GString

    wc :

    a Unicode character +a Unicode character
    - - - @@ -802,28 +801,29 @@ it is the caller's responsibility to ensure that

    g_string_insert ()

    -
    GString*            g_string_insert                     (GString *string,
    -                                                         gssize pos,
    -                                                         const gchar *val);
    +
    GString*            g_string_insert                     (GString *string,
    +                                                         gssize pos,
    +                                                         const gchar *val);

    Inserts a copy of a string into a GString, -expanding it if necessary.

    +expanding it if necessary. +

    string :

    a GString +a GString

    val :

    bytes to prepend +bytes to prepend

    len :

    number of bytes in val to prepend +number of bytes in val to prepend
    - - - @@ -837,27 +837,28 @@ expanding it if necessary.


    g_string_insert_c ()

    -
    GString*            g_string_insert_c                   (GString *string,
    -                                                         gssize pos,
    -                                                         gchar c);
    +
    GString*            g_string_insert_c                   (GString *string,
    +                                                         gssize pos,
    +                                                         gchar c);

    -Inserts a byte into a GString, expanding it if necessary.

    +Inserts a byte into a GString, expanding it if necessary. +

    string :

    a GString +a GString

    pos :

    the position to insert the copy of the string +the position to insert the copy of the string

    val :

    the string to insert +the string to insert
    - - - @@ -871,29 +872,30 @@ Inserts a byte into a

    g_string_insert_unichar ()

    -
    GString*            g_string_insert_unichar             (GString *string,
    -                                                         gssize pos,
    -                                                         gunichar wc);
    +
    GString*            g_string_insert_unichar             (GString *string,
    +                                                         gssize pos,
    +                                                         gunichar wc);

    Converts a Unicode character into UTF-8, and insert it -into the string at the given position.

    +into the string at the given position. +

    string :

    a GString +a GString

    pos :

    the position to insert the byte +the position to insert the byte

    c :

    the byte to insert +the byte to insert
    - - - @@ -907,10 +909,10 @@ into the string at the given position.


    g_string_insert_len ()

    -
    GString*            g_string_insert_len                 (GString *string,
    -                                                         gssize pos,
    -                                                         const gchar *val,
    -                                                         gssize len);
    +
    GString*            g_string_insert_len                 (GString *string,
    +                                                         gssize pos,
    +                                                         const gchar *val,
    +                                                         gssize len);

    Inserts len bytes of val into string at pos. Because len is provided, val may contain embedded @@ -920,29 +922,30 @@ bytes are inserted at the end of the string.

    Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that val has at -least len addressable bytes.

    +least len addressable bytes. +

    string :

    a GString +a GString

    pos :

    the position at which to insert character, or -1 to +the position at which to insert character, or -1 to append at the end of the string

    wc :

    a Unicode character +a Unicode character
    - - - - @@ -956,27 +959,28 @@ least len addressable bytes.


    g_string_overwrite ()

    -
    GString*            g_string_overwrite                  (GString *string,
    -                                                         gsize pos,
    -                                                         const gchar *val);
    +
    GString*            g_string_overwrite                  (GString *string,
    +                                                         gsize pos,
    +                                                         const gchar *val);

    -Overwrites part of a string, lengthening it if necessary.

    +Overwrites part of a string, lengthening it if necessary. +

    string :

    a GString +a GString

    pos :

    position in string where insertion should +position in string where insertion should happen, or -1 for at the end

    val :

    bytes to insert +bytes to insert

    len :

    number of bytes of val to insert +number of bytes of val to insert
    - - - @@ -992,34 +996,35 @@ Overwrites part of a string, lengthening it if necessary.


    g_string_overwrite_len ()

    -
    GString*            g_string_overwrite_len              (GString *string,
    -                                                         gsize pos,
    -                                                         const gchar *val,
    -                                                         gssize len);
    +
    GString*            g_string_overwrite_len              (GString *string,
    +                                                         gsize pos,
    +                                                         const gchar *val,
    +                                                         gssize len);

    Overwrites part of a string, lengthening it if necessary. -This function will work with embedded nuls.

    +This function will work with embedded nuls. +

    string :

    a GString +a GString

    pos :

    the position at which to start overwriting +the position at which to start overwriting

    val :

    the string that will overwrite the string starting at pos +the string that will overwrite the string starting at pos
    - - - - @@ -1035,28 +1040,29 @@ This function will work with embedded nuls.


    g_string_erase ()

    -
    GString*            g_string_erase                      (GString *string,
    -                                                         gssize pos,
    -                                                         gssize len);
    +
    GString*            g_string_erase                      (GString *string,
    +                                                         gssize pos,
    +                                                         gssize len);

    Removes len bytes from a GString, starting at position pos. -The rest of the GString is shifted down to fill the gap.

    +The rest of the GString is shifted down to fill the gap. +

    string :

    a GString +a GString

    pos :

    the position at which to start overwriting +the position at which to start overwriting

    val :

    the string that will overwrite the string starting at pos +the string that will overwrite the string starting at pos

    len :

    the number of bytes to write from val +the number of bytes to write from val
    - - - @@ -1071,21 +1077,22 @@ The rest of the

    g_string_truncate ()

    -
    GString*            g_string_truncate                   (GString *string,
    -                                                         gsize len);
    +
    GString*            g_string_truncate                   (GString *string,
    +                                                         gsize len);

    -Cuts off the end of the GString, leaving the first len bytes.

    +Cuts off the end of the GString, leaving the first len bytes. +

    string :

    a GString +a GString

    pos :

    the position of the content to remove +the position of the content to remove

    len :

    the number of bytes to remove, or -1 to remove all +the number of bytes to remove, or -1 to remove all following bytes
    - - @@ -1099,25 +1106,26 @@ Cuts off the end of the GString, leaving the first l

    g_string_set_size ()

    -
    GString*            g_string_set_size                   (GString *string,
    -                                                         gsize len);
    +
    GString*            g_string_set_size                   (GString *string,
    +                                                         gsize len);

    Sets the length of a GString. If the length is less than the current length, the string will be truncated. If the length is greater than the current length, the contents of the newly added area are undefined. (However, as -always, string->str[string->len] will be a nul byte.)

    +always, string->str[string->len] will be a nul byte.) +

    string :

    a GString +a GString

    len :

    the new size of string +the new size of string
    - - @@ -1131,22 +1139,23 @@ always, string->str[string->len] will be a nul byte.)


    g_string_free ()

    -
    gchar*              g_string_free                       (GString *string,
    -                                                         gboolean free_segment);
    +
    gchar*              g_string_free                       (GString *string,
    +                                                         gboolean free_segment);

    Frees the memory allocated for the GString. -If free_segment is TRUE it also frees the character data.

    +If free_segment is TRUE it also frees the character data. +

    string :

    a GString +a GString

    len :

    the new length +the new length
    - - @@ -1161,7 +1170,7 @@ If free_segment is

    g_string_up ()

    -
    GString*            g_string_up                         (GString *string);
    +
    GString*            g_string_up                         (GString *string);

    Warning

    g_string_up has been deprecated since version 2.2 and should not be used in newly-written code. This function uses the locale-specific @@ -1169,13 +1178,14 @@ If free_segment is g_string_ascii_up() or g_utf8_strup() instead.

    -Converts a GString to uppercase.

    +Converts a GString to uppercase. +

    string :

    a GString +a GString

    free_segment :

    if TRUE the actual character data is freed as well +if TRUE the actual character data is freed as well
    - @@ -1190,7 +1200,7 @@ Converts a

    g_string_down ()

    -
    GString*            g_string_down                       (GString *string);
    +
    GString*            g_string_down                       (GString *string);

    Warning

    g_string_down has been deprecated since version 2.2 and should not be used in newly-written code. This function uses the locale-specific @@ -1198,13 +1208,14 @@ Converts a g_string_ascii_down() or g_utf8_strdown() instead.

    -Converts a GString to lowercase.

    +Converts a GString to lowercase. +

    string :

    a GString +a GString
    - @@ -1219,15 +1230,16 @@ Converts a

    g_string_hash ()

    -
    guint               g_string_hash                       (const GString *str);
    +
    guint               g_string_hash                       (const GString *str);

    -Creates a hash code for str; for use with GHashTable.

    +Creates a hash code for str; for use with GHashTable. +

    string :

    a GString +a GString
    - @@ -1241,22 +1253,23 @@ Creates a hash code for str; for use wit

    g_string_equal ()

    -
    gboolean            g_string_equal                      (const GString *v,
    -                                                         const GString *v2);
    +
    gboolean            g_string_equal                      (const GString *v,
    +                                                         const GString *v2);

    Compares two strings for equality, returning TRUE if they are equal. -For use with GHashTable.

    +For use with GHashTable. +

    str :

    a string to hash +a string to hash
    - - @@ -1272,6 +1285,6 @@ For use with
    - Generated by GTK-Doc V1.13 + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Testing.html b/docs/reference/glib/html/glib-Testing.html index ad5530a..c48435e 100644 --- a/docs/reference/glib/html/glib-Testing.html +++ b/docs/reference/glib/html/glib-Testing.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    v :

    a GString +a GString

    v2 :

    another GString +another GString
    @@ -60,87 +40,104 @@
     #include <glib.h>
     
    -void                g_test_minimized_result             (double minimized_quantity,
    -                                                         const char *format,
    -                                                         ...);
    -void                g_test_maximized_result             (double maximized_quantity,
    -                                                         const char *format,
    -                                                         ...);
    -void                g_test_init                         (int *argc,
    -                                                         char ***argv,
    -                                                         ...);
    -#define             g_test_quick                        ()
    -#define             g_test_slow                         ()
    -#define             g_test_thorough                     ()
    -#define             g_test_perf                         ()
    -#define             g_test_verbose                      ()
    -#define             g_test_quiet                        ()
    -int                 g_test_run                          (void);
    -void                g_test_add_func                     (const char *testpath,
    -                                                         void (test_funcvoid) ());
    -void                g_test_add_data_func                (const char *testpath,
    -                                                         gconstpointer test_data,
    -                                                         void (test_funcgconstpointer) ());
    -#define             g_test_add                          (testpath, Fixture, tdata, fsetup, ftest, fteardown)
    -void                g_test_message                      (const char *format,
    -                                                         ...);
    -void                g_test_bug_base                     (const char *uri_pattern);
    -void                g_test_bug                          (const char *bug_uri_snippet);
    -gboolean            (*GTestLogFatalFunc)                (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *message,
    -                                                         gpointer user_data);
    -void                g_test_log_set_fatal_handler        (GTestLogFatalFunc log_func,
    -                                                         gpointer user_data);
    -void                g_test_timer_start                  (void);
    -double              g_test_timer_elapsed                (void);
    -double              g_test_timer_last                   (void);
    -void                g_test_queue_free                   (gpointer gfree_pointer);
    -void                g_test_queue_destroy                (GDestroyNotify destroy_func,
    -                                                         gpointer destroy_data);
    +void                g_test_minimized_result             (double minimized_quantity,
    +                                                         const char *format,
    +                                                         ...);
    +void                g_test_maximized_result             (double maximized_quantity,
    +                                                         const char *format,
    +                                                         ...);
    +void                g_test_init                         (int *argc,
    +                                                         char ***argv,
    +                                                         ...);
    +#define             g_test_quick
    +#define             g_test_slow
    +#define             g_test_thorough
    +#define             g_test_perf
    +#define             g_test_verbose
    +#define             g_test_quiet
    +int                 g_test_run                          (void);
    +void                g_test_add_func                     (const char *testpath,
    +                                                         void (test_funcvoid) ());
    +void                g_test_add_data_func                (const char *testpath,
    +                                                         gconstpointer test_data,
    +                                                         void (test_funcgconstpointer) ());
    +#define             g_test_add                          (testpath,
    +                                                         Fixture,
    +                                                         tdata,
    +                                                         fsetup,
    +                                                         ftest,
    +                                                         fteardown)
    +void                g_test_message                      (const char *format,
    +                                                         ...);
    +void                g_test_bug_base                     (const char *uri_pattern);
    +void                g_test_bug                          (const char *bug_uri_snippet);
    +gboolean            (*GTestLogFatalFunc)                (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *message,
    +                                                         gpointer user_data);
    +void                g_test_log_set_fatal_handler        (GTestLogFatalFunc log_func,
    +                                                         gpointer user_data);
    +void                g_test_timer_start                  (void);
    +double              g_test_timer_elapsed                (void);
    +double              g_test_timer_last                   (void);
    +void                g_test_queue_free                   (gpointer gfree_pointer);
    +void                g_test_queue_destroy                (GDestroyNotify destroy_func,
    +                                                         gpointer destroy_data);
     #define             g_test_queue_unref                  (gobject)
     enum                GTestTrapFlags;
    -gboolean            g_test_trap_fork                    (guint64 usec_timeout,
    -                                                         GTestTrapFlags test_trap_flags);
    -gboolean            g_test_trap_has_passed              (void);
    -gboolean            g_test_trap_reached_timeout         (void);
    -#define             g_test_trap_assert_passed           ()
    -#define             g_test_trap_assert_failed           ()
    +gboolean            g_test_trap_fork                    (guint64 usec_timeout,
    +                                                         GTestTrapFlags test_trap_flags);
    +gboolean            g_test_trap_has_passed              (void);
    +gboolean            g_test_trap_reached_timeout         (void);
    +#define             g_test_trap_assert_passed
    +#define             g_test_trap_assert_failed
     #define             g_test_trap_assert_stdout           (soutpattern)
     #define             g_test_trap_assert_stdout_unmatched (soutpattern)
     #define             g_test_trap_assert_stderr           (serrpattern)
     #define             g_test_trap_assert_stderr_unmatched (serrpattern)
    -#define             g_test_rand_bit                     ()
    -gint32              g_test_rand_int                     (void);
    -gint32              g_test_rand_int_range               (gint32 begin,
    -                                                         gint32 end);
    -double              g_test_rand_double                  (void);
    -double              g_test_rand_double_range            (double range_start,
    -                                                         double range_end);
    +#define             g_test_rand_bit
    +gint32              g_test_rand_int                     (void);
    +gint32              g_test_rand_int_range               (gint32 begin,
    +                                                         gint32 end);
    +double              g_test_rand_double                  (void);
    +double              g_test_rand_double_range            (double range_start,
    +                                                         double range_end);
     #define             g_assert                            (expr)
    -#define             g_assert_not_reached                ()
    -#define             g_assert_cmpstr                     (s1, cmp, s2)
    -#define             g_assert_cmpint                     (n1, cmp, n2)
    -#define             g_assert_cmpuint                    (n1, cmp, n2)
    -#define             g_assert_cmphex                     (n1, cmp, n2)
    -#define             g_assert_cmpfloat                   (n1,cmp,n2)
    +#define             g_assert_not_reached
    +#define             g_assert_cmpstr                     (s1,
    +                                                         cmp,
    +                                                         s2)
    +#define             g_assert_cmpint                     (n1,
    +                                                         cmp,
    +                                                         n2)
    +#define             g_assert_cmpuint                    (n1,
    +                                                         cmp,
    +                                                         n2)
    +#define             g_assert_cmphex                     (n1,
    +                                                         cmp,
    +                                                         n2)
    +#define             g_assert_cmpfloat                   (n1,
    +                                                         cmp,
    +                                                         n2)
     #define             g_assert_no_error                   (err)
    -#define             g_assert_error                      (err, dom, c)
    +#define             g_assert_error                      (err,
    +                                                         dom,
    +                                                         c)
     typedef             GTestCase;
     typedef             GTestSuite;
    -GTestCase*          g_test_create_case                  (const char *test_name,
    -                                                         gsize data_size,
    -                                                         gconstpointer test_data,
    -                                                         void (data_setupvoid) (),
    -                                                         void (data_testvoid) (),
    -                                                         void (data_teardownvoid) ());
    -GTestSuite*         g_test_create_suite                 (const char *suite_name);
    -GTestSuite*         g_test_get_root                     (void);
    -void                g_test_suite_add                    (GTestSuite *suite,
    -                                                         GTestCase *test_case);
    -void                g_test_suite_add_suite              (GTestSuite *suite,
    -                                                         GTestSuite *nestedsuite);
    -int                 g_test_run_suite                    (GTestSuite *suite);
    +GTestCase*          g_test_create_case                  (const char *test_name,
    +                                                         gsize data_size,
    +                                                         gconstpointer test_data,
    +                                                         void (data_setupvoid) (),
    +                                                         void (data_testvoid) (),
    +                                                         void (data_teardownvoid) ());
    +GTestSuite*         g_test_create_suite                 (const char *suite_name);
    +GTestSuite*         g_test_get_root                     (void);
    +void                g_test_suite_add                    (GTestSuite *suite,
    +                                                         GTestCase *test_case);
    +void                g_test_suite_add_suite              (GTestSuite *suite,
    +                                                         GTestSuite *nestedsuite);
    +int                 g_test_run_suite                    (GTestSuite *suite);
     
    @@ -184,9 +181,17 @@ RUnit), which in turn is based on smalltalk unit testing concepts. The API is designed to handle creation and registration of test suites and test cases implicitly. A simple call like

    -
    -  g_test_add_func ("/misc/assertions", test_assertions);
    -
    +
    +
    + + + + + + +
    1
    g_test_add_func ("/misc/assertions", test_assertions);
    +
    +

    creates a test suite called "misc" with a single test case named "assertions", which consists of running the test_assertions function. @@ -208,31 +213,32 @@ facilitate running tests and producing nicely formatted test reports.

    Details

    g_test_minimized_result ()

    -
    void                g_test_minimized_result             (double minimized_quantity,
    -                                                         const char *format,
    -                                                         ...);
    +
    void                g_test_minimized_result             (double minimized_quantity,
    +                                                         const char *format,
    +                                                         ...);

    Report the result of a performance or measurement test. The test should generally strive to minimize the reported quantities (smaller values are better than larger ones), this and minimized_quantity can determine sorting -order for test result reports.

    +order for test result reports. +

    - - - @@ -242,31 +248,32 @@ order for test result reports.


    g_test_maximized_result ()

    -
    void                g_test_maximized_result             (double maximized_quantity,
    -                                                         const char *format,
    -                                                         ...);
    +
    void                g_test_maximized_result             (double maximized_quantity,
    +                                                         const char *format,
    +                                                         ...);

    Report the result of a performance or measurement test. The test should generally strive to maximize the reported quantities (larger values are better than smaller ones), this and maximized_quantity can determine sorting -order for test result reports.

    +order for test result reports. +

    minimized_quantity :

    the reported value +the reported value

    format :

    the format string of the report message +the format string of the report message

    ... :

    arguments to pass to the printf() function +arguments to pass to the printf() function
    - - - @@ -276,9 +283,9 @@ order for test result reports.


    g_test_init ()

    -
    void                g_test_init                         (int *argc,
    -                                                         char ***argv,
    -                                                         ...);
    +
    void                g_test_init                         (int *argc,
    +                                                         char ***argv,
    +                                                         ...);

    Initialize the GLib testing framework, e.g. by seeding the test random number generator, the name for g_get_prgname() @@ -366,24 +373,26 @@ So far, the following arguments are understood:

    maximized_quantity :

    the reported value +the reported value

    format :

    the format string of the report message +the format string of the report message

    ... :

    arguments to pass to the printf() function +arguments to pass to the printf() function
    +

    +

    - - - @@ -391,48 +400,48 @@ So far, the following arguments are understood:

    Since 2.16


    -
    -

    g_test_quick()

    +
    +

    g_test_quick

    #define             g_test_quick()

    Returns TRUE if tests are run in quick mode.


    -
    -

    g_test_slow()

    +
    +

    g_test_slow

    #define             g_test_slow()

    Returns TRUE if tests are run in slow mode.


    -
    -

    g_test_thorough()

    +
    +

    g_test_thorough

    #define             g_test_thorough()

    Returns TRUE if tests are run in thorough mode.


    -
    -

    g_test_perf()

    +
    +

    g_test_perf

    #define             g_test_perf()

    Returns TRUE if tests are run in performance mode.


    -
    -

    g_test_verbose()

    +
    +

    g_test_verbose

    #define             g_test_verbose()

    Returns TRUE if tests are run in verbose mode.


    -
    -

    g_test_quiet()

    +
    +

    g_test_quiet

    #define             g_test_quiet()

    Returns TRUE if tests are run in quiet mode. @@ -441,7 +450,7 @@ Returns


    g_test_run ()

    -
    int                 g_test_run                          (void);
    +
    int                 g_test_run                          (void);

    Runs all tests under the toplevel suite which can be retrieved with g_test_get_root(). Similar to g_test_run_suite(), the test @@ -449,7 +458,8 @@ cases to be run are filtered according to test path arguments (-p testpath) as parsed by g_test_init(). g_test_run_suite() or g_test_run() may only be called once -in a program.

    +in a program. +

    argc :

    Address of the argc parameter of the main() function. +Address of the argc parameter of the main() function. Changed if any arguments were handled.

    argv :

    Address of the argv parameter of main(). +Address of the argv parameter of main(). Any parameters understood by g_test_init() stripped before return.

    ... :

    Reserved for future extension. Currently, you must pass NULL. +Reserved for future extension. Currently, you must pass NULL.
    @@ -464,58 +474,53 @@ in a program.


    g_test_add_func ()

    -
    void                g_test_add_func                     (const char *testpath,
    -                                                         void (test_funcvoid) ());
    +
    void                g_test_add_func                     (const char *testpath,
    +                                                         void (test_funcvoid) ());

    Create a new test case, similar to g_test_create_case(). However the test is assumed to use no fixture, and test suites are automatically created on the fly and added to the root fixture, based on the -slash-separated portions of testpath.

    +slash-separated portions of testpath. +

    - - + - - - - - - - +

    testpath :

    Slash-separated test case path name for the test. +Slash-separated test case path name for the test.

    test_func :

    The test function to invoke for this test. -

    Since 2.16


    g_test_add_data_func ()

    -
    void                g_test_add_data_func                (const char *testpath,
    -                                                         gconstpointer test_data,
    -                                                         void (test_funcgconstpointer) ());
    +
    void                g_test_add_data_func                (const char *testpath,
    +                                                         gconstpointer test_data,
    +                                                         void (test_funcgconstpointer) ());

    Create a new test case, similar to g_test_create_case(). However the test is assumed to use no fixture, and test suites are automatically created on the fly and added to the root fixture, based on the slash-separated portions of testpath. The test_data argument -will be passed as first argument to test_func.

    +will be passed as first argument to test_func. +

    - - - - + @@ -532,38 +537,39 @@ A fixture data structure with setup and teardown function may be provided though, similar to g_test_create_case(). g_test_add() is implemented as a macro, so that the fsetup(), ftest() and fteardown() callbacks can expect a Fixture pointer as first argument in -a type safe manner.

    +a type safe manner. +

    testpath :

    Slash-separated test case path name for the test. +Slash-separated test case path name for the test.

    test_data :

    Test data argument for the test function. +Test data argument for the test function.

    test_func :

    The test function to invoke for this test. +

    gconstpointer :

    - - - - - - @@ -573,21 +579,22 @@ a type safe manner.


    g_test_message ()

    -
    void                g_test_message                      (const char *format,
    -                                                         ...);
    +
    void                g_test_message                      (const char *format,
    +                                                         ...);

    -Add a message to the test report.

    +Add a message to the test report. +

    testpath :

    The test path for a new test case. +The test path for a new test case.

    Fixture :

    The type of a fixture data structure. +The type of a fixture data structure.

    tdata :

    Data argument for the test functions. +Data argument for the test functions.

    fsetup :

    The function to set up the fixture data. +The function to set up the fixture data.

    ftest :

    The actual test function. +The actual test function.

    fteardown :

    The function to tear down the fixture data. +The function to tear down the fixture data.
    - - @@ -597,7 +604,7 @@ Add a message to the test report.


    g_test_bug_base ()

    -
    void                g_test_bug_base                     (const char *uri_pattern);
    +
    void                g_test_bug_base                     (const char *uri_pattern);

    Specify the base URI for bug reports.

    @@ -610,12 +617,13 @@ a test case changes the base URI for the scope of the test case only. Bug URIs are constructed by appending a bug specific URI portion to uri_pattern, or by replacing the special string -'s' within uri_pattern if that is present.

    +'s' within uri_pattern if that is present. +

    format :

    the format string +the format string

    ... :

    printf-like arguments to format +printf-like arguments to format
    -

    uri_pattern :

    the base pattern for bug URIs +the base pattern for bug URIs
    @@ -624,17 +632,18 @@ portion to uri_pattern, or by replacing

    g_test_bug ()

    -
    void                g_test_bug                          (const char *bug_uri_snippet);
    +
    void                g_test_bug                          (const char *bug_uri_snippet);

    This function adds a message to test reports that associates a bug URI with a test case. Bug URIs are constructed from a base URI set with g_test_bug_base() -and bug_uri_snippet.

    +and bug_uri_snippet. +

    -

    bug_uri_snippet :

    Bug specific bug tracker URI portion. +Bug specific bug tracker URI portion.
    @@ -643,33 +652,34 @@ and bug_uri_snippet.


    GTestLogFatalFunc ()

    -
    gboolean            (*GTestLogFatalFunc)                (const gchar *log_domain,
    -                                                         GLogLevelFlags log_level,
    -                                                         const gchar *message,
    -                                                         gpointer user_data);
    +
    gboolean            (*GTestLogFatalFunc)                (const gchar *log_domain,
    +                                                         GLogLevelFlags log_level,
    +                                                         const gchar *message,
    +                                                         gpointer user_data);

    -Specifies the prototype of fatal log handler functions.

    +Specifies the prototype of fatal log handler functions. +

    - - - - @@ -685,8 +695,8 @@ Specifies the prototype of fatal log handler functions.


    g_test_log_set_fatal_handler ()

    -
    void                g_test_log_set_fatal_handler        (GTestLogFatalFunc log_func,
    -                                                         gpointer user_data);
    +
    void                g_test_log_set_fatal_handler        (GTestLogFatalFunc log_func,
    +                                                         gpointer user_data);

    Installs a non-error fatal log handler which can be used to decide whether log messages which are counted @@ -705,18 +715,19 @@ any test case, so you have to set it inside each test function which needs the special behavior.

    -This handler has no effect on g_error messages.

    +This handler has no effect on g_error messages. +

    log_domain :

    the log domain of the message +the log domain of the message

    log_level :

    the log level of the message (including the fatal and recursion flags) +the log level of the message (including the fatal and recursion flags)

    message :

    the message to process +the message to process

    user_data :

    user data, set in g_test_log_set_fatal_handler() +user data, set in g_test_log_set_fatal_handler()
    - - @@ -726,18 +737,20 @@ This handler has no effect on g_error messages.


    g_test_timer_start ()

    -
    void                g_test_timer_start                  (void);
    +
    void                g_test_timer_start                  (void);

    Start a timing test. Call g_test_timer_elapsed() when the task is supposed -to be done. Call this function again to restart the timer.

    +to be done. Call this function again to restart the timer. +

    Since 2.16


    g_test_timer_elapsed ()

    -
    double              g_test_timer_elapsed                (void);
    +
    double              g_test_timer_elapsed                (void);

    -Get the time since the last start of the timer with g_test_timer_start().

    +Get the time since the last start of the timer with g_test_timer_start(). +

    log_func :

    the log handler function. +the log handler function.

    user_data :

    data passed to the log handler. +data passed to the log handler.
    @@ -752,9 +765,10 @@ Get the time since the last start of the timer with

    g_test_timer_last ()

    -
    double              g_test_timer_last                   (void);
    +
    double              g_test_timer_last                   (void);

    -Report the last result of g_test_timer_elapsed().

    +Report the last result of g_test_timer_elapsed(). +

    @@ -769,16 +783,17 @@ Report the last result of

    g_test_queue_free ()

    -
    void                g_test_queue_free                   (gpointer gfree_pointer);
    +
    void                g_test_queue_free                   (gpointer gfree_pointer);

    Enqueue a pointer to be released with g_free() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() -with a destroy callback of g_free().

    +with a destroy callback of g_free(). +

    -

    gfree_pointer :

    the pointer to be stored. +the pointer to be stored.
    @@ -787,26 +802,27 @@ with a destroy callback of

    g_test_queue_destroy ()

    -
    void                g_test_queue_destroy                (GDestroyNotify destroy_func,
    -                                                         gpointer destroy_data);
    +
    void                g_test_queue_destroy                (GDestroyNotify destroy_func,
    +                                                         gpointer destroy_data);

    This function enqueus a callback @destroy_func() to be executed during the next test case teardown phase. This is most useful to auto destruct allocted test resources at the end of a test run. Resources are released in reverse queue order, that means enqueueing callback A before callback B will cause B() to be called before -A() during teardown.

    +A() during teardown. +

    - - @@ -818,9 +834,9 @@ callback A before callback B will cause B() to be

    g_test_queue_unref()

    #define             g_test_queue_unref(gobject)

    -Enqueue an object to be released with g_object_unref() during +Enqueue an object to be released with g_object_unref() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() -with a destroy callback of g_object_unref(). +with a destroy callback of g_object_unref().

    destroy_func :

    Destroy callback for teardown phase. +Destroy callback for teardown phase.

    destroy_data :

    Destroy callback data. +Destroy callback data.
    @@ -877,8 +893,8 @@ determine what traps to set.

    g_test_trap_fork ()

    -
    gboolean            g_test_trap_fork                    (guint64 usec_timeout,
    -                                                         GTestTrapFlags test_trap_flags);
    +
    gboolean            g_test_trap_fork                    (guint64 usec_timeout,
    +                                                         GTestTrapFlags test_trap_flags);

    Fork the current test program to execute a test case that might not return or that might abort. The forked test case is aborted @@ -895,36 +911,57 @@ termination and validates child program outputs.

    -
    -  static void
    -  test_fork_patterns (void)
    -  {
    -    if (g_test_trap_fork (0, G_TEST_TRAP_SILENCE_STDOUT | G_TEST_TRAP_SILENCE_STDERR))
    -      {
    -        g_print ("some stdout text: somagic17\n");
    -        g_printerr ("some stderr text: semagic43\n");
    -        exit (0); /* successful test run */
    -      }
    -    g_test_trap_assert_passed();
    -    g_test_trap_assert_stdout ("*somagic17*");
    -    g_test_trap_assert_stderr ("*semagic43*");
    -  }
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    static void
    +test_fork_patterns (void)
    +{
    +  if (g_test_trap_fork (0, G_TEST_TRAP_SILENCE_STDOUT | G_TEST_TRAP_SILENCE_STDERR))
    +    {
    +      g_print ("some stdout text: somagic17\n");
    +      g_printerr ("some stderr text: semagic43\n");
    +      exit (0); /* successful test run */
    +    }
    +  g_test_trap_assert_passed();
    +  g_test_trap_assert_stdout ("*somagic17*");
    +  g_test_trap_assert_stderr ("*semagic43*");
    +}
    +
    +

    -This function is implemented only on Unix platforms.

    +This function is implemented only on Unix platforms. +

    - - @@ -940,9 +977,10 @@ This function is implemented only on Unix platforms.


    g_test_trap_has_passed ()

    -
    gboolean            g_test_trap_has_passed              (void);
    +
    gboolean            g_test_trap_has_passed              (void);

    -Check the result of the last g_test_trap_fork() call.

    +Check the result of the last g_test_trap_fork() call. +

    usec_timeout :

    Timeout for the forked test in micro seconds. +Timeout for the forked test in micro seconds.

    test_trap_flags :

    Flags to modify forking behaviour. +Flags to modify forking behaviour.
    @@ -957,9 +995,10 @@ Check the result of the last

    g_test_trap_reached_timeout ()

    -
    gboolean            g_test_trap_reached_timeout         (void);
    +
    gboolean            g_test_trap_reached_timeout         (void);

    -Check the result of the last g_test_trap_fork() call.

    +Check the result of the last g_test_trap_fork() call. +

    @@ -972,8 +1011,8 @@ Check the result of the last Since 2.16


    -
    -

    g_test_trap_assert_passed()

    +
    +

    g_test_trap_assert_passed

    #define             g_test_trap_assert_passed()

    Assert that the last forked test passed. See g_test_trap_fork(). @@ -981,8 +1020,8 @@ Assert that the last forked test passed. See Since 2.16


    -
    -

    g_test_trap_assert_failed()

    +
    +

    g_test_trap_assert_failed

    #define             g_test_trap_assert_failed()

    Assert that the last forked test failed. See g_test_trap_fork(). @@ -1062,8 +1101,8 @@ Assert that the stderr output of the last forked test does not match

    Since 2.16


    -
    -

    g_test_rand_bit()

    +
    +

    g_test_rand_bit

    #define             g_test_rand_bit()

    Get a reproducible random bit (0 or 1), @@ -1074,7 +1113,7 @@ see

    g_test_rand_int ()

    -
    gint32              g_test_rand_int                     (void);
    +
    gint32              g_test_rand_int                     (void);

    Get a reproducible random integer number.

    @@ -1086,7 +1125,8 @@ given when starting test programs.

    For individual test cases however, the random number generator is reseeded, to avoid dependencies between tests and to make --seed -effective for all test cases.

    +effective for all test cases. +

    @@ -1101,22 +1141,23 @@ effective for all test cases.


    g_test_rand_int_range ()

    -
    gint32              g_test_rand_int_range               (gint32 begin,
    -                                                         gint32 end);
    +
    gint32              g_test_rand_int_range               (gint32 begin,
    +                                                         gint32 end);

    Get a reproducible random integer number out of a specified range, -see g_test_rand_int() for details on test case random numbers.

    +see g_test_rand_int() for details on test case random numbers. +

    - - @@ -1132,10 +1173,11 @@ see

    g_test_rand_double ()

    -
    double              g_test_rand_double                  (void);
    +
    double              g_test_rand_double                  (void);

    Get a reproducible random floating point number, -see g_test_rand_int() for details on test case random numbers.

    +see g_test_rand_int() for details on test case random numbers. +

    begin :

    the minimum value returned by this function +the minimum value returned by this function

    end :

    the smallest value not to be returned by this function +the smallest value not to be returned by this function
    @@ -1150,22 +1192,23 @@ see

    g_test_rand_double_range ()

    -
    double              g_test_rand_double_range            (double range_start,
    -                                                         double range_end);
    +
    double              g_test_rand_double_range            (double range_start,
    +                                                         double range_end);

    Get a reproducible random floating pointer number out of a specified range, -see g_test_rand_int() for details on test case random numbers.

    +see g_test_rand_int() for details on test case random numbers. +

    - - @@ -1201,8 +1244,8 @@ The macro can be turned off in final releases of code by defining

    range_start :

    the minimum value returned by this function +the minimum value returned by this function

    range_end :

    the minimum value not returned by this function +the minimum value not returned by this function

    -
    -

    g_assert_not_reached()

    +
    +

    g_assert_not_reached

    #define             g_assert_not_reached()

    Debugging macro to terminate the application if it is ever reached. @@ -1228,9 +1271,17 @@ as g_assert (g_strcmp0 (s1, s2) op 0). The advantag is that it can produce a message that includes the actual values of s1 and s2.

    -
    -  g_assert_cmpstr (mystring, ==, "fubar");
    -
    +
    + + + + + + + +
    1
    g_assert_cmpstr (mystring, ==, "fubar");
    +
    +
    @@ -1478,12 +1529,12 @@ An opaque structure representing a test suite.

    g_test_create_case ()

    -
    GTestCase*          g_test_create_case                  (const char *test_name,
    -                                                         gsize data_size,
    -                                                         gconstpointer test_data,
    -                                                         void (data_setupvoid) (),
    -                                                         void (data_testvoid) (),
    -                                                         void (data_teardownvoid) ());
    +
    GTestCase*          g_test_create_case                  (const char *test_name,
    +                                                         gsize data_size,
    +                                                         gconstpointer test_data,
    +                                                         void (data_setupvoid) (),
    +                                                         void (data_testvoid) (),
    +                                                         void (data_teardownvoid) ());

    Create a new GTestCase, named test_name, this API is fairly low level, calling g_test_add() or g_test_add_func() is preferable. @@ -1499,38 +1550,24 @@ Splitting up a test run into fixture setup, test function and fixture teardown is most usful if the same fixture is used for multiple tests. In this cases, g_test_create_case() will be called with the same fixture, but varying test_name and -data_test arguments.

    +data_test arguments. +

    - - - - - - - - - - - - - - - @@ -1546,15 +1583,16 @@ called with the same fixture, but varying test_name<

    g_test_create_suite ()

    -
    GTestSuite*         g_test_create_suite                 (const char *suite_name);
    +
    GTestSuite*         g_test_create_suite                 (const char *suite_name);

    -Create a new test suite with the name suite_name.

    +Create a new test suite with the name suite_name. +

    test_name :

    the name for the test case +the name for the test case

    data_size :

    the size of the fixture data structure +the size of the fixture data structure

    test_data :

    test data argument for the test functions -

    data_setup :

    the function to set up the fixture data -

    data_test :

    the actual test function -

    data_teardown :

    the function to teardown the fixture data +test data argument for the test functions
    - @@ -1570,9 +1608,10 @@ Create a new test suite with the name suite_name

    g_test_get_root ()

    -
    GTestSuite*         g_test_get_root                     (void);
    +
    GTestSuite*         g_test_get_root                     (void);

    -Get the toplevel test suite for the test path API.

    +Get the toplevel test suite for the test path API. +

    suite_name :

    a name for the suite +a name for the suite
    @@ -1587,21 +1626,22 @@ Get the toplevel test suite for the test path API.


    g_test_suite_add ()

    -
    void                g_test_suite_add                    (GTestSuite *suite,
    -                                                         GTestCase *test_case);
    +
    void                g_test_suite_add                    (GTestSuite *suite,
    +                                                         GTestCase *test_case);

    -Adds test_case to suite.

    +Adds test_case to suite. +

    - - @@ -1611,21 +1651,22 @@ Adds test_case to

    g_test_suite_add_suite ()

    -
    void                g_test_suite_add_suite              (GTestSuite *suite,
    -                                                         GTestSuite *nestedsuite);
    +
    void                g_test_suite_add_suite              (GTestSuite *suite,
    +                                                         GTestSuite *nestedsuite);

    -Adds nestedsuite to suite.

    +Adds nestedsuite to suite. +

    suite :

    a GTestSuite +a GTestSuite

    test_case :

    a GTestCase +a GTestCase
    - - @@ -1635,20 +1676,21 @@ Adds nestedsuite to

    g_test_run_suite ()

    -
    int                 g_test_run_suite                    (GTestSuite *suite);
    +
    int                 g_test_run_suite                    (GTestSuite *suite);

    Execute the tests within suite and all nested GTestSuites. The test suites to be executed are filtered according to test path arguments (-p testpath) as parsed by g_test_init(). g_test_run_suite() or g_test_run() may only be called once -in a program.

    +in a program. +

    suite :

    a GTestSuite +a GTestSuite

    nestedsuite :

    another GTestSuite +another GTestSuite
    - @@ -1672,6 +1714,6 @@ in a program.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-The-Main-Event-Loop.html b/docs/reference/glib/html/glib-The-Main-Event-Loop.html index 2df745c..ce25745 100644 --- a/docs/reference/glib/html/glib-The-Main-Event-Loop.html +++ b/docs/reference/glib/html/glib-The-Main-Event-Loop.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    suite :

    a GTestSuite +a GTestSuite
    @@ -61,14 +41,14 @@ #include <glib.h> GMainLoop; -GMainLoop * g_main_loop_new (GMainContext *context, - gboolean is_running); -GMainLoop * g_main_loop_ref (GMainLoop *loop); -void g_main_loop_unref (GMainLoop *loop); -void g_main_loop_run (GMainLoop *loop); -void g_main_loop_quit (GMainLoop *loop); -gboolean g_main_loop_is_running (GMainLoop *loop); -GMainContext * g_main_loop_get_context (GMainLoop *loop); +GMainLoop * g_main_loop_new (GMainContext *context, + gboolean is_running); +GMainLoop * g_main_loop_ref (GMainLoop *loop); +void g_main_loop_unref (GMainLoop *loop); +void g_main_loop_run (GMainLoop *loop); +void g_main_loop_quit (GMainLoop *loop); +gboolean g_main_loop_is_running (GMainLoop *loop); +GMainContext * g_main_loop_get_context (GMainLoop *loop); #define g_main_new (is_running) #define g_main_destroy (loop) #define g_main_run (loop) @@ -82,150 +62,150 @@ #define G_PRIORITY_LOW GMainContext; -GMainContext * g_main_context_new (void); -GMainContext * g_main_context_ref (GMainContext *context); -void g_main_context_unref (GMainContext *context); -GMainContext * g_main_context_default (void); -gboolean g_main_context_iteration (GMainContext *context, - gboolean may_block); +GMainContext * g_main_context_new (void); +GMainContext * g_main_context_ref (GMainContext *context); +void g_main_context_unref (GMainContext *context); +GMainContext * g_main_context_default (void); +gboolean g_main_context_iteration (GMainContext *context, + gboolean may_block); #define g_main_iteration (may_block) -gboolean g_main_context_pending (GMainContext *context); -#define g_main_pending () -GSource * g_main_context_find_source_by_id (GMainContext *context, - guint source_id); +gboolean g_main_context_pending (GMainContext *context); +#define g_main_pending +GSource * g_main_context_find_source_by_id (GMainContext *context, + guint source_id); GSource * g_main_context_find_source_by_user_data - (GMainContext *context, - gpointer user_data); + (GMainContext *context, + gpointer user_data); GSource * g_main_context_find_source_by_funcs_user_data - (GMainContext *context, - GSourceFuncs *funcs, - gpointer user_data); -void g_main_context_wakeup (GMainContext *context); -gboolean g_main_context_acquire (GMainContext *context); -void g_main_context_release (GMainContext *context); -gboolean g_main_context_is_owner (GMainContext *context); -gboolean g_main_context_wait (GMainContext *context, - GCond *cond, - GMutex *mutex); -gboolean g_main_context_prepare (GMainContext *context, - gint *priority); -gint g_main_context_query (GMainContext *context, - gint max_priority, - gint *timeout_, - GPollFD *fds, - gint n_fds); -gint g_main_context_check (GMainContext *context, - gint max_priority, - GPollFD *fds, - gint n_fds); -void g_main_context_dispatch (GMainContext *context); -void g_main_context_set_poll_func (GMainContext *context, - GPollFunc func); -GPollFunc g_main_context_get_poll_func (GMainContext *context); -gint (*GPollFunc) (GPollFD *ufds, - guint nfsd, - gint timeout_); -void g_main_context_add_poll (GMainContext *context, - GPollFD *fd, - gint priority); -void g_main_context_remove_poll (GMainContext *context, - GPollFD *fd); -gint g_main_depth (void); -GSource * g_main_current_source (void); + (GMainContext *context, + GSourceFuncs *funcs, + gpointer user_data); +void g_main_context_wakeup (GMainContext *context); +gboolean g_main_context_acquire (GMainContext *context); +void g_main_context_release (GMainContext *context); +gboolean g_main_context_is_owner (GMainContext *context); +gboolean g_main_context_wait (GMainContext *context, + GCond *cond, + GMutex *mutex); +gboolean g_main_context_prepare (GMainContext *context, + gint *priority); +gint g_main_context_query (GMainContext *context, + gint max_priority, + gint *timeout_, + GPollFD *fds, + gint n_fds); +gint g_main_context_check (GMainContext *context, + gint max_priority, + GPollFD *fds, + gint n_fds); +void g_main_context_dispatch (GMainContext *context); +void g_main_context_set_poll_func (GMainContext *context, + GPollFunc func); +GPollFunc g_main_context_get_poll_func (GMainContext *context); +gint (*GPollFunc) (GPollFD *ufds, + guint nfsd, + gint timeout_); +void g_main_context_add_poll (GMainContext *context, + GPollFD *fd, + gint priority); +void g_main_context_remove_poll (GMainContext *context, + GPollFD *fd); +gint g_main_depth (void); +GSource * g_main_current_source (void); #define g_main_set_poll_func (func) -GMainContext * g_main_context_get_thread_default (void); -void g_main_context_push_thread_default (GMainContext *context); -void g_main_context_pop_thread_default (GMainContext *context); +GMainContext * g_main_context_get_thread_default (void); +void g_main_context_push_thread_default (GMainContext *context); +void g_main_context_pop_thread_default (GMainContext *context); -GSource * g_timeout_source_new (guint interval); -GSource * g_timeout_source_new_seconds (guint interval); -guint g_timeout_add (guint interval, - GSourceFunc function, - gpointer data); -guint g_timeout_add_full (gint priority, - guint interval, - GSourceFunc function, - gpointer data, - GDestroyNotify notify); -guint g_timeout_add_seconds (guint interval, - GSourceFunc function, - gpointer data); -guint g_timeout_add_seconds_full (gint priority, - guint interval, - GSourceFunc function, - gpointer data, - GDestroyNotify notify); +GSource * g_timeout_source_new (guint interval); +GSource * g_timeout_source_new_seconds (guint interval); +guint g_timeout_add (guint interval, + GSourceFunc function, + gpointer data); +guint g_timeout_add_full (gint priority, + guint interval, + GSourceFunc function, + gpointer data, + GDestroyNotify notify); +guint g_timeout_add_seconds (guint interval, + GSourceFunc function, + gpointer data); +guint g_timeout_add_seconds_full (gint priority, + guint interval, + GSourceFunc function, + gpointer data, + GDestroyNotify notify); -GSource * g_idle_source_new (void); -guint g_idle_add (GSourceFunc function, - gpointer data); -guint g_idle_add_full (gint priority, - GSourceFunc function, - gpointer data, - GDestroyNotify notify); -gboolean g_idle_remove_by_data (gpointer data); +GSource * g_idle_source_new (void); +guint g_idle_add (GSourceFunc function, + gpointer data); +guint g_idle_add_full (gint priority, + GSourceFunc function, + gpointer data, + GDestroyNotify notify); +gboolean g_idle_remove_by_data (gpointer data); typedef GPid; -void (*GChildWatchFunc) (GPid pid, - gint status, - gpointer data); -GSource * g_child_watch_source_new (GPid pid); -guint g_child_watch_add (GPid pid, - GChildWatchFunc function, - gpointer data); -guint g_child_watch_add_full (gint priority, - GPid pid, - GChildWatchFunc function, - gpointer data, - GDestroyNotify notify); +void (*GChildWatchFunc) (GPid pid, + gint status, + gpointer data); +GSource * g_child_watch_source_new (GPid pid); +guint g_child_watch_add (GPid pid, + GChildWatchFunc function, + gpointer data); +guint g_child_watch_add_full (gint priority, + GPid pid, + GChildWatchFunc function, + gpointer data, + GDestroyNotify notify); GPollFD; -gint g_poll (GPollFD *fds, - guint nfds, - gint timeout); +gint g_poll (GPollFD *fds, + guint nfds, + gint timeout); #define G_POLLFD_FORMAT GSource; -void (*GSourceDummyMarshal) (void); +void (*GSourceDummyMarshal) (void); GSourceFuncs; GSourceCallbackFuncs; -GSource * g_source_new (GSourceFuncs *source_funcs, - guint struct_size); -GSource * g_source_ref (GSource *source); -void g_source_unref (GSource *source); -void g_source_set_funcs (GSource *source, - GSourceFuncs *funcs); -guint g_source_attach (GSource *source, - GMainContext *context); -void g_source_destroy (GSource *source); -gboolean g_source_is_destroyed (GSource *source); -void g_source_set_priority (GSource *source, - gint priority); -gint g_source_get_priority (GSource *source); -void g_source_set_can_recurse (GSource *source, - gboolean can_recurse); -gboolean g_source_get_can_recurse (GSource *source); -guint g_source_get_id (GSource *source); -GMainContext * g_source_get_context (GSource *source); -void g_source_set_callback (GSource *source, - GSourceFunc func, - gpointer data, - GDestroyNotify notify); -gboolean (*GSourceFunc) (gpointer data); -void g_source_set_callback_indirect (GSource *source, - gpointer callback_data, - GSourceCallbackFuncs *callback_funcs); -void g_source_add_poll (GSource *source, - GPollFD *fd); -void g_source_remove_poll (GSource *source, - GPollFD *fd); -void g_source_get_current_time (GSource *source, - GTimeVal *timeval); -gboolean g_source_remove (guint tag); -gboolean g_source_remove_by_funcs_user_data (GSourceFuncs *funcs, - gpointer user_data); -gboolean g_source_remove_by_user_data (gpointer user_data); +GSource * g_source_new (GSourceFuncs *source_funcs, + guint struct_size); +GSource * g_source_ref (GSource *source); +void g_source_unref (GSource *source); +void g_source_set_funcs (GSource *source, + GSourceFuncs *funcs); +guint g_source_attach (GSource *source, + GMainContext *context); +void g_source_destroy (GSource *source); +gboolean g_source_is_destroyed (GSource *source); +void g_source_set_priority (GSource *source, + gint priority); +gint g_source_get_priority (GSource *source); +void g_source_set_can_recurse (GSource *source, + gboolean can_recurse); +gboolean g_source_get_can_recurse (GSource *source); +guint g_source_get_id (GSource *source); +GMainContext * g_source_get_context (GSource *source); +void g_source_set_callback (GSource *source, + GSourceFunc func, + gpointer data, + GDestroyNotify notify); +gboolean (*GSourceFunc) (gpointer data); +void g_source_set_callback_indirect (GSource *source, + gpointer callback_data, + GSourceCallbackFuncs *callback_funcs); +void g_source_add_poll (GSource *source, + GPollFD *fd); +void g_source_remove_poll (GSource *source, + GPollFD *fd); +void g_source_get_current_time (GSource *source, + GTimeVal *timeval); +gboolean g_source_remove (guint tag); +gboolean g_source_remove_by_funcs_user_data (GSourceFuncs *funcs, + gpointer user_data); +gboolean g_source_remove_by_user_data (gpointer user_data);
    @@ -271,11 +251,11 @@ typedef GMainContext.

    - GTK+ contains wrappers of some of these functions, e.g. gtk_main(), - gtk_main_quit() and gtk_events_pending(). + GTK+ contains wrappers of some of these functions, e.g. gtk_main(), + gtk_main_quit() and gtk_events_pending().

    -

    Creating new sources types

    +

    Creating new sources types

    One of the unusual features of the GTK+ main loop functionality is that new types of event source can be created and used in @@ -301,7 +281,7 @@ typedef


    -

    Customizing the main loop iteration

    +

    Customizing the main loop iteration

    Single iterations of a GMainContext can be run with g_main_context_iteration(). In some cases, more detailed control @@ -336,21 +316,22 @@ representing the main event loop of a GLib or GTK+ application.


    g_main_loop_new ()

    -
    GMainLoop *         g_main_loop_new                     (GMainContext *context,
    -                                                         gboolean is_running);
    +
    GMainLoop *         g_main_loop_new                     (GMainContext *context,
    +                                                         gboolean is_running);

    -Creates a new GMainLoop structure.

    +Creates a new GMainLoop structure. +

    - - @@ -366,15 +347,16 @@ is not very important since calling

    g_main_loop_ref ()

    -
    GMainLoop *         g_main_loop_ref                     (GMainLoop *loop);
    +
    GMainLoop *         g_main_loop_ref                     (GMainLoop *loop);

    -Increases the reference count on a GMainLoop object by one.

    +Increases the reference count on a GMainLoop object by one. +

    context :

    a GMainContext (if NULL, the default context will be used). +a GMainContext (if NULL, the default context will be used).

    is_running :

    set to TRUE to indicate that the loop is running. This +set to TRUE to indicate that the loop is running. This is not very important since calling g_main_loop_run() will set this to TRUE anyway.
    - @@ -388,15 +370,16 @@ Increases the reference count on a

    g_main_loop_unref ()

    -
    void                g_main_loop_unref                   (GMainLoop *loop);
    +
    void                g_main_loop_unref                   (GMainLoop *loop);

    Decreases the reference count on a GMainLoop object by one. If -the result is zero, free the loop and free all associated memory.

    +the result is zero, free the loop and free all associated memory. +

    loop :

    a GMainLoop +a GMainLoop
    -

    loop :

    a GMainLoop +a GMainLoop
    @@ -404,17 +387,18 @@ the result is zero, free the loop and free all associated memory.


    g_main_loop_run ()

    -
    void                g_main_loop_run                     (GMainLoop *loop);
    +
    void                g_main_loop_run                     (GMainLoop *loop);

    Runs a main loop until g_main_loop_quit() is called on the loop. If this is called for the thread of the loop's GMainContext, it will process events from the loop, otherwise it will -simply wait.

    +simply wait. +

    -

    loop :

    a GMainLoop +a GMainLoop
    @@ -422,19 +406,20 @@ simply wait.


    g_main_loop_quit ()

    -
    void                g_main_loop_quit                    (GMainLoop *loop);
    +
    void                g_main_loop_quit                    (GMainLoop *loop);

    Stops a GMainLoop from running. Any calls to g_main_loop_run() for the loop will return.

    Note that sources that have already been dispatched when -g_main_loop_quit() is called will still be executed.

    +g_main_loop_quit() is called will still be executed. +

    -

    loop :

    a GMainLoop +a GMainLoop
    @@ -442,15 +427,16 @@ Note that sources that have already been dispatched when

    g_main_loop_is_running ()

    -
    gboolean            g_main_loop_is_running              (GMainLoop *loop);
    +
    gboolean            g_main_loop_is_running              (GMainLoop *loop);

    -Checks to see if the main loop is currently being run via g_main_loop_run().

    +Checks to see if the main loop is currently being run via g_main_loop_run(). +

    - @@ -464,15 +450,16 @@ Checks to see if the main loop is currently being run via

    g_main_loop_get_context ()

    -
    GMainContext *      g_main_loop_get_context             (GMainLoop *loop);
    +
    GMainContext *      g_main_loop_get_context             (GMainLoop *loop);

    -Returns the GMainContext of loop.

    +Returns the GMainContext of loop. +

    loop :

    a GMainLoop. +a GMainLoop.
    - @@ -667,9 +654,10 @@ representing a set of sources to be handled in a main loop.

    g_main_context_new ()

    -
    GMainContext *      g_main_context_new                  (void);
    +
    GMainContext *      g_main_context_new                  (void);

    -Creates a new GMainContext structure.

    +Creates a new GMainContext structure. +

    loop :

    a GMainLoop. +a GMainLoop.
    @@ -682,15 +670,16 @@ Creates a new

    g_main_context_ref ()

    -
    GMainContext *      g_main_context_ref                  (GMainContext *context);
    +
    GMainContext *      g_main_context_ref                  (GMainContext *context);

    -Increases the reference count on a GMainContext object by one.

    +Increases the reference count on a GMainContext object by one. +

    - @@ -704,15 +693,16 @@ Increases the reference count on a

    g_main_context_unref ()

    -
    void                g_main_context_unref                (GMainContext *context);
    +
    void                g_main_context_unref                (GMainContext *context);

    Decreases the reference count on a GMainContext object by one. If -the result is zero, free the context and free all associated memory.

    +the result is zero, free the context and free all associated memory. +

    context :

    a GMainContext +a GMainContext
    -

    context :

    a GMainContext +a GMainContext
    @@ -720,12 +710,13 @@ the result is zero, free the context and free all associated memory.


    g_main_context_default ()

    -
    GMainContext *      g_main_context_default              (void);
    +
    GMainContext *      g_main_context_default              (void);

    Returns the global default main context. This is the main context used for main loop functions when a main loop is not explicitly specified, and corresponds to the "main" main loop. See also -g_main_context_get_thread_default().

    +g_main_context_get_thread_default(). +

    @@ -738,8 +729,8 @@ specified, and corresponds to the "main" main loop. See also

    g_main_context_iteration ()

    -
    gboolean            g_main_context_iteration            (GMainContext *context,
    -                                                         gboolean may_block);
    +
    gboolean            g_main_context_iteration            (GMainContext *context,
    +                                                         gboolean may_block);

    Runs a single iteration for the given main loop. This involves checking to see if any event sources are ready to be processed, @@ -753,18 +744,19 @@ given moment without further waiting.

    Note that even when may_block is TRUE, it is still possible for g_main_context_iteration() to return FALSE, since the the wait may -be interrupted for other reasons than an event source becoming ready.

    +be interrupted for other reasons than an event source becoming ready. +

    - - @@ -809,15 +801,16 @@ processed.

    g_main_context_pending ()

    -
    gboolean            g_main_context_pending              (GMainContext *context);
    +
    gboolean            g_main_context_pending              (GMainContext *context);

    -Checks if any sources have pending events for the given context.

    +Checks if any sources have pending events for the given context. +

    context :

    a GMainContext (if NULL, the default context will be used) +a GMainContext (if NULL, the default context will be used)

    may_block :

    whether the call may block. +whether the call may block.
    - @@ -829,8 +822,8 @@ Checks if any sources have pending events for the given context.

    context :

    a GMainContext (if NULL, the default context will be used) +a GMainContext (if NULL, the default context will be used)

    -
    -

    g_main_pending()

    +
    +

    g_main_pending

    #define             g_main_pending()

    Warning

    @@ -853,21 +846,22 @@ Checks if any events are pending for the default

    g_main_context_find_source_by_id ()

    -
    GSource *           g_main_context_find_source_by_id    (GMainContext *context,
    -                                                         guint source_id);
    +
    GSource *           g_main_context_find_source_by_id    (GMainContext *context,
    +                                                         guint source_id);

    -Finds a GSource given a pair of context and ID.

    +Finds a GSource given a pair of context and ID. +

    - - @@ -882,23 +876,24 @@ Finds a

    g_main_context_find_source_by_user_data ()

    GSource *           g_main_context_find_source_by_user_data
    -                                                        (GMainContext *context,
    -                                                         gpointer user_data);
    + (GMainContext *context, + gpointer user_data);

    Finds a source with the given user data for the callback. If multiple sources exist with the same user data, the first -one found will be returned.

    +one found will be returned. +

    context :

    a GMainContext (if NULL, the default context will be used) +a GMainContext (if NULL, the default context will be used)

    source_id :

    the source ID, as returned by g_source_get_id(). +the source ID, as returned by g_source_get_id().
    - - @@ -913,29 +908,30 @@ one found will be returned.

    g_main_context_find_source_by_funcs_user_data ()

    GSource *           g_main_context_find_source_by_funcs_user_data
    -                                                        (GMainContext *context,
    -                                                         GSourceFuncs *funcs,
    -                                                         gpointer user_data);
    + (GMainContext *context, + GSourceFuncs *funcs, + gpointer user_data);

    Finds a source with the given source functions and user data. If multiple sources exist with the same source function and user data, -the first one found will be returned.

    +the first one found will be returned. +

    context :

    a GMainContext +a GMainContext

    user_data :

    the user_data for the callback. +the user_data for the callback.
    - - - @@ -949,15 +945,16 @@ the first one found will be returned.


    g_main_context_wakeup ()

    -
    void                g_main_context_wakeup               (GMainContext *context);
    +
    void                g_main_context_wakeup               (GMainContext *context);

    If context is currently waiting in a poll(), interrupt -the poll(), and continue the iteration process.

    +the poll(), and continue the iteration process. +

    context :

    a GMainContext (if NULL, the default context will be used). +a GMainContext (if NULL, the default context will be used).

    funcs :

    the source_funcs passed to g_source_new(). +the source_funcs passed to g_source_new().

    user_data :

    the user data from the callback. +the user data from the callback.
    -

    context :

    a GMainContext +a GMainContext
    @@ -965,7 +962,7 @@ the poll(), and continue the iteration process.

    g_main_context_acquire ()

    -
    gboolean            g_main_context_acquire              (GMainContext *context);
    +
    gboolean            g_main_context_acquire              (GMainContext *context);

    Tries to become the owner of the specified context. If some other thread is the owner of the context, @@ -977,13 +974,14 @@ is called as many times as g_main_context_prepare(), g_main_context_query(), -g_main_context_check(), g_main_context_dispatch().

    +g_main_context_check(), g_main_context_dispatch(). +

    - @@ -998,17 +996,18 @@ can call

    g_main_context_release ()

    -
    void                g_main_context_release              (GMainContext *context);
    +
    void                g_main_context_release              (GMainContext *context);

    Releases ownership of a context previously acquired by this thread with g_main_context_acquire(). If the context was acquired multiple times, the ownership will be released only when g_main_context_release() -is called as many times as it was acquired.

    +is called as many times as it was acquired. +

    context :

    a GMainContext +a GMainContext
    -

    context :

    a GMainContext +a GMainContext
    @@ -1016,18 +1015,19 @@ is called as many times as it was acquired.


    g_main_context_is_owner ()

    -
    gboolean            g_main_context_is_owner             (GMainContext *context);
    +
    gboolean            g_main_context_is_owner             (GMainContext *context);

    Determines whether this thread holds the (recursive) ownership of this GMaincontext. This is useful to know before waiting on another thread that may be -blocking to get ownership of context.

    +blocking to get ownership of context. +

    - @@ -1043,31 +1043,32 @@ blocking to get ownership of context.

    g_main_context_wait ()

    -
    gboolean            g_main_context_wait                 (GMainContext *context,
    -                                                         GCond *cond,
    -                                                         GMutex *mutex);
    +
    gboolean            g_main_context_wait                 (GMainContext *context,
    +                                                         GCond *cond,
    +                                                         GMutex *mutex);

    Tries to become the owner of the specified context, as with g_main_context_acquire(). But if another thread is the owner, atomically drop mutex and wait on cond until that owner releases ownership or until cond is signaled, then -try again (once) to become the owner.

    +try again (once) to become the owner. +

    context :

    a GMainContext +a GMainContext
    - - - @@ -1082,22 +1083,23 @@ try again (once) to become the owner.


    g_main_context_prepare ()

    -
    gboolean            g_main_context_prepare              (GMainContext *context,
    -                                                         gint *priority);
    +
    gboolean            g_main_context_prepare              (GMainContext *context,
    +                                                         gint *priority);

    Prepares to poll sources within a main loop. The resulting information -for polling is determined by calling g_main_context_query().

    +for polling is determined by calling g_main_context_query(). +

    context :

    a GMainContext +a GMainContext

    cond :

    a condition variable +a condition variable

    mutex :

    a mutex, currently held +a mutex, currently held
    - - @@ -1113,39 +1115,40 @@ for polling is determined by calling

    g_main_context_query ()

    -
    gint                g_main_context_query                (GMainContext *context,
    -                                                         gint max_priority,
    -                                                         gint *timeout_,
    -                                                         GPollFD *fds,
    -                                                         gint n_fds);
    +
    gint                g_main_context_query                (GMainContext *context,
    +                                                         gint max_priority,
    +                                                         gint *timeout_,
    +                                                         GPollFD *fds,
    +                                                         gint n_fds);

    -Determines information necessary to poll this main loop.

    +Determines information necessary to poll this main loop. +

    context :

    a GMainContext +a GMainContext

    priority :

    location to store priority of highest priority +location to store priority of highest priority source already ready.
    - - - - - @@ -1161,34 +1164,35 @@ Determines information necessary to poll this main loop.


    g_main_context_check ()

    -
    gint                g_main_context_check                (GMainContext *context,
    -                                                         gint max_priority,
    -                                                         GPollFD *fds,
    -                                                         gint n_fds);
    +
    gint                g_main_context_check                (GMainContext *context,
    +                                                         gint max_priority,
    +                                                         GPollFD *fds,
    +                                                         gint n_fds);

    -Passes the results of polling back to the main loop.

    +Passes the results of polling back to the main loop. +

    context :

    a GMainContext +a GMainContext

    max_priority :

    maximum priority source to check +maximum priority source to check

    timeout_ :

    location to store timeout to be used in polling +location to store timeout to be used in polling

    fds :

    location to store GPollFD records that need to be polled. +location to store GPollFD records that need to be polled.

    n_fds :

    length of fds. +length of fds.
    - - - - @@ -1202,14 +1206,15 @@ Passes the results of polling back to the main loop.


    g_main_context_dispatch ()

    -
    void                g_main_context_dispatch             (GMainContext *context);
    +
    void                g_main_context_dispatch             (GMainContext *context);

    -Dispatches all pending sources.

    +Dispatches all pending sources. +

    context :

    a GMainContext +a GMainContext

    max_priority :

    the maximum numerical priority of sources to check +the maximum numerical priority of sources to check

    fds :

    array of GPollFD's that was passed to the last call to +array of GPollFD's that was passed to the last call to g_main_context_query()

    n_fds :

    return value of g_main_context_query() +return value of g_main_context_query()
    -

    context :

    a GMainContext +a GMainContext
    @@ -1217,8 +1222,8 @@ Dispatches all pending sources.


    g_main_context_set_poll_func ()

    -
    void                g_main_context_set_poll_func        (GMainContext *context,
    -                                                         GPollFunc func);
    +
    void                g_main_context_set_poll_func        (GMainContext *context,
    +                                                         GPollFunc func);

    Sets the function to use to handle polling of file descriptors. It will be used instead of the poll() system call @@ -1227,18 +1232,19 @@ will be used instead of the poll() system call

    This function could possibly be used to integrate the GLib event -loop with an external event loop.

    +loop with an external event loop. +

    - - @@ -1247,15 +1253,16 @@ loop with an external event loop.


    g_main_context_get_poll_func ()

    -
    GPollFunc           g_main_context_get_poll_func        (GMainContext *context);
    +
    GPollFunc           g_main_context_get_poll_func        (GMainContext *context);

    -Gets the poll function set by g_main_context_set_poll_func().

    +Gets the poll function set by g_main_context_set_poll_func(). +

    context :

    a GMainContext +a GMainContext

    func :

    the function to call to poll all file descriptors +the function to call to poll all file descriptors
    - @@ -1269,9 +1276,9 @@ Gets the poll function set by

    GPollFunc ()

    -
    gint                (*GPollFunc)                        (GPollFD *ufds,
    -                                                         guint nfsd,
    -                                                         gint timeout_);
    +
    gint                (*GPollFunc)                        (GPollFD *ufds,
    +                                                         guint nfsd,
    +                                                         gint timeout_);

    Specifies the type of function passed to g_main_context_set_poll_func(). The semantics of the function should match those of the @@ -1308,30 +1315,31 @@ or -1 if an error occurred.


    g_main_context_add_poll ()

    -
    void                g_main_context_add_poll             (GMainContext *context,
    -                                                         GPollFD *fd,
    -                                                         gint priority);
    +
    void                g_main_context_add_poll             (GMainContext *context,
    +                                                         GPollFD *fd,
    +                                                         gint priority);

    Adds a file descriptor to the set of file descriptors polled for this context. This will very seldomly be used directly. Instead -a typical event source will use g_source_add_poll() instead.

    +a typical event source will use g_source_add_poll() instead. +

    context :

    a GMainContext +a GMainContext
    - - - @@ -1342,11 +1350,12 @@ a typical event source will use

    g_main_context_remove_poll ()

    -
    void                g_main_context_remove_poll          (GMainContext *context,
    -                                                         GPollFD *fd);
    +
    void                g_main_context_remove_poll          (GMainContext *context,
    +                                                         GPollFD *fd);

    Removes file descriptor from the set of file descriptors to be -polled for a particular context.

    +polled for a particular context. +

    context :

    a GMainContext (or NULL for the default context) +a GMainContext (or NULL for the default context)

    fd :

    a GPollFD structure holding information about a file +a GPollFD structure holding information about a file descriptor to watch.

    priority :

    the priority for this file descriptor which should be +the priority for this file descriptor which should be the same as the priority used for g_source_attach() to ensure that the file descriptor is polled whenever the results may be needed.
    @@ -1357,7 +1366,7 @@ polled for a particular context.

    - @@ -1366,7 +1375,7 @@ polled for a particular context.


    g_main_depth ()

    -
    gint                g_main_depth                        (void);
    +
    gint                g_main_depth                        (void);

    Returns the depth of the stack of calls to g_main_context_dispatch() on any GMainContext in the current thread. @@ -1382,35 +1391,69 @@ Imagine an extremely simple "garbage collected" system.

    -
    -static GList *free_list;
    +
    +

    fd :

    a GPollFD descriptor previously added with g_main_context_add_poll() +a GPollFD descriptor previously added with g_main_context_add_poll()
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    static GList *free_list;
     
    -gpointer
    -allocate_memory (gsize size)
    -{ 
    -  gpointer result = g_malloc (size);
    -  free_list = g_list_prepend (free_list, result);
    -  return result;
    -}
    +gpointer
    +allocate_memory (gsize size)
    +{ 
    +  gpointer result = g_malloc (size);
    +  free_list = g_list_prepend (free_list, result);
    +  return result;
    +}
     
    -void
    -free_allocated_memory (void)
    -{
    -  GList *l;
    -  for (l = free_list; l; l = l->next);
    -    g_free (l->data);
    -  g_list_free (free_list);
    -  free_list = NULL;
    - }
    +void
    +free_allocated_memory (void)
    +{
    +  GList *l;
    +  for (l = free_list; l; l = l->next);
    +    g_free (l->data);
    +  g_list_free (free_list);
    +  free_list = NULL;
    + }
     
    -[...]
    +[...]
    +
    +while (TRUE); 
    + {
    +   g_main_context_iteration (NULL, TRUE);
    +   free_allocated_memory();
    +  }
    +
    -while (TRUE); - { - g_main_context_iteration (NULL, TRUE); - free_allocated_memory(); - } -

    @@ -1423,38 +1466,75 @@ recursive callback. This can be fixed by using

    -gpointer
    -allocate_memory (gsize size)
    -{ 
    -  FreeListBlock *block = g_new (FreeListBlock, 1);
    -  block->mem = g_malloc (size);
    -  block->depth = g_main_depth ();   
    -  free_list = g_list_prepend (free_list, block);
    -  return block->mem;
    -}
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    gpointer
    +allocate_memory (gsize size)
    +{ 
    +  FreeListBlock *block = g_new (FreeListBlock, 1);
    +  block->mem = g_malloc (size);
    +  block->depth = g_main_depth ();   
    +  free_list = g_list_prepend (free_list, block);
    +  return block->mem;
    +}
    +
    +void
    +free_allocated_memory (void)
    +{
    +  GList *l;
    +  
    +  int depth = g_main_depth ();
    +  for (l = free_list; l; );
    +    {
    +      GList *next = l->next;
    +      FreeListBlock *block = l->data;
    +      if (block->depth > depth)
    +        {
    +          g_free (block->mem);
    +          g_free (block);
    +          free_list = g_list_delete_link (free_list, l);
    +        }
    +              
    +      l = next;
    +    }
    +  }
    +
    -void -free_allocated_memory (void) -{ - GList *l; - - int depth = g_main_depth (); - for (l = free_list; l; ); - { - GList *next = l->next; - FreeListBlock *block = l->data; - if (block->depth > depth) - { - g_free (block->mem); - g_free (block); - free_list = g_list_delete_link (free_list, l); - } - - l = next; - } - } -

    @@ -1474,7 +1554,7 @@ following techniques:

    1. - Use gtk_widget_set_sensitive() or modal dialogs to prevent + Use gtk_widget_set_sensitive() or modal dialogs to prevent the user from interacting with elements while the main loop is recursing.

    2. @@ -1485,6 +1565,8 @@ following techniques: there is more work to do.

    +

    +

    @@ -1497,9 +1579,10 @@ following techniques:

    g_main_current_source ()

    -
    GSource *           g_main_current_source               (void);
    +
    GSource *           g_main_current_source               (void);

    -Returns the currently firing source for this thread.

    +Returns the currently firing source for this thread. +

    @@ -1535,7 +1618,7 @@ for the default main context.

    g_main_context_get_thread_default ()

    -
    GMainContext *      g_main_context_get_thread_default   (void);
    +
    GMainContext *      g_main_context_get_thread_default   (void);

    Gets the thread-default GMainContext for this thread. Asynchronous operations that want to be able to be run in contexts other than @@ -1543,7 +1626,8 @@ the default one should call this method to get a GSources to. (Note that even in single-threaded programs applications may sometimes want to temporarily push a non-default context, so it is not safe to assume that this will -always return NULL if threads are not initialized.)

    +always return NULL if threads are not initialized.) +

    @@ -1559,7 +1643,7 @@ thread-default context is the global default context.

    g_main_context_push_thread_default ()

    -
    void                g_main_context_push_thread_default  (GMainContext *context);
    +
    void                g_main_context_push_thread_default  (GMainContext *context);

    Acquires context and sets it as the thread-default context for the current thread. This will cause certain asynchronous operations @@ -1590,12 +1674,13 @@ started while the non-default context is active.

    Beware that libraries that predate this function may not correctly handle being used from a thread with a thread-default context. Eg, -see g_file_supports_thread_contexts().

    +see g_file_supports_thread_contexts(). +

    -

    context :

    a GMainContext, or NULL for the global default context +a GMainContext, or NULL for the global default context
    @@ -1604,15 +1689,16 @@ see

    g_main_context_pop_thread_default ()

    -
    void                g_main_context_pop_thread_default   (GMainContext *context);
    +
    void                g_main_context_pop_thread_default   (GMainContext *context);

    Pops context off the thread-default context stack (verifying that -it was on the top of the stack).

    +it was on the top of the stack). +

    -

    context :

    a GMainContext object, or NULL +a GMainContext object, or NULL
    @@ -1621,20 +1707,21 @@ it was on the top of the stack).


    g_timeout_source_new ()

    -
    GSource *           g_timeout_source_new                (guint interval);
    +
    GSource *           g_timeout_source_new                (guint interval);

    Creates a new timeout source.

    The source will not initially be associated with any GMainContext and must be added to one with g_source_attach() before it will be -executed.

    +executed. +

    - @@ -1648,7 +1735,7 @@ executed.


    g_timeout_source_new_seconds ()

    -
    GSource *           g_timeout_source_new_seconds        (guint interval);
    +
    GSource *           g_timeout_source_new_seconds        (guint interval);

    Creates a new timeout source.

    @@ -1659,13 +1746,14 @@ executed.

    The scheduling granularity/accuracy of this timeout source will be -in seconds.

    +in seconds. +

    interval :

    the timeout interval in milliseconds. +the timeout interval in milliseconds.
    - @@ -1681,9 +1769,9 @@ in seconds.


    g_timeout_add ()

    -
    guint               g_timeout_add                       (guint interval,
    -                                                         GSourceFunc function,
    -                                                         gpointer data);
    +
    guint               g_timeout_add                       (guint interval,
    +                                                         GSourceFunc function,
    +                                                         gpointer data);

    Sets a function to be called at regular intervals, with the default priority, G_PRIORITY_DEFAULT. The function is called repeatedly @@ -1707,24 +1795,25 @@ optimizations and more efficient system power usage.

    This internally creates a main loop source using g_timeout_source_new() and attaches it to the main loop context using g_source_attach(). You can -do these steps manually if you need greater control.

    +do these steps manually if you need greater control. +

    interval :

    the timeout interval in seconds +the timeout interval in seconds
    - - - @@ -1738,11 +1827,11 @@ do these steps manually if you need greater control.


    g_timeout_add_full ()

    -
    guint               g_timeout_add_full                  (gint priority,
    -                                                         guint interval,
    -                                                         GSourceFunc function,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               g_timeout_add_full                  (gint priority,
    +                                                         guint interval,
    +                                                         GSourceFunc function,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets a function to be called at regular intervals, with the given priority. The function is called repeatedly until it returns @@ -1761,35 +1850,36 @@ timeout is recalculated based on the current time and the given interval

    This internally creates a main loop source using g_timeout_source_new() and attaches it to the main loop context using g_source_attach(). You can -do these steps manually if you need greater control.

    +do these steps manually if you need greater control. +

    interval :

    the time between calls to the function, in milliseconds +the time between calls to the function, in milliseconds (1/1000ths of a second)

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function
    - - - - - @@ -1803,9 +1893,9 @@ do these steps manually if you need greater control.


    g_timeout_add_seconds ()

    -
    guint               g_timeout_add_seconds               (guint interval,
    -                                                         GSourceFunc function,
    -                                                         gpointer data);
    +
    guint               g_timeout_add_seconds               (guint interval,
    +                                                         GSourceFunc function,
    +                                                         gpointer data);

    Sets a function to be called at regular intervals with the default priority, G_PRIORITY_DEFAULT. The function is called repeatedly until @@ -1816,23 +1906,24 @@ and the function will not be called again. This internally creates a main loop source using g_timeout_source_new_seconds() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need -greater control. Also see g_timout_add_seconds_full().

    +greater control. Also see g_timout_add_seconds_full(). +

    priority :

    the priority of the timeout source. Typically this will be in +the priority of the timeout source. Typically this will be in the range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH.

    interval :

    the time between calls to the function, in milliseconds +the time between calls to the function, in milliseconds (1/1000ths of a second)

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function

    notify :

    function to call when the timeout is removed, or NULL +function to call when the timeout is removed, or NULL
    - - - @@ -1848,11 +1939,11 @@ greater control. Also see g_timout_add_seconds_full()

    g_timeout_add_seconds_full ()

    -
    guint               g_timeout_add_seconds_full          (gint priority,
    -                                                         guint interval,
    -                                                         GSourceFunc function,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               g_timeout_add_seconds_full          (gint priority,
    +                                                         guint interval,
    +                                                         GSourceFunc function,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets a function to be called at regular intervals, with priority. The function is called repeatedly until it returns FALSE, at which @@ -1888,34 +1979,35 @@ use of g_timeout_source_new_seconds() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need -greater control.

    +greater control. +

    interval :

    the time between calls to the function, in seconds +the time between calls to the function, in seconds

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function
    - - - - - @@ -1931,7 +2023,7 @@ greater control.


    g_idle_source_new ()

    -
    GSource *           g_idle_source_new                   (void);
    +
    GSource *           g_idle_source_new                   (void);

    Creates a new idle source.

    @@ -1940,7 +2032,8 @@ The source will not initially be associated with any g_source_attach() before it will be executed. Note that the default priority for idle sources is G_PRIORITY_DEFAULT_IDLE, as compared to other sources which -have a default priority of G_PRIORITY_DEFAULT.

    +have a default priority of G_PRIORITY_DEFAULT. +

    priority :

    the priority of the timeout source. Typically this will be in +the priority of the timeout source. Typically this will be in the range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH.

    interval :

    the time between calls to the function, in seconds +the time between calls to the function, in seconds

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function

    notify :

    function to call when the timeout is removed, or NULL +function to call when the timeout is removed, or NULL
    @@ -1953,8 +2046,8 @@ have a default priority of

    g_idle_add ()

    -
    guint               g_idle_add                          (GSourceFunc function,
    -                                                         gpointer data);
    +
    guint               g_idle_add                          (GSourceFunc function,
    +                                                         gpointer data);

    Adds a function to be called whenever there are no higher priority events pending to the default main loop. The function is given the @@ -1965,18 +2058,19 @@ sources and will not be called again.

    This internally creates a main loop source using g_idle_source_new() and attaches it to the main loop context using g_source_attach(). -You can do these steps manually if you need greater control.

    +You can do these steps manually if you need greater control. +

    - - @@ -1990,10 +2084,10 @@ You can do these steps manually if you need greater control.


    g_idle_add_full ()

    -
    guint               g_idle_add_full                     (gint priority,
    -                                                         GSourceFunc function,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               g_idle_add_full                     (gint priority,
    +                                                         GSourceFunc function,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Adds a function to be called whenever there are no higher priority events pending. If the function returns FALSE it is automatically @@ -2002,29 +2096,30 @@ removed from the list of event sources and will not be called again.

    This internally creates a main loop source using g_idle_source_new() and attaches it to the main loop context using g_source_attach(). -You can do these steps manually if you need greater control.

    +You can do these steps manually if you need greater control. +

    function :

    function to call +function to call

    data :

    data to pass to function. +data to pass to function.
    - - - - @@ -2038,15 +2133,16 @@ You can do these steps manually if you need greater control.


    g_idle_remove_by_data ()

    -
    gboolean            g_idle_remove_by_data               (gpointer data);
    +
    gboolean            g_idle_remove_by_data               (gpointer data);

    -Removes the idle function with the given data.

    +Removes the idle function with the given data. +

    priority :

    the priority of the idle source. Typically this will be in the +the priority of the idle source. Typically this will be in the range between G_PRIORITY_DEFAULT_IDLE and G_PRIORITY_HIGH_IDLE.

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function

    notify :

    function to call when the idle is removed, or NULL +function to call when the idle is removed, or NULL
    - @@ -2072,9 +2168,9 @@ pointers).

    GChildWatchFunc ()

    -
    void                (*GChildWatchFunc)                  (GPid pid,
    -                                                         gint status,
    -                                                         gpointer data);
    +
    void                (*GChildWatchFunc)                  (GPid pid,
    +                                                         gint status,
    +                                                         gpointer data);

    The type of functions to be called when a child exists.

    @@ -2103,7 +2199,7 @@ The type of functions to be called when a child exists.

    g_child_watch_source_new ()

    -
    GSource *           g_child_watch_source_new            (GPid pid);
    +
    GSource *           g_child_watch_source_new            (GPid pid);

    Creates a new child_watch source.

    @@ -2127,13 +2223,14 @@ source is still active. Typically, you will want to call Note further that using g_child_watch_source_new() is not compatible with calling waitpid(-1) in the application. Calling waitpid() for individual pids will -still work fine.

    +still work fine. +

    data :

    the data for the idle source's callback. +the data for the idle source's callback.
    - @@ -2150,9 +2247,9 @@ Windows a handle for a process (which doesn't have to be a child).

    g_child_watch_add ()

    -
    guint               g_child_watch_add                   (GPid pid,
    -                                                         GChildWatchFunc function,
    -                                                         gpointer data);
    +
    guint               g_child_watch_add                   (GPid pid,
    +                                                         GChildWatchFunc function,
    +                                                         gpointer data);

    Sets a function to be called when the child indicated by pid exits, at a default priority, G_PRIORITY_DEFAULT. @@ -2175,24 +2272,25 @@ GLib supports only a single callback per process id. This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you -need greater control.

    +need greater control. +

    pid :

    process to watch. On POSIX the pid of a child process. On +process to watch. On POSIX the pid of a child process. On Windows a handle for a process (which doesn't have to be a child).
    - - - @@ -2208,11 +2306,11 @@ Windows a handle for a process (which doesn't have to be a child).

    g_child_watch_add_full ()

    -
    guint               g_child_watch_add_full              (gint priority,
    -                                                         GPid pid,
    -                                                         GChildWatchFunc function,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               g_child_watch_add_full              (gint priority,
    +                                                         GPid pid,
    +                                                         GChildWatchFunc function,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets a function to be called when the child indicated by pid exits, at the priority priority. @@ -2235,35 +2333,36 @@ GLib supports only a single callback per process id. This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you -need greater control.

    +need greater control. +

    pid :

    process id to watch. On POSIX the pid of a child process. On +process id to watch. On POSIX the pid of a child process. On Windows a handle for a process (which doesn't have to be a child).

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function
    - - - - - @@ -2326,9 +2425,9 @@ you would use

    g_poll ()

    -
    gint                g_poll                              (GPollFD *fds,
    -                                                         guint nfds,
    -                                                         gint timeout);
    +
    gint                g_poll                              (GPollFD *fds,
    +                                                         guint nfds,
    +                                                         gint timeout);

    Polls fds, as with the poll() system call, but portably. (On systems that don't have poll(), it is emulated using select().) @@ -2348,23 +2447,24 @@ On POSIX systems, the file descriptors in fds file descriptor, but the situation is much more complicated on Windows. If you need to use g_poll() in code that has to run on Windows, the easiest solution is to construct all of your -GPollFDs with g_io_channel_win32_make_pollfd().

    +GPollFDs with g_io_channel_win32_make_pollfd(). +

    priority :

    the priority of the idle source. Typically this will be in the +the priority of the idle source. Typically this will be in the range between G_PRIORITY_DEFAULT_IDLE and G_PRIORITY_HIGH_IDLE.

    pid :

    process to watch. On POSIX the pid of a child process. On +process to watch. On POSIX the pid of a child process. On Windows a handle for a process (which doesn't have to be a child).

    function :

    function to call +function to call

    data :

    data to pass to function +data to pass to function

    notify :

    function to call when the idle is removed, or NULL +function to call when the idle is removed, or NULL
    - - - @@ -2400,9 +2500,9 @@ an event source.

    GSourceDummyMarshal ()

    -
    void                (*GSourceDummyMarshal)              (void);
    +
    void                (*GSourceDummyMarshal)              (void);

    -This is just a placeholder for GClosureMarshal, which cannot be used here +This is just a placeholder for GClosureMarshal, which cannot be used here for dependency reasons.

    @@ -2540,8 +2640,8 @@ functions for managing callback objects.

    g_source_new ()

    -
    GSource *           g_source_new                        (GSourceFuncs *source_funcs,
    -                                                         guint struct_size);
    +
    GSource *           g_source_new                        (GSourceFuncs *source_funcs,
    +                                                         guint struct_size);

    Creates a new GSource structure. The size is specified to allow creating structures derived from GSource that contain @@ -2551,19 +2651,20 @@ additional data. The size passed in must be at least

    The source will not initially be associated with any GMainContext and must be added to one with g_source_attach() before it will be -executed.

    +executed. +

    fds :

    file descriptors to poll +file descriptors to poll

    nfds :

    the number of file descriptors in fds +the number of file descriptors in fds

    timeout :

    amount of time to wait, in milliseconds, or -1 to wait forever +amount of time to wait, in milliseconds, or -1 to wait forever
    - - @@ -2577,15 +2678,16 @@ executed.


    g_source_ref ()

    -
    GSource *           g_source_ref                        (GSource *source);
    +
    GSource *           g_source_ref                        (GSource *source);

    -Increases the reference count on a source by one.

    +Increases the reference count on a source by one. +

    source_funcs :

    structure containing functions that implement +structure containing functions that implement the sources behavior.

    struct_size :

    size of the GSource structure to create. +size of the GSource structure to create.
    - @@ -2599,16 +2701,17 @@ Increases the reference count on a source by one.


    g_source_unref ()

    -
    void                g_source_unref                      (GSource *source);
    +
    void                g_source_unref                      (GSource *source);

    Decreases the reference count of a source by one. If the resulting reference count is zero the source and associated -memory will be destroyed.

    +memory will be destroyed. +

    source :

    a GSource +a GSource
    -

    source :

    a GSource +a GSource
    @@ -2616,22 +2719,23 @@ memory will be destroyed.


    g_source_set_funcs ()

    -
    void                g_source_set_funcs                  (GSource *source,
    -                                                         GSourceFuncs *funcs);
    +
    void                g_source_set_funcs                  (GSource *source,
    +                                                         GSourceFuncs *funcs);

    Sets the source functions (can be used to override -default implementations) of an unattached source.

    +default implementations) of an unattached source. +

    - - @@ -2641,22 +2745,23 @@ default implementations) of an unattached source.


    g_source_attach ()

    -
    guint               g_source_attach                     (GSource *source,
    -                                                         GMainContext *context);
    +
    guint               g_source_attach                     (GSource *source,
    +                                                         GMainContext *context);

    Adds a GSource to a context so that it will be executed within -that context. Remove it by calling g_source_destroy().

    +that context. Remove it by calling g_source_destroy(). +

    source :

    a GSource +a GSource

    funcs :

    the new GSourceFuncs +the new GSourceFuncs
    - - @@ -2671,16 +2776,17 @@ that context. Remove it by calling

    g_source_destroy ()

    -
    void                g_source_destroy                    (GSource *source);
    +
    void                g_source_destroy                    (GSource *source);

    Removes a source from its GMainContext, if any, and mark it as destroyed. The source cannot be subsequently added to another -context.

    +context. +

    source :

    a GSource +a GSource

    context :

    a GMainContext (if NULL, the default context will be used) +a GMainContext (if NULL, the default context will be used)
    -

    source :

    a GSource +a GSource
    @@ -2688,7 +2794,7 @@ context.


    g_source_is_destroyed ()

    -
    gboolean            g_source_is_destroyed               (GSource *source);
    +
    gboolean            g_source_is_destroyed               (GSource *source);

    Returns whether source has been destroyed.

    @@ -2699,37 +2805,73 @@ before the dispatch of your idle handler.

    -
    -static gboolean 
    -idle_callback (gpointer data)
    -{
    -  SomeWidget *self = data;
    -   
    -  GDK_THREADS_ENTER ();
    -  /* do stuff with self */
    -  self->idle_id = 0;
    -  GDK_THREADS_LEAVE ();
    -   
    -  return FALSE;
    -}
    - 
    -static void 
    -some_widget_do_stuff_later (SomeWidget *self)
    -{
    -  self->idle_id = g_idle_add (idle_callback, self);
    -}
    - 
    -static void 
    -some_widget_finalize (GObject *object)
    -{
    -  SomeWidget *self = SOME_WIDGET (object);
    -   
    -  if (self->idle_id)
    -    g_source_remove (self->idle_id);
    -   
    -  G_OBJECT_CLASS (parent_class)->finalize (object);
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    static gboolean 
    +idle_callback (gpointer data)
    +{
    +  SomeWidget *self = data;
    +   
    +  GDK_THREADS_ENTER ();
    +  /* do stuff with self */
    +  self->idle_id = 0;
    +  GDK_THREADS_LEAVE ();
    +   
    +  return FALSE;
    +}
    + 
    +static void 
    +some_widget_do_stuff_later (SomeWidget *self)
    +{
    +  self->idle_id = g_idle_add (idle_callback, self);
    +}
    + 
    +static void 
    +some_widget_finalize (GObject *object)
    +{
    +  SomeWidget *self = SOME_WIDGET (object);
    +   
    +  if (self->idle_id)
    +    g_source_remove (self->idle_id);
    +   
    +  G_OBJECT_CLASS (parent_class)->finalize (object);
    +}
    +
    +

    @@ -2741,28 +2883,51 @@ has already been destroy within the callback.

    -
    -static gboolean 
    -idle_callback (gpointer data)
    -{
    -  SomeWidget *self = data;
    -  
    -  GDK_THREADS_ENTER ();
    -  if (!g_source_is_destroyed (g_main_current_source ()))
    -    {
    -      /* do stuff with self */
    -    }
    -  GDK_THREADS_LEAVE ();
    -  
    -  return FALSE;
    -}
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    static gboolean 
    +idle_callback (gpointer data)
    +{
    +  SomeWidget *self = data;
    +  
    +  GDK_THREADS_ENTER ();
    +  if (!g_source_is_destroyed (g_main_current_source ()))
    +    {
    +      /* do stuff with self */
    +    }
    +  GDK_THREADS_LEAVE ();
    +  
    +  return FALSE;
    +}
    +
    + +

    +

    - @@ -2778,23 +2943,24 @@ idle_callback (gpointer data)

    g_source_set_priority ()

    -
    void                g_source_set_priority               (GSource *source,
    -                                                         gint priority);
    +
    void                g_source_set_priority               (GSource *source,
    +                                                         gint priority);

    Sets the priority of a source. While the main loop is being run, a source will be dispatched if it is ready to be dispatched and no sources -at a higher (numerically smaller) priority are ready to be dispatched.

    +at a higher (numerically smaller) priority are ready to be dispatched. +

    source :

    a GSource +a GSource
    - - @@ -2803,15 +2969,16 @@ at a higher (numerically smaller) priority are ready to be dispatched.


    g_source_get_priority ()

    -
    gint                g_source_get_priority               (GSource *source);
    +
    gint                g_source_get_priority               (GSource *source);

    -Gets the priority of a source.

    +Gets the priority of a source. +

    source :

    a GSource +a GSource

    priority :

    the new priority. +the new priority.
    - @@ -2825,24 +2992,25 @@ Gets the priority of a source.


    g_source_set_can_recurse ()

    -
    void                g_source_set_can_recurse            (GSource *source,
    -                                                         gboolean can_recurse);
    +
    void                g_source_set_can_recurse            (GSource *source,
    +                                                         gboolean can_recurse);

    Sets whether a source can be called recursively. If can_recurse is TRUE, then while the source is being dispatched then this source will be processed normally. Otherwise, all processing of this -source is blocked until the dispatch function returns.

    +source is blocked until the dispatch function returns. +

    source :

    a GSource +a GSource
    - - @@ -2851,16 +3019,17 @@ source is blocked until the dispatch function returns.


    g_source_get_can_recurse ()

    -
    gboolean            g_source_get_can_recurse            (GSource *source);
    +
    gboolean            g_source_get_can_recurse            (GSource *source);

    Checks whether a source is allowed to be called recursively. -see g_source_set_can_recurse().

    +see g_source_set_can_recurse(). +

    source :

    a GSource +a GSource

    can_recurse :

    whether recursion is allowed for this source +whether recursion is allowed for this source
    - @@ -2874,18 +3043,19 @@ see

    g_source_get_id ()

    -
    guint               g_source_get_id                     (GSource *source);
    +
    guint               g_source_get_id                     (GSource *source);

    Returns the numeric ID for a particular source. The ID of a source is a positive integer which is unique within a particular main loop context. The reverse -mapping from ID to source is done by g_main_context_find_source_by_id().

    +mapping from ID to source is done by g_main_context_find_source_by_id(). +

    source :

    a GSource +a GSource
    - @@ -2899,16 +3069,17 @@ mapping from ID to source is done by

    g_source_get_context ()

    -
    GMainContext *      g_source_get_context                (GSource *source);
    +
    GMainContext *      g_source_get_context                (GSource *source);

    Gets the GMainContext with which the source is associated. -Calling this function on a destroyed source is an error.

    +Calling this function on a destroyed source is an error. +

    source :

    a GSource +a GSource
    - @@ -2924,10 +3095,10 @@ Calling this function on a destroyed source is an error.


    g_source_set_callback ()

    -
    void                g_source_set_callback               (GSource *source,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    void                g_source_set_callback               (GSource *source,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets the callback function for a source. The callback for a source is called from the source's dispatch function. @@ -2939,28 +3110,29 @@ parameter.

    Typically, you won't use this function. Instead use functions specific -to the type of source you are using.

    +to the type of source you are using. +

    source :

    a GSource +a GSource
    - - - - @@ -2969,7 +3141,7 @@ to the type of source you are using.


    GSourceFunc ()

    -
    gboolean            (*GSourceFunc)                      (gpointer data);
    +
    gboolean            (*GSourceFunc)                      (gpointer data);

    Specifies the type of function passed to g_timeout_add(), g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). @@ -2994,32 +3166,33 @@ of the above functions.


    g_source_set_callback_indirect ()

    -
    void                g_source_set_callback_indirect      (GSource *source,
    -                                                         gpointer callback_data,
    -                                                         GSourceCallbackFuncs *callback_funcs);
    +
    void                g_source_set_callback_indirect      (GSource *source,
    +                                                         gpointer callback_data,
    +                                                         GSourceCallbackFuncs *callback_funcs);

    Sets the callback function storing the data as a refcounted callback "object". This is used internally. Note that calling g_source_set_callback_indirect() assumes an initial reference count on callback_data, and thus callback_funcs->unref will eventually be called once more -than callback_funcs->ref.

    +than callback_funcs->ref. +

    source :

    the source +the source

    func :

    a callback function +a callback function

    data :

    the data to pass to callback function +the data to pass to callback function

    notify :

    a function to call when data is no longer in use, or NULL. +a function to call when data is no longer in use, or NULL.
    - - - @@ -3029,14 +3202,15 @@ than callback_funcs->ref.


    g_source_add_poll ()

    -
    void                g_source_add_poll                   (GSource *source,
    -                                                         GPollFD *fd);
    +
    void                g_source_add_poll                   (GSource *source,
    +                                                         GPollFD *fd);

    Adds a file descriptor to the set of file descriptors polled for this source. This is usually combined with g_source_new() to add an event source. The event source's check function will typically test the revents field in the GPollFD struct and return TRUE if events need -to be processed.

    +to be processed. +

    source :

    the source +the source

    callback_data :

    pointer to callback data "object" +pointer to callback data "object"

    callback_funcs :

    functions for reference counting callback_data +functions for reference counting callback_data and getting the callback and data
    @@ -3047,7 +3221,7 @@ to be processed.

    - @@ -3057,11 +3231,12 @@ to be processed.


    g_source_remove_poll ()

    -
    void                g_source_remove_poll                (GSource *source,
    -                                                         GPollFD *fd);
    +
    void                g_source_remove_poll                (GSource *source,
    +                                                         GPollFD *fd);

    Removes a file descriptor from the set of file descriptors polled for -this source.

    +this source. +

    fd :

    a GPollFD structure holding information about a file +a GPollFD structure holding information about a file descriptor to watch.
    @@ -3072,7 +3247,7 @@ this source.

    - @@ -3081,25 +3256,27 @@ this source.


    g_source_get_current_time ()

    -
    void                g_source_get_current_time           (GSource *source,
    -                                                         GTimeVal *timeval);
    +
    void                g_source_get_current_time           (GSource *source,
    +                                                         GTimeVal *timeval);

    Gets the "current time" to be used when checking this source. The advantage of calling this function over calling g_get_current_time() directly is that when checking multiple sources, GLib can cache a single value -instead of having to repeatedly get the system time.

    +instead of having to repeatedly get the system time. +

    fd :

    a GPollFD structure previously passed to g_source_add_poll(). +a GPollFD structure previously passed to g_source_add_poll().
    - - @@ -3108,7 +3285,7 @@ instead of having to repeatedly get the system time.


    g_source_remove ()

    -
    gboolean            g_source_remove                     (guint tag);
    +
    gboolean            g_source_remove                     (guint tag);

    Removes the source with the given id from the default main context. The id of @@ -3119,13 +3296,14 @@ functions

    See also g_source_destroy(). You must use g_source_destroy() for sources -added to a non-default main context.

    +added to a non-default main context. +

    source :

    a GSource +a GSource

    timeval :

    GTimeVal structure in which to store current time. + +GTimeVal structure in which to store current time.
    - @@ -3139,23 +3317,24 @@ added to a non-default main context.


    g_source_remove_by_funcs_user_data ()

    -
    gboolean            g_source_remove_by_funcs_user_data  (GSourceFuncs *funcs,
    -                                                         gpointer user_data);
    +
    gboolean            g_source_remove_by_funcs_user_data  (GSourceFuncs *funcs,
    +                                                         gpointer user_data);

    Removes a source from the default main loop context given the source functions and user data. If multiple sources exist with the -same source functions and user data, only one will be destroyed.

    +same source functions and user data, only one will be destroyed. +

    tag :

    the ID of the source to remove. +the ID of the source to remove.
    - - @@ -3169,17 +3348,18 @@ same source functions and user data, only one will be destroyed.


    g_source_remove_by_user_data ()

    -
    gboolean            g_source_remove_by_user_data        (gpointer user_data);
    +
    gboolean            g_source_remove_by_user_data        (gpointer user_data);

    Removes a source from the default main loop context given the user data for the callback. If multiple sources exist with the same user -data, only one will be destroyed.

    +data, only one will be destroyed. +

    funcs :

    The source_funcs passed to g_source_new() +The source_funcs passed to g_source_new()

    user_data :

    the user data for the callback +the user data for the callback
    - @@ -3194,6 +3374,6 @@ data, only one will be destroyed.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Thread-Pools.html b/docs/reference/glib/html/glib-Thread-Pools.html index 68d02ee..bf16174 100644 --- a/docs/reference/glib/html/glib-Thread-Pools.html +++ b/docs/reference/glib/html/glib-Thread-Pools.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    user_data :

    the user_data for the callback. +the user_data for the callback.
    @@ -61,35 +41,35 @@ #include <glib.h> GThreadPool; -GThreadPool* g_thread_pool_new (GFunc func, - gpointer user_data, - gint max_threads, - gboolean exclusive, - GError **error); -voidg_thread_pool_push (GThreadPool *pool, - gpointer data, - GError **error); -voidg_thread_pool_set_max_threads (GThreadPool *pool, - gint max_threads, - GError **error); -gintg_thread_pool_get_max_threads (GThreadPool *pool); -guintg_thread_pool_get_num_threads (GThreadPool *pool); -guintg_thread_pool_unprocessed (GThreadPool *pool); -voidg_thread_pool_free (GThreadPool *pool, - gboolean immediate, - gboolean wait_); +GThreadPool* g_thread_pool_new (GFunc func, + gpointer user_data, + gint max_threads, + gboolean exclusive, + GError **error); +voidg_thread_pool_push (GThreadPool *pool, + gpointer data, + GError **error); +voidg_thread_pool_set_max_threads (GThreadPool *pool, + gint max_threads, + GError **error); +gintg_thread_pool_get_max_threads (GThreadPool *pool); +guintg_thread_pool_get_num_threads (GThreadPool *pool); +guintg_thread_pool_unprocessed (GThreadPool *pool); +voidg_thread_pool_free (GThreadPool *pool, + gboolean immediate, + gboolean wait_); voidg_thread_pool_set_max_unused_threads - (gint max_threads); + (gint max_threads); gintg_thread_pool_get_max_unused_threads - (void); + (void); guintg_thread_pool_get_num_unused_threads - (void); -voidg_thread_pool_stop_unused_threads (void); -voidg_thread_pool_set_sort_function (GThreadPool *pool, - GCompareDataFunc func, - gpointer user_data); -voidg_thread_pool_set_max_idle_time (guint interval); -guintg_thread_pool_get_max_idle_time (void); + (void); +voidg_thread_pool_stop_unused_threads (void); +voidg_thread_pool_set_sort_function (GThreadPool *pool, + GCompareDataFunc func, + gpointer user_data); +voidg_thread_pool_set_max_idle_time (guint interval); +guintg_thread_pool_get_max_idle_time (void);
    @@ -128,7 +108,8 @@ alive by GLib for future use. The current number can be fetched with g_thread_pool_get_num_unused_threads(). The maximal number can be controlled by g_thread_pool_get_max_unused_threads() and g_thread_pool_set_max_unused_threads(). All currently unused threads -can be stopped by calling g_thread_pool_stop_unused_threads().

    +can be stopped by calling g_thread_pool_stop_unused_threads(). +

    Details

    @@ -143,23 +124,24 @@ can be stopped by calling GThreadPool struct represents a thread pool. It has three public read-only members, but the underlying struct is bigger, so -you must not copy this struct.

    +you must not copy this struct. +

    - - - @@ -168,11 +150,11 @@ you must not copy this struct.


    g_thread_pool_new ()

    -
    GThreadPool*        g_thread_pool_new                   (GFunc func,
    -                                                         gpointer user_data,
    -                                                         gint max_threads,
    -                                                         gboolean exclusive,
    -                                                         GError **error);
    +
    GThreadPool*        g_thread_pool_new                   (GFunc func,
    +                                                         gpointer user_data,
    +                                                         gint max_threads,
    +                                                         gboolean exclusive,
    +                                                         GError **error);

    This function creates a new thread pool.

    @@ -198,35 +180,36 @@ be -1 for exclusive thread pools.

    error can be NULL to ignore errors, or non-NULL to report errors. An error can only occur when exclusive is set to TRUE and -not all max_threads threads could be created.

    +not all max_threads threads could be created. +

    GFunc func;

    the function to execute in the threads of this pool +the function to execute in the threads of this pool

    gpointer user_data;

    the user data for the threads of this pool +the user data for the threads of this pool

    gboolean exclusive;

    are all threads exclusive to this pool +are all threads exclusive to this pool
    - - - - - @@ -240,9 +223,9 @@ not all max_threads threads could be cre

    g_thread_pool_push ()

    -
    void                g_thread_pool_push                  (GThreadPool *pool,
    -                                                         gpointer data,
    -                                                         GError **error);
    +
    void                g_thread_pool_push                  (GThreadPool *pool,
    +                                                         gpointer data,
    +                                                         GError **error);

    Inserts data into the list of tasks to be executed by pool. When the number of currently running threads is lower than the maximal @@ -255,23 +238,24 @@ and processes data. error can be NULL to ignore errors, or non-NULL to report errors. An error can only occur when a new thread couldn't be created. In that case data is simply appended to the queue of work -to do.

    +to do. +

    func :

    a function to execute in the threads of the new thread pool +a function to execute in the threads of the new thread pool

    user_data :

    user data that is handed over to func every time it +user data that is handed over to func every time it is called

    max_threads :

    the maximal number of threads to execute concurrently in +the maximal number of threads to execute concurrently in the new thread pool, -1 means no limit

    exclusive :

    should this thread pool be exclusive? +should this thread pool be exclusive?

    error :

    return location for error +return location for error
    - - - @@ -280,9 +264,9 @@ to do.


    g_thread_pool_set_max_threads ()

    -
    void                g_thread_pool_set_max_threads       (GThreadPool *pool,
    -                                                         gint max_threads,
    -                                                         GError **error);
    +
    void                g_thread_pool_set_max_threads       (GThreadPool *pool,
    +                                                         gint max_threads,
    +                                                         GError **error);

    Sets the maximal allowed number of threads for pool. A value of -1 means, that the maximal number of threads is unlimited. @@ -302,23 +286,24 @@ running threads in pool is smaller than

    error can be NULL to ignore errors, or non-NULL to report errors. An error can only occur when a new thread couldn't be -created.

    +created. +

    pool :

    a GThreadPool +a GThreadPool

    data :

    a new task for pool +a new task for pool

    error :

    return location for error +return location for error
    - - - @@ -327,15 +312,16 @@ created.


    g_thread_pool_get_max_threads ()

    -
    gint                g_thread_pool_get_max_threads       (GThreadPool *pool);
    +
    gint                g_thread_pool_get_max_threads       (GThreadPool *pool);

    -Returns the maximal number of threads for pool.

    +Returns the maximal number of threads for pool. +

    pool :

    a GThreadPool +a GThreadPool

    max_threads :

    a new maximal number of threads for pool +a new maximal number of threads for pool

    error :

    return location for error +return location for error
    - @@ -349,15 +335,16 @@ Returns the maximal number of threads for pool

    g_thread_pool_get_num_threads ()

    -
    guint               g_thread_pool_get_num_threads       (GThreadPool *pool);
    +
    guint               g_thread_pool_get_num_threads       (GThreadPool *pool);

    -Returns the number of threads currently running in pool.

    +Returns the number of threads currently running in pool. +

    pool :

    a GThreadPool +a GThreadPool
    - @@ -371,15 +358,16 @@ Returns the number of threads currently running in p

    g_thread_pool_unprocessed ()

    -
    guint               g_thread_pool_unprocessed           (GThreadPool *pool);
    +
    guint               g_thread_pool_unprocessed           (GThreadPool *pool);

    -Returns the number of tasks still unprocessed in pool.

    +Returns the number of tasks still unprocessed in pool. +

    pool :

    a GThreadPool +a GThreadPool
    - @@ -393,9 +381,9 @@ Returns the number of tasks still unprocessed in poo

    g_thread_pool_free ()

    -
    void                g_thread_pool_free                  (GThreadPool *pool,
    -                                                         gboolean immediate,
    -                                                         gboolean wait_);
    +
    void                g_thread_pool_free                  (GThreadPool *pool,
    +                                                         gboolean immediate,
    +                                                         gboolean wait_);

    Frees all resources allocated for pool.

    @@ -412,23 +400,24 @@ to be processed (dependent on immediate, currently running) are ready. Otherwise the function returns immediately.

    -After calling this function pool must not be used anymore.

    +After calling this function pool must not be used anymore. +

    pool :

    a GThreadPool +a GThreadPool
    - - - @@ -438,16 +427,17 @@ After calling this function pool must no

    g_thread_pool_set_max_unused_threads ()

    void                g_thread_pool_set_max_unused_threads
    -                                                        (gint max_threads);
    + (gint max_threads);

    Sets the maximal number of unused threads to max_threads. If max_threads is -1, no limit is imposed on the number of unused -threads.

    +threads. +

    pool :

    a GThreadPool +a GThreadPool

    immediate :

    should pool shut down immediately? +should pool shut down immediately?

    wait_ :

    should the function wait for all tasks to be finished? +should the function wait for all tasks to be finished?
    -

    max_threads :

    maximal number of unused threads +maximal number of unused threads
    @@ -456,9 +446,10 @@ threads.

    g_thread_pool_get_max_unused_threads ()

    gint                g_thread_pool_get_max_unused_threads
    -                                                        (void);
    + (void);

    -Returns the maximal allowed number of unused threads.

    +Returns the maximal allowed number of unused threads. +

    @@ -472,9 +463,10 @@ Returns the maximal allowed number of unused threads.

    g_thread_pool_get_num_unused_threads ()

    guint               g_thread_pool_get_num_unused_threads
    -                                                        (void);
    + (void);

    -Returns the number of currently unused threads.

    +Returns the number of currently unused threads. +

    @@ -487,18 +479,19 @@ Returns the number of currently unused threads.


    g_thread_pool_stop_unused_threads ()

    -
    void                g_thread_pool_stop_unused_threads   (void);
    +
    void                g_thread_pool_stop_unused_threads   (void);

    Stops all currently unused threads. This does not change the maximal number of unused threads. This function can be used to -regularly stop all unused threads e.g. from g_timeout_add().

    +regularly stop all unused threads e.g. from g_timeout_add(). +


    g_thread_pool_set_sort_function ()

    -
    void                g_thread_pool_set_sort_function     (GThreadPool *pool,
    -                                                         GCompareDataFunc func,
    -                                                         gpointer user_data);
    +
    void                g_thread_pool_set_sort_function     (GThreadPool *pool,
    +                                                         GCompareDataFunc func,
    +                                                         gpointer user_data);

    Sets the function used to sort the list of tasks. This allows the tasks to be processed by a priority determined by func, and not @@ -509,18 +502,19 @@ Note, if the maximum number of threads is more than 1, the order that threads are executed can not be guranteed 100%. Threads are scheduled by the operating system and are executed at random. It cannot be assumed that threads are executed in the order they are -created.

    +created. +

    - - - @@ -540,7 +534,7 @@ created.


    g_thread_pool_set_max_idle_time ()

    -
    void                g_thread_pool_set_max_idle_time     (guint interval);
    +
    void                g_thread_pool_set_max_idle_time     (guint interval);

    This function will set the maximum interval that a thread waiting in the pool for new tasks can be idle for before being @@ -552,12 +546,13 @@ this is done on a per thread basis. By setting interval to 0, idle threads will not be stopped. This function makes use of g_async_queue_timed_pop() using -interval.

    +interval. +

    pool :

    a GThreadPool +a GThreadPool

    func :

    the GCompareDataFunc used to sort the list of tasks. +the GCompareDataFunc used to sort the list of tasks. This function is passed two tasks. It should return 0 if the order in which they are handled does not matter, a negative value if the first task should be processed before @@ -530,7 +524,7 @@ created.

    user_data :

    user data passed to func. +user data passed to func.
    - @@ -567,14 +562,15 @@ This function makes use of

    g_thread_pool_get_max_idle_time ()

    -
    guint               g_thread_pool_get_max_idle_time     (void);
    +
    guint               g_thread_pool_get_max_idle_time     (void);

    This function will return the maximum interval that a thread will wait in the thread pool for new tasks before being stopped.

    If this function returns 0, threads waiting in the thread pool for -new work are not stopped.

    +new work are not stopped. +

    interval :

    the maximum interval (1/1000ths of a second) a thread +the maximum interval (1/1000ths of a second) a thread can be idle.
    @@ -605,6 +601,6 @@ new work are not stopped.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Threads.html b/docs/reference/glib/html/glib-Threads.html index d467152..97249f7 100644 --- a/docs/reference/glib/html/glib-Threads.html +++ b/docs/reference/glib/html/glib-Threads.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -69,48 +49,48 @@ enum GThreadError; GThreadFunctions; -voidg_thread_init (GThreadFunctions *vtable); +voidg_thread_init (GThreadFunctions *vtable); gbooleang_thread_supported (); -gbooleang_thread_get_initialized (void); +gbooleang_thread_get_initialized (void); -gpointer (*GThreadFunc) (gpointer data); +gpointer (*GThreadFunc) (gpointer data); enum GThreadPriority; GThread; -GThread * g_thread_create (GThreadFunc func, - gpointer data, - gboolean joinable, - GError **error); -GThread* g_thread_create_full (GThreadFunc func, - gpointer data, - gulong stack_size, - gboolean joinable, - gboolean bound, - GThreadPriority priority, - GError **error); -GThread* g_thread_self (void); -gpointerg_thread_join (GThread *thread); -voidg_thread_set_priority (GThread *thread, - GThreadPriority priority); +GThread * g_thread_create (GThreadFunc func, + gpointer data, + gboolean joinable, + GError **error); +GThread* g_thread_create_full (GThreadFunc func, + gpointer data, + gulong stack_size, + gboolean joinable, + gboolean bound, + GThreadPriority priority, + GError **error); +GThread* g_thread_self (void); +gpointerg_thread_join (GThread *thread); +voidg_thread_set_priority (GThread *thread, + GThreadPriority priority); voidg_thread_yield (); -voidg_thread_exit (gpointer retval); -voidg_thread_foreach (GFunc thread_func, - gpointer user_data); +voidg_thread_exit (gpointer retval); +voidg_thread_foreach (GFunc thread_func, + gpointer user_data); GMutex; GMutex * g_mutex_new (); -voidg_mutex_lock (GMutex *mutex); -gbooleang_mutex_trylock (GMutex *mutex); -voidg_mutex_unlock (GMutex *mutex); -voidg_mutex_free (GMutex *mutex); +voidg_mutex_lock (GMutex *mutex); +gbooleang_mutex_trylock (GMutex *mutex); +voidg_mutex_unlock (GMutex *mutex); +voidg_mutex_free (GMutex *mutex); GStaticMutex; #define G_STATIC_MUTEX_INIT -voidg_static_mutex_init (GStaticMutex *mutex); -voidg_static_mutex_lock (GStaticMutex *mutex); -gbooleang_static_mutex_trylock (GStaticMutex *mutex); -voidg_static_mutex_unlock (GStaticMutex *mutex); -GMutex * g_static_mutex_get_mutex (GStaticMutex *mutex); -voidg_static_mutex_free (GStaticMutex *mutex); +voidg_static_mutex_init (GStaticMutex *mutex); +voidg_static_mutex_lock (GStaticMutex *mutex); +gbooleang_static_mutex_trylock (GStaticMutex *mutex); +voidg_static_mutex_unlock (GStaticMutex *mutex); +GMutex * g_static_mutex_get_mutex (GStaticMutex *mutex); +voidg_static_mutex_free (GStaticMutex *mutex); #define G_LOCK_DEFINE (name) #define G_LOCK_DEFINE_STATIC (name) @@ -121,66 +101,68 @@ enum GStaticRecMutex; #define G_STATIC_REC_MUTEX_INIT -voidg_static_rec_mutex_init (GStaticRecMutex *mutex); -voidg_static_rec_mutex_lock (GStaticRecMutex *mutex); -gbooleang_static_rec_mutex_trylock (GStaticRecMutex *mutex); -voidg_static_rec_mutex_unlock (GStaticRecMutex *mutex); -voidg_static_rec_mutex_lock_full (GStaticRecMutex *mutex, - guint depth); -guintg_static_rec_mutex_unlock_full (GStaticRecMutex *mutex); -voidg_static_rec_mutex_free (GStaticRecMutex *mutex); +voidg_static_rec_mutex_init (GStaticRecMutex *mutex); +voidg_static_rec_mutex_lock (GStaticRecMutex *mutex); +gbooleang_static_rec_mutex_trylock (GStaticRecMutex *mutex); +voidg_static_rec_mutex_unlock (GStaticRecMutex *mutex); +voidg_static_rec_mutex_lock_full (GStaticRecMutex *mutex, + guint depth); +guintg_static_rec_mutex_unlock_full (GStaticRecMutex *mutex); +voidg_static_rec_mutex_free (GStaticRecMutex *mutex); GStaticRWLock; #define G_STATIC_RW_LOCK_INIT -voidg_static_rw_lock_init (GStaticRWLock *lock); -voidg_static_rw_lock_reader_lock (GStaticRWLock *lock); -gbooleang_static_rw_lock_reader_trylock (GStaticRWLock *lock); -voidg_static_rw_lock_reader_unlock (GStaticRWLock *lock); -voidg_static_rw_lock_writer_lock (GStaticRWLock *lock); -gbooleang_static_rw_lock_writer_trylock (GStaticRWLock *lock); -voidg_static_rw_lock_writer_unlock (GStaticRWLock *lock); -voidg_static_rw_lock_free (GStaticRWLock *lock); +voidg_static_rw_lock_init (GStaticRWLock *lock); +voidg_static_rw_lock_reader_lock (GStaticRWLock *lock); +gbooleang_static_rw_lock_reader_trylock (GStaticRWLock *lock); +voidg_static_rw_lock_reader_unlock (GStaticRWLock *lock); +voidg_static_rw_lock_writer_lock (GStaticRWLock *lock); +gbooleang_static_rw_lock_writer_trylock (GStaticRWLock *lock); +voidg_static_rw_lock_writer_unlock (GStaticRWLock *lock); +voidg_static_rw_lock_free (GStaticRWLock *lock); GCond; GCond* g_cond_new (); -voidg_cond_signal (GCond *cond); -voidg_cond_broadcast (GCond *cond); -voidg_cond_wait (GCond *cond, - GMutex *mutex); -gbooleang_cond_timed_wait (GCond *cond, - GMutex *mutex, - GTimeVal *abs_time); -voidg_cond_free (GCond *cond); +voidg_cond_signal (GCond *cond); +voidg_cond_broadcast (GCond *cond); +voidg_cond_wait (GCond *cond, + GMutex *mutex); +gbooleang_cond_timed_wait (GCond *cond, + GMutex *mutex, + GTimeVal *abs_time); +voidg_cond_free (GCond *cond); GPrivate; -GPrivate* g_private_new (GDestroyNotify destructor); -gpointerg_private_get (GPrivate *private_key); -voidg_private_set (GPrivate *private_key, - gpointer data); +GPrivate* g_private_new (GDestroyNotify destructor); +gpointerg_private_get (GPrivate *private_key); +voidg_private_set (GPrivate *private_key, + gpointer data); GStaticPrivate; #define G_STATIC_PRIVATE_INIT -voidg_static_private_init (GStaticPrivate *private_key); -gpointerg_static_private_get (GStaticPrivate *private_key); -voidg_static_private_set (GStaticPrivate *private_key, - gpointer data, - GDestroyNotify notify); -voidg_static_private_free (GStaticPrivate *private_key); +voidg_static_private_init (GStaticPrivate *private_key); +gpointerg_static_private_get (GStaticPrivate *private_key); +voidg_static_private_set (GStaticPrivate *private_key, + gpointer data, + GDestroyNotify notify); +voidg_static_private_free (GStaticPrivate *private_key); GOnce; enum GOnceStatus; #define G_ONCE_INIT -#define g_once (once, func, arg) -gbooleang_once_init_enter (volatile gsize *value_location); -voidg_once_init_leave (volatile gsize *value_location, - gsize initialization_value); - -voidg_bit_lock (volatile gint *address, - gint lock_bit); -gbooleang_bit_trylock (volatile gint *address, - gint lock_bit); -voidg_bit_unlock (volatile gint *address, - gint lock_bit); +#define g_once (once, + func, + arg) +gbooleang_once_init_enter (volatile gsize *value_location); +voidg_once_init_leave (volatile gsize *value_location, + gsize initialization_value); + +voidg_bit_lock (volatile gint *address, + gint lock_bit); +gbooleang_bit_trylock (volatile gint *address, + gint lock_bit); +voidg_bit_unlock (volatile gint *address, + gint lock_bit);
    @@ -225,10 +207,10 @@ this should be avoided if possible.

    Please note that since version 2.24 the GObject initialization -function g_type_init() initializes threads (with a NULL argument), +function g_type_init() initializes threads (with a NULL argument), so most applications, including those using Gtk+ will run with threads enabled. If you want a special thread implementation, make -sure you call g_thread_init() before g_type_init() is called. +sure you call g_thread_init() before g_type_init() is called.

    After calling g_thread_init(), GLib is completely thread safe (all @@ -244,7 +226,8 @@ accessed from multiple threads. To help debugging problems in multithreaded applications, GLib supports error-checking mutexes that will give you helpful error messages on common problems. To use error-checking mutexes, define -the symbol G_ERRORCHECK_MUTEXES when compiling the application.

    +the symbol G_ERRORCHECK_MUTEXES when compiling the application. +

    Details

    @@ -258,7 +241,8 @@ does not necessarily mean that there is a thread implementation available, but it does mean that the infrastructure is in place and that once you provide a thread implementation to g_thread_init(), GLib will be multi-thread safe. If G_THREADS_ENABLED is not -defined, then Glib is not, and cannot be, multi-thread safe.

    +defined, then Glib is not, and cannot be, multi-thread safe. +


    @@ -266,7 +250,8 @@ defined, then Glib is not, and cannot be, multi-thread safe.

    #define G_THREADS_IMPL_POSIX
     

    -This macro is defined if POSIX style threads are used.

    +This macro is defined if POSIX style threads are used. +


    @@ -276,7 +261,8 @@ This macro is defined if POSIX style threads are used.

    This macro is defined if no thread implementation is used. You can, however, provide one to g_thread_init() to make GLib multi-thread -safe.

    +safe. +


    @@ -284,7 +270,8 @@ safe.

    #define G_THREAD_ERROR g_thread_error_quark ()
     

    -The error domain of the GLib thread subsystem.

    +The error domain of the GLib thread subsystem. +


    @@ -295,12 +282,13 @@ The error domain of the GLib thread subsystem.

    } GThreadError;

    -Possible errors of thread related functions.

    +Possible errors of thread related functions. +

    - @@ -360,113 +348,115 @@ provided to

    G_THREAD_ERROR_AGAIN

    a thread couldn't be created due to resource +a thread couldn't be created due to resource shortage. Try again later.
    - - - - - - - - - - - - - - - - - - - - - @@ -476,7 +466,7 @@ doing.


    g_thread_init ()

    -
    void                g_thread_init                       (GThreadFunctions *vtable);
    +
    void                g_thread_init                       (GThreadFunctions *vtable);

    If you use GLib from more than one thread, you must initialize the thread system by calling g_thread_init(). Most of the time you will @@ -531,11 +521,13 @@ gthread-2.0 outputs. This is not the case for all the other thread related functions of GLib. Those can be used without having to link with the thread libraries.

    +

    +

    mutex_new ()

    virtual function pointer for g_mutex_new() +virtual function pointer for g_mutex_new()

    mutex_lock ()

    virtual function pointer for g_mutex_lock() +virtual function pointer for g_mutex_lock()

    mutex_trylock ()

    virtual function pointer for g_mutex_trylock() +virtual function pointer for g_mutex_trylock()

    mutex_unlock ()

    virtual function pointer for g_mutex_unlock() +virtual function pointer for g_mutex_unlock()

    mutex_free ()

    virtual function pointer for g_mutex_free() +virtual function pointer for g_mutex_free()

    cond_new ()

    virtual function pointer for g_cond_new() +virtual function pointer for g_cond_new()

    cond_signal ()

    virtual function pointer for g_cond_signal() +virtual function pointer for g_cond_signal()

    cond_broadcast ()

    virtual function pointer for g_cond_broadcast() +virtual function pointer for g_cond_broadcast()

    cond_wait ()

    virtual function pointer for g_cond_wait() +virtual function pointer for g_cond_wait()

    cond_timed_wait ()

    virtual function pointer for g_cond_timed_wait() +virtual function pointer for g_cond_timed_wait()

    cond_free ()

    virtual function pointer for g_cond_free() +virtual function pointer for g_cond_free()

    private_new ()

    virtual function pointer for g_private_new() +virtual function pointer for g_private_new()

    private_get ()

    virtual function pointer for g_private_get() +virtual function pointer for g_private_get()

    private_set ()

    virtual function pointer for g_private_set() +virtual function pointer for g_private_set()

    thread_create ()

    virtual function pointer for g_thread_create() +virtual function pointer for g_thread_create()

    thread_yield ()

    virtual function pointer for g_thread_yield() +virtual function pointer for g_thread_yield()

    thread_join ()

    virtual function pointer for g_thread_join() +virtual function pointer for g_thread_join()

    thread_exit ()

    virtual function pointer for g_thread_exit() +virtual function pointer for g_thread_exit()

    thread_set_priority ()

    virtual function pointer for +virtual function pointer for g_thread_set_priority()

    thread_self ()

    virtual function pointer for g_thread_self() +virtual function pointer for g_thread_self()

    thread_equal ()

    used internally by recursive mutex locks and by some +used internally by recursive mutex locks and by some assertion checks
    - @@ -557,11 +549,14 @@ This function returns +

    +

    vtable :

    a function table of type GThreadFunctions, that provides +a function table of type GThreadFunctions, that provides the entry points to the thread system to be used.
    -

    Returns :

    TRUE, if the thread system is initialized. + +TRUE, if the thread system is initialized.
    @@ -569,9 +564,10 @@ function.


    g_thread_get_initialized ()

    -
    gboolean            g_thread_get_initialized            (void);
    +
    gboolean            g_thread_get_initialized            (void);

    -Indicates if g_thread_init() has been called.

    +Indicates if g_thread_init() has been called. +

    @@ -586,21 +582,22 @@ Indicates if

    GThreadFunc ()

    -
    gpointer            (*GThreadFunc)                      (gpointer data);
    +
    gpointer            (*GThreadFunc)                      (gpointer data);

    Specifies the type of the func functions passed to -g_thread_create() or g_thread_create_full().

    +g_thread_create() or g_thread_create_full(). +

    - - @@ -631,27 +628,29 @@ thread priorities. On other systems (e.g. Solaris) there doesn't seem to be different scheduling for different priorities. All in all try to avoid being dependent on priorities.

    +

    +

    data :

    data passed to the thread. +data passed to the thread.

    Returns :

    the return value of the thread, which will be returned by +the return value of the thread, which will be returned by g_thread_join().
    - - - - @@ -675,14 +674,16 @@ not copy this struct.

    Resources for a joinable thread are not fully released until g_thread_join() is called for that thread.

    +

    +


    g_thread_create ()

    -
    GThread *           g_thread_create                     (GThreadFunc func,
    -                                                         gpointer data,
    -                                                         gboolean joinable,
    -                                                         GError **error);
    +
    GThread *           g_thread_create                     (GThreadFunc func,
    +                                                         gpointer data,
    +                                                         gboolean joinable,
    +                                                         GError **error);

    This function creates a new thread with the default priority.

    @@ -697,33 +698,34 @@ If the thread was created successfully, it is returned.

    error can be NULL to ignore errors, or non-NULL to report errors. -The error is set, if and only if the function returns NULL.

    +The error is set, if and only if the function returns NULL. +

    G_THREAD_PRIORITY_LOW

    a priority lower than normal +a priority lower than normal

    G_THREAD_PRIORITY_NORMAL

    the default priority +the default priority

    G_THREAD_PRIORITY_HIGH

    a priority higher than normal +a priority higher than normal

    G_THREAD_PRIORITY_URGENT

    the highest priority +the highest priority
    - - - - - @@ -732,13 +734,13 @@ The error is set, if and only if the function returns

    g_thread_create_full ()

    -
    GThread*            g_thread_create_full                (GThreadFunc func,
    -                                                         gpointer data,
    -                                                         gulong stack_size,
    -                                                         gboolean joinable,
    -                                                         gboolean bound,
    -                                                         GThreadPriority priority,
    -                                                         GError **error);
    +
    GThread*            g_thread_create_full                (GThreadFunc func,
    +                                                         gpointer data,
    +                                                         gulong stack_size,
    +                                                         gboolean joinable,
    +                                                         gboolean bound,
    +                                                         GThreadPriority priority,
    +                                                         GError **error);

    This function creates a new thread with the priority priority. If the underlying thread implementation supports it, the thread gets a @@ -784,47 +786,49 @@ try to avoid being dependent on priorities. Use stack_size, bound, and priority as arguments, as they should only be used in cases in which it is unavoidable.

    +

    +

    func :

    a function to execute in the new thread. +a function to execute in the new thread.

    data :

    an argument to supply to the new thread. +an argument to supply to the new thread.

    joinable :

    should this thread be joinable? +should this thread be joinable?

    error :

    return location for error. +return location for error.

    Returns :

    the new GThread on success. +the new GThread on success.
    - - - - - - - - @@ -833,15 +837,16 @@ be used in cases in which it is unavoidable.


    g_thread_self ()

    -
    GThread*            g_thread_self                       (void);
    +
    GThread*            g_thread_self                       (void);

    This functions returns the GThread corresponding to the calling -thread.

    +thread. +

    func :

    a function to execute in the new thread. +a function to execute in the new thread.

    data :

    an argument to supply to the new thread. +an argument to supply to the new thread.

    stack_size :

    a stack size for the new thread. +a stack size for the new thread.

    joinable :

    should this thread be joinable? +should this thread be joinable?

    bound :

    should this thread be bound to a system thread? +should this thread be bound to a system thread?

    priority :

    a priority for the thread. +a priority for the thread.

    error :

    return location for error. +return location for error.

    Returns :

    the new GThread on success. +the new GThread on success.
    -

    Returns :

    the current thread. +the current thread.
    @@ -849,25 +854,26 @@ thread.


    g_thread_join ()

    -
    gpointer            g_thread_join                       (GThread *thread);
    +
    gpointer            g_thread_join                       (GThread *thread);

    Waits until thread finishes, i.e. the function func, as given to g_thread_create(), returns or g_thread_exit() is called by thread. All resources of thread including the GThread struct are released. thread must have been created with joinable=TRUE in g_thread_create(). The value returned by func or given to -g_thread_exit() by thread is returned by this function.

    +g_thread_exit() by thread is returned by this function. +

    - - @@ -876,8 +882,8 @@ All resources of thread including the

    g_thread_set_priority ()

    -
    void                g_thread_set_priority               (GThread *thread,
    -                                                         GThreadPriority priority);
    +
    void                g_thread_set_priority               (GThread *thread,
    +                                                         GThreadPriority priority);

    Changes the priority of thread to priority.

    @@ -891,17 +897,19 @@ there are no thread priorities. On other systems (e.g. Solaris) there doesn't seem to be different scheduling for different priorities. All in all try to avoid being dependent on priorities.

    +

    +

    thread :

    a GThread to be waited for. +a GThread to be waited for.

    Returns :

    the return value of the thread. +the return value of the thread.
    - - @@ -917,12 +925,13 @@ Gives way to other threads waiting to be scheduled.

    This function is often used as a method to make busy wait less evil. But in most cases you will encounter, there are better methods to do -that. So in general you shouldn't use this function.

    +that. So in general you shouldn't use this function. +


    g_thread_exit ()

    -
    void                g_thread_exit                       (gpointer retval);
    +
    void                g_thread_exit                       (gpointer retval);

    Exits the current thread. If another thread is waiting for that thread using g_thread_join() and the current thread is joinable, the @@ -932,9 +941,17 @@ is ignored. Calling

    -
    -  g_thread_exit (retval);
    - 
    +
    +

    thread :

    a GThread. +a GThread.

    priority :

    a new priority for thread. +a new priority for thread.
    + + + + + + +
    1
    g_thread_exit (retval);
    +
    +

    @@ -949,11 +966,13 @@ to GThreadPool, as that will mess up the bookkeeping and lead to funny and unwanted results.

    +

    +

    -

    retval :

    the return value of this thread. +the return value of this thread.
    @@ -961,8 +980,8 @@ and unwanted results.


    g_thread_foreach ()

    -
    void                g_thread_foreach                    (GFunc thread_func,
    -                                                         gpointer user_data);
    +
    void                g_thread_foreach                    (GFunc thread_func,
    +                                                         gpointer user_data);

    Call thread_func on all existing GThread structures. Note that threads may decide to exit while thread_func is running, so @@ -973,18 +992,19 @@ which are known to have exited already.

    Due to thread lifetime checks, this function has an execution complexity -which is quadratic in the number of existing threads.

    +which is quadratic in the number of existing threads. +

    - - @@ -1003,21 +1023,40 @@ access. Take for example the following function:

    -

    Example 2. A function which will not work in a threaded environment

    -
    -  int
    -  give_me_next_number (void)
    -  {
    -    static int current_number = 0;
    -
    -    /* now do a very complicated calculation to calculate the new
    -     * number, this might for example be a random number generator
    -     */
    -    current_number = calc_next_number (current_number);
    -
    -    return current_number;
    -  }
    - 
    +

    Example 2. A function which will not work in a threaded environment

    +
    +

    thread_func :

    function to call for all GThread structures +function to call for all GThread structures

    user_data :

    second argument to thread_func +second argument to thread_func
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    int
    +give_me_next_number (void)
    +{
    +  static int current_number = 0;
    +
    +  /* now do a very complicated calculation to calculate the new
    +   * number, this might for example be a random number generator
    +   */
    +  current_number = calc_next_number (current_number);
    +
    +  return current_number;
    +}
    +
    +


    @@ -1029,24 +1068,46 @@ access. A first naive implementation would be:

    -

    Example 3. The wrong way to write a thread-safe function

    -
    -  int
    -  give_me_next_number (void)
    -  {
    -    static int current_number = 0;
    -    int ret_val;
    -    static GMutex * mutex = NULL;
    +

    Example 3. The wrong way to write a thread-safe function

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    int
    +give_me_next_number (void)
    +{
    +  static int current_number = 0;
    +  int ret_val;
    +  static GMutex * mutex = NULL;
     
    -    if (!mutex) mutex = g_mutex_new ();
    +  if (!mutex) mutex = g_mutex_new ();
     
    -    g_mutex_lock (mutex);
    -    ret_val = current_number = calc_next_number (current_number);
    -    g_mutex_unlock (mutex);
    +  g_mutex_lock (mutex);
    +  ret_val = current_number = calc_next_number (current_number);
    +  g_mutex_unlock (mutex);
    +
    +  return ret_val;
    +}
    +
    - return ret_val; - } -


    @@ -1059,35 +1120,68 @@ is:

    -

    Example 4. A correct thread-safe function

    -
    -  static GMutex *give_me_next_number_mutex = NULL;
    -
    -  /* this function must be called before any call to
    -   * give_me_next_number()
    -   *
    -   * it must be called exactly once.
    -   */
    -  void
    -  init_give_me_next_number (void)
    -  {
    -    g_assert (give_me_next_number_mutex == NULL);
    -    give_me_next_number_mutex = g_mutex_new ();
    -  }
    -
    -  int
    -  give_me_next_number (void)
    -  {
    -    static int current_number = 0;
    -    int ret_val;
    -
    -    g_mutex_lock (give_me_next_number_mutex);
    -    ret_val = current_number = calc_next_number (current_number);
    -    g_mutex_unlock (give_me_next_number_mutex);
    -
    -    return ret_val;
    -  }
    - 
    +

    Example 4. A correct thread-safe function

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    static GMutex *give_me_next_number_mutex = NULL;
    +
    +/* this function must be called before any call to
    + * give_me_next_number()
    + *
    + * it must be called exactly once.
    + */
    +void
    +init_give_me_next_number (void)
    +{
    +  g_assert (give_me_next_number_mutex == NULL);
    +  give_me_next_number_mutex = g_mutex_new ();
    +}
    +
    +int
    +give_me_next_number (void)
    +{
    +  static int current_number = 0;
    +  int ret_val;
    +
    +  g_mutex_lock (give_me_next_number_mutex);
    +  ret_val = current_number = calc_next_number (current_number);
    +  g_mutex_unlock (give_me_next_number_mutex);
    +
    +  return ret_val;
    +}
    +
    +


    @@ -1111,6 +1205,8 @@ A @@ -1126,11 +1222,13 @@ Creates a new This function will abort if g_thread_init() has not been called yet.

    +

    +

    -

    Returns :

    a new GMutex. +a new GMutex.
    @@ -1138,7 +1236,7 @@ called yet.


    g_mutex_lock ()

    -
    void                g_mutex_lock                        (GMutex *mutex);
    +
    void                g_mutex_lock                        (GMutex *mutex);

    Locks mutex. If mutex is already locked by another thread, the current thread will block until mutex is unlocked by the other @@ -1157,11 +1255,13 @@ non-recursive, i.e. a thread could deadlock while calling g_mutex_lock(), if it already has locked mutex. Use GStaticRecMutex, if you need recursive mutexes.

    +

    +

    -

    mutex :

    a GMutex. +a GMutex.
    @@ -1169,7 +1269,7 @@ non-recursive, i.e. a thread could deadlock while calling

    g_mutex_trylock ()

    -
    gboolean            g_mutex_trylock                     (GMutex *mutex);
    +
    gboolean            g_mutex_trylock                     (GMutex *mutex);

    Tries to lock mutex. If mutex is already locked by another thread, it immediately returns FALSE. Otherwise it locks mutex and returns @@ -1189,17 +1289,20 @@ both < mutex. Use GStaticRecMutex, if you need recursive mutexes.

    +

    +

    - - @@ -1208,19 +1311,20 @@ mutexes.


    g_mutex_unlock ()

    -
    void                g_mutex_unlock                      (GMutex *mutex);
    +
    void                g_mutex_unlock                      (GMutex *mutex);

    Unlocks mutex. If another thread is blocked in a g_mutex_lock() call for mutex, it will be woken and can lock mutex itself.

    This function can be used even if g_thread_init() has not yet been -called, and, in that case, will do nothing.

    +called, and, in that case, will do nothing. +

    mutex :

    a GMutex. +a GMutex.

    Returns :

    TRUE, if mutex could be locked. + +TRUE, if mutex could be locked.
    -

    mutex :

    a GMutex. +a GMutex.
    @@ -1228,7 +1332,7 @@ called, and, in that case, will do nothing.


    g_mutex_free ()

    -
    void                g_mutex_free                        (GMutex *mutex);
    +
    void                g_mutex_free                        (GMutex *mutex);

    Destroys mutex.

    @@ -1239,11 +1343,13 @@ Destroys mutex.

    Calling g_mutex_free() on a locked mutex may result in undefined behaviour.

    +

    +

    -

    mutex :

    a GMutex. +a GMutex.
    @@ -1262,25 +1368,45 @@ example:

    -

    Example 5.  +

    Example 5.  Using GStaticMutex to simplify thread-safe programming

    -
    -  int
    -  give_me_next_number (void)
    -  {
    -    static int current_number = 0;
    -    int ret_val;
    -    static GStaticMutex mutex = G_STATIC_MUTEX_INIT;
    -
    -    g_static_mutex_lock (&mutex);
    -    ret_val = current_number = calc_next_number (current_number);
    -    g_static_mutex_unlock (&mutex);
    -
    -    return ret_val;
    -  }
    - 
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    int
    +give_me_next_number (void)
    +{
    +  static int current_number = 0;
    +  int ret_val;
    +  static GStaticMutex mutex = G_STATIC_MUTEX_INIT;
    +
    +  g_static_mutex_lock (&mutex);
    +  ret_val = current_number = calc_next_number (current_number);
    +  g_static_mutex_unlock (&mutex);
    +
    +  return ret_val;
    +}
    +
    +


    @@ -1314,6 +1440,8 @@ which does nothing but returning @@ -1328,22 +1456,33 @@ cannot be assigned to a variable. In that case you have to use

    -
    -  GStaticMutex my_mutex = G_STATIC_MUTEX_INIT;
    - 
    +
    + + + + + + + +
    1
    GStaticMutex my_mutex = G_STATIC_MUTEX_INIT;
    +
    + +

    +


    g_static_mutex_init ()

    -
    void                g_static_mutex_init                 (GStaticMutex *mutex);
    +
    void                g_static_mutex_init                 (GStaticMutex *mutex);

    Initializes mutex. Alternatively you can initialize it with -G_STATIC_MUTEX_INIT.

    +G_STATIC_MUTEX_INIT. +

    -

    mutex :

    a GStaticMutex to be initialized. +a GStaticMutex to be initialized.
    @@ -1351,14 +1490,15 @@ Initializes mutex. Alternatively you can

    g_static_mutex_lock ()

    -
    void                g_static_mutex_lock                 (GStaticMutex *mutex);
    +
    void                g_static_mutex_lock                 (GStaticMutex *mutex);

    -Works like g_mutex_lock(), but for a GStaticMutex.

    +Works like g_mutex_lock(), but for a GStaticMutex. +

    -

    mutex :

    a GStaticMutex. +a GStaticMutex.
    @@ -1366,20 +1506,22 @@ Works like

    g_static_mutex_trylock ()

    -
    gboolean            g_static_mutex_trylock              (GStaticMutex *mutex);
    +
    gboolean            g_static_mutex_trylock              (GStaticMutex *mutex);

    -Works like g_mutex_trylock(), but for a GStaticMutex.

    +Works like g_mutex_trylock(), but for a GStaticMutex. +

    - - @@ -1388,14 +1530,15 @@ Works like

    g_static_mutex_unlock ()

    -
    void                g_static_mutex_unlock               (GStaticMutex *mutex);
    +
    void                g_static_mutex_unlock               (GStaticMutex *mutex);

    -Works like g_mutex_unlock(), but for a GStaticMutex.

    +Works like g_mutex_unlock(), but for a GStaticMutex. +

    mutex :

    a GStaticMutex. +a GStaticMutex.

    Returns :

    TRUE, if the GStaticMutex could be locked. + +TRUE, if the GStaticMutex could be locked.
    -

    mutex :

    a GStaticMutex. +a GStaticMutex.
    @@ -1403,22 +1546,23 @@ Works like

    g_static_mutex_get_mutex ()

    -
    GMutex *            g_static_mutex_get_mutex            (GStaticMutex *mutex);
    +
    GMutex *            g_static_mutex_get_mutex            (GStaticMutex *mutex);

    For some operations (like g_cond_wait()) you must have a GMutex instead of a GStaticMutex. This function will return the -corresponding GMutex for mutex.

    +corresponding GMutex for mutex. +

    - - @@ -1427,7 +1571,7 @@ corresponding

    g_static_mutex_free ()

    -
    void                g_static_mutex_free                 (GStaticMutex *mutex);
    +
    void                g_static_mutex_free                 (GStaticMutex *mutex);

    Releases all resources allocated to mutex.

    @@ -1444,11 +1588,13 @@ freed, you should also free the g_static_mutex_free() on a locked mutex may result in undefined behaviour.

    +

    +

    mutex :

    a GStaticMutex. +a GStaticMutex.

    Returns :

    the GMutex corresponding to mutex. +the GMutex corresponding to mutex.
    -

    mutex :

    a GStaticMutex to be freed. +a GStaticMutex to be freed.
    @@ -1473,30 +1619,52 @@ of the variable you intent to protect with the lock. Look at our

    -

    Example 6. Using the G_LOCK_* convenience macros

    -
    -  G_LOCK_DEFINE (current_number);
    +

    Example 6. Using the G_LOCK_* convenience macros

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    G_LOCK_DEFINE (current_number);
     
    -  int
    -  give_me_next_number (void)
    -  {
    -    static int current_number = 0;
    -    int ret_val;
    +int
    +give_me_next_number (void)
    +{
    +  static int current_number = 0;
    +  int ret_val;
     
    -    G_LOCK (current_number);
    -    ret_val = current_number = calc_next_number (current_number);
    -    G_UNLOCK (current_number);
    +  G_LOCK (current_number);
    +  ret_val = current_number = calc_next_number (current_number);
    +  G_UNLOCK (current_number);
     
    -    return ret_val;
    -  }
    - 
    + return ret_val; +}
    -


    + +
    +


    +

    -

    name :

    the name of the lock. +the name of the lock.
    @@ -1506,12 +1674,13 @@ of the variable you intent to protect with the lock. Look at our

    G_LOCK_DEFINE_STATIC()

    #define             G_LOCK_DEFINE_STATIC(name)

    -This works like G_LOCK_DEFINE, but it creates a static object.

    +This works like G_LOCK_DEFINE, but it creates a static object. +

    -

    name :

    the name of the lock. +the name of the lock.
    @@ -1522,12 +1691,13 @@ This works like #define G_LOCK_EXTERN(name)

    This declares a lock, that is defined with G_LOCK_DEFINE in another -module.

    +module. +

    -

    name :

    the name of the lock. +the name of the lock.
    @@ -1538,12 +1708,13 @@ module.

    #define             G_LOCK(name)

    Works like g_mutex_lock(), but for a lock defined with -G_LOCK_DEFINE.

    +G_LOCK_DEFINE. +

    -

    name :

    the name of the lock. +the name of the lock.
    @@ -1554,18 +1725,20 @@ Works like #define G_TRYLOCK(name)

    Works like g_mutex_trylock(), but for a lock defined with -G_LOCK_DEFINE.

    +G_LOCK_DEFINE. +

    - - @@ -1577,12 +1750,13 @@ Works like #define G_UNLOCK(name)

    Works like g_mutex_unlock(), but for a lock defined with -G_LOCK_DEFINE.

    +G_LOCK_DEFINE. +

    name :

    the name of the lock. +the name of the lock.

    Returns :

    TRUE, if the lock could be locked. + +TRUE, if the lock could be locked.
    -

    name :

    the name of the lock. +the name of the lock.
    @@ -1611,7 +1785,8 @@ with the following functions. All of the g_static_rec_mutex_* functions can be used even if g_thread_init() has not been called. Then they do nothing, apart from g_static_rec_mutex_trylock, -which does nothing but returning TRUE.

    +which does nothing but returning TRUE. +


    @@ -1626,23 +1801,34 @@ cannot be assigned to a variable. In that case you have to use

    -
    -  GStaticRecMutex my_mutex = G_STATIC_REC_MUTEX_INIT;
    -
    +
    + + + + + + + +
    1
    GStaticRecMutex my_mutex = G_STATIC_REC_MUTEX_INIT;
    +
    + +

    +


    g_static_rec_mutex_init ()

    -
    void                g_static_rec_mutex_init             (GStaticRecMutex *mutex);
    +
    void                g_static_rec_mutex_init             (GStaticRecMutex *mutex);

    A GStaticRecMutex must be initialized with this function before it can be used. Alternatively you can initialize it with -G_STATIC_REC_MUTEX_INIT.

    +G_STATIC_REC_MUTEX_INIT. +

    -

    mutex :

    a GStaticRecMutex to be initialized. +a GStaticRecMutex to be initialized.
    @@ -1650,17 +1836,18 @@ can be used. Alternatively you can initialize it with

    g_static_rec_mutex_lock ()

    -
    void                g_static_rec_mutex_lock             (GStaticRecMutex *mutex);
    +
    void                g_static_rec_mutex_lock             (GStaticRecMutex *mutex);

    Locks mutex. If mutex is already locked by another thread, the current thread will block until mutex is unlocked by the other thread. If mutex is already locked by the calling thread, this -functions increases the depth of mutex and returns immediately.

    +functions increases the depth of mutex and returns immediately. +

    -

    mutex :

    a GStaticRecMutex to lock. +a GStaticRecMutex to lock.
    @@ -1668,24 +1855,26 @@ functions increases the depth of mutex a

    g_static_rec_mutex_trylock ()

    -
    gboolean            g_static_rec_mutex_trylock          (GStaticRecMutex *mutex);
    +
    gboolean            g_static_rec_mutex_trylock          (GStaticRecMutex *mutex);

    Tries to lock mutex. If mutex is already locked by another thread, it immediately returns FALSE. Otherwise it locks mutex and returns TRUE. If mutex is already locked by the calling thread, this functions increases the depth of mutex and immediately returns -TRUE.

    +TRUE. +

    - - @@ -1694,18 +1883,19 @@ functions increases the depth of mutex a

    g_static_rec_mutex_unlock ()

    -
    void                g_static_rec_mutex_unlock           (GStaticRecMutex *mutex);
    +
    void                g_static_rec_mutex_unlock           (GStaticRecMutex *mutex);

    Unlocks mutex. Another thread will be allowed to lock mutex only when it has been unlocked as many times as it had been locked before. If mutex is completely unlocked and another thread is blocked in a g_static_rec_mutex_lock() call for mutex, it will be -woken and can lock mutex itself.

    +woken and can lock mutex itself. +

    mutex :

    a GStaticRecMutex to lock. +a GStaticRecMutex to lock.

    Returns :

    TRUE, if mutex could be locked. + +TRUE, if mutex could be locked.
    -

    mutex :

    a GStaticRecMutex to unlock. +a GStaticRecMutex to unlock.
    @@ -1713,21 +1903,22 @@ woken and can lock mutex itself.


    g_static_rec_mutex_lock_full ()

    -
    void                g_static_rec_mutex_lock_full        (GStaticRecMutex *mutex,
    -                                                         guint depth);
    +
    void                g_static_rec_mutex_lock_full        (GStaticRecMutex *mutex,
    +                                                         guint depth);

    -Works like calling g_static_rec_mutex_lock() for mutex depth times.

    +Works like calling g_static_rec_mutex_lock() for mutex depth times. +

    - - @@ -1737,7 +1928,7 @@ Works like calling

    g_static_rec_mutex_unlock_full ()

    -
    guint               g_static_rec_mutex_unlock_full      (GStaticRecMutex *mutex);
    +
    guint               g_static_rec_mutex_unlock_full      (GStaticRecMutex *mutex);

    Completely unlocks mutex. If another thread is blocked in a g_static_rec_mutex_lock() call for mutex, it will be woken and can @@ -1745,18 +1936,19 @@ lock mutex itself. This function returns mutex has been locked by the current thread. To restore the state before the call to g_static_rec_mutex_unlock_full() you can call g_static_rec_mutex_lock_full() with the depth returned by this -function.

    +function. +

    mutex :

    a GStaticRecMutex to lock. +a GStaticRecMutex to lock.

    depth :

    number of times this mutex has to be unlocked to be +number of times this mutex has to be unlocked to be completely unlocked.
    - - @@ -1766,7 +1958,7 @@ function.


    g_static_rec_mutex_free ()

    -
    void                g_static_rec_mutex_free             (GStaticRecMutex *mutex);
    +
    void                g_static_rec_mutex_free             (GStaticRecMutex *mutex);

    Releases all resources allocated to a GStaticRecMutex.

    @@ -1774,12 +1966,13 @@ Releases all resources allocated to a GStaticRecMutex with an unbounded lifetime, i.e. objects declared 'static', but if you have a GStaticRecMutex as a member of a structure and the structure is -freed, you should also free the GStaticRecMutex.

    +freed, you should also free the GStaticRecMutex. +

    mutex :

    a GStaticRecMutex to completely unlock. +a GStaticRecMutex to completely unlock.

    Returns :

    number of times mutex has been locked by the current +number of times mutex has been locked by the current thread.
    -

    mutex :

    a GStaticRecMutex to be freed. +a GStaticRecMutex to be freed.
    @@ -1801,42 +1994,82 @@ example:

    -

    Example 7. An array with access functions

    -
    -  GStaticRWLock rwlock = G_STATIC_RW_LOCK_INIT;
    -  GPtrArray *array;
    +

    Example 7. An array with access functions

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    GStaticRWLock rwlock = G_STATIC_RW_LOCK_INIT;
    +GPtrArray *array;
    +
    +gpointer
    +my_array_get (guint index)
    +{
    +  gpointer retval = NULL;
     
    -  gpointer
    -  my_array_get (guint index)
    -  {
    -    gpointer retval = NULL;
    +  if (!array)
    +    return NULL;
     
    -    if (!array)
    -      return NULL;
    +  g_static_rw_lock_reader_lock (&rwlock);
    +  if (index < array->len)
    +    retval = g_ptr_array_index (array, index);
    +  g_static_rw_lock_reader_unlock (&rwlock);
     
    -    g_static_rw_lock_reader_lock (&rwlock);
    -    if (index < array->len)
    -      retval = g_ptr_array_index (array, index);
    -    g_static_rw_lock_reader_unlock (&rwlock);
    +  return retval;
    +}
     
    -    return retval;
    -  }
    +void
    +my_array_set (guint index, gpointer data)
    +{
    +  g_static_rw_lock_writer_lock (&rwlock);
     
    -  void
    -  my_array_set (guint index, gpointer data)
    -  {
    -    g_static_rw_lock_writer_lock (&rwlock);
    +  if (!array)
    +    array = g_ptr_array_new ();
     
    -    if (!array)
    -      array = g_ptr_array_new ();
    +  if (index >= array->len)
    +    g_ptr_array_set_size (array, index+1);
    +  g_ptr_array_index (array, index) = data;
     
    -    if (index >= array->len)
    -      g_ptr_array_set_size (array, index+1);
    -    g_ptr_array_index (array, index) = data;
    +  g_static_rw_lock_writer_unlock (&rwlock);
    +}
    +
    - g_static_rw_lock_writer_unlock (&rwlock); - } -


    @@ -1881,6 +2114,8 @@ keep the lock for a considerable time justify a GStaticMutex.

    +

    +


    @@ -1895,23 +2130,34 @@ cannot be assigned to a variable. In that case you have to use

    -
    -  GStaticRWLock my_lock = G_STATIC_RW_LOCK_INIT;
    - 
    +
    + + + + + + + +
    1
    GStaticRWLock my_lock = G_STATIC_RW_LOCK_INIT;
    +
    + +

    +


    g_static_rw_lock_init ()

    -
    void                g_static_rw_lock_init               (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_init               (GStaticRWLock *lock);

    A GStaticRWLock must be initialized with this function before it can be used. Alternatively you can initialize it with -G_STATIC_RW_LOCK_INIT.

    +G_STATIC_RW_LOCK_INIT. +

    -

    lock :

    a GStaticRWLock to be initialized. +a GStaticRWLock to be initialized.
    @@ -1919,7 +2165,7 @@ can be used. Alternatively you can initialize it with

    g_static_rw_lock_reader_lock ()

    -
    void                g_static_rw_lock_reader_lock        (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_reader_lock        (GStaticRWLock *lock);

    Locks lock for reading. There may be unlimited concurrent locks for reading of a GStaticRWLock at the same time. If lock is already @@ -1932,12 +2178,13 @@ threads want to lock lock. This lock has

    GStaticRWLock is not recursive. It might seem to be possible to recursively lock for reading, but that can result in a deadlock, due -to writer preference.

    +to writer preference. +

    -

    lock :

    a GStaticRWLock to lock for reading. +a GStaticRWLock to lock for reading.
    @@ -1945,24 +2192,26 @@ to writer preference.


    g_static_rw_lock_reader_trylock ()

    -
    gboolean            g_static_rw_lock_reader_trylock     (GStaticRWLock *lock);
    +
    gboolean            g_static_rw_lock_reader_trylock     (GStaticRWLock *lock);

    Tries to lock lock for reading. If lock is already locked for writing by another thread or if another thread is already waiting to lock lock for writing, immediately returns FALSE. Otherwise locks lock for reading and returns TRUE. This lock has to be unlocked by -g_static_rw_lock_reader_unlock().

    +g_static_rw_lock_reader_unlock(). +

    - - @@ -1971,16 +2220,17 @@ lock lock for writing, immediately retur

    g_static_rw_lock_reader_unlock ()

    -
    void                g_static_rw_lock_reader_unlock      (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_reader_unlock      (GStaticRWLock *lock);

    Unlocks lock. If a thread waits to lock lock for writing and all locks for reading have been unlocked, the waiting thread is woken up -and can lock lock for writing.

    +and can lock lock for writing. +

    lock :

    a GStaticRWLock to lock for reading. +a GStaticRWLock to lock for reading.

    Returns :

    TRUE, if lock could be locked for reading. + +TRUE, if lock could be locked for reading.
    -

    lock :

    a GStaticRWLock to unlock after reading. +a GStaticRWLock to unlock after reading.
    @@ -1988,7 +2238,7 @@ and can lock lock for writing.


    g_static_rw_lock_writer_lock ()

    -
    void                g_static_rw_lock_writer_lock        (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_writer_lock        (GStaticRWLock *lock);

    Locks lock for writing. If lock is already locked for writing or reading by other threads, this function will block until lock is @@ -1996,12 +2246,13 @@ completely unlocked and then lock lock f functions waits to lock lock, no other thread can lock lock for reading. When lock is locked for writing, no other thread can lock lock (neither for reading nor writing). This lock has to be -unlocked by g_static_rw_lock_writer_unlock().

    +unlocked by g_static_rw_lock_writer_unlock(). +

    -

    lock :

    a GStaticRWLock to lock for writing. +a GStaticRWLock to lock for writing.
    @@ -2009,23 +2260,25 @@ unlocked by

    g_static_rw_lock_writer_trylock ()

    -
    gboolean            g_static_rw_lock_writer_trylock     (GStaticRWLock *lock);
    +
    gboolean            g_static_rw_lock_writer_trylock     (GStaticRWLock *lock);

    Tries to lock lock for writing. If lock is already locked (for either reading or writing) by another thread, it immediately returns FALSE. Otherwise it locks lock for writing and returns TRUE. This -lock has to be unlocked by g_static_rw_lock_writer_unlock().

    +lock has to be unlocked by g_static_rw_lock_writer_unlock(). +

    - - @@ -2034,19 +2287,20 @@ lock has to be unlocked by

    g_static_rw_lock_writer_unlock ()

    -
    void                g_static_rw_lock_writer_unlock      (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_writer_unlock      (GStaticRWLock *lock);

    Unlocks lock. If a thread is waiting to lock lock for writing and all locks for reading have been unlocked, the waiting thread is woken up and can lock lock for writing. If no thread is waiting to lock lock for writing, and some thread or threads are waiting to lock lock for reading, the waiting threads are woken up and can -lock lock for reading.

    +lock lock for reading. +

    lock :

    a GStaticRWLock to lock for writing. +a GStaticRWLock to lock for writing.

    Returns :

    TRUE, if lock could be locked for writing. + +TRUE, if lock could be locked for writing.
    -

    lock :

    a GStaticRWLock to unlock after writing. +a GStaticRWLock to unlock after writing.
    @@ -2054,7 +2308,7 @@ lock lock for reading.


    g_static_rw_lock_free ()

    -
    void                g_static_rw_lock_free               (GStaticRWLock *lock);
    +
    void                g_static_rw_lock_free               (GStaticRWLock *lock);

    Releases all resources allocated to lock.

    @@ -2062,12 +2316,13 @@ Releases all resources allocated to lock You don't have to call this functions for a GStaticRWLock with an unbounded lifetime, i.e. objects declared 'static', but if you have a GStaticRWLock as a member of a structure, and the structure is -freed, you should also free the GStaticRWLock.

    +freed, you should also free the GStaticRWLock. +

    -

    lock :

    a GStaticRWLock to be freed. +a GStaticRWLock to be freed.
    @@ -2086,38 +2341,72 @@ threads to be woken up.

    -

    Example 8.  +

    Example 8.  Using GCond to block a thread until a condition is satisfied

    -
    -  GCond* data_cond = NULL; /* Must be initialized somewhere */
    -  GMutex* data_mutex = NULL; /* Must be initialized somewhere */
    -  gpointer current_data = NULL;
    -
    -  void
    -  push_data (gpointer data)
    -  {
    -    g_mutex_lock (data_mutex);
    -    current_data = data;
    -    g_cond_signal (data_cond);
    -    g_mutex_unlock (data_mutex);
    -  }
    -
    -  gpointer
    -  pop_data (void)
    -  {
    -    gpointer data;
    -
    -    g_mutex_lock (data_mutex);
    -    while (!current_data)
    -      g_cond_wait (data_cond, data_mutex);
    -    data = current_data;
    -    current_data = NULL;
    -    g_mutex_unlock (data_mutex);
    -
    -    return data;
    -  }
    - 
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    GCond* data_cond = NULL; /* Must be initialized somewhere */
    +GMutex* data_mutex = NULL; /* Must be initialized somewhere */
    +gpointer current_data = NULL;
    +
    +void
    +push_data (gpointer data)
    +{
    +  g_mutex_lock (data_mutex);
    +  current_data = data;
    +  g_cond_signal (data_cond);
    +  g_mutex_unlock (data_mutex);
    +}
    +
    +gpointer
    +pop_data (void)
    +{
    +  gpointer data;
    +
    +  g_mutex_lock (data_mutex);
    +  while (!current_data)
    +    g_cond_wait (data_cond, data_mutex);
    +  data = current_data;
    +  current_data = NULL;
    +  g_mutex_unlock (data_mutex);
    +
    +  return data;
    +}
    +
    +


    @@ -2152,6 +2441,8 @@ A @@ -2159,12 +2450,13 @@ use them as if they were functions.

    GCond*              g_cond_new                          ();

    Creates a new GCond. This function will abort, if g_thread_init() -has not been called yet.

    +has not been called yet. +

    -

    Returns :

    a new GCond. +a new GCond.
    @@ -2172,7 +2464,7 @@ has not been called yet.


    g_cond_signal ()

    -
    void                g_cond_signal                       (GCond *cond);
    +
    void                g_cond_signal                       (GCond *cond);

    If threads are waiting for cond, exactly one of them is woken up. It is good practice to hold the same lock as the waiting thread @@ -2180,12 +2472,13 @@ while calling this function, though not required.

    This function can be used even if g_thread_init() has not yet been -called, and, in that case, will do nothing.

    +called, and, in that case, will do nothing. +

    -

    cond :

    a GCond. +a GCond.
    @@ -2193,7 +2486,7 @@ called, and, in that case, will do nothing.


    g_cond_broadcast ()

    -
    void                g_cond_broadcast                    (GCond *cond);
    +
    void                g_cond_broadcast                    (GCond *cond);

    If threads are waiting for cond, all of them are woken up. It is good practice to lock the same mutex as the waiting threads, while @@ -2201,12 +2494,13 @@ calling this function, though not required.

    This function can be used even if g_thread_init() has not yet been -called, and, in that case, will do nothing.

    +called, and, in that case, will do nothing. +

    -

    cond :

    a GCond. +a GCond.
    @@ -2214,26 +2508,27 @@ called, and, in that case, will do nothing.


    g_cond_wait ()

    -
    void                g_cond_wait                         (GCond *cond,
    -                                                         GMutex *mutex);
    +
    void                g_cond_wait                         (GCond *cond,
    +                                                         GMutex *mutex);

    Waits until this thread is woken up on cond. The mutex is unlocked before falling asleep and locked again before resuming.

    This function can be used even if g_thread_init() has not yet been -called, and, in that case, will immediately return.

    +called, and, in that case, will immediately return. +

    - - @@ -2242,9 +2537,9 @@ called, and, in that case, will immediately return.


    g_cond_timed_wait ()

    -
    gboolean            g_cond_timed_wait                   (GCond *cond,
    -                                                         GMutex *mutex,
    -                                                         GTimeVal *abs_time);
    +
    gboolean            g_cond_timed_wait                   (GCond *cond,
    +                                                         GMutex *mutex,
    +                                                         GTimeVal *abs_time);

    Waits until this thread is woken up on cond, but not longer than until the time specified by abs_time. The mutex is unlocked before @@ -2259,28 +2554,30 @@ called, and, in that case, will immediately return abs_time a combination of g_get_current_time() -and g_time_val_add() can be used.

    +and g_time_val_add() can be used. +

    cond :

    a GCond. +a GCond.

    mutex :

    a GMutex, that is currently locked. +a GMutex, that is currently locked.
    - - - - @@ -2289,14 +2586,15 @@ and

    g_cond_free ()

    -
    void                g_cond_free                         (GCond *cond);
    +
    void                g_cond_free                         (GCond *cond);

    -Destroys the GCond.

    +Destroys the GCond. +

    cond :

    a GCond. +a GCond.

    mutex :

    a GMutex that is currently locked. +a GMutex that is currently locked.

    abs_time :

    a GTimeVal, determining the final time. +a GTimeVal, determining the final time.

    Returns :

    TRUE if cond was signalled, or FALSE on timeout. + +TRUE if cond was signalled, or FALSE on timeout.
    -

    cond :

    a GCond. +a GCond.
    @@ -2317,28 +2615,54 @@ This can be done as follows:

    -

    Example 9. Using GPrivate for per-thread data

    -
    -  GPrivate* current_number_key = NULL; /* Must be initialized somewhere
    -                                          with g_private_new (g_free); */
    +

    Example 9. Using GPrivate for per-thread data

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    GPrivate* current_number_key = NULL; /* Must be initialized somewhere
    +                                        with g_private_new (g_free); */
     
    -  int
    -  give_me_next_number (void)
    -  {
    -    int *current_number = g_private_get (current_number_key);
    +int
    +give_me_next_number (void)
    +{
    +  int *current_number = g_private_get (current_number_key);
     
    -    if (!current_number)
    -      {
    -        current_number = g_new (int, 1);
    -        *current_number = 0;
    -        g_private_set (current_number_key, current_number);
    -      }
    +  if (!current_number)
    +    {
    +      current_number = g_new (int, 1);
    +      *current_number = 0;
    +      g_private_set (current_number_key, current_number);
    +    }
     
    -    *current_number = calc_next_number (*current_number);
    +  *current_number = calc_next_number (*current_number);
    +
    +  return *current_number;
    +}
    +
    - return *current_number; - } -


    @@ -2361,11 +2685,13 @@ functions. actually macros. Apart from taking their addresses, you can however use them as if they were functions.

    +

    +


    g_private_new ()

    -
    GPrivate*           g_private_new                       (GDestroyNotify destructor);
    +
    GPrivate*           g_private_new                       (GDestroyNotify destructor);

    Creates a new GPrivate. If destructor is non-NULL, it is a pointer to a destructor function. Whenever a thread ends and the @@ -2398,18 +2724,20 @@ can, to avoid shortage, or use g_thread_init() has not been called yet.

    +

    +

    - - @@ -2418,7 +2746,7 @@ called yet.


    g_private_get ()

    -
    gpointer            g_private_get                       (GPrivate *private_key);
    +
    gpointer            g_private_get                       (GPrivate *private_key);

    Returns the pointer keyed to private_key for the current thread. If g_private_set() hasn't been called for the current private_key and @@ -2432,18 +2760,19 @@ casted to not be retained after the call. Instead, NULL will be returned in all threads directly after g_thread_init(), regardless of any g_private_set() calls issued -before threading system intialization.

    +before threading system intialization. +

    destructor :

    a function to destroy the data keyed to GPrivate when +a function to destroy the data keyed to GPrivate when a thread ends.

    Returns :

    a new GPrivate. +a new GPrivate.
    - - @@ -2452,26 +2781,27 @@ before threading system intialization.


    g_private_set ()

    -
    void                g_private_set                       (GPrivate *private_key,
    -                                                         gpointer data);
    +
    void                g_private_set                       (GPrivate *private_key,
    +                                                         gpointer data);

    Sets the pointer keyed to private_key for the current thread.

    This function can be used even if g_thread_init() has not yet been called, and, in that case, will set private_key to data casted to -GPrivate*. See g_private_get() for resulting caveats.

    +GPrivate*. See g_private_get() for resulting caveats. +

    private_key :

    a GPrivate. +a GPrivate.

    Returns :

    the corresponding pointer. +the corresponding pointer.
    - - @@ -2494,28 +2824,53 @@ look at our give_me_next_number()<

    -

    Example 10. Using GStaticPrivate for per-thread data

    -
    -  int
    -  give_me_next_number ()
    -  {
    -    static GStaticPrivate current_number_key = G_STATIC_PRIVATE_INIT;
    -    int *current_number = g_static_private_get (&current_number_key);
    +

    Example 10. Using GStaticPrivate for per-thread data

    +
    +

    private_key :

    a GPrivate. +a GPrivate.

    data :

    the new pointer. +the new pointer.
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    int
    +give_me_next_number ()
    +{
    +  static GStaticPrivate current_number_key = G_STATIC_PRIVATE_INIT;
    +  int *current_number = g_static_private_get (&current_number_key);
     
    -    if (!current_number)
    -      {
    -        current_number = g_new (int,1);
    -        *current_number = 0;
    -        g_static_private_set (&current_number_key, current_number, g_free);
    -      }
    +  if (!current_number)
    +    {
    +      current_number = g_new (int,1);
    +      *current_number = 0;
    +      g_static_private_set (&current_number_key, current_number, g_free);
    +    }
     
    -    *current_number = calc_next_number (*current_number);
    +  *current_number = calc_next_number (*current_number);
     
    -    return *current_number;
    -  }
    - 
    + return *current_number; +}
    -


    + +
    +


    +


    @@ -2528,22 +2883,33 @@ can be used.

    -
    -  GStaticPrivate my_private = G_STATIC_PRIVATE_INIT;
    - 
    +
    + + + + + + + +
    1
    GStaticPrivate my_private = G_STATIC_PRIVATE_INIT;
    +
    + +

    +


    g_static_private_init ()

    -
    void                g_static_private_init               (GStaticPrivate *private_key);
    +
    void                g_static_private_init               (GStaticPrivate *private_key);

    Initializes private_key. Alternatively you can initialize it with -G_STATIC_PRIVATE_INIT.

    +G_STATIC_PRIVATE_INIT. +

    -

    private_key :

    a GStaticPrivate to be initialized. +a GStaticPrivate to be initialized.
    @@ -2551,23 +2917,24 @@ Initializes private_key. Alternatively y

    g_static_private_get ()

    -
    gpointer            g_static_private_get                (GStaticPrivate *private_key);
    +
    gpointer            g_static_private_get                (GStaticPrivate *private_key);

    Works like g_private_get() only for a GStaticPrivate.

    -This function works even if g_thread_init() has not yet been called.

    +This function works even if g_thread_init() has not yet been called. +

    - - @@ -2576,9 +2943,9 @@ This function works even if

    g_static_private_set ()

    -
    void                g_static_private_set                (GStaticPrivate *private_key,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    void                g_static_private_set                (GStaticPrivate *private_key,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets the pointer keyed to private_key for the current thread and the function notify to be called with that pointer (NULL or @@ -2598,22 +2965,24 @@ will be inherited only by the main thread, i.e. the one that called

    notify is used quite differently from destructor in g_private_new().

    +

    +

    private_key :

    a GStaticPrivate. +a GStaticPrivate.

    Returns :

    the corresponding pointer. +the corresponding pointer.
    - - - @@ -2623,7 +2992,7 @@ will be inherited only by the main thread, i.e. the one that called

    g_static_private_free ()

    -
    void                g_static_private_free               (GStaticPrivate *private_key);
    +
    void                g_static_private_free               (GStaticPrivate *private_key);

    Releases all resources allocated to private_key.

    @@ -2631,12 +3000,13 @@ Releases all resources allocated to private_keyGStaticPrivate with an unbounded lifetime, i.e. objects declared 'static', but if you have a GStaticPrivate as a member of a structure and the structure is -freed, you should also free the GStaticPrivate.

    +freed, you should also free the GStaticPrivate. +

    private_key :

    a GStaticPrivate. +a GStaticPrivate.

    data :

    the new pointer. +the new pointer.

    notify :

    a function to be called with the pointer whenever the +a function to be called with the pointer whenever the current thread ends or sets this pointer again.
    -

    private_key :

    a GStaticPrivate to be freed. +a GStaticPrivate to be freed.
    @@ -2652,18 +3022,19 @@ freed, you should also free the GOnce struct controls a one-time initialization function. Any one-time initialization function must have its own unique GOnce -struct.

    +struct. +

    - - @@ -2683,23 +3054,24 @@ struct.

    The possible statuses of a one-time initialization function -controlled by a GOnce struct.

    +controlled by a GOnce struct. +

    volatile GOnceStatus status;

    the status of the GOnce +the status of the GOnce

    volatile gpointer retval;

    the value returned by the call to the function, if status +the value returned by the call to the function, if status is G_ONCE_STATUS_READY
    - - - @@ -2716,9 +3088,19 @@ A
    -  GOnce my_once = G_ONCE_INIT;
    - 
    +
    +

    G_ONCE_STATUS_NOTCALLED

    the function has not been called yet. +the function has not been called yet.

    G_ONCE_STATUS_PROGRESS

    the function call is currently in progress. +the function call is currently in progress.

    G_ONCE_STATUS_READY

    the function has been called. +the function has been called.
    + + + + + + +
    1
    GOnce my_once = G_ONCE_INIT;
    +
    + +

    +

    Since 2.4


    @@ -2748,35 +3130,53 @@ that the initialization is serialized across multiple threads.

    -
    -  gpointer
    -  get_debug_flags (void)
    -  {
    -    static GOnce my_once = G_ONCE_INIT;
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    gpointer
    +get_debug_flags (void)
    +{
    +  static GOnce my_once = G_ONCE_INIT;
     
    -    g_once (&my_once, parse_debug_flags, NULL);
    +  g_once (&my_once, parse_debug_flags, NULL);
    +
    +  return my_once.retval;
    +}
    +
    - return my_once.retval; - } -
    +

    +

    - - - @@ -2786,7 +3186,7 @@ that the initialization is serialized across multiple threads.

    g_once_init_enter ()

    -
    gboolean            g_once_init_enter                   (volatile gsize *value_location);
    +
    gboolean            g_once_init_enter                   (volatile gsize *value_location);

    Function to be called when starting a critical initialization section. The argument value_location must point to a static @@ -2800,30 +3200,50 @@ like this:

    -
    -  static gsize initialization_value = 0;
    +
    +

    once :

    a GOnce structure +a GOnce structure

    func :

    the GThreadFunc function associated to once. This function +the GThreadFunc function associated to once. This function is called only once, regardless of the number of times it and its associated GOnce struct are passed to g_once().

    arg :

    data to be passed to func +data to be passed to func
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    static gsize initialization_value = 0;
     
    -  if (g_once_init_enter (&initialization_value))
    -    {
    -      gsize setup_value = 42; /* initialization code here */
    +if (g_once_init_enter (&initialization_value))
    +  {
    +    gsize setup_value = 42; /* initialization code here */
     
    -      g_once_init_leave (&initialization_value, setup_value);
    -    }
    +    g_once_init_leave (&initialization_value, setup_value);
    +  }
     
    -  /* use initialization_value here */
    - 
    +/* use initialization_value here */
    +
    + +

    +

    - - @@ -2834,26 +3254,27 @@ like this:

    g_once_init_leave ()

    -
    void                g_once_init_leave                   (volatile gsize *value_location,
    -                                                         gsize initialization_value);
    +
    void                g_once_init_leave                   (volatile gsize *value_location,
    +                                                         gsize initialization_value);

    Counterpart to g_once_init_enter(). Expects a location of a static 0-initialized initialization variable, and an initialization value other than 0. Sets the variable to the initialization value, and releases concurrent threads blocking in g_once_init_enter() on this -initialization variable.

    +initialization variable. +

    value_location :

    location of a static initializable variable +location of a static initializable variable containing 0.

    Returns :

    TRUE if the initialization section should be entered, + +TRUE if the initialization section should be entered, FALSE and blocks otherwise
    - - @@ -2863,8 +3284,8 @@ initialization variable.


    g_bit_lock ()

    -
    void                g_bit_lock                          (volatile gint *address,
    -                                                         gint lock_bit);
    +
    void                g_bit_lock                          (volatile gint *address,
    +                                                         gint lock_bit);

    Sets the indicated lock_bit in address. If the bit is already set, this call will block until g_bit_unlock() unsets the @@ -2881,18 +3302,19 @@ between 0 and 31 then the result is undefined.

    This function accesses address atomically. All other accesses to address must be atomic in order for this function to work -reliably.

    +reliably. +

    value_location :

    location of a static initializable variable +location of a static initializable variable containing 0.

    initialization_value :

    new non-0 value for *value_location. +new non-0 value for *value_location.
    - - @@ -2902,8 +3324,8 @@ reliably.


    g_bit_trylock ()

    -
    gboolean            g_bit_trylock                       (volatile gint *address,
    -                                                         gint lock_bit);
    +
    gboolean            g_bit_trylock                       (volatile gint *address,
    +                                                         gint lock_bit);

    Sets the indicated lock_bit in address, returning TRUE if successful. If the bit is already set, returns FALSE immediately. @@ -2919,23 +3341,25 @@ between 0 and 31 then the result is undefined.

    This function accesses address atomically. All other accesses to address must be atomic in order for this function to work -reliably.

    +reliably. +

    address :

    a pointer to an integer +a pointer to an integer

    lock_bit :

    a bit value between 0 and 31 +a bit value between 0 and 31
    - - - @@ -2945,8 +3369,8 @@ reliably.


    g_bit_unlock ()

    -
    void                g_bit_unlock                        (volatile gint *address,
    -                                                         gint lock_bit);
    +
    void                g_bit_unlock                        (volatile gint *address,
    +                                                         gint lock_bit);

    Clears the indicated lock_bit in address. If another thread is currently blocked in g_bit_lock() on this same bit then it will be @@ -2955,18 +3379,19 @@ woken up.

    This function accesses address atomically. All other accesses to address must be atomic in order for this function to work -reliably.

    +reliably. +

    address :

    a pointer to an integer +a pointer to an integer

    lock_bit :

    a bit value between 0 and 31 +a bit value between 0 and 31

    Returns :

    TRUE if the lock was acquired + +TRUE if the lock was acquired
    - - @@ -2981,6 +3406,6 @@ reliably.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Timers.html b/docs/reference/glib/html/glib-Timers.html index fdadc92..67883f7 100644 --- a/docs/reference/glib/html/glib-Timers.html +++ b/docs/reference/glib/html/glib-Timers.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    address :

    a pointer to an integer +a pointer to an integer

    lock_bit :

    a bit value between 0 and 31 +a bit value between 0 and 31
    @@ -61,14 +41,14 @@ #include <glib.h> GTimer; -GTimer* g_timer_new (void); -voidg_timer_start (GTimer *timer); -voidg_timer_stop (GTimer *timer); -voidg_timer_continue (GTimer *timer); -gdoubleg_timer_elapsed (GTimer *timer, - gulong *microseconds); -voidg_timer_reset (GTimer *timer); -voidg_timer_destroy (GTimer *timer); +GTimer* g_timer_new (void); +voidg_timer_start (GTimer *timer); +voidg_timer_stop (GTimer *timer); +voidg_timer_continue (GTimer *timer); +gdoubleg_timer_elapsed (GTimer *timer, + gulong *microseconds); +voidg_timer_reset (GTimer *timer); +voidg_timer_destroy (GTimer *timer);
    @@ -90,6 +70,8 @@ portable/convenient interface. timers, if you are using threads at all.

    +

    +

    Details

    @@ -97,20 +79,22 @@ portable/convenient interface.

    GTimer

    typedef struct _GTimer GTimer;

    -Opaque datatype that records a start time.

    +Opaque datatype that records a start time. +


    g_timer_new ()

    -
    GTimer*             g_timer_new                         (void);
    +
    GTimer*             g_timer_new                         (void);

    Creates a new timer, and starts timing (i.e. g_timer_start() is -implicitly called for you).

    +implicitly called for you). +

    -

    Returns :

    a new GTimer. +a new GTimer.
    @@ -118,17 +102,18 @@ implicitly called for you).


    g_timer_start ()

    -
    void                g_timer_start                       (GTimer *timer);
    +
    void                g_timer_start                       (GTimer *timer);

    Marks a start time, so that future calls to g_timer_elapsed() will report the time since g_timer_start() was called. g_timer_new() automatically marks the start time, so no need to call -g_timer_start() immediately after creating the timer.

    +g_timer_start() immediately after creating the timer. +

    -

    timer :

    a GTimer. +a GTimer.
    @@ -136,15 +121,16 @@ automatically marks the start time, so no need to call

    g_timer_stop ()

    -
    void                g_timer_stop                        (GTimer *timer);
    +
    void                g_timer_stop                        (GTimer *timer);

    Marks an end time, so calls to g_timer_elapsed() will return the -difference between this end time and the start time.

    +difference between this end time and the start time. +

    -

    timer :

    a GTimer. +a GTimer.
    @@ -152,16 +138,17 @@ difference between this end time and the start time.


    g_timer_continue ()

    -
    void                g_timer_continue                    (GTimer *timer);
    +
    void                g_timer_continue                    (GTimer *timer);

    Resumes a timer that has previously been stopped with g_timer_stop(). g_timer_stop() must be called before using this -function.

    +function. +

    -

    timer :

    a GTimer. +a GTimer.
    @@ -170,8 +157,8 @@ function.


    g_timer_elapsed ()

    -
    gdouble             g_timer_elapsed                     (GTimer *timer,
    -                                                         gulong *microseconds);
    +
    gdouble             g_timer_elapsed                     (GTimer *timer,
    +                                                         gulong *microseconds);

    If timer has been started but not stopped, obtains the time since the timer was started. If timer has been stopped, obtains the @@ -189,24 +176,26 @@ essentially useless. timer is running will cause invalid return values from this function.

    +

    +

    - - - @@ -216,16 +205,17 @@ essentially useless.

    g_timer_reset ()

    -
    void                g_timer_reset                       (GTimer *timer);
    +
    void                g_timer_reset                       (GTimer *timer);

    This function is useless; it's fine to call g_timer_start() on an already-started timer to reset the start time, so g_timer_reset() -serves no purpose.

    +serves no purpose. +

    timer :

    a GTimer. +a GTimer.

    microseconds :

    return location for the fractional part of seconds +return location for the fractional part of seconds elapsed, in microseconds (that is, the total number of microseconds elapsed, modulo 1000000), or NULL

    Returns :

    seconds elapsed as a floating point value, including any +seconds elapsed as a floating point value, including any fractional part.
    -

    timer :

    a GTimer. +a GTimer.
    @@ -233,14 +223,15 @@ serves no purpose.


    g_timer_destroy ()

    -
    void                g_timer_destroy                     (GTimer *timer);
    +
    void                g_timer_destroy                     (GTimer *timer);

    -Destroys a timer, freeing associated resources.

    +Destroys a timer, freeing associated resources. +

    -

    timer :

    a GTimer to destroy. +a GTimer to destroy.
    @@ -249,6 +240,6 @@ Destroys a timer, freeing associated resources.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Trash-Stacks.html b/docs/reference/glib/html/glib-Trash-Stacks.html index 530fcdd..049b2a6 100644 --- a/docs/reference/glib/html/glib-Trash-Stacks.html +++ b/docs/reference/glib/html/glib-Trash-Stacks.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,11 +41,11 @@ #include <glib.h> GTrashStack; -voidg_trash_stack_push (GTrashStack **stack_p, - gpointer data_p); -gpointerg_trash_stack_pop (GTrashStack **stack_p); -gpointerg_trash_stack_peek (GTrashStack **stack_p); -guintg_trash_stack_height (GTrashStack **stack_p); +voidg_trash_stack_push (GTrashStack **stack_p, + gpointer data_p); +gpointerg_trash_stack_pop (GTrashStack **stack_p); +gpointerg_trash_stack_peek (GTrashStack **stack_p); +guintg_trash_stack_height (GTrashStack **stack_p);
    @@ -107,8 +87,8 @@ bytes of the element.

    g_trash_stack_push ()

    -
    void                g_trash_stack_push                  (GTrashStack **stack_p,
    -                                                         gpointer data_p);
    +
    void                g_trash_stack_push                  (GTrashStack **stack_p,
    +                                                         gpointer data_p);

    Pushes a piece of memory onto a GTrashStack.

    @@ -131,7 +111,7 @@ Pushes a piece of memory onto a

    g_trash_stack_pop ()

    -
    gpointer            g_trash_stack_pop                   (GTrashStack **stack_p);
    +
    gpointer            g_trash_stack_pop                   (GTrashStack **stack_p);

    Pops a piece of memory off a GTrashStack.

    @@ -154,7 +134,7 @@ Pops a piece of memory off a

    g_trash_stack_peek ()

    -
    gpointer            g_trash_stack_peek                  (GTrashStack **stack_p);
    +
    gpointer            g_trash_stack_peek                  (GTrashStack **stack_p);

    Returns the element at the top of a GTrashStack which may be NULL.

    @@ -177,7 +157,7 @@ Returns the element at the top of a

    g_trash_stack_height ()

    -
    guint               g_trash_stack_height                (GTrashStack **stack_p);
    +
    guint               g_trash_stack_height                (GTrashStack **stack_p);

    Returns the height of a GTrashStack. Note that execution of this function is of O(N) complexity @@ -203,6 +183,6 @@ where N denotes the number of items on the stack.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Type-Conversion-Macros.html b/docs/reference/glib/html/glib-Type-Conversion-Macros.html index 599459a..c03df86 100644 --- a/docs/reference/glib/html/glib-Type-Conversion-Macros.html +++ b/docs/reference/glib/html/glib-Type-Conversion-Macros.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -77,10 +57,19 @@ data" to a callback, in the form of a void pointer. From time to time you want to pass an integer instead of a pointer. You could allocate an integer, with something like:

    -
    - int *ip = g_new (int, 1);
    - *ip = 42;
    -
    +
    +
    + + + + + + +
    1
    +2
    int *ip = g_new (int, 1);
    +*ip = 42;
    +
    +

    But this is inconvenient, and it's annoying to have to free the memory at some later time. @@ -90,22 +79,44 @@ Pointers are always at least 32 bits in size (on all platforms GLib intends to support). Thus you can store at least 32-bit integer values in a pointer value. Naively, you might try this, but it's incorrect:

    -
    - gpointer p;
    - int i;
    - p = (void*) 42;
    - i = (int) p;
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    gpointer p;
    +int i;
    +p = (void*) 42;
    +i = (int) p;
    +
    +

    Again, that example was not correct, don't copy it. The problem is that on some systems you need to do this:

    -
    - gpointer p;
    - int i;
    - p = (void*) (long) 42;
    - i = (int) (long) p;
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    gpointer p;
    +int i;
    +p = (void*) (long) 42;
    +i = (int) (long) p;
    +
    +

    So GPOINTER_TO_INT(), GINT_TO_POINTER(), etc. do the right thing on the current platform. @@ -247,6 +258,6 @@ been stored in the pointer with


    - Generated by GTK-Doc V1.13
    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-URI-Functions.html b/docs/reference/glib/html/glib-URI-Functions.html index d9ac8ca..4336e45 100644 --- a/docs/reference/glib/html/glib-URI-Functions.html +++ b/docs/reference/glib/html/glib-URI-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -65,16 +45,16 @@ #define G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO #define G_URI_RESERVED_CHARS_GENERIC_DELIMITERS #define G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS -char * g_uri_parse_scheme (const char *uri); -char * g_uri_escape_string (const char *unescaped, - const char *reserved_chars_allowed, - gboolean allow_utf8); -char * g_uri_unescape_string (const char *escaped_string, - const char *illegal_characters); -char * g_uri_unescape_segment (const char *escaped_string, - const char *escaped_string_end, - const char *illegal_characters); -gchar ** g_uri_list_extract_uris (const gchar *uri_list); +char * g_uri_parse_scheme (const char *uri); +char * g_uri_escape_string (const char *unescaped, + const char *reserved_chars_allowed, + gboolean allow_utf8); +char * g_uri_unescape_string (const char *escaped_string, + const char *illegal_characters); +char * g_uri_unescape_segment (const char *escaped_string, + const char *escaped_string_end, + const char *illegal_characters); +gchar ** g_uri_list_extract_uris (const gchar *uri_list);
    @@ -83,7 +63,8 @@ Functions for manipulating Universal Resource Identifiers (URIs) as defined by RFC 3986. It is highly recommended that you have read and -understand RFC 3986 for understanding this API.

    +understand RFC 3986 for understanding this API. +

    Details

    @@ -92,7 +73,8 @@ understand RFC 3986 for understanding this API.

    #define G_URI_RESERVED_CHARS_ALLOWED_IN_PATH G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT "/"
     

    -Allowed characters in a path. Includes "!$&'()*+,;=:@/".

    +Allowed characters in a path. Includes "!$&'()*+,;=:@/". +


    @@ -100,7 +82,8 @@ Allowed characters in a path. Includes "!$&'()*+,;=:@/".

    #define G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS ":@"
     

    -Allowed characters in path elements. Includes "!$&'()*+,;=:@".

    +Allowed characters in path elements. Includes "!$&'()*+,;=:@". +


    @@ -108,7 +91,8 @@ Allowed characters in path elements. Includes "!$&'()*+,;=:@".

    #define G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS ":"
     

    -Allowed characters in userinfo as defined in RFC 3986. Includes "!$&'()*+,;=:".

    +Allowed characters in userinfo as defined in RFC 3986. Includes "!$&'()*+,;=:". +


    @@ -116,7 +100,8 @@ Allowed characters in userinfo as defined in RFC 3986. Includes "!$&'()*+,;=
    #define G_URI_RESERVED_CHARS_GENERIC_DELIMITERS ":/?#[]@"
     

    -Generic delimiters characters as defined in RFC 3986. Includes ":/?#[]@".

    +Generic delimiters characters as defined in RFC 3986. Includes ":/?#[]@". +


    @@ -124,12 +109,13 @@ Generic delimiters characters as defined in RFC 3986. Includes ":/?#[]@".

    #define G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS "!$&'()*+,;="
     

    -Subcomponent delimiter characters as defined in RFC 3986. Includes "!$&'()*+,;=".

    +Subcomponent delimiter characters as defined in RFC 3986. Includes "!$&'()*+,;=". +


    g_uri_parse_scheme ()

    -
    char *              g_uri_parse_scheme                  (const char *uri);
    +
    char *              g_uri_parse_scheme                  (const char *uri);

    Gets the scheme portion of a URI string. RFC 3986 decodes the scheme as:

    @@ -137,13 +123,14 @@ Gets the scheme portion of a URI string. RFC 3986 decodes the scheme as: URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]

    -Common schemes include "file", "http", "svn+ssh", etc.

    +Common schemes include "file", "http", "svn+ssh", etc. +

    - @@ -160,9 +147,9 @@ The returned string should be freed when no longer needed.

    g_uri_escape_string ()

    -
    char *              g_uri_escape_string                 (const char *unescaped,
    -                                                         const char *reserved_chars_allowed,
    -                                                         gboolean allow_utf8);
    +
    char *              g_uri_escape_string                 (const char *unescaped,
    +                                                         const char *reserved_chars_allowed,
    +                                                         gboolean allow_utf8);

    Escapes a string for use in a URI.

    @@ -172,24 +159,26 @@ characters plus dash, dot, underscore and tilde) are escaped. But if you specify characters in reserved_chars_allowed they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of -a URI.

    +a URI. +

    uri :

    a valid URI. +a valid URI.
    - - - @@ -206,8 +195,8 @@ freed when no longer needed.

    g_uri_unescape_string ()

    -
    char *              g_uri_unescape_string               (const char *escaped_string,
    -                                                         const char *illegal_characters);
    +
    char *              g_uri_unescape_string               (const char *escaped_string,
    +                                                         const char *illegal_characters);

    Unescapes a whole escaped string.

    @@ -216,18 +205,19 @@ If any of the characters in illegal_charactersescaped_string then that is an error and NULL will be returned. This is useful it you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname -handling.

    +handling. +

    unescaped :

    the unescaped input string. +the unescaped input string.

    reserved_chars_allowed :

    a string of reserved characters that are +a string of reserved characters that are allowed to be used.

    allow_utf8 :

    TRUE if the result can include UTF-8 characters. + +TRUE if the result can include UTF-8 characters.
    - - @@ -244,9 +234,9 @@ should be freed when no longer needed.

    g_uri_unescape_segment ()

    -
    char *              g_uri_unescape_segment              (const char *escaped_string,
    -                                                         const char *escaped_string_end,
    -                                                         const char *illegal_characters);
    +
    char *              g_uri_unescape_segment              (const char *escaped_string,
    +                                                         const char *escaped_string_end,
    +                                                         const char *illegal_characters);

    Unescapes a segment of an escaped string.

    @@ -255,23 +245,24 @@ If any of the characters in illegal_charactersescaped_string then that is an error and NULL will be returned. This is useful it you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname -handling.

    +handling. +

    escaped_string :

    an escaped string to be unescaped. +an escaped string to be unescaped.

    illegal_characters :

    an optional string of illegal characters not to be allowed. +an optional string of illegal characters not to be allowed.
    - - - @@ -288,17 +279,18 @@ The returned string should be freed when no longer needed.

    g_uri_list_extract_uris ()

    -
    gchar **            g_uri_list_extract_uris             (const gchar *uri_list);
    +
    gchar **            g_uri_list_extract_uris             (const gchar *uri_list);

    Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, -discarding any comments. The URIs are not validated.

    +discarding any comments. The URIs are not validated. +

    escaped_string :

    a string. +a string.

    escaped_string_end :

    a string. +a string.

    illegal_characters :

    an optional string of illegal characters not to be allowed. +an optional string of illegal characters not to be allowed.
    - @@ -317,6 +309,6 @@ discarding any comments. The URIs are not validated.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Unicode-Manipulation.html b/docs/reference/glib/html/glib-Unicode-Manipulation.html index 9e0eb6e..dd116ed 100644 --- a/docs/reference/glib/html/glib-Unicode-Manipulation.html +++ b/docs/reference/glib/html/glib-Unicode-Manipulation.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    uri_list :

    an URI list +an URI list
    @@ -63,125 +43,125 @@ typedef gunichar; typedef gunichar2; -gbooleang_unichar_validate (gunichar ch); -gbooleang_unichar_isalnum (gunichar c); -gbooleang_unichar_isalpha (gunichar c); -gbooleang_unichar_iscntrl (gunichar c); -gbooleang_unichar_isdefined (gunichar c); -gbooleang_unichar_isdigit (gunichar c); -gbooleang_unichar_isgraph (gunichar c); -gbooleang_unichar_islower (gunichar c); -gbooleang_unichar_ismark (gunichar c); -gbooleang_unichar_isprint (gunichar c); -gbooleang_unichar_ispunct (gunichar c); -gbooleang_unichar_isspace (gunichar c); -gbooleang_unichar_istitle (gunichar c); -gbooleang_unichar_isupper (gunichar c); -gbooleang_unichar_isxdigit (gunichar c); -gbooleang_unichar_iswide (gunichar c); -gbooleang_unichar_iswide_cjk (gunichar c); -gbooleang_unichar_iszerowidth (gunichar c); -gunicharg_unichar_toupper (gunichar c); -gunicharg_unichar_tolower (gunichar c); -gunicharg_unichar_totitle (gunichar c); -gintg_unichar_digit_value (gunichar c); -gintg_unichar_xdigit_value (gunichar c); +gbooleang_unichar_validate (gunichar ch); +gbooleang_unichar_isalnum (gunichar c); +gbooleang_unichar_isalpha (gunichar c); +gbooleang_unichar_iscntrl (gunichar c); +gbooleang_unichar_isdefined (gunichar c); +gbooleang_unichar_isdigit (gunichar c); +gbooleang_unichar_isgraph (gunichar c); +gbooleang_unichar_islower (gunichar c); +gbooleang_unichar_ismark (gunichar c); +gbooleang_unichar_isprint (gunichar c); +gbooleang_unichar_ispunct (gunichar c); +gbooleang_unichar_isspace (gunichar c); +gbooleang_unichar_istitle (gunichar c); +gbooleang_unichar_isupper (gunichar c); +gbooleang_unichar_isxdigit (gunichar c); +gbooleang_unichar_iswide (gunichar c); +gbooleang_unichar_iswide_cjk (gunichar c); +gbooleang_unichar_iszerowidth (gunichar c); +gunicharg_unichar_toupper (gunichar c); +gunicharg_unichar_tolower (gunichar c); +gunicharg_unichar_totitle (gunichar c); +gintg_unichar_digit_value (gunichar c); +gintg_unichar_xdigit_value (gunichar c); enum GUnicodeType; -GUnicodeTypeg_unichar_type (gunichar c); +GUnicodeTypeg_unichar_type (gunichar c); enum GUnicodeBreakType; -GUnicodeBreakTypeg_unichar_break_type (gunichar c); -gintg_unichar_combining_class (gunichar uc); -voidg_unicode_canonical_ordering (gunichar *string, - gsize len); -gunichar * g_unicode_canonical_decomposition (gunichar ch, - gsize *result_len); -gbooleang_unichar_get_mirror_char (gunichar ch, - gunichar *mirrored_ch); +GUnicodeBreakTypeg_unichar_break_type (gunichar c); +gintg_unichar_combining_class (gunichar uc); +voidg_unicode_canonical_ordering (gunichar *string, + gsize len); +gunichar * g_unicode_canonical_decomposition (gunichar ch, + gsize *result_len); +gbooleang_unichar_get_mirror_char (gunichar ch, + gunichar *mirrored_ch); enum GUnicodeScript; -GUnicodeScriptg_unichar_get_script (gunichar ch); +GUnicodeScriptg_unichar_get_script (gunichar ch); #define g_utf8_next_char (p) -gunicharg_utf8_get_char (const gchar *p); -gunicharg_utf8_get_char_validated (const gchar *p, - gssize max_len); -gchar* g_utf8_offset_to_pointer (const gchar *str, - glong offset); -glongg_utf8_pointer_to_offset (const gchar *str, - const gchar *pos); -gchar* g_utf8_prev_char (const gchar *p); -gchar* g_utf8_find_next_char (const gchar *p, - const gchar *end); -gchar* g_utf8_find_prev_char (const gchar *str, - const gchar *p); -glongg_utf8_strlen (const gchar *p, - gssize max); -gchar* g_utf8_strncpy (gchar *dest, - const gchar *src, - gsize n); -gchar* g_utf8_strchr (const gchar *p, - gssize len, - gunichar c); -gchar* g_utf8_strrchr (const gchar *p, - gssize len, - gunichar c); -gchar* g_utf8_strreverse (const gchar *str, - gssize len); -gbooleang_utf8_validate (const gchar *str, - gssize max_len, - const gchar **end); +gunicharg_utf8_get_char (const gchar *p); +gunicharg_utf8_get_char_validated (const gchar *p, + gssize max_len); +gchar* g_utf8_offset_to_pointer (const gchar *str, + glong offset); +glongg_utf8_pointer_to_offset (const gchar *str, + const gchar *pos); +gchar* g_utf8_prev_char (const gchar *p); +gchar* g_utf8_find_next_char (const gchar *p, + const gchar *end); +gchar* g_utf8_find_prev_char (const gchar *str, + const gchar *p); +glongg_utf8_strlen (const gchar *p, + gssize max); +gchar* g_utf8_strncpy (gchar *dest, + const gchar *src, + gsize n); +gchar* g_utf8_strchr (const gchar *p, + gssize len, + gunichar c); +gchar* g_utf8_strrchr (const gchar *p, + gssize len, + gunichar c); +gchar* g_utf8_strreverse (const gchar *str, + gssize len); +gbooleang_utf8_validate (const gchar *str, + gssize max_len, + const gchar **end); -gchar * g_utf8_strup (const gchar *str, - gssize len); -gchar * g_utf8_strdown (const gchar *str, - gssize len); -gchar * g_utf8_casefold (const gchar *str, - gssize len); -gchar * g_utf8_normalize (const gchar *str, - gssize len, - GNormalizeMode mode); +gchar * g_utf8_strup (const gchar *str, + gssize len); +gchar * g_utf8_strdown (const gchar *str, + gssize len); +gchar * g_utf8_casefold (const gchar *str, + gssize len); +gchar * g_utf8_normalize (const gchar *str, + gssize len, + GNormalizeMode mode); enum GNormalizeMode; -gintg_utf8_collate (const gchar *str1, - const gchar *str2); -gchar * g_utf8_collate_key (const gchar *str, - gssize len); -gchar * g_utf8_collate_key_for_filename (const gchar *str, - gssize len); +gintg_utf8_collate (const gchar *str1, + const gchar *str2); +gchar * g_utf8_collate_key (const gchar *str, + gssize len); +gchar * g_utf8_collate_key_for_filename (const gchar *str, + gssize len); -gunichar2 * g_utf8_to_utf16 (const gchar *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gunichar * g_utf8_to_ucs4 (const gchar *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gunichar * g_utf8_to_ucs4_fast (const gchar *str, - glong len, - glong *items_written); -gunichar * g_utf16_to_ucs4 (const gunichar2 *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gchar* g_utf16_to_utf8 (const gunichar2 *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gunichar2 * g_ucs4_to_utf16 (const gunichar *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gchar* g_ucs4_to_utf8 (const gunichar *str, - glong len, - glong *items_read, - glong *items_written, - GError **error); -gintg_unichar_to_utf8 (gunichar c, - gchar *outbuf); +gunichar2 * g_utf8_to_utf16 (const gchar *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gunichar * g_utf8_to_ucs4 (const gchar *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gunichar * g_utf8_to_ucs4_fast (const gchar *str, + glong len, + glong *items_written); +gunichar * g_utf16_to_ucs4 (const gunichar2 *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gchar* g_utf16_to_utf8 (const gunichar2 *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gunichar2 * g_ucs4_to_utf16 (const gunichar *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gchar* g_ucs4_to_utf8 (const gunichar *str, + glong len, + glong *items_read, + glong *items_written, + GError **error); +gintg_unichar_to_utf8 (gunichar c, + gchar *outbuf);
    @@ -231,11 +211,21 @@ To print a code point in the U+-notation, use the format string "U+04"G_GINT32_FORMAT"X". To scan, use the format string "U+06"G_GINT32_FORMAT"X".

    -
    -gunichar c;
    -sscanf ("U+0041", "U+%06"G_GINT32_FORMAT"X", &c)
    -g_print ("Read U+%04"G_GINT32_FORMAT"X", c);
    -
    +
    +
    + + + + + + +
    1
    +2
    +3
    gunichar c;
    +sscanf ("U+0041", "U+%06"G_GINT32_FORMAT"X", &c)
    +g_print ("Read U+%04"G_GINT32_FORMAT"X", c);
    +
    +

    @@ -260,17 +250,18 @@ To print/scan values of this type as integer, use

    g_unichar_validate ()

    -
    gboolean            g_unichar_validate                  (gunichar ch);
    +
    gboolean            g_unichar_validate                  (gunichar ch);

    Checks whether ch is a valid Unicode character. Some possible integer values of ch will not be valid. 0 is considered a valid -character, though it's normally a string terminator.

    +character, though it's normally a string terminator. +

    - @@ -284,17 +275,18 @@ character, though it's normally a string terminator.


    g_unichar_isalnum ()

    -
    gboolean            g_unichar_isalnum                   (gunichar c);
    +
    gboolean            g_unichar_isalnum                   (gunichar c);

    Determines whether a character is alphanumeric. Given some UTF-8 text, obtain a character value -with g_utf8_get_char().

    +with g_utf8_get_char(). +

    ch :

    a Unicode character +a Unicode character
    - @@ -308,17 +300,18 @@ with

    g_unichar_isalpha ()

    -
    gboolean            g_unichar_isalpha                   (gunichar c);
    +
    gboolean            g_unichar_isalpha                   (gunichar c);

    Determines whether a character is alphabetic (i.e. a letter). Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -332,17 +325,18 @@ Given some UTF-8 text, obtain a character value with

    g_unichar_iscntrl ()

    -
    gboolean            g_unichar_iscntrl                   (gunichar c);
    +
    gboolean            g_unichar_iscntrl                   (gunichar c);

    Determines whether a character is a control character. Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -356,16 +350,17 @@ Given some UTF-8 text, obtain a character value with

    g_unichar_isdefined ()

    -
    gboolean            g_unichar_isdefined                 (gunichar c);
    +
    gboolean            g_unichar_isdefined                 (gunichar c);

    Determines if a given character is assigned in the Unicode -standard.

    +standard. +

    c :

    a Unicode character +a Unicode character
    - @@ -379,17 +374,18 @@ standard.


    g_unichar_isdigit ()

    -
    gboolean            g_unichar_isdigit                   (gunichar c);
    +
    gboolean            g_unichar_isdigit                   (gunichar c);

    Determines whether a character is numeric (i.e. a digit). This covers ASCII 0-9 and also digits in other languages/scripts. Given -some UTF-8 text, obtain a character value with g_utf8_get_char().

    +some UTF-8 text, obtain a character value with g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -403,19 +399,20 @@ some UTF-8 text, obtain a character value with

    g_unichar_isgraph ()

    -
    gboolean            g_unichar_isgraph                   (gunichar c);
    +
    gboolean            g_unichar_isgraph                   (gunichar c);

    Determines whether a character is printable and not a space (returns FALSE for control characters, format characters, and spaces). g_unichar_isprint() is similar, but returns TRUE for spaces. Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -429,17 +426,18 @@ spaces. Given some UTF-8 text, obtain a character value with

    g_unichar_islower ()

    -
    gboolean            g_unichar_islower                   (gunichar c);
    +
    gboolean            g_unichar_islower                   (gunichar c);

    Determines whether a character is a lowercase letter. Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -453,7 +451,7 @@ Given some UTF-8 text, obtain a character value with

    g_unichar_ismark ()

    -
    gboolean            g_unichar_ismark                    (gunichar c);
    +
    gboolean            g_unichar_ismark                    (gunichar c);

    Determines whether a character is a mark (non-spacing mark, combining mark, or enclosing mark in Unicode speak). @@ -464,13 +462,14 @@ with +scripts. +

    c :

    a Unicode character +a Unicode character
    - @@ -486,18 +485,19 @@ scripts.


    g_unichar_isprint ()

    -
    gboolean            g_unichar_isprint                   (gunichar c);
    +
    gboolean            g_unichar_isprint                   (gunichar c);

    Determines whether a character is printable. Unlike g_unichar_isgraph(), returns TRUE for spaces. Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -511,17 +511,18 @@ Given some UTF-8 text, obtain a character value with

    g_unichar_ispunct ()

    -
    gboolean            g_unichar_ispunct                   (gunichar c);
    +
    gboolean            g_unichar_ispunct                   (gunichar c);

    Determines whether a character is punctuation or a symbol. Given some UTF-8 text, obtain a character value with -g_utf8_get_char().

    +g_utf8_get_char(). +

    c :

    a Unicode character +a Unicode character
    - @@ -535,7 +536,7 @@ Given some UTF-8 text, obtain a character value with

    g_unichar_isspace ()

    -
    gboolean            g_unichar_isspace                   (gunichar c);
    +
    gboolean            g_unichar_isspace                   (gunichar c);

    Determines whether a character is a space, tab, or line separator (newline, carriage return, etc.). Given some UTF-8 text, obtain a @@ -544,13 +545,14 @@ character value with

    c :

    a Unicode character +a Unicode character
    - @@ -564,20 +566,21 @@ is fairly complex.)


    g_unichar_istitle ()

    -
    gboolean            g_unichar_istitle                   (gunichar c);
    +
    gboolean            g_unichar_istitle                   (gunichar c);

    Determines if a character is titlecase. Some characters in Unicode which are composites, such as the DZ digraph have three case variants instead of just two. The titlecase form is used at the beginning of a word where only the first letter is capitalized. The titlecase form of the DZ -digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z.

    +digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. +

    c :

    a Unicode character +a Unicode character
    - @@ -591,15 +594,16 @@ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z.


    g_unichar_isupper ()

    -
    gboolean            g_unichar_isupper                   (gunichar c);
    +
    gboolean            g_unichar_isupper                   (gunichar c);

    -Determines if a character is uppercase.

    +Determines if a character is uppercase. +

    c :

    a Unicode character +a Unicode character
    - @@ -613,15 +617,16 @@ Determines if a character is uppercase.


    g_unichar_isxdigit ()

    -
    gboolean            g_unichar_isxdigit                  (gunichar c);
    +
    gboolean            g_unichar_isxdigit                  (gunichar c);

    -Determines if a character is a hexidecimal digit.

    +Determines if a character is a hexidecimal digit. +

    c :

    a Unicode character +a Unicode character
    - @@ -635,16 +640,17 @@ Determines if a character is a hexidecimal digit.


    g_unichar_iswide ()

    -
    gboolean            g_unichar_iswide                    (gunichar c);
    +
    gboolean            g_unichar_iswide                    (gunichar c);

    Determines if a character is typically rendered in a double-width -cell.

    +cell. +

    c :

    a Unicode character. +a Unicode character.
    - @@ -658,7 +664,7 @@ cell.


    g_unichar_iswide_cjk ()

    -
    gboolean            g_unichar_iswide_cjk                (gunichar c);
    +
    gboolean            g_unichar_iswide_cjk                (gunichar c);

    Determines if a character is typically rendered in a double-width cell under legacy East Asian locales. If a character is wide according to @@ -670,13 +676,14 @@ Annex #11 for details.

    If a character passes the g_unichar_iswide() test then it will also pass this test, but not the other way around. Note that some characters may -pas both this test and g_unichar_iszerowidth().

    +pas both this test and g_unichar_iszerowidth(). +

    c :

    a Unicode character +a Unicode character
    - @@ -692,7 +699,7 @@ pas both this test and

    g_unichar_iszerowidth ()

    -
    gboolean            g_unichar_iszerowidth               (gunichar c);
    +
    gboolean            g_unichar_iszerowidth               (gunichar c);

    Determines if a given character typically takes zero width when rendered. The return value is TRUE for all non-spacing and enclosing marks @@ -703,13 +710,14 @@ space, but not U+00AD SOFT HYPHEN. A typical use of this function is with one of g_unichar_iswide() or g_unichar_iswide_cjk() to determine the number of cells a string occupies when displayed on a grid display (terminals). However, note that not all -terminals support zero-width rendering of zero-width marks.

    +terminals support zero-width rendering of zero-width marks. +

    c :

    a Unicode character +a Unicode character
    - @@ -725,15 +733,16 @@ terminals support zero-width rendering of zero-width marks.


    g_unichar_toupper ()

    -
    gunichar            g_unichar_toupper                   (gunichar c);
    +
    gunichar            g_unichar_toupper                   (gunichar c);

    -Converts a character to uppercase.

    +Converts a character to uppercase. +

    c :

    a Unicode character +a Unicode character
    - @@ -749,15 +758,16 @@ Converts a character to uppercase.


    g_unichar_tolower ()

    -
    gunichar            g_unichar_tolower                   (gunichar c);
    +
    gunichar            g_unichar_tolower                   (gunichar c);

    -Converts a character to lower case.

    +Converts a character to lower case. +

    c :

    a Unicode character +a Unicode character
    - @@ -773,15 +783,16 @@ Converts a character to lower case.


    g_unichar_totitle ()

    -
    gunichar            g_unichar_totitle                   (gunichar c);
    +
    gunichar            g_unichar_totitle                   (gunichar c);

    -Converts a character to the titlecase.

    +Converts a character to the titlecase. +

    c :

    a Unicode character. +a Unicode character.
    - @@ -797,16 +808,17 @@ Converts a character to the titlecase.


    g_unichar_digit_value ()

    -
    gint                g_unichar_digit_value               (gunichar c);
    +
    gint                g_unichar_digit_value               (gunichar c);

    Determines the numeric value of a character as a decimal -digit.

    +digit. +

    c :

    a Unicode character +a Unicode character
    - @@ -821,16 +833,17 @@ digit.


    g_unichar_xdigit_value ()

    -
    gint                g_unichar_xdigit_value              (gunichar c);
    +
    gint                g_unichar_xdigit_value              (gunichar c);

    Determines the numeric value of a character as a hexidecimal -digit.

    +digit. +

    c :

    a Unicode character +a Unicode character
    - @@ -1043,15 +1056,16 @@ See

    g_unichar_type ()

    -
    GUnicodeType        g_unichar_type                      (gunichar c);
    +
    GUnicodeType        g_unichar_type                      (gunichar c);

    -Classifies a Unicode character by type.

    +Classifies a Unicode character by type. +

    c :

    a Unicode character +a Unicode character
    - @@ -1302,20 +1316,21 @@ See

    g_unichar_break_type ()

    -
    GUnicodeBreakType   g_unichar_break_type                (gunichar c);
    +
    GUnicodeBreakType   g_unichar_break_type                (gunichar c);

    Determines the break type of c. c should be a Unicode character (to derive a character from UTF-8 encoded text, use g_utf8_get_char()). The break type is used to find word and line breaks ("text boundaries"), Pango implements the Unicode boundary resolution algorithms and normally you would use a function such -as pango_break() instead of caring about break types yourself.

    +as pango_break() instead of caring about break types yourself. +

    c :

    a Unicode character +a Unicode character
    - @@ -1329,15 +1344,16 @@ as

    g_unichar_combining_class ()

    -
    gint                g_unichar_combining_class           (gunichar uc);
    +
    gint                g_unichar_combining_class           (gunichar uc);

    -Determines the canonical combining class of a Unicode character.

    +Determines the canonical combining class of a Unicode character. +

    c :

    a Unicode character +a Unicode character
    - @@ -1353,24 +1369,25 @@ Determines the canonical combining class of a Unicode character.


    g_unicode_canonical_ordering ()

    -
    void                g_unicode_canonical_ordering        (gunichar *string,
    -                                                         gsize len);
    +
    void                g_unicode_canonical_ordering        (gunichar *string,
    +                                                         gsize len);

    Computes the canonical ordering of a string in-place. This rearranges decomposed characters in the string according to their combining classes. See the Unicode -manual for more information.

    +manual for more information. +

    uc :

    a Unicode character +a Unicode character
    - - @@ -1379,21 +1396,22 @@ manual for more information.


    g_unicode_canonical_decomposition ()

    -
    gunichar *          g_unicode_canonical_decomposition   (gunichar ch,
    -                                                         gsize *result_len);
    +
    gunichar *          g_unicode_canonical_decomposition   (gunichar ch,
    +                                                         gsize *result_len);

    -Computes the canonical decomposition of a Unicode character.

    +Computes the canonical decomposition of a Unicode character. +

    string :

    a UCS-4 encoded string. +a UCS-4 encoded string.

    len :

    the maximum length of string to use. +the maximum length of string to use.
    - - @@ -1408,8 +1426,8 @@ Computes the canonical decomposition of a Unicode character.


    g_unichar_get_mirror_char ()

    -
    gboolean            g_unichar_get_mirror_char           (gunichar ch,
    -                                                         gunichar *mirrored_ch);
    +
    gboolean            g_unichar_get_mirror_char           (gunichar ch,
    +                                                         gunichar *mirrored_ch);

    In Unicode, some characters are mirrored. This means that their images are mirrored horizontally in text that is laid @@ -1420,18 +1438,19 @@ out from right to left. For instance, "(" would become its mirror image, If ch has the Unicode mirrored property and there is another unicode character that typically has a glyph that is the mirror image of ch's glyph and mirrored_ch is set, it puts that character in the address -pointed to by mirrored_ch. Otherwise the original character is put.

    +pointed to by mirrored_ch. Otherwise the original character is put. +

    ch :

    a Unicode character. +a Unicode character.

    result_len :

    location to store the length of the return value. +location to store the length of the return value.
    - - @@ -1954,7 +1973,7 @@ See U

    g_unichar_get_script ()

    -
    GUnicodeScript      g_unichar_get_script                (gunichar ch);
    +
    GUnicodeScript      g_unichar_get_script                (gunichar ch);

    Looks up the GUnicodeScript for a particular character (as defined by Unicode Standard Annex 24). No check is made for ch being a @@ -1963,13 +1982,14 @@ result is undefined.

    This function is equivalent to pango_script_for_unichar() and the -two are interchangeable.

    +two are interchangeable. +

    ch :

    a Unicode character +a Unicode character

    mirrored_ch :

    location to store the mirrored character +location to store the mirrored character
    - @@ -2006,19 +2026,20 @@ that may contain invalid UTF-8.

    g_utf8_get_char ()

    -
    gunichar            g_utf8_get_char                     (const gchar *p);
    +
    gunichar            g_utf8_get_char                     (const gchar *p);

    Converts a sequence of bytes encoded as UTF-8 to a Unicode character. If p does not point to a valid UTF-8 encoded character, results are undefined. If you are not sure that the bytes are complete valid Unicode characters, you should use g_utf8_get_char_validated() -instead.

    +instead. +

    ch :

    a Unicode character +a Unicode character
    - @@ -2032,24 +2053,25 @@ instead.


    g_utf8_get_char_validated ()

    -
    gunichar            g_utf8_get_char_validated           (const gchar *p,
    -                                                         gssize max_len);
    +
    gunichar            g_utf8_get_char_validated           (const gchar *p,
    +                                                         gssize max_len);

    Convert a sequence of bytes encoded as UTF-8 to a Unicode character. This function checks for incomplete characters, for invalid characters such as characters that are out of the range of Unicode, and for -overlong encodings of valid characters.

    +overlong encodings of valid characters. +

    p :

    a pointer to Unicode character encoded as UTF-8 +a pointer to Unicode character encoded as UTF-8
    - - @@ -2068,8 +2090,8 @@ overlong encodings of valid characters.


    g_utf8_offset_to_pointer ()

    -
    gchar*              g_utf8_offset_to_pointer            (const gchar *str,
    -                                                         glong offset);
    +
    gchar*              g_utf8_offset_to_pointer            (const gchar *str,
    +                                                         glong offset);

    Converts from an integer character offset to a pointer to a position within the string. @@ -2094,17 +2116,19 @@ This limitation exists as this function is called frequently during text rendering and therefore has to be as fast as possible.

    +

    +

    p :

    a pointer to Unicode character encoded as UTF-8 +a pointer to Unicode character encoded as UTF-8

    max_len :

    the maximum number of bytes to read, or -1, for no maximum or +the maximum number of bytes to read, or -1, for no maximum or if p is nul-terminated
    - - @@ -2118,26 +2142,27 @@ text rendering and therefore has to be as fast as possible.

    g_utf8_pointer_to_offset ()

    -
    glong               g_utf8_pointer_to_offset            (const gchar *str,
    -                                                         const gchar *pos);
    +
    glong               g_utf8_pointer_to_offset            (const gchar *str,
    +                                                         const gchar *pos);

    Converts from a pointer to position within a string to a integer character offset.

    Since 2.10, this function allows pos to be before str, and returns -a negative offset in this case.

    +a negative offset in this case. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    offset :

    a character offset within str +a character offset within str
    - - @@ -2151,7 +2176,7 @@ a negative offset in this case.


    g_utf8_prev_char ()

    -
    gchar*              g_utf8_prev_char                    (const gchar *p);
    +
    gchar*              g_utf8_prev_char                    (const gchar *p);

    Finds the previous UTF-8 character in the string before p.

    @@ -2159,13 +2184,14 @@ Finds the previous UTF-8 character in the string before p does not have to be at the beginning of a UTF-8 character. No check is made to see if the character found is actually valid other than it starts with an appropriate byte. If p might be the first -character of the string, you must use g_utf8_find_prev_char() instead.

    +character of the string, you must use g_utf8_find_prev_char() instead. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    pos :

    a pointer to a position within str +a pointer to a position within str
    - @@ -2179,26 +2205,27 @@ character of the string, you must use

    g_utf8_find_next_char ()

    -
    gchar*              g_utf8_find_next_char               (const gchar *p,
    -                                                         const gchar *end);
    +
    gchar*              g_utf8_find_next_char               (const gchar *p,
    +                                                         const gchar *end);

    Finds the start of the next UTF-8 character in the string after p.

    p does not have to be at the beginning of a UTF-8 character. No check is made to see if the character found is actually valid other than -it starts with an appropriate byte.

    +it starts with an appropriate byte. +

    p :

    a pointer to a position within a UTF-8 encoded string +a pointer to a position within a UTF-8 encoded string
    - - @@ -2213,8 +2240,8 @@ or

    g_utf8_find_prev_char ()

    -
    gchar*              g_utf8_find_prev_char               (const gchar *str,
    -                                                         const gchar *p);
    +
    gchar*              g_utf8_find_prev_char               (const gchar *str,
    +                                                         const gchar *p);

    Given a position p with a UTF-8 encoded string str, find the start of the previous UTF-8 character starting before p. Returns NULL if no @@ -2223,18 +2250,19 @@ UTF-8 characters are present in str befo

    p does not have to be at the beginning of a UTF-8 character. No check is made to see if the character found is actually valid other than -it starts with an appropriate byte.

    +it starts with an appropriate byte. +

    p :

    a pointer to a position within a UTF-8 encoded string +a pointer to a position within a UTF-8 encoded string

    end :

    a pointer to the byte following the end of the string, +a pointer to the byte following the end of the string, or NULL to indicate that the string is nul-terminated.
    - - @@ -2248,22 +2276,23 @@ it starts with an appropriate byte.


    g_utf8_strlen ()

    -
    glong               g_utf8_strlen                       (const gchar *p,
    -                                                         gssize max);
    +
    glong               g_utf8_strlen                       (const gchar *p,
    +                                                         gssize max);

    Computes the length of the string in characters, not including -the terminating nul character.

    +the terminating nul character. +

    str :

    pointer to the beginning of a UTF-8 encoded string +pointer to the beginning of a UTF-8 encoded string

    p :

    pointer to some position within str +pointer to some position within str
    - -

    p :

    pointer to the start of a UTF-8 encoded string +pointer to the start of a UTF-8 encoded string

    max :

    the maximum number of bytes to examine. If max +the maximum number of bytes to examine. If max is less than 0, then the string is assumed to be nul-terminated. If max is 0, p will not be examined and may be NULL. @@ -2280,31 +2309,32 @@ the terminating nul character.


    g_utf8_strncpy ()

    -
    gchar*              g_utf8_strncpy                      (gchar *dest,
    -                                                         const gchar *src,
    -                                                         gsize n);
    +
    gchar*              g_utf8_strncpy                      (gchar *dest,
    +                                                         const gchar *src,
    +                                                         gsize n);

    Like the standard C strncpy() function, but copies a given number of characters instead of a given number of bytes. The src string must be valid UTF-8 encoded text. (Use g_utf8_validate() on all text before trying to use UTF-8 -utility functions with it.)

    +utility functions with it.) +

    - - - @@ -2318,29 +2348,30 @@ utility functions with it.)


    g_utf8_strchr ()

    -
    gchar*              g_utf8_strchr                       (const gchar *p,
    -                                                         gssize len,
    -                                                         gunichar c);
    +
    gchar*              g_utf8_strchr                       (const gchar *p,
    +                                                         gssize len,
    +                                                         gunichar c);

    Finds the leftmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to len bytes. -If len is -1, allow unbounded search.

    +If len is -1, allow unbounded search. +

    dest :

    buffer to fill with characters from src +buffer to fill with characters from src

    src :

    UTF-8 encoded string +UTF-8 encoded string

    n :

    character count +character count
    - - - @@ -2356,29 +2387,30 @@ If len is -1, allow unbounded search.

    g_utf8_strrchr ()

    -
    gchar*              g_utf8_strrchr                      (const gchar *p,
    -                                                         gssize len,
    -                                                         gunichar c);
    +
    gchar*              g_utf8_strrchr                      (const gchar *p,
    +                                                         gssize len,
    +                                                         gunichar c);

    Find the rightmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to len bytes. -If len is -1, allow unbounded search.

    +If len is -1, allow unbounded search. +

    p :

    a nul-terminated UTF-8 encoded string +a nul-terminated UTF-8 encoded string

    len :

    the maximum length of p +the maximum length of p

    c :

    a Unicode character +a Unicode character
    - - - @@ -2394,8 +2426,8 @@ If len is -1, allow unbounded search.

    g_utf8_strreverse ()

    -
    gchar*              g_utf8_strreverse                   (const gchar *str,
    -                                                         gssize len);
    +
    gchar*              g_utf8_strreverse                   (const gchar *str,
    +                                                         gssize len);

    Reverses a UTF-8 string. str must be valid UTF-8 encoded text. (Use g_utf8_validate() on all text before trying to use UTF-8 @@ -2411,18 +2443,19 @@ for display purposes.

    Note that unlike g_strreverse(), this function returns newly-allocated memory, which should be freed with g_free() when -no longer needed.

    +no longer needed. +

    p :

    a nul-terminated UTF-8 encoded string +a nul-terminated UTF-8 encoded string

    len :

    the maximum length of p +the maximum length of p

    c :

    a Unicode character +a Unicode character
    - - @@ -2439,9 +2472,9 @@ no longer needed.


    g_utf8_validate ()

    -
    gboolean            g_utf8_validate                     (const gchar *str,
    -                                                         gssize max_len,
    -                                                         const gchar **end);
    +
    gboolean            g_utf8_validate                     (const gchar *str,
    +                                                         gssize max_len,
    +                                                         const gchar **end);

    Validates UTF-8 encoded text. str is the text to validate; if str is nul-terminated, then max_len can be -1, otherwise @@ -2459,23 +2492,24 @@ positive and NUL is met before max_len b Returns TRUE if all of str was valid. Many GLib and GTK+ routines require valid UTF-8 as input; so data read from a file or the network should be checked -with g_utf8_validate() before doing anything else with it.

    +with g_utf8_validate() before doing anything else with it. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    the maximum length of str to use, in bytes. If len < 0, +the maximum length of str to use, in bytes. If len < 0, then the string is nul-terminated.
    - - - @@ -2489,25 +2523,26 @@ with

    g_utf8_strup ()

    -
    gchar *             g_utf8_strup                        (const gchar *str,
    -                                                         gssize len);
    +
    gchar *             g_utf8_strup                        (const gchar *str,
    +                                                         gssize len);

    Converts all Unicode characters in the string that have a case to uppercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string increasing. (For instance, the -German ess-zet will be changed to SS.)

    +German ess-zet will be changed to SS.) +

    str :

    a pointer to character data +a pointer to character data

    max_len :

    max bytes to validate, or -1 to go until NUL +max bytes to validate, or -1 to go until NUL

    end :

    return location for end of valid data +return location for end of valid data
    - - @@ -2522,24 +2557,25 @@ German ess-zet will be changed to SS.)


    g_utf8_strdown ()

    -
    gchar *             g_utf8_strdown                      (const gchar *str,
    -                                                         gssize len);
    +
    gchar *             g_utf8_strdown                      (const gchar *str,
    +                                                         gssize len);

    Converts all Unicode characters in the string that have a case to lowercase. The exact manner that this is done depends on the current locale, and may result in the number of -characters in the string changing.

    +characters in the string changing. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.
    - - @@ -2554,8 +2590,8 @@ characters in the string changing.


    g_utf8_casefold ()

    -
    gchar *             g_utf8_casefold                     (const gchar *str,
    -                                                         gssize len);
    +
    gchar *             g_utf8_casefold                     (const gchar *str,
    +                                                         gssize len);

    Converts a string into a form that is independent of case. The result will not correspond to any particular case, but can be @@ -2568,18 +2604,19 @@ only an approximation to the correct linguistic case insensitive ordering, though it is a fairly good one. Getting this exactly right would require a more sophisticated collation function that takes case sensitivity into account. GLib does not currently -provide such a function.

    +provide such a function. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.
    - - @@ -2594,9 +2631,9 @@ provide such a function.


    g_utf8_normalize ()

    -
    gchar *             g_utf8_normalize                    (const gchar *str,
    -                                                         gssize len,
    -                                                         GNormalizeMode mode);
    +
    gchar *             g_utf8_normalize                    (const gchar *str,
    +                                                         gssize len,
    +                                                         GNormalizeMode mode);

    Converts a string into canonical form, standardizing such issues as whether a character with an accent @@ -2624,23 +2661,24 @@ but returned a result with composed forms rather than a maximally decomposed form. This is often useful if you intend to convert the string to a legacy encoding or pass it to a system with -less capable Unicode handling.

    +less capable Unicode handling. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.
    - - - @@ -2729,26 +2767,27 @@ character. Unicode strings should generally be normalized before comparing them.

    g_utf8_collate ()

    -
    gint                g_utf8_collate                      (const gchar *str1,
    -                                                         const gchar *str2);
    +
    gint                g_utf8_collate                      (const gchar *str1,
    +                                                         const gchar *str2);

    Compares two strings for ordering using the linguistically correct rules for the current locale. When sorting a large number of strings, it will be significantly faster to obtain collation keys with g_utf8_collate_key() and compare the keys with strcmp() when sorting instead of sorting -the original strings.

    +the original strings. +

    str :

    a UTF-8 encoded string. +a UTF-8 encoded string.

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.

    mode :

    the type of normalization to perform. +the type of normalization to perform.
    - - @@ -2763,8 +2802,8 @@ the original strings.


    g_utf8_collate_key ()

    -
    gchar *             g_utf8_collate_key                  (const gchar *str,
    -                                                         gssize len);
    +
    gchar *             g_utf8_collate_key                  (const gchar *str,
    +                                                         gssize len);

    Converts a string into a collation key that can be compared with other collation keys produced by the same function using @@ -2777,18 +2816,19 @@ original keys with current locale.

    +current locale. +

    str1 :

    a UTF-8 encoded string +a UTF-8 encoded string

    str2 :

    a UTF-8 encoded string +a UTF-8 encoded string
    - - @@ -2803,8 +2843,8 @@ Note that this function depends on the

    g_utf8_collate_key_for_filename ()

    -
    gchar *             g_utf8_collate_key_for_filename     (const gchar *str,
    -                                                         gssize len);
    +
    gchar *             g_utf8_collate_key_for_filename     (const gchar *str,
    +                                                         gssize len);

    Converts a string into a collation key that can be compared with other collation keys produced by the same function using strcmp(). @@ -2819,18 +2859,19 @@ is sorted as "file1" "file5" "file10".

    Note that this function depends on the -current locale.

    +current locale. +

    str :

    a UTF-8 encoded string. +a UTF-8 encoded string.

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.
    - - @@ -2847,31 +2888,32 @@ Note that this function depends on the

    g_utf8_to_utf16 ()

    -
    gunichar2 *         g_utf8_to_utf16                     (const gchar *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gunichar2 *         g_utf8_to_utf16                     (const gchar *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from UTF-8 to UTF-16. A 0 character will be -added to the result after the converted text.

    +added to the result after the converted text. +

    str :

    a UTF-8 encoded string. +a UTF-8 encoded string.

    len :

    length of str, in bytes, or -1 if str is nul-terminated. +length of str, in bytes, or -1 if str is nul-terminated.
    - - - - - @@ -2906,32 +2948,33 @@ added to the result after the converted text.


    g_utf8_to_ucs4 ()

    -
    gunichar *          g_utf8_to_ucs4                      (const gchar *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gunichar *          g_utf8_to_ucs4                      (const gchar *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. A trailing 0 will be added to the -string after the converted text.

    +string after the converted text. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    the maximum length (number of bytes) of str to use. +the maximum length (number of bytes) of str to use. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of bytes read, or NULL. +location to store number of bytes read, or NULL. If NULL, then G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case str contains a trailing partial character. If an error occurs then the index of the @@ -2880,14 +2922,14 @@ added to the result after the converted text.

    items_written :

    location to store number of gunichar2 written, +location to store number of gunichar2 written, or NULL. The value stored here does not include the trailing 0.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - - - - @@ -2966,31 +3009,32 @@ string after the converted text.


    g_utf8_to_ucs4_fast ()

    -
    gunichar *          g_utf8_to_ucs4_fast                 (const gchar *str,
    -                                                         glong len,
    -                                                         glong *items_written);
    +
    gunichar *          g_utf8_to_ucs4_fast                 (const gchar *str,
    +                                                         glong len,
    +                                                         glong *items_written);

    Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4, assuming valid UTF-8 input. This function is roughly twice as fast as g_utf8_to_ucs4() -but does no error checking on the input.

    +but does no error checking on the input. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    the maximum length of str to use, in bytes. If len < 0, +the maximum length of str to use, in bytes. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of bytes read, or NULL. +location to store number of bytes read, or NULL. If NULL, then G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case str contains a trailing partial character. If an error occurs then the index of the @@ -2940,14 +2983,14 @@ string after the converted text.

    items_written :

    location to store number of characters written or NULL. +location to store number of characters written or NULL. The value here stored does not include the trailing 0 character.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - - @@ -3006,31 +3050,32 @@ but does no error checking on the input.


    g_utf16_to_ucs4 ()

    -
    gunichar *          g_utf16_to_ucs4                     (const gunichar2 *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gunichar *          g_utf16_to_ucs4                     (const gunichar2 *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from UTF-16 to UCS-4. The result will be -nul-terminated.

    +nul-terminated. +

    str :

    a UTF-8 encoded string +a UTF-8 encoded string

    len :

    the maximum length of str to use, in bytes. If len < 0, +the maximum length of str to use, in bytes. If len < 0, then the string is nul-terminated.

    items_written :

    location to store the number of characters in the +location to store the number of characters in the result, or NULL.
    - - - - - @@ -3065,11 +3110,11 @@ nul-terminated.


    g_utf16_to_utf8 ()

    -
    gchar*              g_utf16_to_utf8                     (const gunichar2 *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gchar*              g_utf16_to_utf8                     (const gunichar2 *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from UTF-16 to UTF-8. The result will be terminated with a 0 byte. @@ -3085,24 +3130,25 @@ Further note that this function does not validate the result string; it may e.g. include embedded NUL characters. The only validation done by this function is to ensure that the input can be correctly interpreted as UTF-16, i.e. it doesn't contain -things unpaired surrogates.

    +things unpaired surrogates. +

    str :

    a UTF-16 encoded string +a UTF-16 encoded string

    len :

    the maximum length (number of gunichar2) of str to use. +the maximum length (number of gunichar2) of str to use. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of words read, or NULL. +location to store number of words read, or NULL. If NULL, then G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case str contains a trailing partial character. If an error occurs then the index of the @@ -3039,14 +3084,14 @@ nul-terminated.

    items_written :

    location to store number of characters written, or NULL. +location to store number of characters written, or NULL. The value stored here does not include the trailing 0 character.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - - - - @@ -3137,45 +3183,46 @@ things unpaired surrogates.


    g_ucs4_to_utf16 ()

    -
    gunichar2 *         g_ucs4_to_utf16                     (const gunichar *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gunichar2 *         g_ucs4_to_utf16                     (const gunichar *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from UCS-4 to UTF-16. A 0 character will be -added to the result after the converted text.

    +added to the result after the converted text. +

    str :

    a UTF-16 encoded string +a UTF-16 encoded string

    len :

    the maximum length (number of gunichar2) of str to use. +the maximum length (number of gunichar2) of str to use. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of words read, or NULL. +location to store number of words read, or NULL. If NULL, then G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case str contains a trailing partial character. If an error occurs then the index of the @@ -3111,14 +3157,14 @@ things unpaired surrogates.

    items_written :

    location to store number of bytes written, or NULL. +location to store number of bytes written, or NULL. The value stored here does not include the trailing 0 byte.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - - - - @@ -3194,43 +3241,44 @@ added to the result after the converted text.


    g_ucs4_to_utf8 ()

    -
    gchar*              g_ucs4_to_utf8                      (const gunichar *str,
    -                                                         glong len,
    -                                                         glong *items_read,
    -                                                         glong *items_written,
    -                                                         GError **error);
    +
    gchar*              g_ucs4_to_utf8                      (const gunichar *str,
    +                                                         glong len,
    +                                                         glong *items_read,
    +                                                         glong *items_written,
    +                                                         GError **error);

    Convert a string from a 32-bit fixed width representation as UCS-4. -to UTF-8. The result will be terminated with a 0 byte.

    +to UTF-8. The result will be terminated with a 0 byte. +

    str :

    a UCS-4 encoded string +a UCS-4 encoded string

    len :

    the maximum length (number of characters) of str to use. +the maximum length (number of characters) of str to use. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of bytes read, or NULL. +location to store number of bytes read, or NULL. If an error occurs then the index of the invalid input is stored here.

    items_written :

    location to store number of gunichar2 +location to store number of gunichar2 written, or NULL. The value stored here does not include the trailing 0.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - - - - @@ -3251,21 +3299,22 @@ to UTF-8. The result will be terminated with a 0 byte.


    g_unichar_to_utf8 ()

    -
    gint                g_unichar_to_utf8                   (gunichar c,
    -                                                         gchar *outbuf);
    +
    gint                g_unichar_to_utf8                   (gunichar c,
    +                                                         gchar *outbuf);

    -Converts a single character to UTF-8.

    +Converts a single character to UTF-8. +

    str :

    a UCS-4 encoded string +a UCS-4 encoded string

    len :

    the maximum length (number of characters) of str to use. +the maximum length (number of characters) of str to use. If len < 0, then the string is nul-terminated.

    items_read :

    location to store number of characters read, or NULL. +location to store number of characters read, or NULL.

    items_written :

    location to store number of bytes written or NULL. +location to store number of bytes written or NULL. The value here stored does not include the trailing 0 byte.

    error :

    location to store the error occuring, or NULL to ignore +location to store the error occuring, or NULL to ignore errors. Any of the errors in GConvertError other than G_CONVERT_ERROR_NO_CONVERSION may occur.
    - - @@ -3302,6 +3351,6 @@ Convenience functions for converting between UTF-8 and the locale encoding. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Version-Information.html b/docs/reference/glib/html/glib-Version-Information.html index 07dd2aa..6f70f1e 100644 --- a/docs/reference/glib/html/glib-Version-Information.html +++ b/docs/reference/glib/html/glib-Version-Information.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -

    c :

    a Unicode character code +a Unicode character code

    outbuf :

    output buffer, must have at least 6 bytes of space. +output buffer, must have at least 6 bytes of space. If NULL, the length will be computed and returned and nothing will be written to outbuf.
    @@ -63,7 +43,9 @@ #define GLIB_MAJOR_VERSION #define GLIB_MINOR_VERSION #define GLIB_MICRO_VERSION -#define GLIB_CHECK_VERSION (major,minor,micro) +#define GLIB_CHECK_VERSION (major, + minor, + micro)
    @@ -94,7 +76,7 @@ at application run time.

    The minor version number of the GLib library. -Like gtk_minor_version, but from the headers used at +Like gtk_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

    @@ -102,11 +84,11 @@ at application run time.

    GLIB_MICRO_VERSION

    -
    #define GLIB_MICRO_VERSION 0
    +
    #define GLIB_MICRO_VERSION 2
     

    The micro version number of the GLib library. -Like gtk_micro_version, but from the headers used at +Like gtk_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

    @@ -121,11 +103,20 @@ Returns as or newer than the passed-in version.

    -

    Example 1. Checking the version of the GLib library

    -
    -  if (!GLIB_CHECK_VERSION (1, 2, 0))
    -    g_error ("GLib version 1.2.0 or above is needed");
    -
    +

    Example 1. Checking the version of the GLib library

    +
    +
    + + + + + + +
    1
    +2
    if (!GLIB_CHECK_VERSION (1, 2, 0))
    +  g_error ("GLib version 1.2.0 or above is needed");
    +
    +


    @@ -154,6 +145,6 @@ as or newer than the passed-in version. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Warnings-and-Assertions.html b/docs/reference/glib/html/glib-Warnings-and-Assertions.html index a92520a..ea3276a 100644 --- a/docs/reference/glib/html/glib-Warnings-and-Assertions.html +++ b/docs/reference/glib/html/glib-Warnings-and-Assertions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -60,26 +40,27 @@
     #include <glib.h>
     
    -void                g_print                             (const gchar *format,
    -                                                         ...);
    -GPrintFunc          g_set_print_handler                 (GPrintFunc func);
    -void                (*GPrintFunc)                       (const gchar *string);
    +void                g_print                             (const gchar *format,
    +                                                         ...);
    +GPrintFunc          g_set_print_handler                 (GPrintFunc func);
    +void                (*GPrintFunc)                       (const gchar *string);
     
    -void                g_printerr                          (const gchar *format,
    -                                                         ...);
    -GPrintFunc          g_set_printerr_handler              (GPrintFunc func);
    +void                g_printerr                          (const gchar *format,
    +                                                         ...);
    +GPrintFunc          g_set_printerr_handler              (GPrintFunc func);
     
     #define             g_return_if_fail                    (expr)
    -#define             g_return_val_if_fail                (expr,val)
    -#define             g_return_if_reached                 ()
    +#define             g_return_val_if_fail                (expr,
    +                                                         val)
    +#define             g_return_if_reached
     #define             g_return_val_if_reached             (val)
     #define             g_warn_if_fail                      (expr)
    -#define             g_warn_if_reached                   ()
    +#define             g_warn_if_reached
     
    -void                g_on_error_query                    (const gchar *prg_name);
    -void                g_on_error_stack_trace              (const gchar *prg_name);
    +void                g_on_error_query                    (const gchar *prg_name);
    +void                g_on_error_stack_trace              (const gchar *prg_name);
     
    -#define             G_BREAKPOINT                        ()
    +#define             G_BREAKPOINT
     
    @@ -89,7 +70,7 @@ These functions provide support for outputting messages.

    The g_return family of macros (g_return_if_fail(), -g_return_val_if_fail(), g_return_if_reached(), g_return_val_if_reached()) +g_return_val_if_fail(), g_return_if_reached(), g_return_val_if_reached()) should only be used for programming errors, a typical use case is checking for invalid parameters at the beginning of a public function. They should not be used if you just mean "if (error) return", they @@ -103,8 +84,8 @@ give a perhaps-helpful warning before giving up.

    Details

    g_print ()

    -
    void                g_print                             (const gchar *format,
    -                                                         ...);
    +
    void                g_print                             (const gchar *format,
    +                                                         ...);

    Outputs a formatted message via the print handler. The default print handler simply outputs the message to stdout. @@ -135,7 +116,7 @@ Instead, libraries should use

    g_set_print_handler ()

    -
    GPrintFunc          g_set_print_handler                 (GPrintFunc func);
    +
    GPrintFunc          g_set_print_handler                 (GPrintFunc func);

    Sets the print handler. Any messages passed to g_print() will be output via the new handler. @@ -162,7 +143,7 @@ widget or a log file for example.


    GPrintFunc ()

    -
    void                (*GPrintFunc)                       (const gchar *string);
    +
    void                (*GPrintFunc)                       (const gchar *string);

    Specifies the type of the print handler functions. These are called with the complete formatted string to output. @@ -179,8 +160,8 @@ These are called with the complete formatted string to output.


    g_printerr ()

    -
    void                g_printerr                          (const gchar *format,
    -                                                         ...);
    +
    void                g_printerr                          (const gchar *format,
    +                                                         ...);

    Outputs a formatted message via the error message handler. The default handler simply outputs the message to stderr. @@ -208,7 +189,7 @@ be used, or the convenience functions

    g_set_printerr_handler ()

    -
    GPrintFunc          g_set_printerr_handler              (GPrintFunc func);
    +
    GPrintFunc          g_set_printerr_handler              (GPrintFunc func);

    Sets the handler for printing error messages. Any messages passed to g_printerr() will be output via the new handler. @@ -279,8 +260,8 @@ true.


    -
    -

    g_return_if_reached()

    +
    +

    g_return_if_reached

    #define             g_return_if_reached()

    Logs a critical message and returns from the current function. @@ -321,8 +302,8 @@ Logs a warning if the expression is not true.

    Since 2.16


    -
    -

    g_warn_if_reached()

    +
    +

    g_warn_if_reached

    #define             g_warn_if_reached()

    Logs a critical warning. @@ -332,33 +313,59 @@ Logs a critical warning.


    g_on_error_query ()

    -
    void                g_on_error_query                    (const gchar *prg_name);
    +
    void                g_on_error_query                    (const gchar *prg_name);

    Prompts the user with [E]xit, [H]alt, show [S]tack trace or [P]roceed. This function is intended to be used for debugging use only. The following example shows how it can be used together with the g_log() functions.

    -
    -#include <glib.h>
    -static void
    -log_handler (const gchar   *log_domain,
    -	     GLogLevelFlags log_level,
    -	     const gchar   *message,
    -	     gpointer       user_data)
    -{
    -  g_log_default_handler (log_domain, log_level, message, user_data);
    -  g_on_error_query (MY_PROGRAM_NAME);
    -}
    -int main (int argc, char *argv[])
    -{
    -  g_log_set_handler (MY_LOG_DOMAIN,
    -		     G_LOG_LEVEL_WARNING |
    -                     G_LOG_LEVEL_ERROR |
    -                     G_LOG_LEVEL_CRITICAL,
    -		     log_handler,
    -		     NULL);
    - /* ... */
    -
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    #include <glib.h>
    +static void
    +log_handler (const gchar   *log_domain,
    +         GLogLevelFlags log_level,
    +         const gchar   *message,
    +         gpointer       user_data)
    +{
    +  g_log_default_handler (log_domain, log_level, message, user_data);
    +  g_on_error_query (MY_PROGRAM_NAME);
    +}
    +int main (int argc, char *argv[])
    +{
    +  g_log_set_handler (MY_LOG_DOMAIN,
    +             G_LOG_LEVEL_WARNING |
    +                     G_LOG_LEVEL_ERROR |
    +                     G_LOG_LEVEL_CRITICAL,
    +             log_handler,
    +             NULL);
    + /* ... */
    +
    +

    If [E]xit is selected, the application terminates with a call to _exit(0). @@ -385,7 +392,7 @@ This function may cause different actions on non-UNIX platforms.

    prg_name :

    the program name, needed by gdb for the [S]tack trace option. If prg_name is NULL, g_get_prgname() is called to get the program name -(which will work correctly if gdk_init() or gtk_init() has been called). +(which will work correctly if gdk_init() or gtk_init() has been called).
    @@ -393,7 +400,7 @@ If prg_name is

    g_on_error_stack_trace ()

    -
    void                g_on_error_stack_trace              (const gchar *prg_name);
    +
    void                g_on_error_stack_trace              (const gchar *prg_name);

    Invokes gdb, which attaches to the current process and shows a stack trace. Called by g_on_error_query() when the [S]tack trace option is selected. @@ -407,14 +414,14 @@ This function may cause different actions on non-UNIX platforms.

    prg_name :

    the program name, needed by gdb for the [S]tack trace option. If prg_name is NULL, g_get_prgname() is called to get the program name -(which will work correctly if gdk_init() or gtk_init() has been called). +(which will work correctly if gdk_init() or gtk_init() has been called).

    -
    -

    G_BREAKPOINT()

    +
    +

    G_BREAKPOINT

    #define             G_BREAKPOINT()

    Inserts a breakpoint instruction into the code. On x86 and alpha systems @@ -426,6 +433,6 @@ a SIGTRAP signal.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-Windows-Compatibility-Functions.html b/docs/reference/glib/html/glib-Windows-Compatibility-Functions.html index cece309..b510785 100644 --- a/docs/reference/glib/html/glib-Windows-Compatibility-Functions.html +++ b/docs/reference/glib/html/glib-Windows-Compatibility-Functions.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -61,22 +41,23 @@ #include <glib.h> #define MAXPATHLEN -gchar* g_win32_error_message (gint error); -gchar* g_win32_getlocale (void); +gchar* g_win32_error_message (gint error); +gchar* g_win32_getlocale (void); gchar* g_win32_get_package_installation_directory - (const gchar *package, - const gchar *dll_name); + (const gchar *package, + const gchar *dll_name); gchar* g_win32_get_package_installation_directory_of_module - (gpointer hmodule); + (gpointer hmodule); gchar* g_win32_get_package_installation_subdirectory - (const gchar *package, - const gchar *dll_name, - const gchar *subdir); -guintg_win32_get_windows_version (void); -gchar* g_win32_locale_filename_from_utf8 (const gchar *utf8filename); -#define G_WIN32_DLLMAIN_FOR_DLL_NAME (static, dll_name) -#define G_WIN32_HAVE_WIDECHAR_API () -#define G_WIN32_IS_NT_BASED () + (const gchar *package, + const gchar *dll_name, + const gchar *subdir); +guintg_win32_get_windows_version (void); +gchar* g_win32_locale_filename_from_utf8 (const gchar *utf8filename); +#define G_WIN32_DLLMAIN_FOR_DLL_NAME (static, + dll_name) +#define G_WIN32_HAVE_WIDECHAR_API +#define G_WIN32_IS_NT_BASED
    @@ -102,20 +83,21 @@ macro

    g_win32_error_message ()

    -
    gchar*              g_win32_error_message               (gint error);
    +
    gchar*              g_win32_error_message               (gint error);

    Translate a Win32 error code (as returned by GetLastError()) into the corresponding message. The message is either language neutral, or in the thread's language, or the user's language, the system's language, or US English (see docs for FormatMessage()). The returned string is in UTF-8. It should be deallocated with -g_free().

    +g_free(). +

    - @@ -129,7 +111,7 @@ returned string is in UTF-8. It should be deallocated with

    g_win32_getlocale ()

    -
    gchar*              g_win32_getlocale                   (void);
    +
    gchar*              g_win32_getlocale                   (void);

    The setlocale() function in the Microsoft C library uses locale names of the form "English_United States.1252" etc. We want the @@ -137,7 +119,8 @@ UNIXish standard form "en_US", "zh_TW" etc. This function gets the current thread locale from Windows - without any encoding info - and returns it as a string of the above form for use in forming file names etc. The returned string should be deallocated with -g_free().

    +g_free(). +

    error :

    error code. +error code.
    @@ -151,8 +134,8 @@ file names etc. The returned string should be deallocated with

    g_win32_get_package_installation_directory ()

    gchar*              g_win32_get_package_installation_directory
    -                                                        (const gchar *package,
    -                                                         const gchar *dll_name);
    + (const gchar *package, + const gchar *dll_name);

    Warning

    g_win32_get_package_installation_directory has been deprecated since version 2.18 and should not be used in newly-written code. Pass the HMODULE of a DLL or EXE to @@ -206,18 +189,19 @@ itself. If that DLL isn't loaded, the function proceeds as if

    If both package and dll_name are NULL, the directory from where the main executable of the process was loaded is used instead in -the same way as above.

    +the same way as above. +

    - - @@ -236,7 +220,7 @@ needed any longer. If the function fails

    g_win32_get_package_installation_directory_of_module ()

    gchar*              g_win32_get_package_installation_directory_of_module
    -                                                        (gpointer hmodule);
    + (gpointer hmodule);

    This function tries to determine the installation directory of a software package based on the location of a DLL of the software @@ -263,13 +247,14 @@ deduce the root of the package installation. The typical use case for this function is to have a DllMain() that saves the handle for the DLL. Then when code in the DLL needs to construct names of files in the installation tree it calls this -function passing the DLL handle.

    +function passing the DLL handle. +

    package :

    You should pass NULL for this. +You should pass NULL for this.

    dll_name :

    The name of a DLL that a package provides in UTF-8, or NULL. +The name of a DLL that a package provides in UTF-8, or NULL.
    - @@ -290,9 +275,9 @@ with

    g_win32_get_package_installation_subdirectory ()

    gchar*              g_win32_get_package_installation_subdirectory
    -                                                        (const gchar *package,
    -                                                         const gchar *dll_name,
    -                                                         const gchar *subdir);
    + (const gchar *package, + const gchar *dll_name, + const gchar *subdir);

    Warning

    g_win32_get_package_installation_subdirectory has been deprecated since version 2.18 and should not be used in newly-written code. Pass the HMODULE of a DLL or EXE to @@ -311,23 +296,24 @@ subdirectory subdir in the return value dll_name parameters. See the documentation for g_win32_get_package_installation_directory() for more details. In particular, note that it is deprecated to pass anything except NULL -as package.

    +as package. +

    hmodule :

    The Win32 handle for a DLL loaded into the current process, or NULL +The Win32 handle for a DLL loaded into the current process, or NULL
    - - - @@ -346,7 +332,7 @@ freed with

    g_win32_get_windows_version ()

    -
    guint               g_win32_get_windows_version         (void);
    +
    guint               g_win32_get_windows_version         (void);

    Returns version information for the Windows operating system the code is running on. See MSDN documentation for the GetVersion() @@ -356,7 +342,8 @@ on NT-based systems, so checking whether your are running on Win9x in your own software is moot. The least significant byte is 4 on Windows NT 4, and 5 on Windows XP. Software that needs really detailled version and feature information should use Win32 API like -GetVersionEx() and VerifyVersionInfo().

    +GetVersionEx() and VerifyVersionInfo(). +

    package :

    You should pass NULL for this. +You should pass NULL for this.

    dll_name :

    The name of a DLL that a package provides, in UTF-8, or NULL. +The name of a DLL that a package provides, in UTF-8, or NULL.

    subdir :

    A subdirectory of the package installation directory, also in UTF-8 +A subdirectory of the package installation directory, also in UTF-8
    @@ -371,7 +358,7 @@ detailled version and feature information should use Win32 API like

    g_win32_locale_filename_from_utf8 ()

    -
    gchar*              g_win32_locale_filename_from_utf8   (const gchar *utf8filename);
    +
    gchar*              g_win32_locale_filename_from_utf8   (const gchar *utf8filename);

    Converts a filename from UTF-8 to the system codepage.

    @@ -394,13 +381,14 @@ possible, g_free() when no longer needed.

    +g_free() when no longer needed. +

    - @@ -449,8 +437,8 @@ On non-Windows platforms, expands to nothing.

    utf8filename :

    a UTF-8 encoded filename. +a UTF-8 encoded filename.

    -
    -

    G_WIN32_HAVE_WIDECHAR_API()

    +
    +

    G_WIN32_HAVE_WIDECHAR_API

    #define G_WIN32_HAVE_WIDECHAR_API() TRUE
     

    @@ -466,8 +454,8 @@ On non-Windows platforms, it is not defined.

    Since 2.6


    -
    -

    G_WIN32_IS_NT_BASED()

    +
    +

    G_WIN32_IS_NT_BASED

    #define G_WIN32_IS_NT_BASED() TRUE
     

    @@ -483,6 +471,6 @@ On non-Windows platforms, it is not defined.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-building.html b/docs/reference/glib/html/glib-building.html index 89f2ab3..807be16 100644 --- a/docs/reference/glib/html/glib-building.html +++ b/docs/reference/glib/html/glib-building.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -80,7 +60,7 @@ How to compile GLib itself

    The GTK+ documentation contains - further details + further details about the build process and ways to influence it.

    @@ -453,6 +433,6 @@ How to compile GLib itself + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-changes.html b/docs/reference/glib/html/glib-changes.html index d724343..576f814 100644 --- a/docs/reference/glib/html/glib-changes.html +++ b/docs/reference/glib/html/glib-changes.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -51,7 +31,7 @@ Incompatible changes made between successing versions of GLib
    -

    Incompatible changes from 2.0 to 2.2

    +

    Incompatible changes from 2.0 to 2.2

    • GLib changed the seeding algorithm for the pseudo-random number @@ -76,7 +56,7 @@ with Glib-2.0 that you need to reproduce exactly.

    -

    Incompatible changes from 1.2 to 2.0

    +

    Incompatible changes from 1.2 to 2.0

    The GNOME 2.0 porting guide on http://developer.gnome.org @@ -174,6 +154,6 @@ Deprecated functions that got removed:

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-compiling.html b/docs/reference/glib/html/glib-compiling.html index 9f739cf..7d1f08e 100644 --- a/docs/reference/glib/html/glib-compiling.html +++ b/docs/reference/glib/html/glib-compiling.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -51,7 +31,7 @@ How to compile your GLib application
    -

    Compiling GLib Applications on UNIX

    +

    Compiling GLib Applications on UNIX

    To compile a GLib application, you need to tell the compiler where to find the GLib header files and libraries. This is done with the @@ -133,6 +113,6 @@ by using the command line option -DG_DISABLE_SINGLE_INCLUD

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-core.html b/docs/reference/glib/html/glib-core.html index eec69bf..0cebc65 100644 --- a/docs/reference/glib/html/glib-core.html +++ b/docs/reference/glib/html/glib-core.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -79,6 +59,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-cross-compiling.html b/docs/reference/glib/html/glib-cross-compiling.html index 73d442c..ef4b315 100644 --- a/docs/reference/glib/html/glib-cross-compiling.html +++ b/docs/reference/glib/html/glib-cross-compiling.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -175,6 +155,6 @@ chmod a-w win32.cache # prevent configure from changing it + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-data-types.html b/docs/reference/glib/html/glib-data-types.html index 71dd3c5..d6815af 100644 --- a/docs/reference/glib/html/glib-data-types.html +++ b/docs/reference/glib/html/glib-data-types.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -135,6 +115,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-fundamentals.html b/docs/reference/glib/html/glib-fundamentals.html index 04acde1..8d26156 100644 --- a/docs/reference/glib/html/glib-fundamentals.html +++ b/docs/reference/glib/html/glib-fundamentals.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -74,6 +54,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-gettextize.html b/docs/reference/glib/html/glib-gettextize.html index 4f4e8a3..8770b3d 100644 --- a/docs/reference/glib/html/glib-gettextize.html +++ b/docs/reference/glib/html/glib-gettextize.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -53,7 +33,7 @@

    glib-gettextize [option...] [directory]

    -

    Description

    +

    Description

    glib-gettextize helps to prepare a source package for being internationalized through gettext. It is a variant of the gettextize that ships with @@ -67,7 +47,7 @@ from gettextize in that it doesn't --no-changelog option).

    -

    Options

    +

    Options

    @@ -100,7 +80,7 @@ force writing of new files even if old ones exist
    -

    See also

    +

    See also

    gettextize(1)

    @@ -108,6 +88,6 @@ force writing of new files even if old ones exist
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-regex-syntax.html b/docs/reference/glib/html/glib-regex-syntax.html index 557465b..c60b781 100644 --- a/docs/reference/glib/html/glib-regex-syntax.html +++ b/docs/reference/glib/html/glib-regex-syntax.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -51,7 +31,7 @@ Syntax and semantics of the regular expressions supported by GRegex
    -

    GRegex regular expression details

    +

    GRegex regular expression details

    A regular expression is a pattern that is matched against a string from left to right. Most characters stand for themselves in a @@ -79,7 +59,7 @@ that are recognized in square brackets. Outside square brackets, the metacharacters are as follows:

    -

    Table 1. Metacharacters outside square brackets

    +

    Table 1. Metacharacters outside square brackets

    @@ -146,7 +126,7 @@ Part of a pattern that is in square brackets is called a "character class". In a character class the only metacharacters are:

    -

    Table 2. Metacharacters inside square brackets

    +

    Table 2. Metacharacters inside square brackets

    @@ -183,7 +163,7 @@ class". In a character class the only metacharacters are:
    -

    Backslash

    +

    Backslash

    The backslash character has several uses. Firstly, if it is followed by a non-alphanumeric character, it takes away any special meaning that @@ -213,7 +193,7 @@ The \Q...\E sequence is recognized both inside and outside character classes.

    -

    Non-printing characters

    +

    Non-printing characters

    A second use of backslash provides a way of encoding non-printing characters in patterns in a visible manner. There is no restriction on the @@ -223,7 +203,7 @@ editing, it is usually easier to use one of the following escape sequences than the binary character it represents:

    -

    Table 3. Non-printing characters

    +

    Table 3. Non-printing characters

    @@ -324,7 +304,7 @@ up to three octal digits following the backslash, and uses them to generate a data character. Any subsequent digits stand for themselves. For example:

    -

    Table 4. Non-printing characters

    +

    Table 4. Non-printing characters

    @@ -388,7 +368,7 @@ Outside a character class, these sequences have different meanings (see below).
    -

    Absolute and relative back references

    +

    Absolute and relative back references

    The sequence \g followed by a positive or negative number, optionally enclosed in braces, is an absolute or relative back reference. Back references are @@ -397,13 +377,13 @@ discussed later, following the discussion of parenthesized subpatterns.


    -

    Generic character types

    +

    Generic character types

    Another use of backslash is for specifying generic character types. The following are always recognized:

    -

    Table 5. Generic characters

    +

    Table 5. Generic characters

    @@ -467,7 +447,7 @@ Characters with values greater than 128 never match \d,
    -

    Newline sequences

    +

    Newline sequences

    Outside a character class, the escape sequence \R matches any Unicode newline sequence. This particular group matches either the two-character sequence CR followed by @@ -479,13 +459,13 @@ cannot be split. Inside a character class, \R matches the letter "R".


    -

    Unicode character properties

    +

    Unicode character properties

    To support generic character types there are three additional escape sequences, they are:

    -

    Table 6. Generic character types

    +

    Table 6. Generic character types

    @@ -615,7 +595,7 @@ examples have the same effect: The following general category property codes are supported:

    -

    Table 7. Property codes

    +

    Table 7. Property codes

    @@ -818,7 +798,7 @@ characters. That is why the traditional escape sequences such as \d and
    -

    Simple assertions

    +

    Simple assertions

    The final use of backslash is for certain simple assertions. An assertion specifies a condition that has to be met at a particular point in @@ -827,7 +807,7 @@ use of subpatterns for more complicated assertions is described below. The backslashed assertions are:

    -

    Table 8. Simple assertions

    +

    Table 8. Simple assertions

    @@ -909,7 +889,7 @@ in the compiled regular expression.
    -

    Circumflex and dollar

    +

    Circumflex and dollar

    Outside a character class, in the default matching mode, the circumflex character is an assertion that is true only if the current matching @@ -967,7 +947,7 @@ is set.

    -

    Full stop (period, dot)

    +

    Full stop (period, dot)

    Outside a character class, a dot in the pattern matches any one character in the string, including a non-printing character, but not (by @@ -1000,7 +980,7 @@ special meaning in a character class.

    -

    Matching a single byte

    +

    Matching a single byte

    Outside a character class, the escape sequence \C matches any one byte, both in and out of UTF-8 mode. Unlike a dot, it always matches any line @@ -1017,7 +997,7 @@ the length of the lookbehind.

    -

    Square brackets and character classes

    +

    Square brackets and character classes

    An opening square bracket introduces a character class, terminated by a closing square bracket. A closing square bracket on its own is not special. If a closing square bracket is required as a member of the class, @@ -1102,7 +1082,7 @@ escaping other non-alphanumeric characters does no harm.

    -

    Posix character classes

    +

    Posix character classes

    GRegex supports the POSIX notation for character classes. This uses names enclosed by [: and :] within the enclosing square brackets. For example, @@ -1115,7 +1095,7 @@ matches "0", "1", any alphabetic character, or "%". The supported class names are

    -

    Table 9. Posix classes

    +

    Table 9. Posix classes

    @@ -1210,7 +1190,7 @@ of the POSIX character classes.

    -

    Vertical bar

    +

    Vertical bar

    Vertical bar characters are used to separate alternative patterns. For example, the pattern @@ -1226,7 +1206,7 @@ left to right, and the first one that succeeds is used. If the alternatives are

    -

    Internal option setting

    +

    Internal option setting

    The settings of the G_REGEX_CASELESS, G_REGEX_MULTILINE, G_REGEX_MULTILINE, and G_REGEX_EXTENDED options can be changed from within the pattern by a @@ -1234,7 +1214,7 @@ sequence of Perl-style option letters enclosed between "(?" and ")". The option letters are

    -

    Table 10. Option settings

    +

    Table 10. Option settings

    @@ -1308,7 +1288,7 @@ the characters U, X and J respectively.

    -

    Subpatterns

    +

    Subpatterns

    Subpatterns are delimited by parentheses (round brackets), which can be nested. Turning part of a pattern into a subpattern does two things: @@ -1372,7 +1352,7 @@ subsequent branches, so the above patterns match "SUNDAY" as well as

    -

    Named subpatterns

    +

    Named subpatterns

    Identifying capturing parentheses by number is simple, but it can be very hard to keep track of the numbers in complicated regular expressions. @@ -1413,7 +1393,7 @@ pattern, the one that corresponds to the lowest number is used.

    -

    Repetition

    +

    Repetition

    Repetition is specified by quantifiers, which can follow any of the following items: @@ -1476,7 +1456,7 @@ For convenience, the three most common quantifiers have single-character abbreviations:

    -

    Table 11. Abbreviations for quantifiers

    +

    Table 11. Abbreviations for quantifiers

    @@ -1617,7 +1597,7 @@ matches "aba" the value of the second captured substring is "b".

    -

    Atomic grouping and possessive quantifiers

    +

    Atomic grouping and possessive quantifiers

    With both maximizing ("greedy") and minimizing ("ungreedy" or "lazy") repetition, failure of what follows normally causes the repeated @@ -1735,7 +1715,7 @@ sequences of non-digits cannot be broken, and failure happens quickly.

    -

    Back references

    +

    Back references

    Outside a character class, a backslash followed by a digit greater than 0 (and possibly further digits) is a back reference to a capturing subpattern @@ -1844,7 +1824,7 @@ the example above, or by a quantifier with a minimum of zero.

    -

    Assertions

    +

    Assertions

    An assertion is a test on the characters following or preceding the current matching point that does not actually consume any characters. @@ -1868,7 +1848,7 @@ out only for positive assertions, because it does not make sense for negative assertions.

    -

    Lookahead assertions

    +

    Lookahead assertions

    Lookahead assertions start with (?= for positive assertions and (?! for negative assertions. For example, @@ -1905,7 +1885,7 @@ string must always fail.


    -

    Lookbehind assertions

    +

    Lookbehind assertions

    Lookbehind assertions start with (?<= for positive assertions and (?<! for negative assertions. For example, @@ -1994,7 +1974,7 @@ processing time.


    -

    Using multiple assertions

    +

    Using multiple assertions

    Several assertions (of any sort) may occur in succession. For example,

    @@ -2039,7 +2019,7 @@ three characters that are not "999".
    -

    Conditional subpatterns

    +

    Conditional subpatterns

    It is possible to cause the matching process to obey a subpattern conditionally or to choose between two alternative subpatterns, depending @@ -2060,7 +2040,7 @@ There are four kinds of condition: references to subpatterns, references to recursion, a pseudo-condition called DEFINE, and assertions.

    -

    Checking for a used subpattern by number

    +

    Checking for a used subpattern by number

    If the text between the parentheses consists of a sequence of digits, the condition is true if the capturing subpattern of that number has previously @@ -2089,7 +2069,7 @@ optionally enclosed in parentheses.


    -

    Checking for a used subpattern by name

    +

    Checking for a used subpattern by name

    Perl uses the syntax (?(<name>)...) or (?('name')...) to test for a used subpattern by name, the Python syntax (?(name)...) is also recognized. However, @@ -2108,7 +2088,7 @@ Rewriting the above example to use a named subpattern gives this:


    -

    Checking for pattern recursion

    +

    Checking for pattern recursion

    If the condition is the string (R), and there is no subpattern with the name R, the condition is true if a recursive call to the whole pattern or any @@ -2131,7 +2111,7 @@ patterns are described below.


    -

    Defining subpatterns for use by reference only

    +

    Defining subpatterns for use by reference only

    If the condition is the string (DEFINE), and there is no subpattern with the name DEFINE, the condition is always false. In this case, there may be only one @@ -2159,7 +2139,7 @@ each end.


    -

    Assertion conditions

    +

    Assertion conditions

    If the condition is not in any of the above formats, it must be an assertion. This may be a positive or negative lookahead or lookbehind @@ -2182,7 +2162,7 @@ letters and dd are digits.

    -

    Comments

    +

    Comments

    The sequence (?# marks the start of a comment that continues up to the next closing parenthesis. Nested parentheses are not permitted. The @@ -2196,7 +2176,7 @@ immediately after the next newline in the pattern.

    -

    Recursive patterns

    +

    Recursive patterns

    Consider the problem of matching a string in parentheses, allowing for unlimited nested parentheses. Without the use of recursion, the best @@ -2328,7 +2308,7 @@ The (?R) item is the actual recursive call.

    -

    Subpatterns as subroutines

    +

    Subpatterns as subroutines

    If the syntax for a recursive subpattern reference (either by number or by name) is used outside the parentheses to which it refers, it operates @@ -2370,7 +2350,7 @@ processing option does not affect the called subpattern.

    -

    Copyright

    +

    Copyright

    This document was copied and adapted from the PCRE documentation, specifically from the man page for pcrepattern. @@ -2410,6 +2390,6 @@ POSSIBILITY OF SUCH DAMAGE.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib-resources.html b/docs/reference/glib/html/glib-resources.html index f01baa5..8104a3b 100644 --- a/docs/reference/glib/html/glib-resources.html +++ b/docs/reference/glib/html/glib-resources.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -51,7 +31,7 @@ Getting help with GLib
    -

    Filing a bug report or feature request

    +

    Filing a bug report or feature request

    If you encounter a bug, misfeature, or missing feature in GLib, please file a bug report on @@ -73,7 +53,7 @@ the way to be sure the GLib developers won't forget about an issue.

    -

    Submitting Patches

    +

    Submitting Patches

    If you develop a bugfix or enhancement for GLib, please file that in Bugzilla as well. Bugzilla allows you to attach files; please attach a @@ -90,7 +70,7 @@ list and not in Bugzilla, it's likely to slip through the cracks.

    -

    Mailing lists

    +

    Mailing lists

    There are several mailing lists dedicated to GTK+ and related libraries. Discussion of GLib generally takes place on these lists. @@ -136,6 +116,6 @@ documentation system (used to document GTK+ and Glib), and for work on the GTK+

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-running.html b/docs/reference/glib/html/glib-running.html index e0a9e80..4bb7b38 100644 --- a/docs/reference/glib/html/glib-running.html +++ b/docs/reference/glib/html/glib-running.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -51,9 +31,9 @@ How to run and debug your GLib application
    -

    Running and debugging GLib Applications

    +

    Running and debugging GLib Applications

    -

    Environment variables

    +

    Environment variables

    GLib inspects a few of environment variables in addition to standard variables like LANG, PATH or HOME. @@ -229,7 +209,7 @@ returned by functions like strftime().


    -

    Traps and traces

    +

    Traps and traces

    @@ -270,7 +250,7 @@ is 20.


    -

    Gdb debugging macros

    +

    Gdb debugging macros

    glib ships with a set of python macros for the gdb debugger. These includes pretty printers for lists, hashtables and gobject types. It also has a backtrace filter @@ -301,7 +281,7 @@ Which would print the contents of each widget in a list of widgets.


    -

    Memory statistics

    +

    Memory statistics

    g_mem_profile() will output a summary g_malloc() memory usage, if memory profiling has been enabled by calling @@ -317,6 +297,6 @@ output details about the memory usage of the slice allocator.

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/glib-utilities.html b/docs/reference/glib/html/glib-utilities.html index f3c9ea7..eb95173 100644 --- a/docs/reference/glib/html/glib-utilities.html +++ b/docs/reference/glib/html/glib-utilities.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -127,6 +107,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/glib.devhelp b/docs/reference/glib/html/glib.devhelp index d14da5f..ab166df 100644 --- a/docs/reference/glib/html/glib.devhelp +++ b/docs/reference/glib/html/glib.devhelp @@ -109,25 +109,25 @@ - + - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + @@ -355,8 +355,8 @@ - - + + @@ -383,7 +383,7 @@ - + @@ -688,13 +688,13 @@ - + - + - + @@ -980,7 +980,7 @@ - + @@ -1412,12 +1412,12 @@ - - - - - - + + + + + + @@ -1437,19 +1437,19 @@ - - + + - + - + @@ -1474,8 +1474,8 @@ - - + + @@ -1976,7 +1976,7 @@ - + @@ -2077,8 +2077,8 @@ - - - + + + diff --git a/docs/reference/glib/html/glib.devhelp2 b/docs/reference/glib/html/glib.devhelp2 index 2ba1240..da252e8 100644 --- a/docs/reference/glib/html/glib.devhelp2 +++ b/docs/reference/glib/html/glib.devhelp2 @@ -109,25 +109,25 @@ - + - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + @@ -355,8 +355,8 @@ - - + + @@ -383,7 +383,7 @@ - + @@ -688,13 +688,13 @@ - + - + - + @@ -980,7 +980,7 @@ - + @@ -1412,12 +1412,12 @@ - - - - - - + + + + + + @@ -1437,19 +1437,19 @@ - - + + - + - + @@ -1474,8 +1474,8 @@ - - + + @@ -1976,7 +1976,7 @@ - + @@ -2077,9 +2077,9 @@ - - - + + + diff --git a/docs/reference/glib/html/glib.html b/docs/reference/glib/html/glib.html index ddd77d7..bd3c44c 100644 --- a/docs/reference/glib/html/glib.html +++ b/docs/reference/glib/html/glib.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -95,6 +75,6 @@ synchronize their operation. + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/gtester-report.html b/docs/reference/glib/html/gtester-report.html index 46b4926..a7591bb 100644 --- a/docs/reference/glib/html/gtester-report.html +++ b/docs/reference/glib/html/gtester-report.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -53,12 +33,12 @@

    gtester-report [option...] [gtester-log]

    -

    Description

    +

    Description

    gtester-report is a script which converts the XML output generated by gtester into HTML.

    -

    Options

    +

    Options

    @@ -79,7 +59,7 @@ print version information and exit
    -

    See also

    +

    See also

    gtester(1)

    @@ -87,6 +67,6 @@ print version information and exit
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/gtester.html b/docs/reference/glib/html/gtester.html index 097a5f7..f525e83 100644 --- a/docs/reference/glib/html/gtester.html +++ b/docs/reference/glib/html/gtester.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -53,7 +33,7 @@

    gtester [option...] [testprogram]

    -

    Description

    +

    Description

    gtester is a utility to run unit tests that have been written using the GLib test framework.

    @@ -63,7 +43,7 @@ writes an XML report of the test results, which can be converted into HTML using the gtester-report utility.

    -

    Options

    +

    Options

    @@ -138,7 +118,7 @@ report success per testcase
    -

    See also

    +

    See also

    gtester-report(1)

    @@ -146,6 +126,6 @@ report success per testcase
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/gvariant-format-strings.html b/docs/reference/glib/html/gvariant-format-strings.html index 71b21ae..9a465fc 100644 --- a/docs/reference/glib/html/gvariant-format-strings.html +++ b/docs/reference/glib/html/gvariant-format-strings.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -42,7 +22,7 @@
    -

    Variable Argument Conversions

    +

    Variable Argument Conversions

    This page attempts to document how to perform variable argument conversions with GVariant.

    @@ -58,7 +38,7 @@

    -

    Syntax

    +

    Syntax

    This section exhaustively describes all possibilities for GVariant format strings. There are no valid forms of format strings other than those described here. Please note that the format string syntax is likely to expand in the @@ -90,7 +70,7 @@

    -

    Symbols

    +

    Symbols

    The following table describes the rough meaning of symbols that may appear inside a GVariant format string. Each symbol is described in detail in its own section, including usage examples. @@ -480,26 +460,52 @@ it operates with pointers. The pointers must always point to a memory region of exactly the correct size.

    -

    Examples

    -
    -GVariant *value1, *value2, *value3, *value4;
    +

    Examples

    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    GVariant *value1, *value2, *value3, *value4;
     
    -value1 = g_variant_new ("y", 200);
    -value2 = g_variant_new ("b", TRUE);
    -value3 = g_variant_new ("d", 37.5):
    -value4 = g_variant_new ("x", G_GINT64_CONSTANT (998877665544332211));
    +value1 = g_variant_new ("y", 200);
    +value2 = g_variant_new ("b", TRUE);
    +value3 = g_variant_new ("d", 37.5):
    +value4 = g_variant_new ("x", G_GINT64_CONSTANT (998877665544332211));
     
    -{
    -  gdouble floating;
    -  gboolean truth;
    -  gint64 bignum;
    +{
    +  gdouble floating;
    +  gboolean truth;
    +  gint64 bignum;
     
     
    -  g_variant_get (value1, "y", NULL);      /* ignore the value. */
    -  g_variant_get (value2, "b", &truth);
    -  g_variant_get (value3, "d", &floating);
    -  g_variant_get (value4, "x", &bignum);
    -}
    + g_variant_get (value1, "y", NULL); /* ignore the value. */ + g_variant_get (value2, "b", &truth); + g_variant_get (value3, "d", &floating); + g_variant_get (value4, "x", &bignum); +}
    + +
    @@ -528,25 +534,50 @@ value4 = g_variant_new ("x", G_GINT64_CONSTANT (998877665544332211)); string should be ignored (in which case no copy is made).

    -

    Examples

    -
    -GVariant *value1, *value2, *value3;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    GVariant *value1, *value2, *value3;
     
    -value1 = g_variant_new ("s", "hello world!");
    -value2 = g_variant_new ("o", "/must/be/a/valid/path");
    -value3 = g_variant_new ("g", "iias");
    +value1 = g_variant_new ("s", "hello world!");
    +value2 = g_variant_new ("o", "/must/be/a/valid/path");
    +value3 = g_variant_new ("g", "iias");
     
    -#if 0
    -  g_variant_new ("s", NULL);      /* not valid: NULL is not a string. */
    -#endif
    +#if 0
    +  g_variant_new ("s", NULL);      /* not valid: NULL is not a string. */
    +#endif
     
    -{
    -  gchar *result;
    +{
    +  gchar *result;
    +
    +  g_variant_get (value1, "s", &result);
    +  g_print ("It was '%s'\n", result);
    +  g_free (result);
    +}
    +
    - g_variant_get (value1, "s", &result); - g_print ("It was '%s'\n", result); - g_free (result); -}

    @@ -572,17 +603,34 @@ value3 = g_variant_new ("g", "iias"); ignored (in which case no new reference is created).

    -

    Examples

    -
    -GVariant *x, *y;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    GVariant *x, *y;
     
    -/* the following two lines are equivalent: */
    -x = g_variant_new ("v", y);
    -x = g_variant_new_variant (y);
    +/* the following two lines are equivalent: */
    +x = g_variant_new ("v", y);
    +x = g_variant_new_variant (y);
    +
    +/* as are these: */
    +g_variant_get (x, "v", &y);
    +y = g_variant_get_variant (x);
    +
    -/* as are these: */ -g_variant_get (x, "v", &y); -y = g_variant_get_variant (x);

    @@ -614,27 +662,54 @@ y = g_variant_get_variant (x); should be ignored.

    -

    Examples

    -
    -GVariantBuilder *builder;
    -GVariant *value;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    GVariantBuilder *builder;
    +GVariant *value;
    +
    +builder = g_variant_builder_new (G_VARIANT_TYPE_CLASS_ARRAY, NULL);
    +g_variant_builder_add (builder, "s", "when");
    +g_variant_builder_add (builder, "s", "in");
    +g_variant_builder_add (builder, "s", "the");
    +g_variant_builder_add (builder, "s", "course");
    +value = g_variant_new ("as", builder);
     
    -builder = g_variant_builder_new (G_VARIANT_TYPE_CLASS_ARRAY, NULL);
    -g_variant_builder_add (builder, "s", "when");
    -g_variant_builder_add (builder, "s", "in");
    -g_variant_builder_add (builder, "s", "the");
    -g_variant_builder_add (builder, "s", "course");
    -value = g_variant_new ("as", builder);
    +{
    +  GVariantIter *iter;
    +  gchar *str;
     
    -{
    -  GVariantIter *iter;
    -  gchar *str;
    +  g_variant_get (value, "as", &iter);
    +  while (g_variant_iter_loop (iter, "s", &str))
    +    g_print ("%s\n");
    +  g_variant_iter_unref (iter);
    +}
    +
    - g_variant_get (value, "as", &iter); - while (g_variant_iter_loop (iter, "s", &str)) - g_print ("%s\n"); - g_variant_iter_unref (iter); -}

    @@ -687,63 +762,126 @@ value = g_variant_new ("as", builder); but have their values set to binary zero.

    -

    Examples

    -
    -GVariant *value1, *value2, *value3, *value4, *value5, *value6;
    -value1 = g_variant_new ("ms", "Hello world");
    -value2 = g_variant_new ("ms", NULL);
    -value3 = g_variant_new ("(m(ii)s)", TRUE, 123, 456, "Done");
    -value4 = g_variant_new ("(m(ii)s)", FALSE, -1, -1, "Done");          /* both '-1' are ignored. */
    -value5 = g_variant_new ("(m@(ii)s)", NULL, "Done");
    -
    -{
    -  GVariant *contents;
    -  const gchar *cstr;
    -  gboolean just;
    -  gint32 x, y;
    -  gchar *str;
    -
    -  g_variant_get (value1, "ms", &str);
    -  if (str != NULL)
    -    g_print ("str: %s\n", str);
    -  else
    -    g_print ("it was null\n");
    -  g_free (str);
    -
    -
    -  g_variant_get (value2, "m&s", &cstr);
    -  if (cstr != NULL)
    -    g_print ("str: %s\n", cstr);
    -  else
    -    g_print ("it was null\n");
    -  /* don't free 'cstr' */
    -
    -
    -  /* NULL passed for the gboolean *, but two 'gint32 *' still collected */
    -  g_variant_get (value3, "(m(ii)s)", NULL, NULL, NULL, &str);
    -  g_print ("string is %s\n", str);
    -  g_free (str);
    -
    -  /* note: &s used, so g_free() not needed */
    -  g_variant_get (value4, "(m(ii)&s)", &just, &x, &y, &cstr);
    -  if (just)
    -    g_print ("it was (%d, %d)\n", x, y);
    -  else
    -    g_print ("it was null\n");
    -  g_print ("string is %s\n", cstr);
    -  /* don't free 'cstr' */
    -
    -
    -  g_variant_get (value5, "(m*s)", &contents, NULL); /* ignore the string. */
    -  if (contents != NULL)
    -    {
    -      g_variant_get (contents, "(ii)", &x, &y);
    -      g_print ("it was (%d, %d)\n", x, y);
    -      g_variant_unref (contents);
    -    }
    -  else
    -    g_print ("it was null\n");
    -}
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    +35
    +36
    +37
    +38
    +39
    +40
    +41
    +42
    +43
    +44
    +45
    +46
    +47
    +48
    +49
    +50
    +51
    +52
    +53
    +54
    +55
    GVariant *value1, *value2, *value3, *value4, *value5, *value6;
    +value1 = g_variant_new ("ms", "Hello world");
    +value2 = g_variant_new ("ms", NULL);
    +value3 = g_variant_new ("(m(ii)s)", TRUE, 123, 456, "Done");
    +value4 = g_variant_new ("(m(ii)s)", FALSE, -1, -1, "Done");          /* both '-1' are ignored. */
    +value5 = g_variant_new ("(m@(ii)s)", NULL, "Done");
    +
    +{
    +  GVariant *contents;
    +  const gchar *cstr;
    +  gboolean just;
    +  gint32 x, y;
    +  gchar *str;
    +
    +  g_variant_get (value1, "ms", &str);
    +  if (str != NULL)
    +    g_print ("str: %s\n", str);
    +  else
    +    g_print ("it was null\n");
    +  g_free (str);
    +
    +
    +  g_variant_get (value2, "m&s", &cstr);
    +  if (cstr != NULL)
    +    g_print ("str: %s\n", cstr);
    +  else
    +    g_print ("it was null\n");
    +  /* don't free 'cstr' */
    +
    +
    +  /* NULL passed for the gboolean *, but two 'gint32 *' still collected */
    +  g_variant_get (value3, "(m(ii)s)", NULL, NULL, NULL, &str);
    +  g_print ("string is %s\n", str);
    +  g_free (str);
    +
    +  /* note: &s used, so g_free() not needed */
    +  g_variant_get (value4, "(m(ii)&s)", &just, &x, &y, &cstr);
    +  if (just)
    +    g_print ("it was (%d, %d)\n", x, y);
    +  else
    +    g_print ("it was null\n");
    +  g_print ("string is %s\n", cstr);
    +  /* don't free 'cstr' */
    +
    +
    +  g_variant_get (value5, "(m*s)", &contents, NULL); /* ignore the string. */
    +  if (contents != NULL)
    +    {
    +      g_variant_get (contents, "(ii)", &x, &y);
    +      g_print ("it was (%d, %d)\n", x, y);
    +      g_variant_unref (contents);
    +    }
    +  else
    +    g_print ("it was null\n");
    +}
    +
    +

    @@ -758,23 +896,46 @@ value5 = g_variant_new ("(m@(ii)s)", NULL, "Done"); Tuples are handled by handling each item in the tuple, in sequence. Each item is handled in the usual way.

    -

    Examples

    -
    -GVariant *value1, *value2;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    GVariant *value1, *value2;
    +
    +value1 = g_variant_new ("(s(ii))", "Hello", 55, 77);
    +value2 = g_variant_new ("()");
     
    -value1 = g_variant_new ("(s(ii))", "Hello", 55, 77);
    -value2 = g_variant_new ("()");
    +{
    +  gchar *string;
    +  gint x, y;
     
    -{
    -  gchar *string;
    -  gint x, y;
    +  g_variant_get (value1, "(s(ii))", &string, &x, &y);
    +  g_print ("%s, %d, %d\n", string, x, y);
    +  g_free (string);
     
    -  g_variant_get (value1, "(s(ii))", &string, &x, &y);
    -  g_print ("%s, %d, %d\n", string, x, y);
    -  g_free (string);
    +  g_variant_get (value2, "()");   /* do nothing... */
    +}
    +
    - g_variant_get (value2, "()"); /* do nothing... */ -}

    @@ -789,15 +950,30 @@ value2 = g_variant_new ("()"); Dictionary entries are handled by handling first the key, then the value. Each is handled in the usual way.

    -

    Examples

    -
    -GVariantBuilder *b;
    -GVariant *dict;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    GVariantBuilder *b;
    +GVariant *dict;
    +
    +b = g_variant_builder_new (G_VARIANT_TYPE_CLASS_ARRAY, G_VARIANT_TYPE ("a{sv}"));
    +g_variant_builder_add (b, "{sv}", "name", g_variant_new_string ("foo"));
    +g_variant_builder_add (b, "{sv}", "timeout", g_variant_new_int32 (10));
    +dict = g_variant_builder_end (b);
    +
    -b = g_variant_builder_new (G_VARIANT_TYPE_CLASS_ARRAY, G_VARIANT_TYPE ("a{sv}")); -g_variant_builder_add (b, "{sv}", "name", g_variant_new_string ("foo")); -g_variant_builder_add (b, "{sv}", "timeout", g_variant_new_int32 (10)); -dict = g_variant_builder_end (b);

    @@ -837,31 +1013,62 @@ dict = g_variant_builder_end (b); improvements in type safety and code self-documentation.

    -

    Examples

    -
    -GVariant *value1, *value2;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    GVariant *value1, *value2;
    +
    +value1 = g_variant_new ("(i@ii)", 44, g_variant_new_int32 (55), 66);
     
    -value1 = g_variant_new ("(i@ii)", 44, g_variant_new_int32 (55), 66);
    +/* note: consumes floating reference count on 'value1' */
    +value2 = g_variant_new ("(@(iii)*)", value1, g_variant_new_string ("foo"));
     
    -/* note: consumes floating reference count on 'value1' */
    -value2 = g_variant_new ("(@(iii)*)", value1, g_variant_new_string ("foo"));
    +{
    +  const gchar *string;
    +  GVariant *tmp;
    +  gsize length;
    +  gint x, y, z;
     
    -{
    -  const gchar *string;
    -  GVariant *tmp;
    -  gsize length;
    -  gint x, y, z;
    +  g_variant_get (value2, "((iii)*)", &x, &y, &z, &tmp);
    +  string = g_variant_get_string (tmp, &length);
    +  g_print ("it is %d %d %d %s (length=%d)\n", x, y, z, string, (int) length);
    +  g_variant_unref (tmp);
     
    -  g_variant_get (value2, "((iii)*)", &x, &y, &z, &tmp);
    -  string = g_variant_get_string (tmp, &length);
    -  g_print ("it is %d %d %d %s (length=%d)\n", x, y, z, string, (int) length);
    -  g_variant_unref (tmp);
    +  /* quick way to skip all the values in a tuple */
    +  g_variant_get (value2, "(rs)", NULL, &string); /* or "(@(iii)s)" */
    +  g_print ("i only got the string: %s\n", string);
    +  g_free (string);
    +}
    +
    - /* quick way to skip all the values in a tuple */ - g_variant_get (value2, "(rs)", NULL, &string); /* or "(@(iii)s)" */ - g_print ("i only got the string: %s\n", string); - g_free (string); -}

    @@ -886,17 +1093,34 @@ value2 = g_variant_new ("(@(iii)*)", value1, g_variant_new_string ("foo")); always be properly nul-terminated.

    -

    Examples

    -
    -{
    -  const gchar *str;
    -  GVariant *value;
    +

    Examples

    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    {
    +  const gchar *str;
    +  GVariant *value;
    +
    +  value = g_variant_new ("&s", "hello world");
    +  str = g_variant_get ("&s", &str);
    +  g_print ("string is: %s\n", str);
    +  /* no need to free str */
    +}
    +
    - value = g_variant_new ("&s", "hello world"); - str = g_variant_get ("&s", &str); - g_print ("string is: %s\n", str); - /* no need to free str */ -}

    @@ -942,6 +1166,6 @@ value2 = g_variant_new ("(@(iii)*)", value1, g_variant_new_string ("foo")); + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/html/index.html b/docs/reference/glib/html/index.html index a3e160a..fe41f82 100644 --- a/docs/reference/glib/html/index.html +++ b/docs/reference/glib/html/index.html @@ -6,28 +6,8 @@ - + - - - - - - - - - - - - - - - - - - - -
    @@ -35,7 +15,7 @@

    - for GLib 2.24.0 + for GLib 2.24.2 The latest version of this documentation can be found on-line at http://library.gnome.org/devel/glib/unstable/. @@ -351,6 +331,6 @@ Getting help with GLib

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/glib/html/index.sgml b/docs/reference/glib/html/index.sgml index a05938e..afbabde 100644 --- a/docs/reference/glib/html/index.sgml +++ b/docs/reference/glib/html/index.sgml @@ -1,4 +1,3 @@ - diff --git a/docs/reference/glib/html/style.css b/docs/reference/glib/html/style.css index e31596b..82115eb 100644 --- a/docs/reference/glib/html/style.css +++ b/docs/reference/glib/html/style.css @@ -211,19 +211,19 @@ h2 .extralinks, h3 .extralinks /* code listings */ -.programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.programlisting .function { color: #000000; font-weight: bold; } -.programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ -.programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.programlisting .normal { color: #000000; } -.programlisting .number { color: #75507b; } /* tango: plum 2 */ -.programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.programlisting .type { color: #000000; } -.programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ +.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ +.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ +.listing_code .programlisting .function { color: #000000; font-weight: bold; } +.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ +.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ +.listing_code .programlisting .normal { color: #000000; } +.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ +.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ +.listing_code .programlisting .type { color: #000000; } +.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ +.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ .listing_frame { /* tango:sky blue 1 */ diff --git a/docs/reference/glib/html/tools.html b/docs/reference/glib/html/tools.html index 11019a6..85be7d8 100644 --- a/docs/reference/glib/html/tools.html +++ b/docs/reference/glib/html/tools.html @@ -8,28 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - @@ -56,6 +36,6 @@ + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/glib/tmpl/allocators.sgml b/docs/reference/glib/tmpl/allocators.sgml index 191ff8a..6dd0448 100644 --- a/docs/reference/glib/tmpl/allocators.sgml +++ b/docs/reference/glib/tmpl/allocators.sgml @@ -19,6 +19,9 @@ Memory Allocators + + + diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml index e001919..2eea9b7 100644 --- a/docs/reference/glib/tmpl/arrays.sgml +++ b/docs/reference/glib/tmpl/arrays.sgml @@ -19,6 +19,9 @@ Arrays + + + diff --git a/docs/reference/glib/tmpl/arrays_byte.sgml b/docs/reference/glib/tmpl/arrays_byte.sgml index 59d9d85..577fb39 100644 --- a/docs/reference/glib/tmpl/arrays_byte.sgml +++ b/docs/reference/glib/tmpl/arrays_byte.sgml @@ -19,6 +19,9 @@ Byte Arrays + + + @@ -32,6 +35,7 @@ Byte Arrays +@void: @Returns: diff --git a/docs/reference/glib/tmpl/arrays_pointer.sgml b/docs/reference/glib/tmpl/arrays_pointer.sgml index dec6dff..4a16cd1 100644 --- a/docs/reference/glib/tmpl/arrays_pointer.sgml +++ b/docs/reference/glib/tmpl/arrays_pointer.sgml @@ -19,6 +19,9 @@ Pointer Arrays + + + @@ -32,6 +35,7 @@ Pointer Arrays +@void: @Returns: diff --git a/docs/reference/glib/tmpl/async_queues.sgml b/docs/reference/glib/tmpl/async_queues.sgml index 79dbec8..7a58f3e 100644 --- a/docs/reference/glib/tmpl/async_queues.sgml +++ b/docs/reference/glib/tmpl/async_queues.sgml @@ -66,6 +66,9 @@ locking function variants (those without the suffix _unlocked) + + + The #GAsyncQueue struct is an opaque data structure, which represents @@ -77,6 +80,7 @@ an asynchronous queue. It should only be accessed through the +@void: @Returns: diff --git a/docs/reference/glib/tmpl/atomic_operations.sgml b/docs/reference/glib/tmpl/atomic_operations.sgml index 13ca69a..d7eab3f 100644 --- a/docs/reference/glib/tmpl/atomic_operations.sgml +++ b/docs/reference/glib/tmpl/atomic_operations.sgml @@ -65,16 +65,18 @@ g_atomic_pointer_compare_and_exchange() respectively. + + + Reads the value of the integer pointed to by @atomic. Also acts as a memory barrier. +@atomic: a pointer to an integer @Returns: the value of *@atomic @Since: 2.4 - -@atomic: a pointer to an integer @@ -83,10 +85,9 @@ Sets the value of the integer pointed to by @atomic. Also acts as a memory barrier. -@Since: 2.10 - @atomic: a pointer to an integer @newval: the new value +@Since: 2.10 @@ -95,10 +96,9 @@ Atomically adds @val to the integer pointed to by @atomic. Also acts as a memory barrier. -@Since: 2.4 - @atomic: a pointer to an integer. @val: the value to add to *@atomic. +@Since: 2.4 @@ -108,11 +108,10 @@ the value of *@atomic just before the addition took place. Also acts as a memory barrier. -@Returns: the value of *@atomic before the addition. -@Since: 2.4 - @atomic: a pointer to an integer. @val: the value to add to *@atomic. +@Returns: the value of *@atomic before the addition. +@Since: 2.4 @@ -122,12 +121,11 @@ if they are equal, atomically exchanges *@atomic with @newval. Also acts as a memory barrier. -@Returns: %TRUE, if *@atomic was equal @oldval. %FALSE otherwise. -@Since: 2.4 - @atomic: a pointer to an integer. @oldval: the assumed old value of *@atomic. @newval: the new value of *@atomic. +@Returns: %TRUE, if *@atomic was equal @oldval. %FALSE otherwise. +@Since: 2.4 @@ -136,10 +134,9 @@ Reads the value of the pointer pointed to by @atomic. Also acts as a memory barrier. +@atomic: a pointer to a #gpointer. @Returns: the value to add to *@atomic. @Since: 2.4 - -@atomic: a pointer to a #gpointer. @@ -148,10 +145,9 @@ Sets the value of the pointer pointed to by @atomic. Also acts as a memory barrier. -@Since: 2.10 - @atomic: a pointer to a #gpointer @newval: the new value +@Since: 2.10 @@ -161,12 +157,11 @@ if they are equal, atomically exchanges *@atomic with @newval. Also acts as a memory barrier. -@Returns: %TRUE, if *@atomic was equal @oldval. %FALSE otherwise. -@Since: 2.4 - @atomic: a pointer to a #gpointer. @oldval: the assumed old value of *@atomic. @newval: the new value of *@atomic. +@Returns: %TRUE, if *@atomic was equal @oldval. %FALSE otherwise. +@Since: 2.4 diff --git a/docs/reference/glib/tmpl/base64.sgml b/docs/reference/glib/tmpl/base64.sgml index e1b9d87..b6aeb27 100644 --- a/docs/reference/glib/tmpl/base64.sgml +++ b/docs/reference/glib/tmpl/base64.sgml @@ -19,6 +19,9 @@ Base64 Encoding + + + diff --git a/docs/reference/glib/tmpl/bookmarkfile.sgml b/docs/reference/glib/tmpl/bookmarkfile.sgml index 5542b98..6ffae8e 100644 --- a/docs/reference/glib/tmpl/bookmarkfile.sgml +++ b/docs/reference/glib/tmpl/bookmarkfile.sgml @@ -88,6 +88,9 @@ The #GBookmarkFile parser was added in GLib 2.12. + + + The GBookmarkFile struct contains only private data @@ -125,6 +128,7 @@ unknown encoding +@void: @Returns: diff --git a/docs/reference/glib/tmpl/byte_order.sgml b/docs/reference/glib/tmpl/byte_order.sgml index 3f60fd7..82b488c 100644 --- a/docs/reference/glib/tmpl/byte_order.sgml +++ b/docs/reference/glib/tmpl/byte_order.sgml @@ -52,6 +52,9 @@ side-effects. + + + The host byte order. diff --git a/docs/reference/glib/tmpl/caches.sgml b/docs/reference/glib/tmpl/caches.sgml index ed18018..2730337 100644 --- a/docs/reference/glib/tmpl/caches.sgml +++ b/docs/reference/glib/tmpl/caches.sgml @@ -19,6 +19,9 @@ Caches + + + diff --git a/docs/reference/glib/tmpl/checksum.sgml b/docs/reference/glib/tmpl/checksum.sgml index 69640b4..fc739d8 100644 --- a/docs/reference/glib/tmpl/checksum.sgml +++ b/docs/reference/glib/tmpl/checksum.sgml @@ -19,6 +19,9 @@ Data Checksums + + + diff --git a/docs/reference/glib/tmpl/completion.sgml b/docs/reference/glib/tmpl/completion.sgml index f5d5c16..7b23aeb 100644 --- a/docs/reference/glib/tmpl/completion.sgml +++ b/docs/reference/glib/tmpl/completion.sgml @@ -19,6 +19,9 @@ Automatic String Completion + + + diff --git a/docs/reference/glib/tmpl/conversions.sgml b/docs/reference/glib/tmpl/conversions.sgml index b28ec41..3bfad72 100644 --- a/docs/reference/glib/tmpl/conversions.sgml +++ b/docs/reference/glib/tmpl/conversions.sgml @@ -164,6 +164,9 @@ export G_FILENAME_ENCODING=ISO-8859-1 + + + diff --git a/docs/reference/glib/tmpl/datalist.sgml b/docs/reference/glib/tmpl/datalist.sgml index f41a613..fb61360 100644 --- a/docs/reference/glib/tmpl/datalist.sgml +++ b/docs/reference/glib/tmpl/datalist.sgml @@ -19,6 +19,9 @@ Keyed Data Lists + + + diff --git a/docs/reference/glib/tmpl/datasets.sgml b/docs/reference/glib/tmpl/datasets.sgml index 1ce7f4f..1e3b6b2 100644 --- a/docs/reference/glib/tmpl/datasets.sgml +++ b/docs/reference/glib/tmpl/datasets.sgml @@ -19,6 +19,9 @@ Datasets + + + diff --git a/docs/reference/glib/tmpl/date.sgml b/docs/reference/glib/tmpl/date.sgml index 5d2610b..d097edb 100644 --- a/docs/reference/glib/tmpl/date.sgml +++ b/docs/reference/glib/tmpl/date.sgml @@ -66,6 +66,9 @@ a #GTimeVal with g_get_current_time(). + + + Number of microseconds in one second (1 million). This macro is provided for @@ -268,6 +271,7 @@ be cleared (as if you'd called g_date_clear()) but invalid (it won't represent an existing day). Free the return value with g_date_free(). +@void: @Returns: a newly-allocated #GDate diff --git a/docs/reference/glib/tmpl/error_reporting.sgml b/docs/reference/glib/tmpl/error_reporting.sgml index fc3284c..858e48e 100644 --- a/docs/reference/glib/tmpl/error_reporting.sgml +++ b/docs/reference/glib/tmpl/error_reporting.sgml @@ -382,6 +382,9 @@ Summary of rules for use of #GError: + + + The GError structure contains diff --git a/docs/reference/glib/tmpl/fileutils.sgml b/docs/reference/glib/tmpl/fileutils.sgml index 817aeb6..b99430b 100644 --- a/docs/reference/glib/tmpl/fileutils.sgml +++ b/docs/reference/glib/tmpl/fileutils.sgml @@ -41,6 +41,9 @@ g_dir_read_name(), g_dir_rewind(), g_dir_close(). + + + Values corresponding to errno codes returned from file operations diff --git a/docs/reference/glib/tmpl/ghostutils.sgml b/docs/reference/glib/tmpl/ghostutils.sgml index b619912..1f49102 100644 --- a/docs/reference/glib/tmpl/ghostutils.sgml +++ b/docs/reference/glib/tmpl/ghostutils.sgml @@ -19,6 +19,9 @@ Hostname Utilities + + + diff --git a/docs/reference/glib/tmpl/gregex.sgml b/docs/reference/glib/tmpl/gregex.sgml index 317aa59..51fbeb8 100644 --- a/docs/reference/glib/tmpl/gregex.sgml +++ b/docs/reference/glib/tmpl/gregex.sgml @@ -75,6 +75,9 @@ written by Philip Hazel. + + + Error codes returned by regular expressions functions. diff --git a/docs/reference/glib/tmpl/gurifuncs.sgml b/docs/reference/glib/tmpl/gurifuncs.sgml index 82c0f7b..b2bbd6d 100644 --- a/docs/reference/glib/tmpl/gurifuncs.sgml +++ b/docs/reference/glib/tmpl/gurifuncs.sgml @@ -19,6 +19,9 @@ URI Functions + + + diff --git a/docs/reference/glib/tmpl/gvariant.sgml b/docs/reference/glib/tmpl/gvariant.sgml index 99c4d47..c2ca7a0 100644 --- a/docs/reference/glib/tmpl/gvariant.sgml +++ b/docs/reference/glib/tmpl/gvariant.sgml @@ -19,6 +19,9 @@ GVariant + + + diff --git a/docs/reference/glib/tmpl/gvarianttype.sgml b/docs/reference/glib/tmpl/gvarianttype.sgml index d01675b..dc846df 100644 --- a/docs/reference/glib/tmpl/gvarianttype.sgml +++ b/docs/reference/glib/tmpl/gvarianttype.sgml @@ -19,6 +19,9 @@ GVariantType + + + diff --git a/docs/reference/glib/tmpl/hash_tables.sgml b/docs/reference/glib/tmpl/hash_tables.sgml index 0f9b542..51755e3 100644 --- a/docs/reference/glib/tmpl/hash_tables.sgml +++ b/docs/reference/glib/tmpl/hash_tables.sgml @@ -19,6 +19,9 @@ Hash Tables + + + diff --git a/docs/reference/glib/tmpl/hooks.sgml b/docs/reference/glib/tmpl/hooks.sgml index f02dbf6..763d5dc 100644 --- a/docs/reference/glib/tmpl/hooks.sgml +++ b/docs/reference/glib/tmpl/hooks.sgml @@ -20,6 +20,9 @@ and the list of hook functions can be invoked. + + + The GHookList struct represents a diff --git a/docs/reference/glib/tmpl/i18n.sgml b/docs/reference/glib/tmpl/i18n.sgml index 8afc7ae..665371d 100644 --- a/docs/reference/glib/tmpl/i18n.sgml +++ b/docs/reference/glib/tmpl/i18n.sgml @@ -32,6 +32,9 @@ The gettext manual. + + + Like _(), but handles context in message ids. This has the advantage that @@ -209,6 +212,7 @@ Intltool has support for the NC_() macro since version 0.40.1. +@void: @Returns: diff --git a/docs/reference/glib/tmpl/iochannels.sgml b/docs/reference/glib/tmpl/iochannels.sgml index 4829d71..26cd23d 100644 --- a/docs/reference/glib/tmpl/iochannels.sgml +++ b/docs/reference/glib/tmpl/iochannels.sgml @@ -19,6 +19,9 @@ IO Channels + + + diff --git a/docs/reference/glib/tmpl/keyfile.sgml b/docs/reference/glib/tmpl/keyfile.sgml index 18ce443..4e72ad6 100644 --- a/docs/reference/glib/tmpl/keyfile.sgml +++ b/docs/reference/glib/tmpl/keyfile.sgml @@ -118,6 +118,9 @@ restricted to ASCII characters. + + + The GKeyFile struct contains only private fields @@ -164,6 +167,7 @@ Flags which influence the parsing. +@void: @Returns: diff --git a/docs/reference/glib/tmpl/limits.sgml b/docs/reference/glib/tmpl/limits.sgml index c0fe16c..caa305d 100644 --- a/docs/reference/glib/tmpl/limits.sgml +++ b/docs/reference/glib/tmpl/limits.sgml @@ -18,6 +18,9 @@ the standard integer and floating point types. + + + The minimum value which can be held in a #gint. diff --git a/docs/reference/glib/tmpl/linked_lists_double.sgml b/docs/reference/glib/tmpl/linked_lists_double.sgml index 888783c..f495abd 100644 --- a/docs/reference/glib/tmpl/linked_lists_double.sgml +++ b/docs/reference/glib/tmpl/linked_lists_double.sgml @@ -19,6 +19,9 @@ Doubly-Linked Lists + + + @@ -134,6 +137,7 @@ Doubly-Linked Lists +@void: @Returns: @@ -380,5 +384,6 @@ Doubly-Linked Lists +@void: diff --git a/docs/reference/glib/tmpl/linked_lists_single.sgml b/docs/reference/glib/tmpl/linked_lists_single.sgml index a8a3edd..b5863bf 100644 --- a/docs/reference/glib/tmpl/linked_lists_single.sgml +++ b/docs/reference/glib/tmpl/linked_lists_single.sgml @@ -19,6 +19,9 @@ Singly-Linked Lists + + + @@ -32,6 +35,7 @@ Singly-Linked Lists +@void: @Returns: @@ -322,5 +326,6 @@ Singly-Linked Lists +@void: diff --git a/docs/reference/glib/tmpl/macros.sgml b/docs/reference/glib/tmpl/macros.sgml index efa2779..7f40eb3 100644 --- a/docs/reference/glib/tmpl/macros.sgml +++ b/docs/reference/glib/tmpl/macros.sgml @@ -17,6 +17,9 @@ These macros provide a few commonly-used features. + + + This macro is defined only on Windows. So you can bracket diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml index 29ad670..131472d 100644 --- a/docs/reference/glib/tmpl/macros_misc.sgml +++ b/docs/reference/glib/tmpl/macros_misc.sgml @@ -18,6 +18,9 @@ by application programmers. + + + This macro is used to export function prototypes so they can be linked diff --git a/docs/reference/glib/tmpl/main.sgml b/docs/reference/glib/tmpl/main.sgml index 39a3b46..04c0eb3 100644 --- a/docs/reference/glib/tmpl/main.sgml +++ b/docs/reference/glib/tmpl/main.sgml @@ -104,6 +104,9 @@ manages all available sources of events + + + The GMainLoop struct is an opaque data type @@ -278,6 +281,7 @@ representing a set of sources to be handled in a main loop. +@void: @Returns: @@ -303,6 +307,7 @@ representing a set of sources to be handled in a main loop. +@void: @Returns: @@ -524,6 +529,7 @@ or -1 if an error occurred. +@void: @Returns: @@ -532,6 +538,7 @@ or -1 if an error occurred. +@void: @Returns: @@ -550,6 +557,7 @@ for the default main context. +@void: @Returns: @@ -638,6 +646,7 @@ for the default main context. +@void: @Returns: @@ -789,6 +798,7 @@ This is just a placeholder for #GClosureMarshal, which cannot be used here for dependency reasons. +@void: diff --git a/docs/reference/glib/tmpl/markup.sgml b/docs/reference/glib/tmpl/markup.sgml index 365f5cd..7a14ecb 100644 --- a/docs/reference/glib/tmpl/markup.sgml +++ b/docs/reference/glib/tmpl/markup.sgml @@ -92,6 +92,9 @@ Sections marked as CDATA + + + Error codes returned by markup parsing. diff --git a/docs/reference/glib/tmpl/memory.sgml b/docs/reference/glib/tmpl/memory.sgml index c113e48..3e8fe97 100644 --- a/docs/reference/glib/tmpl/memory.sgml +++ b/docs/reference/glib/tmpl/memory.sgml @@ -34,6 +34,9 @@ g_mem_set_vtable(). + + + Allocates @n_structs elements of type @struct_type. @@ -391,6 +394,7 @@ should return %NULL on failure, GLib will handle error-checking for you. +@void: @Returns: @@ -419,5 +423,6 @@ Note that this function will not output anything unless you have previously installed the #glib_mem_profiler_table with g_mem_set_vtable(). +@void: diff --git a/docs/reference/glib/tmpl/memory_chunks.sgml b/docs/reference/glib/tmpl/memory_chunks.sgml index 0bb5eef..21f979a 100644 --- a/docs/reference/glib/tmpl/memory_chunks.sgml +++ b/docs/reference/glib/tmpl/memory_chunks.sgml @@ -19,6 +19,9 @@ Memory Chunks + + + @@ -144,6 +147,7 @@ Memory Chunks +@void: @@ -151,6 +155,7 @@ Memory Chunks +@void: diff --git a/docs/reference/glib/tmpl/memory_slices.sgml b/docs/reference/glib/tmpl/memory_slices.sgml index 2538fa1..e9fb620 100644 --- a/docs/reference/glib/tmpl/memory_slices.sgml +++ b/docs/reference/glib/tmpl/memory_slices.sgml @@ -92,6 +92,9 @@ object size used at allocation time is still available when freeing. + + + Allocates a block of memory from the slice allocator. diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml index 0915f55..2c4e8d8 100644 --- a/docs/reference/glib/tmpl/messages.sgml +++ b/docs/reference/glib/tmpl/messages.sgml @@ -23,6 +23,9 @@ These can be extended with user-defined levels. + + + Defines the log domain. diff --git a/docs/reference/glib/tmpl/misc_utils.sgml b/docs/reference/glib/tmpl/misc_utils.sgml index 9cfb65f..6e9d790 100644 --- a/docs/reference/glib/tmpl/misc_utils.sgml +++ b/docs/reference/glib/tmpl/misc_utils.sgml @@ -17,11 +17,15 @@ These are portable utility functions. + + + +@void: @Returns: @@ -38,6 +42,7 @@ These are portable utility functions. +@void: @Returns: @@ -82,6 +87,7 @@ These are portable utility functions. +@void: @Returns: @@ -90,6 +96,7 @@ These are portable utility functions. +@void: @Returns: @@ -98,6 +105,7 @@ These are portable utility functions. +@void: @Returns: @@ -106,6 +114,7 @@ These are portable utility functions. +@void: @Returns: @@ -114,6 +123,7 @@ These are portable utility functions. +@void: @Returns: @@ -122,6 +132,7 @@ These are portable utility functions. +@void: @Returns: @@ -154,6 +165,7 @@ These are portable utility functions. +@void: @Returns: @@ -162,6 +174,7 @@ These are portable utility functions. +@void: @Returns: @@ -170,6 +183,7 @@ These are portable utility functions. +@void: @@ -177,6 +191,7 @@ These are portable utility functions. +@void: @Returns: @@ -185,6 +200,7 @@ These are portable utility functions. +@void: @Returns: @@ -193,6 +209,7 @@ These are portable utility functions. +@void: @Returns: @@ -201,6 +218,7 @@ These are portable utility functions. +@void: @Returns: @@ -406,6 +424,7 @@ Declares a type of function which takes no arguments and has no return value. It is used to specify the type function passed to g_atexit(). +@void: diff --git a/docs/reference/glib/tmpl/modules.sgml b/docs/reference/glib/tmpl/modules.sgml index c47df35..51329d3 100644 --- a/docs/reference/glib/tmpl/modules.sgml +++ b/docs/reference/glib/tmpl/modules.sgml @@ -99,6 +99,9 @@ just_say_hello (const char *filename, GError **error) + + + The #GModule struct is an opaque data structure to represent a @@ -112,6 +115,7 @@ It should only be accessed via the following functions. Checks if modules are supported on the current platform. +@void: @Returns: %TRUE if modules are supported. @@ -228,6 +232,7 @@ Closes a module. Gets a string describing the last module error. +@void: @Returns: a string describing the last module error. diff --git a/docs/reference/glib/tmpl/numerical.sgml b/docs/reference/glib/tmpl/numerical.sgml index 271cf90..64d9800 100644 --- a/docs/reference/glib/tmpl/numerical.sgml +++ b/docs/reference/glib/tmpl/numerical.sgml @@ -27,6 +27,9 @@ The #GFloatIEEE754 and #GDoubleIEEE754 unions are used to access the + + + See http://cch.loria.fr/documentation/IEEE754/numerical_comp_guide/ncg_math.doc.html diff --git a/docs/reference/glib/tmpl/option.sgml b/docs/reference/glib/tmpl/option.sgml index 3e65869..475caeb 100644 --- a/docs/reference/glib/tmpl/option.sgml +++ b/docs/reference/glib/tmpl/option.sgml @@ -19,6 +19,9 @@ Commandline option parser + + + diff --git a/docs/reference/glib/tmpl/patterns.sgml b/docs/reference/glib/tmpl/patterns.sgml index a749a32..c07e8c8 100644 --- a/docs/reference/glib/tmpl/patterns.sgml +++ b/docs/reference/glib/tmpl/patterns.sgml @@ -19,6 +19,9 @@ Glob-style pattern matching + + + diff --git a/docs/reference/glib/tmpl/quarks.sgml b/docs/reference/glib/tmpl/quarks.sgml index e628bf8..4ca807b 100644 --- a/docs/reference/glib/tmpl/quarks.sgml +++ b/docs/reference/glib/tmpl/quarks.sgml @@ -19,6 +19,9 @@ Quarks + + + diff --git a/docs/reference/glib/tmpl/queue.sgml b/docs/reference/glib/tmpl/queue.sgml index fbc2667..96ce2d2 100644 --- a/docs/reference/glib/tmpl/queue.sgml +++ b/docs/reference/glib/tmpl/queue.sgml @@ -42,6 +42,9 @@ To free the entire queue, use g_queue_free(). + + + Contains the public fields of a Queue. @@ -56,6 +59,7 @@ Contains the public fields of a Queue. +@void: @Returns: diff --git a/docs/reference/glib/tmpl/random_numbers.sgml b/docs/reference/glib/tmpl/random_numbers.sgml index c59bf94..2cac1c9 100644 --- a/docs/reference/glib/tmpl/random_numbers.sgml +++ b/docs/reference/glib/tmpl/random_numbers.sgml @@ -19,6 +19,9 @@ Random Numbers + + + @@ -49,6 +52,7 @@ Random Numbers +@void: @Returns: @@ -156,6 +160,7 @@ Random Numbers +@void: @Returns: @@ -174,6 +179,7 @@ Random Numbers +@void: @Returns: diff --git a/docs/reference/glib/tmpl/relations.sgml b/docs/reference/glib/tmpl/relations.sgml index a77f4c7..bcbbd24 100644 --- a/docs/reference/glib/tmpl/relations.sgml +++ b/docs/reference/glib/tmpl/relations.sgml @@ -19,6 +19,9 @@ Relations and Tuples + + + diff --git a/docs/reference/glib/tmpl/scanner.sgml b/docs/reference/glib/tmpl/scanner.sgml index dc9da80..7c14ba8 100644 --- a/docs/reference/glib/tmpl/scanner.sgml +++ b/docs/reference/glib/tmpl/scanner.sgml @@ -23,6 +23,9 @@ understand it myself. Look at gtkrc.c for some code using the scanner. + + + The data structure representing a lexical scanner. diff --git a/docs/reference/glib/tmpl/sequence.sgml b/docs/reference/glib/tmpl/sequence.sgml index 7428a6d..40c4e2e 100644 --- a/docs/reference/glib/tmpl/sequence.sgml +++ b/docs/reference/glib/tmpl/sequence.sgml @@ -19,6 +19,9 @@ Sequences + + + diff --git a/docs/reference/glib/tmpl/shell.sgml b/docs/reference/glib/tmpl/shell.sgml index 26638ac..3581d69 100644 --- a/docs/reference/glib/tmpl/shell.sgml +++ b/docs/reference/glib/tmpl/shell.sgml @@ -19,6 +19,9 @@ Shell-related Utilities + + + diff --git a/docs/reference/glib/tmpl/spawn.sgml b/docs/reference/glib/tmpl/spawn.sgml index c0f8d25..baf085e 100644 --- a/docs/reference/glib/tmpl/spawn.sgml +++ b/docs/reference/glib/tmpl/spawn.sgml @@ -17,6 +17,9 @@ process launching + + + Error codes returned by spawning processes. diff --git a/docs/reference/glib/tmpl/string_chunks.sgml b/docs/reference/glib/tmpl/string_chunks.sgml index 7da9591..c8a3c2c 100644 --- a/docs/reference/glib/tmpl/string_chunks.sgml +++ b/docs/reference/glib/tmpl/string_chunks.sgml @@ -19,6 +19,9 @@ String Chunks + + + diff --git a/docs/reference/glib/tmpl/string_utils.sgml b/docs/reference/glib/tmpl/string_utils.sgml index faaec7d..06c3fcb 100644 --- a/docs/reference/glib/tmpl/string_utils.sgml +++ b/docs/reference/glib/tmpl/string_utils.sgml @@ -40,6 +40,9 @@ wide characters (see g_unichar_iswide()) into account. + + + diff --git a/docs/reference/glib/tmpl/strings.sgml b/docs/reference/glib/tmpl/strings.sgml index 58a1307..cf435a6 100644 --- a/docs/reference/glib/tmpl/strings.sgml +++ b/docs/reference/glib/tmpl/strings.sgml @@ -20,6 +20,9 @@ nul bytes. + + + The #GString struct contains the public fields of a #GString. diff --git a/docs/reference/glib/tmpl/testing.sgml b/docs/reference/glib/tmpl/testing.sgml index 4dd819e..477c88d 100644 --- a/docs/reference/glib/tmpl/testing.sgml +++ b/docs/reference/glib/tmpl/testing.sgml @@ -66,6 +66,9 @@ facilitate running tests and producing nicely formatted test reports. + + + @@ -143,6 +146,7 @@ Returns %TRUE if tests are run in quiet mode. +@void: @Returns: @@ -152,7 +156,7 @@ Returns %TRUE if tests are run in quiet mode. @testpath: -@test_func: +@void: @@ -162,7 +166,7 @@ Returns %TRUE if tests are run in quiet mode. @testpath: @test_data: -@test_func: +@gconstpointer: @@ -229,6 +233,7 @@ Returns %TRUE if tests are run in quiet mode. +@void: @@ -236,6 +241,7 @@ Returns %TRUE if tests are run in quiet mode. +@void: @Returns: @@ -244,6 +250,7 @@ Returns %TRUE if tests are run in quiet mode. +@void: @Returns: @@ -308,6 +315,7 @@ determine what traps to set. +@void: @Returns: @@ -316,6 +324,7 @@ determine what traps to set. +@void: @Returns: @@ -389,6 +398,7 @@ see g_test_rand_int() for details on test case random numbers. +@void: @Returns: @@ -407,6 +417,7 @@ see g_test_rand_int() for details on test case random numbers. +@void: @Returns: @@ -594,9 +605,9 @@ An opaque structure representing a test suite. @test_name: @data_size: @test_data: -@data_setup: -@data_test: -@data_teardown: +@void: +@void: +@void: @Returns: @@ -614,6 +625,7 @@ An opaque structure representing a test suite. +@void: @Returns: diff --git a/docs/reference/glib/tmpl/thread_pools.sgml b/docs/reference/glib/tmpl/thread_pools.sgml index f206209..acff92a 100644 --- a/docs/reference/glib/tmpl/thread_pools.sgml +++ b/docs/reference/glib/tmpl/thread_pools.sgml @@ -19,6 +19,9 @@ Thread Pools + + + @@ -111,6 +114,7 @@ Thread Pools +@void: @Returns: @@ -119,6 +123,7 @@ Thread Pools +@void: @Returns: @@ -127,6 +132,7 @@ Thread Pools +@void: @@ -152,6 +158,7 @@ Thread Pools +@void: @Returns: diff --git a/docs/reference/glib/tmpl/threads.sgml b/docs/reference/glib/tmpl/threads.sgml index ee501e4..25ee759 100644 --- a/docs/reference/glib/tmpl/threads.sgml +++ b/docs/reference/glib/tmpl/threads.sgml @@ -19,6 +19,9 @@ Threads + + + @@ -102,6 +105,7 @@ Threads +@void: @Returns: @@ -162,6 +166,7 @@ Threads +@void: @Returns: diff --git a/docs/reference/glib/tmpl/timers.sgml b/docs/reference/glib/tmpl/timers.sgml index bb3f563..ec97218 100644 --- a/docs/reference/glib/tmpl/timers.sgml +++ b/docs/reference/glib/tmpl/timers.sgml @@ -19,6 +19,9 @@ Timers + + + @@ -30,6 +33,7 @@ Timers +@void: @Returns: diff --git a/docs/reference/glib/tmpl/trash_stack.sgml b/docs/reference/glib/tmpl/trash_stack.sgml index ead22b8..d9c3d7c 100644 --- a/docs/reference/glib/tmpl/trash_stack.sgml +++ b/docs/reference/glib/tmpl/trash_stack.sgml @@ -24,6 +24,9 @@ is a perfectly valid empty stack. + + + Each piece of memory that is pushed onto the stack diff --git a/docs/reference/glib/tmpl/trees-binary.sgml b/docs/reference/glib/tmpl/trees-binary.sgml index 4a6f94a..d89baa4 100644 --- a/docs/reference/glib/tmpl/trees-binary.sgml +++ b/docs/reference/glib/tmpl/trees-binary.sgml @@ -19,6 +19,9 @@ Balanced Binary Trees + + + diff --git a/docs/reference/glib/tmpl/trees-nary.sgml b/docs/reference/glib/tmpl/trees-nary.sgml index d4aefd6..bdab3c4 100644 --- a/docs/reference/glib/tmpl/trees-nary.sgml +++ b/docs/reference/glib/tmpl/trees-nary.sgml @@ -19,6 +19,9 @@ N-ary Trees + + + @@ -427,5 +430,6 @@ N-ary Trees +@void: diff --git a/docs/reference/glib/tmpl/type_conversion.sgml b/docs/reference/glib/tmpl/type_conversion.sgml index 0d1d94b..65be905 100644 --- a/docs/reference/glib/tmpl/type_conversion.sgml +++ b/docs/reference/glib/tmpl/type_conversion.sgml @@ -57,6 +57,9 @@ integer; values outside the range of a 32-bit integer will be mangled. + + + Stuffs an integer into a pointer type. diff --git a/docs/reference/glib/tmpl/types.sgml b/docs/reference/glib/tmpl/types.sgml index 37efca2..b17b546 100644 --- a/docs/reference/glib/tmpl/types.sgml +++ b/docs/reference/glib/tmpl/types.sgml @@ -42,6 +42,9 @@ for completeness - #gchar, #gint, #gshort, #glong, #gfloat, #gdouble. + + + A standard boolean type. diff --git a/docs/reference/glib/tmpl/unicode.sgml b/docs/reference/glib/tmpl/unicode.sgml index e0596c1..120723c 100644 --- a/docs/reference/glib/tmpl/unicode.sgml +++ b/docs/reference/glib/tmpl/unicode.sgml @@ -40,6 +40,9 @@ Convenience functions for converting between UTF-8 and the locale encoding. + + + A type which can hold any UTF-32 or UCS-4 character code, also known diff --git a/docs/reference/glib/tmpl/version.sgml b/docs/reference/glib/tmpl/version.sgml index b1cf0bb..dca4ac9 100644 --- a/docs/reference/glib/tmpl/version.sgml +++ b/docs/reference/glib/tmpl/version.sgml @@ -19,6 +19,9 @@ typically use the features described here. + + + The major version number of the GLib library. diff --git a/docs/reference/glib/tmpl/warnings.sgml b/docs/reference/glib/tmpl/warnings.sgml index cc46878..6c2aad7 100644 --- a/docs/reference/glib/tmpl/warnings.sgml +++ b/docs/reference/glib/tmpl/warnings.sgml @@ -28,6 +28,9 @@ give a perhaps-helpful warning before giving up. + + + Outputs a formatted message via the print handler. diff --git a/docs/reference/glib/tmpl/windows.sgml b/docs/reference/glib/tmpl/windows.sgml index 2a5a961..d1855ad 100644 --- a/docs/reference/glib/tmpl/windows.sgml +++ b/docs/reference/glib/tmpl/windows.sgml @@ -19,6 +19,9 @@ project. + + + Provided for UNIX emulation on Windows; equivalent to UNIX @@ -42,6 +45,7 @@ macro %MAXPATHLEN, which is the maximum length of a filename +@void: @Returns: @@ -80,6 +84,7 @@ macro %MAXPATHLEN, which is the maximum length of a filename +@void: @Returns: diff --git a/docs/reference/glib/version.xml b/docs/reference/glib/version.xml new file mode 100644 index 0000000..5827d9b --- /dev/null +++ b/docs/reference/glib/version.xml @@ -0,0 +1 @@ +2.24.2 diff --git a/docs/reference/gobject/glib-genmarshal.1 b/docs/reference/gobject/glib-genmarshal.1 index cef295d..3ea1dd8 100644 --- a/docs/reference/gobject/glib-genmarshal.1 +++ b/docs/reference/gobject/glib-genmarshal.1 @@ -1,13 +1,13 @@ '\" t .\" Title: glib-genmarshal .\" Author: [see the "Author" section] -.\" Generator: DocBook XSL Stylesheets v1.74.2 -.\" Date: 03/13/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 05/02/2010 .\" Manual: [FIXME: manual] .\" Source: [FIXME: source] .\" Language: English .\" -.TH "GLIB\-GENMARSHAL" "1" "03/13/2009" "[FIXME: source]" "[FIXME: manual]" +.TH "GLIB\-GENMARSHAL" "1" "05/02/2010" "[FIXME: source]" "[FIXME: manual]" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- diff --git a/docs/reference/gobject/glib-mkenums.1 b/docs/reference/gobject/glib-mkenums.1 index 5b961f3..d0463ab 100644 --- a/docs/reference/gobject/glib-mkenums.1 +++ b/docs/reference/gobject/glib-mkenums.1 @@ -1,13 +1,13 @@ '\" t .\" Title: glib-mkenums .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.75.1 -.\" Date: 07/05/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 05/02/2010 .\" Manual: [FIXME: manual] .\" Source: [FIXME: source] .\" Language: English .\" -.TH "GLIB\-MKENUMS" "1" "07/05/2009" "[FIXME: source]" "[FIXME: manual]" +.TH "GLIB\-MKENUMS" "1" "05/02/2010" "[FIXME: source]" "[FIXME: manual]" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- diff --git a/docs/reference/gobject/gobject-query.1 b/docs/reference/gobject/gobject-query.1 index 53903c3..02f4464 100644 --- a/docs/reference/gobject/gobject-query.1 +++ b/docs/reference/gobject/gobject-query.1 @@ -1,13 +1,13 @@ '\" t .\" Title: gobject-query .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.74.2 -.\" Date: 03/13/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 08/08/2010 .\" Manual: [FIXME: manual] .\" Source: [FIXME: source] .\" Language: English .\" -.TH "GOBJECT\-QUERY" "1" "03/13/2009" "[FIXME: source]" "[FIXME: manual]" +.TH "GOBJECT\-QUERY" "1" "08/08/2010" "[FIXME: source]" "[FIXME: manual]" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- diff --git a/docs/reference/gobject/gobject-sections.txt b/docs/reference/gobject/gobject-sections.txt index 58bea93..44c6947 100644 --- a/docs/reference/gobject/gobject-sections.txt +++ b/docs/reference/gobject/gobject-sections.txt @@ -705,6 +705,7 @@ g_param_spec_types value_collection glib-object.h,gobject/gvaluecollector.h GTypeCValue +G_VALUE_COLLECT_INIT G_VALUE_COLLECT G_VALUE_LCOPY G_VALUE_COLLECT_FORMAT_MAX_LENGTH diff --git a/docs/reference/gobject/html/GTypeModule.html b/docs/reference/gobject/html/GTypeModule.html index e605543..2d3c3e1 100644 --- a/docs/reference/gobject/html/GTypeModule.html +++ b/docs/reference/gobject/html/GTypeModule.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -76,28 +46,35 @@ GTypeModule; GTypeModuleClass; -gbooleang_type_module_use (GTypeModule *module); -voidg_type_module_unuse (GTypeModule *module); -voidg_type_module_set_name (GTypeModule *module, - const gchar *name); -GTypeg_type_module_register_type (GTypeModule *module, - GType parent_type, - const gchar *type_name, - const GTypeInfo *type_info, - GTypeFlags flags); -voidg_type_module_add_interface (GTypeModule *module, - GType instance_type, - GType interface_type, - const GInterfaceInfo *interface_info); -GTypeg_type_module_register_enum (GTypeModule *module, - const gchar *name, - const GEnumValue *const_static_values); -GTypeg_type_module_register_flags (GTypeModule *module, - const gchar *name, - const GFlagsValue *const_static_values); -#define G_DEFINE_DYNAMIC_TYPE (TN, t_n, T_P) -#define G_DEFINE_DYNAMIC_TYPE_EXTENDED (TypeName, type_name, TYPE_PARENT, flags, CODE) -#define G_IMPLEMENT_INTERFACE_DYNAMIC (TYPE_IFACE, iface_init) +gbooleang_type_module_use (GTypeModule *module); +voidg_type_module_unuse (GTypeModule *module); +voidg_type_module_set_name (GTypeModule *module, + const gchar *name); +GTypeg_type_module_register_type (GTypeModule *module, + GType parent_type, + const gchar *type_name, + const GTypeInfo *type_info, + GTypeFlags flags); +voidg_type_module_add_interface (GTypeModule *module, + GType instance_type, + GType interface_type, + const GInterfaceInfo *interface_info); +GTypeg_type_module_register_enum (GTypeModule *module, + const gchar *name, + const GEnumValue *const_static_values); +GTypeg_type_module_register_flags (GTypeModule *module, + const gchar *name, + const GFlagsValue *const_static_values); +#define G_DEFINE_DYNAMIC_TYPE (TN, + t_n, + T_P) +#define G_DEFINE_DYNAMIC_TYPE_EXTENDED (TypeName, + type_name, + TYPE_PARENT, + flags, + CODE) +#define G_IMPLEMENT_INTERFACE_DYNAMIC (TYPE_IFACE, + iface_init)
    @@ -144,7 +121,8 @@ implementations it contains, GTypeModule does not actually provide any implementation of module loading and unloading. To create a particular module type you must derive from GTypeModule and implement the load and unload functions -in GTypeModuleClass.

    +in GTypeModuleClass. +

    -

    gchar *name;

    the name of the module +the name of the module
    @@ -178,24 +157,25 @@ be accessed directly, except for the name

    In order to implement dynamic loading of types based on GTypeModule, -the load and unload functions in GTypeModuleClass must be implemented.

    +the load and unload functions in GTypeModuleClass must be implemented. +

    - - - @@ -204,18 +184,19 @@ the load and

    g_type_module_use ()

    -
    gboolean            g_type_module_use                   (GTypeModule *module);
    +
    gboolean            g_type_module_use                   (GTypeModule *module);

    Increases the use count of a GTypeModule by one. If the use count was zero before, the plugin will be loaded. If loading the plugin fails, the use count is reset to -its prior value.

    +its prior value. +

    GObjectClass parent_class;

    the parent class +the parent class

    load ()

    loads the module and registers one or more types using +loads the module and registers one or more types using g_type_module_register_type().

    unload ()

    unloads the module +unloads the module
    - @@ -230,18 +211,19 @@ its prior value.


    g_type_module_unuse ()

    -
    void                g_type_module_unuse                 (GTypeModule *module);
    +
    void                g_type_module_unuse                 (GTypeModule *module);

    Decreases the use count of a GTypeModule by one. If the result is zero, the module will be unloaded. (However, the GTypeModule will not be freed, and types associated with the GTypeModule are not unregistered. Once a GTypeModule is -initialized, it must exist forever.)

    +initialized, it must exist forever.) +

    module :

    a GTypeModule +a GTypeModule
    -

    module :

    a GTypeModule +a GTypeModule
    @@ -249,21 +231,22 @@ initialized, it must exist forever.)


    g_type_module_set_name ()

    -
    void                g_type_module_set_name              (GTypeModule *module,
    -                                                         const gchar *name);
    +
    void                g_type_module_set_name              (GTypeModule *module,
    +                                                         const gchar *name);

    -Sets the name for a GTypeModule

    +Sets the name for a GTypeModule +

    - - @@ -272,11 +255,11 @@ Sets the name for a

    g_type_module_register_type ()

    -
    GType               g_type_module_register_type         (GTypeModule *module,
    -                                                         GType parent_type,
    -                                                         const gchar *type_name,
    -                                                         const GTypeInfo *type_info,
    -                                                         GTypeFlags flags);
    +
    GType               g_type_module_register_type         (GTypeModule *module,
    +                                                         GType parent_type,
    +                                                         const gchar *type_name,
    +                                                         const GTypeInfo *type_info,
    +                                                         GTypeFlags flags);

    Looks up or registers a type that is implemented with a particular type plugin. If a type with name type_name was previously registered, @@ -290,33 +273,34 @@ be the same as they were previously.

    As long as any instances of the type exist, the type plugin will -not be unloaded.

    +not be unloaded. +

    module :

    a GTypeModule. +a GTypeModule.

    name :

    a human-readable name to use in error messages. +a human-readable name to use in error messages.
    - - - - - @@ -330,10 +314,10 @@ not be unloaded.


    g_type_module_add_interface ()

    -
    void                g_type_module_add_interface         (GTypeModule *module,
    -                                                         GType instance_type,
    -                                                         GType interface_type,
    -                                                         const GInterfaceInfo *interface_info);
    +
    void                g_type_module_add_interface         (GTypeModule *module,
    +                                                         GType instance_type,
    +                                                         GType interface_type,
    +                                                         const GInterfaceInfo *interface_info);

    Registers an additional interface for a type, whose interface lives in the given type plugin. If the interface was already registered @@ -341,28 +325,29 @@ for the type in this plugin, nothing will be done.

    As long as any instances of the type exist, the type plugin will -not be unloaded.

    +not be unloaded. +

    module :

    a GTypeModule +a GTypeModule

    parent_type :

    the type for the parent class +the type for the parent class

    type_name :

    name for the type +name for the type

    type_info :

    type information structure +type information structure

    flags :

    flags field providing details about the type +flags field providing details about the type
    - - - - @@ -371,9 +356,9 @@ not be unloaded.


    g_type_module_register_enum ()

    -
    GType               g_type_module_register_enum         (GTypeModule *module,
    -                                                         const gchar *name,
    -                                                         const GEnumValue *const_static_values);
    +
    GType               g_type_module_register_enum         (GTypeModule *module,
    +                                                         const gchar *name,
    +                                                         const GEnumValue *const_static_values);

    Looks up or registers an enumeration that is implemented with a particular type plugin. If a type with name type_name was previously registered, @@ -382,23 +367,24 @@ is newly registered, and the resulting

    module :

    a GTypeModule +a GTypeModule

    instance_type :

    type to which to add the interface. +type to which to add the interface.

    interface_type :

    interface type to add +interface type to add

    interface_info :

    type information structure +type information structure
    - - -

    module :

    a GTypeModule +a GTypeModule

    name :

    name for the type +name for the type

    const_static_values :

    an array of GEnumValue structs for the +an array of GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. @@ -416,9 +402,9 @@ not be unloaded.


    g_type_module_register_flags ()

    -
    GType               g_type_module_register_flags        (GTypeModule *module,
    -                                                         const gchar *name,
    -                                                         const GFlagsValue *const_static_values);
    +
    GType               g_type_module_register_flags        (GTypeModule *module,
    +                                                         const gchar *name,
    +                                                         const GFlagsValue *const_static_values);

    Looks up or registers a flags type that is implemented with a particular type plugin. If a type with name type_name was previously registered, @@ -427,23 +413,24 @@ is newly registered, and the resulting - - -

    module :

    a GTypeModule +a GTypeModule

    name :

    name for the type +name for the type

    const_static_values :

    an array of GFlagsValue structs for the +an array of GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. @@ -471,24 +458,25 @@ class initialization function, an instance initialization function (see it defines a *_get_type() and a static *_register_type() function for use in your module_init(). -See G_DEFINE_DYNAMIC_TYPE_EXTENDED() for an example.

    +See G_DEFINE_DYNAMIC_TYPE_EXTENDED() for an example. +

    - - - @@ -505,92 +493,161 @@ allows to specify
    -G_DEFINE_DYNAMIC_TYPE_EXTENDED (GtkGadget,
    -                                gtk_gadget,
    -                                GTK_TYPE_THING,
    -                                0,
    -                                G_IMPLEMENT_INTERFACE_DYNAMIC (TYPE_GIZMO,
    -                                                               gtk_gadget_gizmo_init));
    -
    +
    +

    TN :

    The name of the new type, in Camel case. +The name of the new type, in Camel case.

    t_n :

    The name of the new type, in lowercase, with words +The name of the new type, in lowercase, with words separated by '_'.

    T_P :

    The GType of the parent type. +The GType of the parent type.
    + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    G_DEFINE_DYNAMIC_TYPE_EXTENDED (GtkGadget,
    +                                gtk_gadget,
    +                                GTK_TYPE_THING,
    +                                0,
    +                                G_IMPLEMENT_INTERFACE_DYNAMIC (TYPE_GIZMO,
    +                                                               gtk_gadget_gizmo_init));
    +
    +

    expands to

    -
    -static void     gtk_gadget_init              (GtkGadget      *self);
    -static void     gtk_gadget_class_init        (GtkGadgetClass *klass);
    -static void     gtk_gadget_class_finalize    (GtkGadgetClass *klass);
    +
    + + + + + + + +
    1
    +2
    +3
    +4
    +5
    +6
    +7
    +8
    +9
    +10
    +11
    +12
    +13
    +14
    +15
    +16
    +17
    +18
    +19
    +20
    +21
    +22
    +23
    +24
    +25
    +26
    +27
    +28
    +29
    +30
    +31
    +32
    +33
    +34
    +35
    +36
    +37
    +38
    +39
    +40
    +41
    +42
    +43
    +44
    +45
    +46
    static void     gtk_gadget_init              (GtkGadget      *self);
    +static void     gtk_gadget_class_init        (GtkGadgetClass *klass);
    +static void     gtk_gadget_class_finalize    (GtkGadgetClass *klass);
     
    -static gpointer gtk_gadget_parent_class = NULL;
    -static GType    gtk_gadget_type_id = 0;
    +static gpointer gtk_gadget_parent_class = NULL;
    +static GType    gtk_gadget_type_id = 0;
     
    -static void     gtk_gadget_class_intern_init (gpointer klass)
    -{
    -  gtk_gadget_parent_class = g_type_class_peek_parent (klass); 
    -  gtk_gadget_class_init ((GtkGadgetClass*) klass); 
    -}
    +static void     gtk_gadget_class_intern_init (gpointer klass)
    +{
    +  gtk_gadget_parent_class = g_type_class_peek_parent (klass); 
    +  gtk_gadget_class_init ((GtkGadgetClass*) klass); 
    +}
     
    -GType
    -gtk_gadget_get_type (void)
    -{
    -  return gtk_gadget_type_id;
    -}
    +GType
    +gtk_gadget_get_type (void)
    +{
    +  return gtk_gadget_type_id;
    +}
     
    -static void
    -gtk_gadget_register_type (GTypeModule *type_module)
    -{
    -  const GTypeInfo g_define_type_info = {
    -    sizeof (GtkGadgetClass),
    -    (GBaseInitFunc) NULL,
    -    (GBaseFinalizeFunc) NULL,
    -    (GClassInitFunc) gtk_gadget_class_intern_init,
    -    (GClassFinalizeFunc) gtk_gadget_class_finalize,
    -    NULL,   // class_data
    -    sizeof (GtkGadget),
    -    0,      // n_preallocs
    -    (GInstanceInitFunc) gtk_gadget_init, 
    -    NULL    // value_table
    -  };
    -  gtk_gadget_type_id = g_type_module_register_type (type_module,
    -                                                    GTK_TYPE_THING,
    -                                                    GtkGadget,
    -                                                    &g_define_type_info,
    -                                                    (GTypeFlags) flags);
    -  {
    -    const GInterfaceInfo g_implement_interface_info = {
    -      (GInterfaceInitFunc) gtk_gadget_gizmo_init
    -    };
    -    g_type_module_add_interface (type_module, g_define_type_id, TYPE_GIZMO, &g_implement_interface_info);
    -  }
    -}
    -
    +static void +gtk_gadget_register_type (GTypeModule *type_module) +{ + const GTypeInfo g_define_type_info = { + sizeof (GtkGadgetClass), + (GBaseInitFunc) NULL, + (GBaseFinalizeFunc) NULL, + (GClassInitFunc) gtk_gadget_class_intern_init, + (GClassFinalizeFunc) gtk_gadget_class_finalize, + NULL, // class_data + sizeof (GtkGadget), + 0, // n_preallocs + (GInstanceInitFunc) gtk_gadget_init, + NULL // value_table + }; + gtk_gadget_type_id = g_type_module_register_type (type_module, + GTK_TYPE_THING, + GtkGadget, + &g_define_type_info, + (GTypeFlags) flags); + { + const GInterfaceInfo g_implement_interface_info = { + (GInterfaceInitFunc) gtk_gadget_gizmo_init + }; + g_type_module_add_interface (type_module, g_define_type_id, TYPE_GIZMO, &g_implement_interface_info); + } +}
    +
    + +

    +

    - - - - - @@ -609,18 +666,19 @@ for an example.

    Note that this macro can only be used together with the G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable -names from that macro.

    +names from that macro. +

    TypeName :

    The name of the new type, in Camel case. +The name of the new type, in Camel case.

    type_name :

    The name of the new type, in lowercase, with words +The name of the new type, in lowercase, with words separated by '_'.

    TYPE_PARENT :

    The GType of the parent type. +The GType of the parent type.

    flags :

    GTypeFlags to pass to g_type_module_register_type() + +GTypeFlags to pass to g_type_module_register_type()

    CODE :

    Custom code that gets inserted in the *_get_type() function. +Custom code that gets inserted in the *_get_type() function.
    - - @@ -647,6 +705,6 @@ names from that macro.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/GTypePlugin.html b/docs/reference/gobject/html/GTypePlugin.html index 5bea32c..47bcd0b 100644 --- a/docs/reference/gobject/html/GTypePlugin.html +++ b/docs/reference/gobject/html/GTypePlugin.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    TYPE_IFACE :

    The GType of the interface to add +The GType of the interface to add

    iface_init :

    The interface init function +The interface init function
    @@ -76,27 +46,27 @@ GTypePlugin; GTypePluginClass; -void (*GTypePluginUse) (GTypePlugin *plugin); -void (*GTypePluginUnuse) (GTypePlugin *plugin); -void (*GTypePluginCompleteTypeInfo) (GTypePlugin *plugin, - GType g_type, - GTypeInfo *info, - GTypeValueTable *value_table); -void (*GTypePluginCompleteInterfaceInfo) (GTypePlugin *plugin, - GType instance_type, - GType interface_type, - GInterfaceInfo *info); -voidg_type_plugin_use (GTypePlugin *plugin); -voidg_type_plugin_unuse (GTypePlugin *plugin); -voidg_type_plugin_complete_type_info (GTypePlugin *plugin, - GType g_type, - GTypeInfo *info, - GTypeValueTable *value_table); +void (*GTypePluginUse) (GTypePlugin *plugin); +void (*GTypePluginUnuse) (GTypePlugin *plugin); +void (*GTypePluginCompleteTypeInfo) (GTypePlugin *plugin, + GType g_type, + GTypeInfo *info, + GTypeValueTable *value_table); +void (*GTypePluginCompleteInterfaceInfo) (GTypePlugin *plugin, + GType instance_type, + GType interface_type, + GInterfaceInfo *info); +voidg_type_plugin_use (GTypePlugin *plugin); +voidg_type_plugin_unuse (GTypePlugin *plugin); +voidg_type_plugin_complete_type_info (GTypePlugin *plugin, + GType g_type, + GTypeInfo *info, + GTypeValueTable *value_table); voidg_type_plugin_complete_interface_info - (GTypePlugin *plugin, - GType instance_type, - GType interface_type, - GInterfaceInfo *info); + (GTypePlugin *plugin, + GType instance_type, + GType interface_type, + GInterfaceInfo *info);
    @@ -128,12 +98,23 @@ dynamically loaded types. It goes as follows: the first time, or by your main application that knows what modules introduces what types), like this:

    -
    -  new_type_id = g_type_register_dynamic (parent_type_id,
    -                                                "TypeName",
    -                                                new_type_plugin,
    -                                                type_flags);
    -  
    +
    +
    + + + + + + +
    1
    +2
    +3
    +4
    new_type_id = g_type_register_dynamic (parent_type_id,
    +                                              "TypeName",
    +                                              new_type_plugin,
    +                                              type_flags);
    +
    +

    where new_type_plugin is an implementation of the GTypePlugin interface. @@ -179,7 +160,8 @@ when the type is needed again.

    GTypeModule is an implementation of GTypePlugin that already implements most of this except for the actual module loading and -unloading. It even handles multiple registered types per module.

    +unloading. It even handles multiple registered types per module. +

    Details

    @@ -189,7 +171,8 @@ unloading. It even handles multiple registered types per module.

    The GTypePlugin typedef is used as a placeholder for objects that implement the GTypePlugin -interface.

    +interface. +


    @@ -203,23 +186,24 @@ interface.

    The GTypePlugin interface is used by the type system in order to handle -the lifecycle of dynamically loaded types.

    +the lifecycle of dynamically loaded types. +

    - - - -

    GTypePluginUse use_plugin;

    Increases the use count of the plugin. +Increases the use count of the plugin.

    GTypePluginUnuse unuse_plugin;

    Decreases the use count of the plugin. +Decreases the use count of the plugin.

    GTypePluginCompleteTypeInfo complete_type_info;

    Fills in the GTypeInfo and +Fills in the GTypeInfo and GTypeValueTable structs for the type. The structs are initialized with memset(s, 0, sizeof (s)) before calling this function. @@ -227,7 +211,7 @@ the lifecycle of dynamically loaded types.

    GTypePluginCompleteInterfaceInfo complete_interface_info;

    Fills in missing parts of the GInterfaceInfo +Fills in missing parts of the GInterfaceInfo for the interface. The structs is initialized with memset(s, 0, sizeof (s)) before calling this function. @@ -239,15 +223,16 @@ the lifecycle of dynamically loaded types.


    GTypePluginUse ()

    -
    void                (*GTypePluginUse)                   (GTypePlugin *plugin);
    +
    void                (*GTypePluginUse)                   (GTypePlugin *plugin);

    The type of the use_plugin function of GTypePluginClass, which gets called -to increase the use count of plugin.

    +to increase the use count of plugin. +

    -

    plugin :

    the GTypePlugin whose use count should be increased +the GTypePlugin whose use count should be increased
    @@ -255,14 +240,15 @@ to increase the use count of plugin.


    GTypePluginUnuse ()

    -
    void                (*GTypePluginUnuse)                 (GTypePlugin *plugin);
    +
    void                (*GTypePluginUnuse)                 (GTypePlugin *plugin);

    -The type of the unuse_plugin function of GTypePluginClass.

    +The type of the unuse_plugin function of GTypePluginClass. +

    -

    plugin :

    the GTypePlugin whose use count should be decreased +the GTypePlugin whose use count should be decreased
    @@ -270,33 +256,34 @@ The type of the unuse_plugin function of

    GTypePluginCompleteTypeInfo ()

    -
    void                (*GTypePluginCompleteTypeInfo)      (GTypePlugin *plugin,
    -                                                         GType g_type,
    -                                                         GTypeInfo *info,
    -                                                         GTypeValueTable *value_table);
    +
    void                (*GTypePluginCompleteTypeInfo)      (GTypePlugin *plugin,
    +                                                         GType g_type,
    +                                                         GTypeInfo *info,
    +                                                         GTypeValueTable *value_table);

    -The type of the complete_type_info function of GTypePluginClass.

    +The type of the complete_type_info function of GTypePluginClass. +

    - - - - @@ -305,34 +292,35 @@ The type of the complete_type_info funct

    GTypePluginCompleteInterfaceInfo ()

    -
    void                (*GTypePluginCompleteInterfaceInfo) (GTypePlugin *plugin,
    -                                                         GType instance_type,
    -                                                         GType interface_type,
    -                                                         GInterfaceInfo *info);
    +
    void                (*GTypePluginCompleteInterfaceInfo) (GTypePlugin *plugin,
    +                                                         GType instance_type,
    +                                                         GType interface_type,
    +                                                         GInterfaceInfo *info);

    -The type of the complete_interface_info function of GTypePluginClass.

    +The type of the complete_interface_info function of GTypePluginClass. +

    plugin :

    the GTypePlugin +the GTypePlugin

    g_type :

    the GType whose info is completed +the GType whose info is completed

    info :

    the GTypeInfo struct to fill in +the GTypeInfo struct to fill in

    value_table :

    the GTypeValueTable to fill in +the GTypeValueTable to fill in
    - - - - @@ -341,16 +329,17 @@ The type of the complete_interface_info

    g_type_plugin_use ()

    -
    void                g_type_plugin_use                   (GTypePlugin *plugin);
    +
    void                g_type_plugin_use                   (GTypePlugin *plugin);

    Calls the use_plugin function from the GTypePluginClass of plugin. There should be no need to use this function outside of -the GObject type system itself.

    +the GObject type system itself. +

    plugin :

    the GTypePlugin +the GTypePlugin

    instance_type :

    the GType of an instantiable type to which the interface +the GType of an instantiable type to which the interface is added

    interface_type :

    the GType of the interface whose info is completed +the GType of the interface whose info is completed

    info :

    the GInterfaceInfo to fill in +the GInterfaceInfo to fill in
    -

    plugin :

    a GTypePlugin +a GTypePlugin
    @@ -358,16 +347,17 @@ the GObject type system itself.


    g_type_plugin_unuse ()

    -
    void                g_type_plugin_unuse                 (GTypePlugin *plugin);
    +
    void                g_type_plugin_unuse                 (GTypePlugin *plugin);

    Calls the unuse_plugin function from the GTypePluginClass of plugin. There should be no need to use this function outside of -the GObject type system itself.

    +the GObject type system itself. +

    -

    plugin :

    a GTypePlugin +a GTypePlugin
    @@ -375,35 +365,36 @@ the GObject type system itself.


    g_type_plugin_complete_type_info ()

    -
    void                g_type_plugin_complete_type_info    (GTypePlugin *plugin,
    -                                                         GType g_type,
    -                                                         GTypeInfo *info,
    -                                                         GTypeValueTable *value_table);
    +
    void                g_type_plugin_complete_type_info    (GTypePlugin *plugin,
    +                                                         GType g_type,
    +                                                         GTypeInfo *info,
    +                                                         GTypeValueTable *value_table);

    Calls the complete_type_info function from the GTypePluginClass of plugin. There should be no need to use this function outside of the GObject -type system itself.

    +type system itself. +

    - - - - @@ -413,36 +404,37 @@ type system itself.

    g_type_plugin_complete_interface_info ()

    void                g_type_plugin_complete_interface_info
    -                                                        (GTypePlugin *plugin,
    -                                                         GType instance_type,
    -                                                         GType interface_type,
    -                                                         GInterfaceInfo *info);
    + (GTypePlugin *plugin, + GType instance_type, + GType interface_type, + GInterfaceInfo *info);

    Calls the complete_interface_info function from the GTypePluginClass of plugin. There should be no need to use this -function outside of the GObject type system itself.

    +function outside of the GObject type system itself. +

    plugin :

    a GTypePlugin +a GTypePlugin

    g_type :

    the GType whose info is completed +the GType whose info is completed

    info :

    the GTypeInfo struct to fill in +the GTypeInfo struct to fill in

    value_table :

    the GTypeValueTable to fill in +the GTypeValueTable to fill in
    - - - - @@ -456,6 +448,6 @@ function outside of the GObject type system itself.

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-10.html b/docs/reference/gobject/html/api-index-2-10.html index 4c18798..67f5333 100644 --- a/docs/reference/gobject/html/api-index-2-10.html +++ b/docs/reference/gobject/html/api-index-2-10.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    plugin :

    the GTypePlugin +the GTypePlugin

    instance_type :

    the GType of an instantiable type to which the interface +the GType of an instantiable type to which the interface is added

    interface_type :

    the GType of the interface whose info is completed +the GType of the interface whose info is completed

    info :

    the GInterfaceInfo to fill in +the GInterfaceInfo to fill in
    @@ -64,32 +34,52 @@

    Index of new symbols in 2.10

    I

    -
    G_IS_PARAM_SPEC_GTYPE
    +
    +G_IS_PARAM_SPEC_GTYPE, macro in Standard Parameter and Value Types +

    O

    -
    g_object_force_floating
    +
    +g_object_force_floating, function in The Base Object Type +
    -
    g_object_is_floating
    +
    +g_object_is_floating, function in The Base Object Type +
    -
    g_object_ref_sink
    +
    +g_object_ref_sink, function in The Base Object Type +

    P

    -
    GParamSpecGType
    +
    +GParamSpecGType, struct in Standard Parameter and Value Types +
    -
    g_param_spec_gtype
    +
    +g_param_spec_gtype, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_GTYPE
    +
    +G_PARAM_SPEC_GTYPE, macro in Standard Parameter and Value Types +
    -
    g_param_spec_ref_sink
    +
    +g_param_spec_ref_sink, function in GParamSpec +

    T

    -
    G_TYPE_HASH_TABLE
    +
    +G_TYPE_HASH_TABLE, macro in Boxed Types +
    -
    G_TYPE_PARAM_GTYPE
    +
    +G_TYPE_PARAM_GTYPE, macro in Standard Parameter and Value Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-12.html b/docs/reference/gobject/html/api-index-2-12.html index 1e21e3c..11b8240 100644 --- a/docs/reference/gobject/html/api-index-2-12.html +++ b/docs/reference/gobject/html/api-index-2-12.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -60,18 +30,26 @@

    Index of new symbols in 2.12

    T

    -
    g_type_register_static_simple
    +
    +g_type_register_static_simple, function in Type Information +

    V

    -
    g_value_get_gtype
    +
    +g_value_get_gtype, function in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_GTYPE
    +
    +G_VALUE_HOLDS_GTYPE, macro in Standard Parameter and Value Types +
    -
    g_value_set_gtype
    +
    +g_value_set_gtype, function in Standard Parameter and Value Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-14.html b/docs/reference/gobject/html/api-index-2-14.html index aa526d4..d80a6fe 100644 --- a/docs/reference/gobject/html/api-index-2-14.html +++ b/docs/reference/gobject/html/api-index-2-14.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -60,16 +30,22 @@

    Index of new symbols in 2.14

    D

    -
    G_DEFINE_DYNAMIC_TYPE
    +
    +G_DEFINE_DYNAMIC_TYPE, macro in GTypeModule +
    -
    G_DEFINE_DYNAMIC_TYPE_EXTENDED
    +
    +G_DEFINE_DYNAMIC_TYPE_EXTENDED, macro in GTypeModule +

    T

    -
    G_TYPE_REGEX
    +
    +G_TYPE_REGEX, macro in Boxed Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-18.html b/docs/reference/gobject/html/api-index-2-18.html index be3f264..4ea0819 100644 --- a/docs/reference/gobject/html/api-index-2-18.html +++ b/docs/reference/gobject/html/api-index-2-18.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,15 +26,21 @@

    Index of new symbols in 2.18

    S

    -
    g_signal_chain_from_overridden_handler
    +
    +g_signal_chain_from_overridden_handler, function in Signals +
    -
    g_signal_new_class_handler
    +
    +g_signal_new_class_handler, function in Signals +
    -
    g_signal_override_class_handler
    +
    +g_signal_override_class_handler, function in Signals +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-2.html b/docs/reference/gobject/html/api-index-2-2.html index c2ae135..d8d73ce 100644 --- a/docs/reference/gobject/html/api-index-2-2.html +++ b/docs/reference/gobject/html/api-index-2-2.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,11 +26,13 @@

    Index of new symbols in 2.2

    T

    -
    g_type_interface_prerequisites
    +
    +g_type_interface_prerequisites, function in Type Information +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-22.html b/docs/reference/gobject/html/api-index-2-22.html index 3e47640..5e312c0 100644 --- a/docs/reference/gobject/html/api-index-2-22.html +++ b/docs/reference/gobject/html/api-index-2-22.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,15 +26,21 @@

    Index of new symbols in 2.22

    T

    -
    G_TYPE_ARRAY
    +
    +G_TYPE_ARRAY, macro in Boxed Types +
    -
    G_TYPE_BYTE_ARRAY
    +
    +G_TYPE_BYTE_ARRAY, macro in Boxed Types +
    -
    G_TYPE_PTR_ARRAY
    +
    +G_TYPE_PTR_ARRAY, macro in Boxed Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-24.html b/docs/reference/gobject/html/api-index-2-24.html index 0c43c7f..57e6698 100644 --- a/docs/reference/gobject/html/api-index-2-24.html +++ b/docs/reference/gobject/html/api-index-2-24.html @@ -7,38 +7,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -55,31 +25,48 @@ I  |  T +  |  + V + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-4.html b/docs/reference/gobject/html/api-index-2-4.html index 017b89e..b4f0b0c 100644 --- a/docs/reference/gobject/html/api-index-2-4.html +++ b/docs/reference/gobject/html/api-index-2-4.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -70,75 +40,139 @@

    Index of new symbols in 2.4

    D

    -
    G_DEFINE_ABSTRACT_TYPE
    +
    +G_DEFINE_ABSTRACT_TYPE, macro in Type Information +
    -
    G_DEFINE_ABSTRACT_TYPE_WITH_CODE
    +
    +G_DEFINE_ABSTRACT_TYPE_WITH_CODE, macro in Type Information +
    -
    G_DEFINE_TYPE
    +
    +G_DEFINE_TYPE, macro in Type Information +
    -
    G_DEFINE_TYPE_EXTENDED
    +
    +G_DEFINE_TYPE_EXTENDED, macro in Type Information +
    -
    G_DEFINE_TYPE_WITH_CODE
    +
    +G_DEFINE_TYPE_WITH_CODE, macro in Type Information +

    I

    -
    G_IMPLEMENT_INTERFACE
    +
    +G_IMPLEMENT_INTERFACE, macro in Type Information +
    -
    G_IS_PARAM_SPEC_OVERRIDE
    +
    +G_IS_PARAM_SPEC_OVERRIDE, macro in Standard Parameter and Value Types +

    O

    -
    g_object_class_override_property
    +
    +g_object_class_override_property, function in The Base Object Type +
    -
    g_object_interface_find_property
    +
    +g_object_interface_find_property, function in The Base Object Type +
    -
    g_object_interface_install_property
    +
    +g_object_interface_install_property, function in The Base Object Type +
    -
    g_object_interface_list_properties
    +
    +g_object_interface_list_properties, function in The Base Object Type +

    P

    -
    GParamSpecOverride
    +
    +GParamSpecOverride, struct in Standard Parameter and Value Types +
    -
    g_param_spec_get_redirect_target
    +
    +g_param_spec_get_redirect_target, function in GParamSpec +
    -
    g_param_spec_override
    +
    +g_param_spec_override, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_OVERRIDE
    +
    +G_PARAM_SPEC_OVERRIDE, macro in Standard Parameter and Value Types +

    S

    -
    g_signal_accumulator_true_handled
    +
    +g_signal_accumulator_true_handled, function in Signals +

    T

    -
    GTypeInterfaceCheckFunc
    +
    +GTypeInterfaceCheckFunc, user_function in Type Information +
    -
    g_type_add_interface_check
    +
    +g_type_add_interface_check, function in Type Information +
    -
    g_type_class_peek_static
    +
    +g_type_class_add_private, function in Type Information +
    -
    g_type_default_interface_peek
    +
    +g_type_class_peek_static, function in Type Information +
    -
    g_type_default_interface_ref
    +
    +g_type_default_interface_peek, function in Type Information +
    -
    g_type_default_interface_unref
    +
    +g_type_default_interface_ref, function in Type Information +
    -
    G_TYPE_INSTANCE_GET_PRIVATE
    +
    +g_type_default_interface_unref, function in Type Information +
    -
    G_TYPE_PARAM_OVERRIDE
    +
    +G_TYPE_INSTANCE_GET_PRIVATE, macro in Type Information +
    -
    g_type_remove_interface_check
    +
    +G_TYPE_PARAM_OVERRIDE, macro in Standard Parameter and Value Types +
    -
    G_TYPE_STRV
    +
    +g_type_remove_interface_check, function in Type Information +
    +
    +
    +G_TYPE_STRV, macro in Boxed Types +

    V

    -
    g_value_take_boxed
    +
    +g_value_take_boxed, function in Standard Parameter and Value Types +
    -
    g_value_take_object
    +
    +g_value_take_object, function in Standard Parameter and Value Types +
    -
    g_value_take_param
    +
    +g_value_take_param, function in Standard Parameter and Value Types +
    -
    g_value_take_string
    +
    +g_value_take_string, function in Standard Parameter and Value Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-6.html b/docs/reference/gobject/html/api-index-2-6.html index f648537..3d147a0 100644 --- a/docs/reference/gobject/html/api-index-2-6.html +++ b/docs/reference/gobject/html/api-index-2-6.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,13 +26,17 @@

    Index of new symbols in 2.6

    T

    -
    g_type_module_register_enum
    +
    +g_type_module_register_enum, function in GTypeModule +
    -
    g_type_module_register_flags
    +
    +g_type_module_register_flags, function in GTypeModule +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-2-8.html b/docs/reference/gobject/html/api-index-2-8.html index d2922a8..3b36dc1 100644 --- a/docs/reference/gobject/html/api-index-2-8.html +++ b/docs/reference/gobject/html/api-index-2-8.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,13 +26,17 @@

    Index of new symbols in 2.8

    O

    -
    g_object_add_toggle_ref
    +
    +g_object_add_toggle_ref, function in The Base Object Type +
    -
    g_object_remove_toggle_ref
    +
    +g_object_remove_toggle_ref, function in The Base Object Type +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-deprecated.html b/docs/reference/gobject/html/api-index-deprecated.html index a3e109f..c333884 100644 --- a/docs/reference/gobject/html/api-index-deprecated.html +++ b/docs/reference/gobject/html/api-index-deprecated.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -56,17 +26,25 @@

    Index of deprecated symbols

    V

    -
    g_value_set_boxed_take_ownership
    +
    +g_value_set_boxed_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_object_take_ownership
    +
    +g_value_set_object_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_param_take_ownership
    +
    +g_value_set_param_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_string_take_ownership
    +
    +g_value_set_string_take_ownership, function in Standard Parameter and Value Types +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/api-index-full.html b/docs/reference/gobject/html/api-index-full.html index 8ee0124..eb8dbb2 100644 --- a/docs/reference/gobject/html/api-index-full.html +++ b/docs/reference/gobject/html/api-index-full.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -80,1272 +50,2528 @@

    Index

    B

    -
    GBaseFinalizeFunc
    +
    +GBaseFinalizeFunc, user_function in Type Information +
    -
    GBaseInitFunc
    +
    +GBaseInitFunc, user_function in Type Information +
    -
    GBoxedCopyFunc
    +
    +GBoxedCopyFunc, user_function in Boxed Types +
    -
    GBoxedFreeFunc
    +
    +GBoxedFreeFunc, user_function in Boxed Types +
    -
    g_boxed_copy
    +
    +g_boxed_copy, function in Boxed Types +
    -
    g_boxed_free
    +
    +g_boxed_free, function in Boxed Types +
    -
    g_boxed_type_register_static
    +
    +g_boxed_type_register_static, function in Boxed Types +

    C

    -
    G_CALLBACK
    +
    +G_CALLBACK, macro in Closures +
    -
    GCallback
    +
    +GCallback, user_function in Closures +
    -
    GCClosure
    +
    +GCClosure, struct in Closures +
    -
    g_cclosure_marshal_BOOLEAN__FLAGS
    +
    +g_cclosure_marshal_BOOLEAN__FLAGS, function in Closures +
    -
    g_cclosure_marshal_BOOL__FLAGS
    +
    +g_cclosure_marshal_BOOL__FLAGS, macro in Closures +
    -
    g_cclosure_marshal_STRING__OBJECT_POINTER
    +
    +g_cclosure_marshal_STRING__OBJECT_POINTER, function in Closures +
    -
    g_cclosure_marshal_VOID__BOOLEAN
    +
    +g_cclosure_marshal_VOID__BOOLEAN, function in Closures +
    -
    g_cclosure_marshal_VOID__BOXED
    +
    +g_cclosure_marshal_VOID__BOXED, function in Closures +
    -
    g_cclosure_marshal_VOID__CHAR
    +
    +g_cclosure_marshal_VOID__CHAR, function in Closures +
    -
    g_cclosure_marshal_VOID__DOUBLE
    +
    +g_cclosure_marshal_VOID__DOUBLE, function in Closures +
    -
    g_cclosure_marshal_VOID__ENUM
    +
    +g_cclosure_marshal_VOID__ENUM, function in Closures +
    -
    g_cclosure_marshal_VOID__FLAGS
    +
    +g_cclosure_marshal_VOID__FLAGS, function in Closures +
    -
    g_cclosure_marshal_VOID__FLOAT
    +
    +g_cclosure_marshal_VOID__FLOAT, function in Closures +
    -
    g_cclosure_marshal_VOID__INT
    +
    +g_cclosure_marshal_VOID__INT, function in Closures +
    -
    g_cclosure_marshal_VOID__LONG
    +
    +g_cclosure_marshal_VOID__LONG, function in Closures +
    -
    g_cclosure_marshal_VOID__OBJECT
    +
    +g_cclosure_marshal_VOID__OBJECT, function in Closures +
    -
    g_cclosure_marshal_VOID__PARAM
    +
    +g_cclosure_marshal_VOID__PARAM, function in Closures +
    -
    g_cclosure_marshal_VOID__POINTER
    +
    +g_cclosure_marshal_VOID__POINTER, function in Closures +
    -
    g_cclosure_marshal_VOID__STRING
    +
    +g_cclosure_marshal_VOID__STRING, function in Closures +
    -
    g_cclosure_marshal_VOID__UCHAR
    +
    +g_cclosure_marshal_VOID__UCHAR, function in Closures +
    -
    g_cclosure_marshal_VOID__UINT
    +
    +g_cclosure_marshal_VOID__UINT, function in Closures +
    -
    g_cclosure_marshal_VOID__UINT_POINTER
    +
    +g_cclosure_marshal_VOID__UINT_POINTER, function in Closures +
    -
    g_cclosure_marshal_VOID__ULONG
    +
    +g_cclosure_marshal_VOID__ULONG, function in Closures +
    -
    g_cclosure_marshal_VOID__VOID
    +
    +g_cclosure_marshal_VOID__VOID, function in Closures +
    -
    g_cclosure_new
    +
    +g_cclosure_new, function in Closures +
    -
    g_cclosure_new_object
    +
    +g_cclosure_new_object, function in Closures +
    -
    g_cclosure_new_object_swap
    +
    +g_cclosure_new_object_swap, function in Closures +
    -
    g_cclosure_new_swap
    +
    +g_cclosure_new_swap, function in Closures +
    -
    G_CCLOSURE_SWAP_DATA
    +
    +G_CCLOSURE_SWAP_DATA, macro in Closures +
    -
    gchararray
    +
    +gchararray, typedef in Standard Parameter and Value Types +
    -
    GClassFinalizeFunc
    +
    +GClassFinalizeFunc, user_function in Type Information +
    -
    GClassInitFunc
    +
    +GClassInitFunc, user_function in Type Information +
    -
    GClosure
    +
    +GClosure, struct in Closures +
    -
    GClosureMarshal
    +
    +GClosureMarshal, user_function in Closures +
    -
    GClosureNotify
    +
    +GClosureNotify, user_function in Closures +
    -
    g_closure_add_finalize_notifier
    +
    +g_closure_add_finalize_notifier, function in Closures +
    -
    g_closure_add_invalidate_notifier
    +
    +g_closure_add_invalidate_notifier, function in Closures +
    -
    g_closure_add_marshal_guards
    +
    +g_closure_add_marshal_guards, function in Closures +
    -
    g_closure_invalidate
    +
    +g_closure_invalidate, function in Closures +
    -
    g_closure_invoke
    +
    +g_closure_invoke, function in Closures +
    -
    G_CLOSURE_NEEDS_MARSHAL
    +
    +G_CLOSURE_NEEDS_MARSHAL, macro in Closures +
    -
    g_closure_new_object
    +
    +g_closure_new_object, function in Closures +
    -
    g_closure_new_simple
    +
    +g_closure_new_simple, function in Closures +
    -
    G_CLOSURE_N_NOTIFIERS
    +
    +G_CLOSURE_N_NOTIFIERS, macro in Closures +
    -
    g_closure_ref
    +
    +g_closure_ref, function in Closures +
    -
    g_closure_remove_finalize_notifier
    +
    +g_closure_remove_finalize_notifier, function in Closures +
    -
    g_closure_remove_invalidate_notifier
    +
    +g_closure_remove_invalidate_notifier, function in Closures +
    -
    g_closure_set_marshal
    +
    +g_closure_set_marshal, function in Closures +
    -
    g_closure_set_meta_marshal
    +
    +g_closure_set_meta_marshal, function in Closures +
    -
    g_closure_sink
    +
    +g_closure_sink, function in Closures +
    -
    g_closure_unref
    +
    +g_closure_unref, function in Closures +
    -
    GConnectFlags
    +
    +GConnectFlags, enum in Signals +

    D

    -
    G_DEFINE_ABSTRACT_TYPE
    +
    +G_DEFINE_ABSTRACT_TYPE, macro in Type Information +
    -
    G_DEFINE_ABSTRACT_TYPE_WITH_CODE
    +
    +G_DEFINE_ABSTRACT_TYPE_WITH_CODE, macro in Type Information +
    -
    G_DEFINE_DYNAMIC_TYPE
    +
    +G_DEFINE_DYNAMIC_TYPE, macro in GTypeModule +
    -
    G_DEFINE_DYNAMIC_TYPE_EXTENDED
    +
    +G_DEFINE_DYNAMIC_TYPE_EXTENDED, macro in GTypeModule +
    -
    G_DEFINE_INTERFACE
    +
    +G_DEFINE_INTERFACE, macro in Type Information +
    -
    G_DEFINE_INTERFACE_WITH_CODE
    +
    +G_DEFINE_INTERFACE_WITH_CODE, macro in Type Information +
    -
    G_DEFINE_TYPE
    +
    +G_DEFINE_TYPE, macro in Type Information +
    -
    G_DEFINE_TYPE_EXTENDED
    +
    +G_DEFINE_TYPE_EXTENDED, macro in Type Information +
    -
    G_DEFINE_TYPE_WITH_CODE
    +
    +G_DEFINE_TYPE_WITH_CODE, macro in Type Information +

    E

    -
    GEnumClass
    +
    +GEnumClass, struct in Enumeration and Flag Types +
    -
    GEnumValue
    +
    +GEnumValue, struct in Enumeration and Flag Types +
    -
    G_ENUM_CLASS
    +
    +G_ENUM_CLASS, macro in Enumeration and Flag Types +
    -
    G_ENUM_CLASS_TYPE
    +
    +G_ENUM_CLASS_TYPE, macro in Enumeration and Flag Types +
    -
    G_ENUM_CLASS_TYPE_NAME
    +
    +G_ENUM_CLASS_TYPE_NAME, macro in Enumeration and Flag Types +
    -
    g_enum_complete_type_info
    +
    +g_enum_complete_type_info, function in Enumeration and Flag Types +
    -
    g_enum_get_value
    +
    +g_enum_get_value, function in Enumeration and Flag Types +
    -
    g_enum_get_value_by_name
    +
    +g_enum_get_value_by_name, function in Enumeration and Flag Types +
    -
    g_enum_get_value_by_nick
    +
    +g_enum_get_value_by_nick, function in Enumeration and Flag Types +
    -
    g_enum_register_static
    +
    +g_enum_register_static, function in Enumeration and Flag Types +

    F

    -
    GFlagsClass
    +
    +GFlagsClass, struct in Enumeration and Flag Types +
    -
    GFlagsValue
    +
    +GFlagsValue, struct in Enumeration and Flag Types +
    -
    G_FLAGS_CLASS
    +
    +G_FLAGS_CLASS, macro in Enumeration and Flag Types +
    -
    G_FLAGS_CLASS_TYPE
    +
    +G_FLAGS_CLASS_TYPE, macro in Enumeration and Flag Types +
    -
    G_FLAGS_CLASS_TYPE_NAME
    +
    +G_FLAGS_CLASS_TYPE_NAME, macro in Enumeration and Flag Types +
    -
    g_flags_complete_type_info
    +
    +g_flags_complete_type_info, function in Enumeration and Flag Types +
    -
    g_flags_get_first_value
    +
    +g_flags_get_first_value, function in Enumeration and Flag Types +
    -
    g_flags_get_value_by_name
    +
    +g_flags_get_value_by_name, function in Enumeration and Flag Types +
    -
    g_flags_get_value_by_nick
    +
    +g_flags_get_value_by_nick, function in Enumeration and Flag Types +
    -
    g_flags_register_static
    +
    +g_flags_register_static, function in Enumeration and Flag Types +

    I

    -
    G_IMPLEMENT_INTERFACE
    +
    +G_IMPLEMENT_INTERFACE, macro in Type Information +
    -
    G_IMPLEMENT_INTERFACE_DYNAMIC
    +
    +G_IMPLEMENT_INTERFACE_DYNAMIC, macro in GTypeModule +
    -
    GInitiallyUnowned
    +
    +GInitiallyUnowned, typedef in The Base Object Type +
    -
    GInitiallyUnownedClass
    +
    +GInitiallyUnownedClass, typedef in The Base Object Type +
    -
    GInstanceInitFunc
    +
    +GInstanceInitFunc, user_function in Type Information +
    -
    GInterfaceFinalizeFunc
    +
    +GInterfaceFinalizeFunc, user_function in Type Information +
    -
    GInterfaceInfo
    +
    +GInterfaceInfo, struct in Type Information +
    -
    GInterfaceInitFunc
    +
    +GInterfaceInitFunc, user_function in Type Information +
    -
    G_IS_ENUM_CLASS
    +
    +G_IS_ENUM_CLASS, macro in Enumeration and Flag Types +
    -
    G_IS_FLAGS_CLASS
    +
    +G_IS_FLAGS_CLASS, macro in Enumeration and Flag Types +
    -
    G_IS_OBJECT
    +
    +G_IS_OBJECT, macro in The Base Object Type +
    -
    G_IS_OBJECT_CLASS
    +
    +G_IS_OBJECT_CLASS, macro in The Base Object Type +
    -
    G_IS_PARAM_SPEC
    +
    +G_IS_PARAM_SPEC, macro in GParamSpec +
    -
    G_IS_PARAM_SPEC_BOOLEAN
    +
    +G_IS_PARAM_SPEC_BOOLEAN, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_BOXED
    +
    +G_IS_PARAM_SPEC_BOXED, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_CHAR
    +
    +G_IS_PARAM_SPEC_CHAR, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_CLASS
    +
    +G_IS_PARAM_SPEC_CLASS, macro in GParamSpec +
    -
    G_IS_PARAM_SPEC_DOUBLE
    +
    +G_IS_PARAM_SPEC_DOUBLE, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_ENUM
    +
    +G_IS_PARAM_SPEC_ENUM, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_FLAGS
    +
    +G_IS_PARAM_SPEC_FLAGS, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_FLOAT
    +
    +G_IS_PARAM_SPEC_FLOAT, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_GTYPE
    +
    +G_IS_PARAM_SPEC_GTYPE, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_INT
    +
    +G_IS_PARAM_SPEC_INT, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_INT64
    +
    +G_IS_PARAM_SPEC_INT64, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_LONG
    +
    +G_IS_PARAM_SPEC_LONG, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_OBJECT
    +
    +G_IS_PARAM_SPEC_OBJECT, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_OVERRIDE
    +
    +G_IS_PARAM_SPEC_OVERRIDE, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_PARAM
    +
    +G_IS_PARAM_SPEC_PARAM, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_POINTER
    +
    +G_IS_PARAM_SPEC_POINTER, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_STRING
    +
    +G_IS_PARAM_SPEC_STRING, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_UCHAR
    +
    +G_IS_PARAM_SPEC_UCHAR, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_UINT
    +
    +G_IS_PARAM_SPEC_UINT, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_UINT64
    +
    +G_IS_PARAM_SPEC_UINT64, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_ULONG
    +
    +G_IS_PARAM_SPEC_ULONG, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_UNICHAR
    +
    +G_IS_PARAM_SPEC_UNICHAR, macro in Standard Parameter and Value Types +
    -
    G_IS_PARAM_SPEC_VALUE_ARRAY
    +
    +G_IS_PARAM_SPEC_VALUE_ARRAY, macro in Standard Parameter and Value Types +
    -
    G_IS_VALUE
    +
    +G_IS_VALUE, macro in Generic values +

    O

    -
    GObject
    +
    +GObject, struct in The Base Object Type +
    -
    G_OBJECT
    +
    +G_OBJECT, macro in The Base Object Type +
    -
    GObject::notify
    +
    +GObject::notify, object signal in The Base Object Type +
    -
    GObjectClass
    +
    +GObjectClass, struct in The Base Object Type +
    -
    GObjectConstructParam
    +
    +GObjectConstructParam, struct in The Base Object Type +
    -
    GObjectFinalizeFunc
    +
    +GObjectFinalizeFunc, user_function in The Base Object Type +
    -
    GObjectGetPropertyFunc
    +
    +GObjectGetPropertyFunc, user_function in The Base Object Type +
    -
    GObjectSetPropertyFunc
    +
    +GObjectSetPropertyFunc, user_function in The Base Object Type +
    -
    g_object_add_toggle_ref
    +
    +g_object_add_toggle_ref, function in The Base Object Type +
    -
    g_object_add_weak_pointer
    +
    +g_object_add_weak_pointer, function in The Base Object Type +
    -
    G_OBJECT_CLASS
    +
    +G_OBJECT_CLASS, macro in The Base Object Type +
    -
    g_object_class_find_property
    +
    +g_object_class_find_property, function in The Base Object Type +
    -
    g_object_class_install_property
    +
    +g_object_class_install_property, function in The Base Object Type +
    -
    g_object_class_list_properties
    +
    +g_object_class_list_properties, function in The Base Object Type +
    -
    G_OBJECT_CLASS_NAME
    +
    +G_OBJECT_CLASS_NAME, macro in The Base Object Type +
    -
    g_object_class_override_property
    +
    +g_object_class_override_property, function in The Base Object Type +
    -
    G_OBJECT_CLASS_TYPE
    +
    +G_OBJECT_CLASS_TYPE, macro in The Base Object Type +
    -
    g_object_connect
    +
    +g_object_connect, function in The Base Object Type +
    -
    g_object_disconnect
    +
    +g_object_disconnect, function in The Base Object Type +
    -
    g_object_force_floating
    +
    +g_object_force_floating, function in The Base Object Type +
    -
    g_object_freeze_notify
    +
    +g_object_freeze_notify, function in The Base Object Type +
    -
    g_object_get
    +
    +g_object_get, function in The Base Object Type +
    -
    G_OBJECT_GET_CLASS
    +
    +G_OBJECT_GET_CLASS, macro in The Base Object Type +
    -
    g_object_get_data
    +
    +g_object_get_data, function in The Base Object Type +
    -
    g_object_get_property
    +
    +g_object_get_property, function in The Base Object Type +
    -
    g_object_get_qdata
    +
    +g_object_get_qdata, function in The Base Object Type +
    -
    g_object_get_valist
    +
    +g_object_get_valist, function in The Base Object Type +
    -
    g_object_interface_find_property
    +
    +g_object_interface_find_property, function in The Base Object Type +
    -
    g_object_interface_install_property
    +
    +g_object_interface_install_property, function in The Base Object Type +
    -
    g_object_interface_list_properties
    +
    +g_object_interface_list_properties, function in The Base Object Type +
    -
    g_object_is_floating
    +
    +g_object_is_floating, function in The Base Object Type +
    -
    g_object_new
    +
    +g_object_new, function in The Base Object Type +
    -
    g_object_newv
    +
    +g_object_newv, function in The Base Object Type +
    -
    g_object_new_valist
    +
    +g_object_new_valist, function in The Base Object Type +
    -
    g_object_notify
    +
    +g_object_notify, function in The Base Object Type +
    -
    g_object_ref
    +
    +g_object_ref, function in The Base Object Type +
    -
    g_object_ref_sink
    +
    +g_object_ref_sink, function in The Base Object Type +
    -
    g_object_remove_toggle_ref
    +
    +g_object_remove_toggle_ref, function in The Base Object Type +
    -
    g_object_remove_weak_pointer
    +
    +g_object_remove_weak_pointer, function in The Base Object Type +
    -
    g_object_run_dispose
    +
    +g_object_run_dispose, function in The Base Object Type +
    -
    g_object_set
    +
    +g_object_set, function in The Base Object Type +
    -
    g_object_set_data
    +
    +g_object_set_data, function in The Base Object Type +
    -
    g_object_set_data_full
    +
    +g_object_set_data_full, function in The Base Object Type +
    -
    g_object_set_property
    +
    +g_object_set_property, function in The Base Object Type +
    -
    g_object_set_qdata
    +
    +g_object_set_qdata, function in The Base Object Type +
    -
    g_object_set_qdata_full
    +
    +g_object_set_qdata_full, function in The Base Object Type +
    -
    g_object_set_valist
    +
    +g_object_set_valist, function in The Base Object Type +
    -
    g_object_steal_data
    +
    +g_object_steal_data, function in The Base Object Type +
    -
    g_object_steal_qdata
    +
    +g_object_steal_qdata, function in The Base Object Type +
    -
    g_object_thaw_notify
    +
    +g_object_thaw_notify, function in The Base Object Type +
    -
    G_OBJECT_TYPE
    +
    +G_OBJECT_TYPE, macro in The Base Object Type +
    -
    G_OBJECT_TYPE_NAME
    +
    +G_OBJECT_TYPE_NAME, macro in The Base Object Type +
    -
    g_object_unref
    +
    +g_object_unref, function in The Base Object Type +
    -
    G_OBJECT_WARN_INVALID_PROPERTY_ID
    +
    +G_OBJECT_WARN_INVALID_PROPERTY_ID, macro in The Base Object Type +
    -
    g_object_watch_closure
    +
    +g_object_watch_closure, function in The Base Object Type +
    -
    g_object_weak_ref
    +
    +g_object_weak_ref, function in The Base Object Type +
    -
    g_object_weak_unref
    +
    +g_object_weak_unref, function in The Base Object Type +

    P

    -
    GParameter
    +
    +GParameter, struct in The Base Object Type +
    -
    GParamFlags
    +
    +GParamFlags, enum in GParamSpec +
    -
    GParamSpec
    +
    +GParamSpec, struct in GParamSpec +
    -
    GParamSpecBoolean
    +
    +GParamSpecBoolean, struct in Standard Parameter and Value Types +
    -
    GParamSpecBoxed
    +
    +GParamSpecBoxed, struct in Standard Parameter and Value Types +
    -
    GParamSpecChar
    +
    +GParamSpecChar, struct in Standard Parameter and Value Types +
    -
    GParamSpecClass
    +
    +GParamSpecClass, struct in GParamSpec +
    -
    GParamSpecDouble
    +
    +GParamSpecDouble, struct in Standard Parameter and Value Types +
    -
    GParamSpecEnum
    +
    +GParamSpecEnum, struct in Standard Parameter and Value Types +
    -
    GParamSpecFlags
    +
    +GParamSpecFlags, struct in Standard Parameter and Value Types +
    -
    GParamSpecFloat
    +
    +GParamSpecFloat, struct in Standard Parameter and Value Types +
    -
    GParamSpecGType
    +
    +GParamSpecGType, struct in Standard Parameter and Value Types +
    -
    GParamSpecInt
    +
    +GParamSpecInt, struct in Standard Parameter and Value Types +
    -
    GParamSpecInt64
    +
    +GParamSpecInt64, struct in Standard Parameter and Value Types +
    -
    GParamSpecLong
    +
    +GParamSpecLong, struct in Standard Parameter and Value Types +
    -
    GParamSpecObject
    +
    +GParamSpecObject, struct in Standard Parameter and Value Types +
    -
    GParamSpecOverride
    +
    +GParamSpecOverride, struct in Standard Parameter and Value Types +
    -
    GParamSpecParam
    +
    +GParamSpecParam, struct in Standard Parameter and Value Types +
    -
    GParamSpecPointer
    +
    +GParamSpecPointer, struct in Standard Parameter and Value Types +
    -
    GParamSpecPool
    +
    +GParamSpecPool, struct in GParamSpec +
    -
    GParamSpecString
    +
    +GParamSpecString, struct in Standard Parameter and Value Types +
    -
    GParamSpecTypeInfo
    +
    +GParamSpecTypeInfo, struct in GParamSpec +
    -
    GParamSpecUChar
    +
    +GParamSpecUChar, struct in Standard Parameter and Value Types +
    -
    GParamSpecUInt
    +
    +GParamSpecUInt, struct in Standard Parameter and Value Types +
    -
    GParamSpecUInt64
    +
    +GParamSpecUInt64, struct in Standard Parameter and Value Types +
    -
    GParamSpecULong
    +
    +GParamSpecULong, struct in Standard Parameter and Value Types +
    -
    GParamSpecUnichar
    +
    +GParamSpecUnichar, struct in Standard Parameter and Value Types +
    -
    GParamSpecValueArray
    +
    +GParamSpecValueArray, struct in Standard Parameter and Value Types +
    -
    G_PARAM_MASK
    +
    +G_PARAM_MASK, macro in GParamSpec +
    -
    G_PARAM_READWRITE
    +
    +G_PARAM_READWRITE, macro in GParamSpec +
    -
    G_PARAM_SPEC
    +
    +G_PARAM_SPEC, macro in GParamSpec +
    -
    G_PARAM_SPEC_BOOLEAN
    +
    +G_PARAM_SPEC_BOOLEAN, macro in Standard Parameter and Value Types +
    -
    g_param_spec_boolean
    +
    +g_param_spec_boolean, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_BOXED
    +
    +G_PARAM_SPEC_BOXED, macro in Standard Parameter and Value Types +
    -
    g_param_spec_boxed
    +
    +g_param_spec_boxed, function in Standard Parameter and Value Types +
    -
    g_param_spec_char
    +
    +g_param_spec_char, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_CHAR
    +
    +G_PARAM_SPEC_CHAR, macro in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_CLASS
    +
    +G_PARAM_SPEC_CLASS, macro in GParamSpec +
    -
    G_PARAM_SPEC_DOUBLE
    +
    +G_PARAM_SPEC_DOUBLE, macro in Standard Parameter and Value Types +
    -
    g_param_spec_double
    +
    +g_param_spec_double, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_ENUM
    +
    +G_PARAM_SPEC_ENUM, macro in Standard Parameter and Value Types +
    -
    g_param_spec_enum
    +
    +g_param_spec_enum, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_FLAGS
    +
    +G_PARAM_SPEC_FLAGS, macro in Standard Parameter and Value Types +
    -
    g_param_spec_flags
    +
    +g_param_spec_flags, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_FLOAT
    +
    +G_PARAM_SPEC_FLOAT, macro in Standard Parameter and Value Types +
    -
    g_param_spec_float
    +
    +g_param_spec_float, function in Standard Parameter and Value Types +
    -
    g_param_spec_get_blurb
    +
    +g_param_spec_get_blurb, function in GParamSpec +
    -
    G_PARAM_SPEC_GET_CLASS
    +
    +G_PARAM_SPEC_GET_CLASS, macro in GParamSpec +
    -
    g_param_spec_get_name
    +
    +g_param_spec_get_name, function in GParamSpec +
    -
    g_param_spec_get_nick
    +
    +g_param_spec_get_nick, function in GParamSpec +
    -
    g_param_spec_get_qdata
    +
    +g_param_spec_get_qdata, function in GParamSpec +
    -
    g_param_spec_get_redirect_target
    +
    +g_param_spec_get_redirect_target, function in GParamSpec +
    -
    g_param_spec_gtype
    +
    +g_param_spec_gtype, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_GTYPE
    +
    +G_PARAM_SPEC_GTYPE, macro in Standard Parameter and Value Types +
    -
    g_param_spec_int
    +
    +g_param_spec_int, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_INT
    +
    +G_PARAM_SPEC_INT, macro in Standard Parameter and Value Types +
    -
    g_param_spec_int64
    +
    +g_param_spec_int64, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_INT64
    +
    +G_PARAM_SPEC_INT64, macro in Standard Parameter and Value Types +
    -
    g_param_spec_internal
    +
    +g_param_spec_internal, function in GParamSpec +
    -
    G_PARAM_SPEC_LONG
    +
    +G_PARAM_SPEC_LONG, macro in Standard Parameter and Value Types +
    -
    g_param_spec_long
    +
    +g_param_spec_long, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_OBJECT
    +
    +G_PARAM_SPEC_OBJECT, macro in Standard Parameter and Value Types +
    -
    g_param_spec_object
    +
    +g_param_spec_object, function in Standard Parameter and Value Types +
    -
    g_param_spec_override
    +
    +g_param_spec_override, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_OVERRIDE
    +
    +G_PARAM_SPEC_OVERRIDE, macro in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_PARAM
    +
    +G_PARAM_SPEC_PARAM, macro in Standard Parameter and Value Types +
    -
    g_param_spec_param
    +
    +g_param_spec_param, function in Standard Parameter and Value Types +
    -
    g_param_spec_pointer
    +
    +g_param_spec_pointer, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_POINTER
    +
    +G_PARAM_SPEC_POINTER, macro in Standard Parameter and Value Types +
    -
    g_param_spec_pool_insert
    +
    +g_param_spec_pool_insert, function in GParamSpec +
    -
    g_param_spec_pool_list
    +
    +g_param_spec_pool_list, function in GParamSpec +
    -
    g_param_spec_pool_list_owned
    +
    +g_param_spec_pool_list_owned, function in GParamSpec +
    -
    g_param_spec_pool_lookup
    +
    +g_param_spec_pool_lookup, function in GParamSpec +
    -
    g_param_spec_pool_new
    +
    +g_param_spec_pool_new, function in GParamSpec +
    -
    g_param_spec_pool_remove
    +
    +g_param_spec_pool_remove, function in GParamSpec +
    -
    g_param_spec_ref
    +
    +g_param_spec_ref, function in GParamSpec +
    -
    g_param_spec_ref_sink
    +
    +g_param_spec_ref_sink, function in GParamSpec +
    -
    g_param_spec_set_qdata
    +
    +g_param_spec_set_qdata, function in GParamSpec +
    -
    g_param_spec_set_qdata_full
    +
    +g_param_spec_set_qdata_full, function in GParamSpec +
    -
    g_param_spec_sink
    +
    +g_param_spec_sink, function in GParamSpec +
    -
    g_param_spec_steal_qdata
    +
    +g_param_spec_steal_qdata, function in GParamSpec +
    -
    g_param_spec_string
    +
    +g_param_spec_string, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_STRING
    +
    +G_PARAM_SPEC_STRING, macro in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_TYPE
    +
    +G_PARAM_SPEC_TYPE, macro in GParamSpec +
    -
    G_PARAM_SPEC_TYPE_NAME
    +
    +G_PARAM_SPEC_TYPE_NAME, macro in GParamSpec +
    -
    g_param_spec_uchar
    +
    +g_param_spec_uchar, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_UCHAR
    +
    +G_PARAM_SPEC_UCHAR, macro in Standard Parameter and Value Types +
    -
    g_param_spec_uint
    +
    +g_param_spec_uint, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_UINT
    +
    +G_PARAM_SPEC_UINT, macro in Standard Parameter and Value Types +
    -
    g_param_spec_uint64
    +
    +g_param_spec_uint64, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_UINT64
    +
    +G_PARAM_SPEC_UINT64, macro in Standard Parameter and Value Types +
    -
    g_param_spec_ulong
    +
    +g_param_spec_ulong, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_ULONG
    +
    +G_PARAM_SPEC_ULONG, macro in Standard Parameter and Value Types +
    -
    g_param_spec_unichar
    +
    +g_param_spec_unichar, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_UNICHAR
    +
    +G_PARAM_SPEC_UNICHAR, macro in Standard Parameter and Value Types +
    -
    g_param_spec_unref
    +
    +g_param_spec_unref, function in GParamSpec +
    -
    g_param_spec_value_array
    +
    +g_param_spec_value_array, function in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_VALUE_ARRAY
    +
    +G_PARAM_SPEC_VALUE_ARRAY, macro in Standard Parameter and Value Types +
    -
    G_PARAM_SPEC_VALUE_TYPE
    +
    +G_PARAM_SPEC_VALUE_TYPE, macro in GParamSpec +
    -
    G_PARAM_STATIC_STRINGS
    +
    +G_PARAM_STATIC_STRINGS, macro in GParamSpec +
    -
    g_param_type_register_static
    +
    +g_param_type_register_static, function in GParamSpec +
    -
    G_PARAM_USER_SHIFT
    +
    +G_PARAM_USER_SHIFT, macro in GParamSpec +
    -
    g_param_values_cmp
    +
    +g_param_values_cmp, function in GParamSpec +
    -
    g_param_value_convert
    +
    +g_param_value_convert, function in GParamSpec +
    -
    g_param_value_defaults
    +
    +g_param_value_defaults, function in GParamSpec +
    -
    g_param_value_set_default
    +
    +g_param_value_set_default, function in GParamSpec +
    -
    g_param_value_validate
    +
    +g_param_value_validate, function in GParamSpec +
    -
    g_pointer_type_register_static
    +
    +g_pointer_type_register_static, function in Boxed Types +

    S

    -
    GSignalAccumulator
    +
    +GSignalAccumulator, user_function in Signals +
    -
    GSignalCMarshaller
    +
    +GSignalCMarshaller, typedef in Signals +
    -
    GSignalEmissionHook
    +
    +GSignalEmissionHook, user_function in Signals +
    -
    GSignalFlags
    +
    +GSignalFlags, enum in Signals +
    -
    GSignalInvocationHint
    +
    +GSignalInvocationHint, struct in Signals +
    -
    GSignalMatchType
    +
    +GSignalMatchType, enum in Signals +
    -
    GSignalQuery
    +
    +GSignalQuery, struct in Signals +
    -
    g_signal_accumulator_true_handled
    +
    +g_signal_accumulator_true_handled, function in Signals +
    -
    g_signal_add_emission_hook
    +
    +g_signal_add_emission_hook, function in Signals +
    -
    g_signal_chain_from_overridden
    +
    +g_signal_chain_from_overridden, function in Signals +
    -
    g_signal_chain_from_overridden_handler
    +
    +g_signal_chain_from_overridden_handler, function in Signals +
    -
    g_signal_connect
    +
    +g_signal_connect, macro in Signals +
    -
    g_signal_connect_after
    +
    +g_signal_connect_after, macro in Signals +
    -
    g_signal_connect_closure
    +
    +g_signal_connect_closure, function in Signals +
    -
    g_signal_connect_closure_by_id
    +
    +g_signal_connect_closure_by_id, function in Signals +
    -
    g_signal_connect_data
    +
    +g_signal_connect_data, function in Signals +
    -
    g_signal_connect_object
    +
    +g_signal_connect_object, function in Signals +
    -
    g_signal_connect_swapped
    +
    +g_signal_connect_swapped, macro in Signals +
    -
    g_signal_emit
    +
    +g_signal_emit, function in Signals +
    -
    g_signal_emitv
    +
    +g_signal_emitv, function in Signals +
    -
    g_signal_emit_by_name
    +
    +g_signal_emit_by_name, function in Signals +
    -
    g_signal_emit_valist
    +
    +g_signal_emit_valist, function in Signals +
    -
    G_SIGNAL_FLAGS_MASK
    +
    +G_SIGNAL_FLAGS_MASK, macro in Signals +
    -
    g_signal_get_invocation_hint
    +
    +g_signal_get_invocation_hint, function in Signals +
    -
    g_signal_handlers_block_by_func
    +
    +g_signal_handlers_block_by_func, macro in Signals +
    -
    g_signal_handlers_block_matched
    +
    +g_signal_handlers_block_matched, function in Signals +
    -
    g_signal_handlers_disconnect_by_func
    +
    +g_signal_handlers_disconnect_by_func, macro in Signals +
    -
    g_signal_handlers_disconnect_matched
    +
    +g_signal_handlers_disconnect_matched, function in Signals +
    -
    g_signal_handlers_unblock_by_func
    +
    +g_signal_handlers_unblock_by_func, macro in Signals +
    -
    g_signal_handlers_unblock_matched
    +
    +g_signal_handlers_unblock_matched, function in Signals +
    -
    g_signal_handler_block
    +
    +g_signal_handler_block, function in Signals +
    -
    g_signal_handler_disconnect
    +
    +g_signal_handler_disconnect, function in Signals +
    -
    g_signal_handler_find
    +
    +g_signal_handler_find, function in Signals +
    -
    g_signal_handler_is_connected
    +
    +g_signal_handler_is_connected, function in Signals +
    -
    g_signal_handler_unblock
    +
    +g_signal_handler_unblock, function in Signals +
    -
    g_signal_has_handler_pending
    +
    +g_signal_has_handler_pending, function in Signals +
    -
    g_signal_list_ids
    +
    +g_signal_list_ids, function in Signals +
    -
    g_signal_lookup
    +
    +g_signal_lookup, function in Signals +
    -
    G_SIGNAL_MATCH_MASK
    +
    +G_SIGNAL_MATCH_MASK, macro in Signals +
    -
    g_signal_name
    +
    +g_signal_name, function in Signals +
    -
    g_signal_new
    +
    +g_signal_new, function in Signals +
    -
    g_signal_newv
    +
    +g_signal_newv, function in Signals +
    -
    g_signal_new_class_handler
    +
    +g_signal_new_class_handler, function in Signals +
    -
    g_signal_new_valist
    +
    +g_signal_new_valist, function in Signals +
    -
    g_signal_override_class_closure
    +
    +g_signal_override_class_closure, function in Signals +
    -
    g_signal_override_class_handler
    +
    +g_signal_override_class_handler, function in Signals +
    -
    g_signal_parse_name
    +
    +g_signal_parse_name, function in Signals +
    -
    g_signal_query
    +
    +g_signal_query, function in Signals +
    -
    g_signal_remove_emission_hook
    +
    +g_signal_remove_emission_hook, function in Signals +
    -
    g_signal_stop_emission
    +
    +g_signal_stop_emission, function in Signals +
    -
    g_signal_stop_emission_by_name
    +
    +g_signal_stop_emission_by_name, function in Signals +
    -
    g_signal_type_cclosure_new
    +
    +g_signal_type_cclosure_new, function in Signals +
    -
    G_SIGNAL_TYPE_STATIC_SCOPE
    +
    +G_SIGNAL_TYPE_STATIC_SCOPE, macro in Signals +
    -
    g_source_set_closure
    +
    +g_source_set_closure, function in Closures +
    -
    g_strdup_value_contents
    +
    +g_strdup_value_contents, function in Generic values +
    -
    GStrv
    +
    +GStrv, typedef in Boxed Types +

    T

    -
    GToggleNotify
    +
    +GToggleNotify, user_function in The Base Object Type +
    -
    GType
    +
    +GType, typedef in Type Information +
    -
    GTypeClass
    +
    +GTypeClass, struct in Type Information +
    -
    GTypeClassCacheFunc
    +
    +GTypeClassCacheFunc, user_function in Type Information +
    -
    GTypeCValue
    +
    +GTypeCValue, union in Varargs Value Collection +
    -
    GTypeDebugFlags
    +
    +GTypeDebugFlags, enum in Type Information +
    -
    GTypeFlags
    +
    +GTypeFlags, enum in Type Information +
    -
    GTypeFundamentalFlags
    +
    +GTypeFundamentalFlags, enum in Type Information +
    -
    GTypeFundamentalInfo
    +
    +GTypeFundamentalInfo, struct in Type Information +
    -
    GTypeInfo
    +
    +GTypeInfo, struct in Type Information +
    -
    GTypeInstance
    +
    +GTypeInstance, struct in Type Information +
    -
    GTypeInterface
    +
    +GTypeInterface, struct in Type Information +
    -
    GTypeInterfaceCheckFunc
    +
    +GTypeInterfaceCheckFunc, user_function in Type Information +
    -
    GTypeModule
    +
    +GTypeModule, struct in GTypeModule +
    -
    GTypeModuleClass
    +
    +GTypeModuleClass, struct in GTypeModule +
    -
    GTypePlugin
    +
    +GTypePlugin, struct in GTypePlugin +
    -
    GTypePluginClass
    +
    +GTypePluginClass, struct in GTypePlugin +
    -
    GTypePluginCompleteInterfaceInfo
    +
    +GTypePluginCompleteInterfaceInfo, user_function in GTypePlugin +
    -
    GTypePluginCompleteTypeInfo
    +
    +GTypePluginCompleteTypeInfo, user_function in GTypePlugin +
    -
    GTypePluginUnuse
    +
    +GTypePluginUnuse, user_function in GTypePlugin +
    -
    GTypePluginUse
    +
    +GTypePluginUse, user_function in GTypePlugin +
    -
    GTypeQuery
    +
    +GTypeQuery, struct in Type Information +
    -
    GTypeValueTable
    +
    +GTypeValueTable, struct in Type Information +
    -
    g_type_add_class_cache_func
    +
    +g_type_add_class_cache_func, function in Type Information +
    -
    g_type_add_class_private
    +
    +g_type_add_class_private, function in Type Information +
    -
    g_type_add_interface_check
    +
    +g_type_add_interface_check, function in Type Information +
    -
    g_type_add_interface_dynamic
    +
    +g_type_add_interface_dynamic, function in Type Information +
    -
    g_type_add_interface_static
    +
    +g_type_add_interface_static, function in Type Information +
    -
    G_TYPE_ARRAY
    +
    +G_TYPE_ARRAY, macro in Boxed Types +
    -
    G_TYPE_BOOLEAN
    +
    +G_TYPE_BOOLEAN, macro in Type Information +
    -
    G_TYPE_BOXED
    +
    +G_TYPE_BOXED, macro in Type Information +
    -
    G_TYPE_BYTE_ARRAY
    +
    +G_TYPE_BYTE_ARRAY, macro in Boxed Types +
    -
    G_TYPE_CHAR
    +
    +G_TYPE_CHAR, macro in Type Information +
    -
    G_TYPE_CHECK_CLASS_CAST
    +
    +G_TYPE_CHECK_CLASS_CAST, macro in Type Information +
    -
    G_TYPE_CHECK_CLASS_TYPE
    +
    +G_TYPE_CHECK_CLASS_TYPE, macro in Type Information +
    -
    G_TYPE_CHECK_INSTANCE
    +
    +G_TYPE_CHECK_INSTANCE, macro in Type Information +
    -
    G_TYPE_CHECK_INSTANCE_CAST
    +
    +G_TYPE_CHECK_INSTANCE_CAST, macro in Type Information +
    -
    G_TYPE_CHECK_INSTANCE_TYPE
    +
    +G_TYPE_CHECK_INSTANCE_TYPE, macro in Type Information +
    -
    G_TYPE_CHECK_VALUE
    +
    +G_TYPE_CHECK_VALUE, macro in Type Information +
    -
    G_TYPE_CHECK_VALUE_TYPE
    +
    +G_TYPE_CHECK_VALUE_TYPE, macro in Type Information +
    -
    g_type_children
    +
    +g_type_children, function in Type Information +
    -
    g_type_class_add_private
    +
    +g_type_class_add_private, function in Type Information +
    -
    g_type_class_peek
    +
    +g_type_class_peek, function in Type Information +
    -
    g_type_class_peek_parent
    +
    +g_type_class_peek_parent, function in Type Information +
    -
    g_type_class_peek_static
    +
    +g_type_class_peek_static, function in Type Information +
    -
    g_type_class_ref
    +
    +g_type_class_ref, function in Type Information +
    -
    g_type_class_unref
    +
    +g_type_class_unref, function in Type Information +
    -
    g_type_class_unref_uncached
    +
    +g_type_class_unref_uncached, function in Type Information +
    -
    G_TYPE_CLOSURE
    +
    +G_TYPE_CLOSURE, macro in Closures +
    -
    g_type_create_instance
    +
    +g_type_create_instance, function in Type Information +
    -
    G_TYPE_DATE
    +
    +G_TYPE_DATE, macro in Boxed Types +
    -
    g_type_default_interface_peek
    +
    +g_type_default_interface_peek, function in Type Information +
    -
    g_type_default_interface_ref
    +
    +g_type_default_interface_ref, function in Type Information +
    -
    g_type_default_interface_unref
    +
    +g_type_default_interface_unref, function in Type Information +
    -
    g_type_depth
    +
    +g_type_depth, function in Type Information +
    -
    G_TYPE_DOUBLE
    +
    +G_TYPE_DOUBLE, macro in Type Information +
    -
    G_TYPE_ENUM
    +
    +G_TYPE_ENUM, macro in Type Information +
    -
    G_TYPE_FLAGS
    +
    +G_TYPE_FLAGS, macro in Type Information +
    -
    G_TYPE_FLAG_RESERVED_ID_BIT
    +
    +G_TYPE_FLAG_RESERVED_ID_BIT, macro in Type Information +
    -
    G_TYPE_FLOAT
    +
    +G_TYPE_FLOAT, macro in Type Information +
    -
    g_type_free_instance
    +
    +g_type_free_instance, function in Type Information +
    -
    G_TYPE_FROM_CLASS
    +
    +G_TYPE_FROM_CLASS, macro in Type Information +
    -
    G_TYPE_FROM_INSTANCE
    +
    +G_TYPE_FROM_INSTANCE, macro in Type Information +
    -
    G_TYPE_FROM_INTERFACE
    +
    +G_TYPE_FROM_INTERFACE, macro in Type Information +
    -
    g_type_from_name
    +
    +g_type_from_name, function in Type Information +
    -
    g_type_fundamental
    +
    +g_type_fundamental, function in Type Information +
    -
    G_TYPE_FUNDAMENTAL
    +
    +G_TYPE_FUNDAMENTAL, macro in Type Information +
    -
    G_TYPE_FUNDAMENTAL_MAX
    +
    +G_TYPE_FUNDAMENTAL_MAX, macro in Type Information +
    -
    g_type_fundamental_next
    +
    +g_type_fundamental_next, function in Type Information +
    -
    g_type_get_plugin
    +
    +g_type_get_plugin, function in Type Information +
    -
    g_type_get_qdata
    +
    +g_type_get_qdata, function in Type Information +
    -
    G_TYPE_GSTRING
    +
    +G_TYPE_GSTRING, macro in Boxed Types +
    -
    G_TYPE_GTYPE
    +
    +G_TYPE_GTYPE, macro in Type Information +
    -
    G_TYPE_HASH_TABLE
    +
    +G_TYPE_HASH_TABLE, macro in Boxed Types +
    -
    G_TYPE_HAS_VALUE_TABLE
    +
    +G_TYPE_HAS_VALUE_TABLE, macro in Type Information +
    -
    g_type_init
    +
    +g_type_init, function in Type Information +
    -
    G_TYPE_INITIALLY_UNOWNED
    +
    +G_TYPE_INITIALLY_UNOWNED, macro in The Base Object Type +
    -
    g_type_init_with_debug_flags
    +
    +g_type_init_with_debug_flags, function in Type Information +
    -
    G_TYPE_INSTANCE_GET_CLASS
    +
    +G_TYPE_INSTANCE_GET_CLASS, macro in Type Information +
    -
    G_TYPE_INSTANCE_GET_INTERFACE
    +
    +G_TYPE_INSTANCE_GET_INTERFACE, macro in Type Information +
    -
    G_TYPE_INSTANCE_GET_PRIVATE
    +
    +G_TYPE_INSTANCE_GET_PRIVATE, macro in Type Information +
    -
    G_TYPE_INT
    +
    +G_TYPE_INT, macro in Type Information +
    -
    G_TYPE_INT64
    +
    +G_TYPE_INT64, macro in Type Information +
    -
    G_TYPE_INTERFACE
    +
    +G_TYPE_INTERFACE, macro in Type Information +
    -
    g_type_interfaces
    +
    +g_type_interfaces, function in Type Information +
    -
    g_type_interface_add_prerequisite
    +
    +g_type_interface_add_prerequisite, function in Type Information +
    -
    g_type_interface_get_plugin
    +
    +g_type_interface_get_plugin, function in Type Information +
    -
    g_type_interface_peek
    +
    +g_type_interface_peek, function in Type Information +
    -
    g_type_interface_peek_parent
    +
    +g_type_interface_peek_parent, function in Type Information +
    -
    g_type_interface_prerequisites
    +
    +g_type_interface_prerequisites, function in Type Information +
    -
    G_TYPE_INVALID
    +
    +G_TYPE_INVALID, macro in Type Information +
    -
    G_TYPE_IO_CHANNEL
    +
    +G_TYPE_IO_CHANNEL, macro in Closures +
    -
    G_TYPE_IO_CONDITION
    +
    +G_TYPE_IO_CONDITION, macro in Closures +
    -
    g_type_is_a
    +
    +g_type_is_a, function in Type Information +
    -
    G_TYPE_IS_ABSTRACT
    +
    +G_TYPE_IS_ABSTRACT, macro in Type Information +
    -
    G_TYPE_IS_CLASSED
    +
    +G_TYPE_IS_CLASSED, macro in Type Information +
    -
    G_TYPE_IS_DEEP_DERIVABLE
    +
    +G_TYPE_IS_DEEP_DERIVABLE, macro in Type Information +
    -
    G_TYPE_IS_DERIVABLE
    +
    +G_TYPE_IS_DERIVABLE, macro in Type Information +
    -
    G_TYPE_IS_DERIVED
    +
    +G_TYPE_IS_DERIVED, macro in Type Information +
    -
    G_TYPE_IS_ENUM
    +
    +G_TYPE_IS_ENUM, macro in Enumeration and Flag Types +
    -
    G_TYPE_IS_FLAGS
    +
    +G_TYPE_IS_FLAGS, macro in Enumeration and Flag Types +
    -
    G_TYPE_IS_FUNDAMENTAL
    +
    +G_TYPE_IS_FUNDAMENTAL, macro in Type Information +
    -
    G_TYPE_IS_INSTANTIATABLE
    +
    +G_TYPE_IS_INSTANTIATABLE, macro in Type Information +
    -
    G_TYPE_IS_INTERFACE
    +
    +G_TYPE_IS_INTERFACE, macro in Type Information +
    -
    G_TYPE_IS_OBJECT
    +
    +G_TYPE_IS_OBJECT, macro in The Base Object Type +
    -
    G_TYPE_IS_PARAM
    +
    +G_TYPE_IS_PARAM, macro in GParamSpec +
    -
    G_TYPE_IS_VALUE
    +
    +G_TYPE_IS_VALUE, macro in Generic values +
    -
    G_TYPE_IS_VALUE_ABSTRACT
    +
    +G_TYPE_IS_VALUE_ABSTRACT, macro in Generic values +
    -
    G_TYPE_IS_VALUE_TYPE
    +
    +G_TYPE_IS_VALUE_TYPE, macro in Type Information +
    -
    G_TYPE_LONG
    +
    +G_TYPE_LONG, macro in Type Information +
    -
    G_TYPE_MAKE_FUNDAMENTAL
    +
    +G_TYPE_MAKE_FUNDAMENTAL, macro in Type Information +
    -
    g_type_module_add_interface
    +
    +g_type_module_add_interface, function in GTypeModule +
    -
    g_type_module_register_enum
    +
    +g_type_module_register_enum, function in GTypeModule +
    -
    g_type_module_register_flags
    +
    +g_type_module_register_flags, function in GTypeModule +
    -
    g_type_module_register_type
    +
    +g_type_module_register_type, function in GTypeModule +
    -
    g_type_module_set_name
    +
    +g_type_module_set_name, function in GTypeModule +
    -
    g_type_module_unuse
    +
    +g_type_module_unuse, function in GTypeModule +
    -
    g_type_module_use
    +
    +g_type_module_use, function in GTypeModule +
    -
    g_type_name
    +
    +g_type_name, function in Type Information +
    -
    g_type_next_base
    +
    +g_type_next_base, function in Type Information +
    -
    G_TYPE_NONE
    +
    +G_TYPE_NONE, macro in Type Information +
    -
    G_TYPE_OBJECT
    +
    +G_TYPE_OBJECT, macro in Type Information +
    -
    G_TYPE_PARAM
    +
    +G_TYPE_PARAM, macro in Type Information +
    -
    G_TYPE_PARAM_BOOLEAN
    +
    +G_TYPE_PARAM_BOOLEAN, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_BOXED
    +
    +G_TYPE_PARAM_BOXED, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_CHAR
    +
    +G_TYPE_PARAM_CHAR, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_DOUBLE
    +
    +G_TYPE_PARAM_DOUBLE, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_ENUM
    +
    +G_TYPE_PARAM_ENUM, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_FLAGS
    +
    +G_TYPE_PARAM_FLAGS, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_FLOAT
    +
    +G_TYPE_PARAM_FLOAT, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_GTYPE
    +
    +G_TYPE_PARAM_GTYPE, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_INT
    +
    +G_TYPE_PARAM_INT, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_INT64
    +
    +G_TYPE_PARAM_INT64, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_LONG
    +
    +G_TYPE_PARAM_LONG, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_OBJECT
    +
    +G_TYPE_PARAM_OBJECT, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_OVERRIDE
    +
    +G_TYPE_PARAM_OVERRIDE, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_PARAM
    +
    +G_TYPE_PARAM_PARAM, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_POINTER
    +
    +G_TYPE_PARAM_POINTER, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_STRING
    +
    +G_TYPE_PARAM_STRING, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_UCHAR
    +
    +G_TYPE_PARAM_UCHAR, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_UINT
    +
    +G_TYPE_PARAM_UINT, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_UINT64
    +
    +G_TYPE_PARAM_UINT64, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_ULONG
    +
    +G_TYPE_PARAM_ULONG, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_UNICHAR
    +
    +G_TYPE_PARAM_UNICHAR, macro in Standard Parameter and Value Types +
    -
    G_TYPE_PARAM_VALUE_ARRAY
    +
    +G_TYPE_PARAM_VALUE_ARRAY, macro in Standard Parameter and Value Types +
    -
    g_type_parent
    +
    +g_type_parent, function in Type Information +
    -
    g_type_plugin_complete_interface_info
    +
    +g_type_plugin_complete_interface_info, function in GTypePlugin +
    -
    g_type_plugin_complete_type_info
    +
    +g_type_plugin_complete_type_info, function in GTypePlugin +
    -
    g_type_plugin_unuse
    +
    +g_type_plugin_unuse, function in GTypePlugin +
    -
    g_type_plugin_use
    +
    +g_type_plugin_use, function in GTypePlugin +
    -
    G_TYPE_POINTER
    +
    +G_TYPE_POINTER, macro in Type Information +
    -
    G_TYPE_PTR_ARRAY
    +
    +G_TYPE_PTR_ARRAY, macro in Boxed Types +
    -
    g_type_qname
    +
    +g_type_qname, function in Type Information +
    -
    g_type_query
    +
    +g_type_query, function in Type Information +
    -
    G_TYPE_REGEX
    +
    +G_TYPE_REGEX, macro in Boxed Types +
    -
    g_type_register_dynamic
    +
    +g_type_register_dynamic, function in Type Information +
    -
    g_type_register_fundamental
    +
    +g_type_register_fundamental, function in Type Information +
    -
    g_type_register_static
    +
    +g_type_register_static, function in Type Information +
    -
    g_type_register_static_simple
    +
    +g_type_register_static_simple, function in Type Information +
    -
    g_type_remove_class_cache_func
    +
    +g_type_remove_class_cache_func, function in Type Information +
    -
    g_type_remove_interface_check
    +
    +g_type_remove_interface_check, function in Type Information +
    -
    G_TYPE_RESERVED_BSE_FIRST
    +
    +G_TYPE_RESERVED_BSE_FIRST, macro in Type Information +
    -
    G_TYPE_RESERVED_BSE_LAST
    +
    +G_TYPE_RESERVED_BSE_LAST, macro in Type Information +
    -
    G_TYPE_RESERVED_GLIB_FIRST
    +
    +G_TYPE_RESERVED_GLIB_FIRST, macro in Type Information +
    -
    G_TYPE_RESERVED_GLIB_LAST
    +
    +G_TYPE_RESERVED_GLIB_LAST, macro in Type Information +
    -
    G_TYPE_RESERVED_USER_FIRST
    +
    +G_TYPE_RESERVED_USER_FIRST, macro in Type Information +
    -
    g_type_set_qdata
    +
    +g_type_set_qdata, function in Type Information +
    -
    G_TYPE_STRING
    +
    +G_TYPE_STRING, macro in Type Information +
    -
    G_TYPE_STRV
    +
    +G_TYPE_STRV, macro in Boxed Types +
    -
    G_TYPE_UCHAR
    +
    +G_TYPE_UCHAR, macro in Type Information +
    -
    G_TYPE_UINT
    +
    +G_TYPE_UINT, macro in Type Information +
    -
    G_TYPE_UINT64
    +
    +G_TYPE_UINT64, macro in Type Information +
    -
    G_TYPE_ULONG
    +
    +G_TYPE_ULONG, macro in Type Information +
    -
    G_TYPE_VALUE
    +
    +G_TYPE_VALUE, macro in Generic values +
    -
    G_TYPE_VALUE_ARRAY
    +
    +G_TYPE_VALUE_ARRAY, macro in Generic values +
    -
    g_type_value_table_peek
    +
    +g_type_value_table_peek, function in Type Information +
    -
    G_TYPE_VARIANT
    +
    +G_TYPE_VARIANT, macro in Boxed Types +
    -
    G_TYPE_VARIANT_TYPE
    +
    +G_TYPE_VARIANT_TYPE, macro in Boxed Types +

    V

    -
    GValue
    +
    +GValue, struct in Generic values +
    -
    GValueArray
    +
    +GValueArray, struct in Value arrays +
    -
    GValueTransform
    +
    +GValueTransform, user_function in Generic values +
    -
    g_value_array_append
    +
    +g_value_array_append, function in Value arrays +
    -
    g_value_array_copy
    +
    +g_value_array_copy, function in Value arrays +
    -
    g_value_array_free
    +
    +g_value_array_free, function in Value arrays +
    -
    g_value_array_get_nth
    +
    +g_value_array_get_nth, function in Value arrays +
    -
    g_value_array_insert
    +
    +g_value_array_insert, function in Value arrays +
    -
    g_value_array_new
    +
    +g_value_array_new, function in Value arrays +
    -
    g_value_array_prepend
    +
    +g_value_array_prepend, function in Value arrays +
    -
    g_value_array_remove
    +
    +g_value_array_remove, function in Value arrays +
    -
    g_value_array_sort
    +
    +g_value_array_sort, function in Value arrays +
    -
    g_value_array_sort_with_data
    +
    +g_value_array_sort_with_data, function in Value arrays +
    -
    G_VALUE_COLLECT
    +
    +G_VALUE_COLLECT, macro in Varargs Value Collection +
    -
    G_VALUE_COLLECT_FORMAT_MAX_LENGTH
    +
    +G_VALUE_COLLECT_FORMAT_MAX_LENGTH, macro in Varargs Value Collection +
    -
    g_value_copy
    +
    +G_VALUE_COLLECT_INIT, macro in Varargs Value Collection +
    -
    g_value_dup_boxed
    +
    +g_value_copy, function in Generic values +
    -
    g_value_dup_object
    +
    +g_value_dup_boxed, function in Standard Parameter and Value Types +
    -
    g_value_dup_param
    +
    +g_value_dup_object, function in Standard Parameter and Value Types +
    -
    g_value_dup_string
    +
    +g_value_dup_param, function in Standard Parameter and Value Types +
    -
    g_value_fits_pointer
    +
    +g_value_dup_string, function in Standard Parameter and Value Types +
    -
    g_value_get_boolean
    +
    +g_value_fits_pointer, function in Generic values +
    -
    g_value_get_boxed
    +
    +g_value_get_boolean, function in Standard Parameter and Value Types +
    -
    g_value_get_char
    +
    +g_value_get_boxed, function in Standard Parameter and Value Types +
    -
    g_value_get_double
    +
    +g_value_get_char, function in Standard Parameter and Value Types +
    -
    g_value_get_enum
    +
    +g_value_get_double, function in Standard Parameter and Value Types +
    -
    g_value_get_flags
    +
    +g_value_get_enum, function in Standard Parameter and Value Types +
    -
    g_value_get_float
    +
    +g_value_get_flags, function in Standard Parameter and Value Types +
    -
    g_value_get_gtype
    +
    +g_value_get_float, function in Standard Parameter and Value Types +
    -
    g_value_get_int
    +
    +g_value_get_gtype, function in Standard Parameter and Value Types +
    -
    g_value_get_int64
    +
    +g_value_get_int, function in Standard Parameter and Value Types +
    -
    g_value_get_long
    +
    +g_value_get_int64, function in Standard Parameter and Value Types +
    -
    g_value_get_object
    +
    +g_value_get_long, function in Standard Parameter and Value Types +
    -
    g_value_get_param
    +
    +g_value_get_object, function in Standard Parameter and Value Types +
    -
    g_value_get_pointer
    +
    +g_value_get_param, function in Standard Parameter and Value Types +
    -
    g_value_get_string
    +
    +g_value_get_pointer, function in Standard Parameter and Value Types +
    -
    g_value_get_uchar
    +
    +g_value_get_string, function in Standard Parameter and Value Types +
    -
    g_value_get_uint
    +
    +g_value_get_uchar, function in Standard Parameter and Value Types +
    -
    g_value_get_uint64
    +
    +g_value_get_uint, function in Standard Parameter and Value Types +
    -
    g_value_get_ulong
    +
    +g_value_get_uint64, function in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS
    +
    +g_value_get_ulong, function in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_BOOLEAN
    +
    +G_VALUE_HOLDS, macro in Generic values +
    -
    G_VALUE_HOLDS_BOXED
    +
    +G_VALUE_HOLDS_BOOLEAN, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_CHAR
    +
    +G_VALUE_HOLDS_BOXED, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_DOUBLE
    +
    +G_VALUE_HOLDS_CHAR, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_ENUM
    +
    +G_VALUE_HOLDS_DOUBLE, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_FLAGS
    +
    +G_VALUE_HOLDS_ENUM, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_FLOAT
    +
    +G_VALUE_HOLDS_FLAGS, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_GTYPE
    +
    +G_VALUE_HOLDS_FLOAT, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_INT
    +
    +G_VALUE_HOLDS_GTYPE, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_INT64
    +
    +G_VALUE_HOLDS_INT, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_LONG
    +
    +G_VALUE_HOLDS_INT64, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_OBJECT
    +
    +G_VALUE_HOLDS_LONG, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_PARAM
    +
    +G_VALUE_HOLDS_OBJECT, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_POINTER
    +
    +G_VALUE_HOLDS_PARAM, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_STRING
    +
    +G_VALUE_HOLDS_POINTER, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_UCHAR
    +
    +G_VALUE_HOLDS_STRING, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_UINT
    +
    +G_VALUE_HOLDS_UCHAR, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_UINT64
    +
    +G_VALUE_HOLDS_UINT, macro in Standard Parameter and Value Types +
    -
    G_VALUE_HOLDS_ULONG
    +
    +G_VALUE_HOLDS_UINT64, macro in Standard Parameter and Value Types +
    -
    g_value_init
    +
    +G_VALUE_HOLDS_ULONG, macro in Standard Parameter and Value Types +
    -
    G_VALUE_LCOPY
    +
    +g_value_init, function in Generic values +
    -
    g_value_peek_pointer
    +
    +G_VALUE_LCOPY, macro in Varargs Value Collection +
    -
    g_value_register_transform_func
    +
    +g_value_peek_pointer, function in Generic values +
    -
    g_value_reset
    +
    +g_value_register_transform_func, function in Generic values +
    -
    g_value_set_boolean
    +
    +g_value_reset, function in Generic values +
    -
    g_value_set_boxed
    +
    +g_value_set_boolean, function in Standard Parameter and Value Types +
    -
    g_value_set_boxed_take_ownership
    +
    +g_value_set_boxed, function in Standard Parameter and Value Types +
    -
    g_value_set_char
    +
    +g_value_set_boxed_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_double
    +
    +g_value_set_char, function in Standard Parameter and Value Types +
    -
    g_value_set_enum
    +
    +g_value_set_double, function in Standard Parameter and Value Types +
    -
    g_value_set_flags
    +
    +g_value_set_enum, function in Standard Parameter and Value Types +
    -
    g_value_set_float
    +
    +g_value_set_flags, function in Standard Parameter and Value Types +
    -
    g_value_set_gtype
    +
    +g_value_set_float, function in Standard Parameter and Value Types +
    -
    g_value_set_instance
    +
    +g_value_set_gtype, function in Standard Parameter and Value Types +
    -
    g_value_set_int
    +
    +g_value_set_instance, function in Standard Parameter and Value Types +
    -
    g_value_set_int64
    +
    +g_value_set_int, function in Standard Parameter and Value Types +
    -
    g_value_set_long
    +
    +g_value_set_int64, function in Standard Parameter and Value Types +
    -
    g_value_set_object
    +
    +g_value_set_long, function in Standard Parameter and Value Types +
    -
    g_value_set_object_take_ownership
    +
    +g_value_set_object, function in Standard Parameter and Value Types +
    -
    g_value_set_param
    +
    +g_value_set_object_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_param_take_ownership
    +
    +g_value_set_param, function in Standard Parameter and Value Types +
    -
    g_value_set_pointer
    +
    +g_value_set_param_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_static_boxed
    +
    +g_value_set_pointer, function in Standard Parameter and Value Types +
    -
    g_value_set_static_string
    +
    +g_value_set_static_boxed, function in Standard Parameter and Value Types +
    -
    g_value_set_string
    +
    +g_value_set_static_string, function in Standard Parameter and Value Types +
    -
    g_value_set_string_take_ownership
    +
    +g_value_set_string, function in Standard Parameter and Value Types +
    -
    g_value_set_uchar
    +
    +g_value_set_string_take_ownership, function in Standard Parameter and Value Types +
    -
    g_value_set_uint
    +
    +g_value_set_uchar, function in Standard Parameter and Value Types +
    -
    g_value_set_uint64
    +
    +g_value_set_uint, function in Standard Parameter and Value Types +
    -
    g_value_set_ulong
    +
    +g_value_set_uint64, function in Standard Parameter and Value Types +
    -
    g_value_take_boxed
    +
    +g_value_set_ulong, function in Standard Parameter and Value Types +
    -
    g_value_take_object
    +
    +g_value_take_boxed, function in Standard Parameter and Value Types +
    -
    g_value_take_param
    +
    +g_value_take_object, function in Standard Parameter and Value Types +
    -
    g_value_take_string
    +
    +g_value_take_param, function in Standard Parameter and Value Types +
    -
    g_value_transform
    +
    +g_value_take_string, function in Standard Parameter and Value Types +
    -
    G_VALUE_TYPE
    +
    +g_value_transform, function in Generic values +
    -
    g_value_type_compatible
    +
    +G_VALUE_TYPE, macro in Generic values +
    -
    G_VALUE_TYPE_NAME
    +
    +g_value_type_compatible, function in Generic values +
    -
    g_value_type_transformable
    +
    +G_VALUE_TYPE_NAME, macro in Generic values +
    -
    g_value_unset
    +
    +g_value_type_transformable, function in Generic values +
    +
    +
    +g_value_unset, function in Generic values +

    W

    -
    GWeakNotify
    +
    +GWeakNotify, user_function in The Base Object Type +
    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/ch01s02.html b/docs/reference/gobject/html/ch01s02.html index 26c290a..da7a52e 100644 --- a/docs/reference/gobject/html/ch01s02.html +++ b/docs/reference/gobject/html/ch01s02.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

    -Exporting a C API

    +Exporting a C API

    C APIs are defined by a set of functions and global variables which are usually exported from a binary. C functions have an arbitrary number of arguments and one return value. Each function is thus @@ -121,7 +91,7 @@ call 0x80482f4 <function_foo> reads the original function signature.

  • The solution used by GLib is to use the GType library which holds at runtime a description of all the objects manipulated by the programmer. This so-called dynamic type - [1] + [1] library is then used by special generic glue code to automatically convert function parameters and function calling conventions between different runtime domains.

  • @@ -130,7 +100,7 @@ call 0x80482f4 <function_foo> boundaries is written once: the figure below states this more clearly.

    -

    Figure 1. 

    +

    Figure 1. 


    @@ -148,7 +118,7 @@ call 0x80482f4 <function_foo>



    -

    [1] +

    [1] There are numerous different implementations of dynamic type systems: all C++ compilers have one, Java and .NET have one too. A dynamic type system allows you to get information about every instantiated object at runtime. It can be implemented @@ -161,6 +131,6 @@ call 0x80482f4 <function_foo>

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/gobject/html/ch06s03.html b/docs/reference/gobject/html/ch06s03.html index f61561c..38f213c 100644 --- a/docs/reference/gobject/html/ch06s03.html +++ b/docs/reference/gobject/html/ch06s03.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -51,7 +21,7 @@

    -Interface definition prerequisites

    +Interface definition prerequisites

    To specify that an interface requires the presence of other interfaces when implemented, GObject introduces the concept of @@ -138,6 +108,6 @@ G_DEFINE_TYPE_WITH_CODE (MamanBar, maman_bar, G_TYPE_OBJECT,

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/chapter-gobject.html b/docs/reference/gobject/html/chapter-gobject.html index ebb23da..da30c9f 100644 --- a/docs/reference/gobject/html/chapter-gobject.html +++ b/docs/reference/gobject/html/chapter-gobject.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -318,6 +288,6 @@ MamanBar *bar = g_object_new (MAMAN_TYPE_BAR, NULL); + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/chapter-gtype.html b/docs/reference/gobject/html/chapter-gtype.html index e5f79b1..92efae2 100644 --- a/docs/reference/gobject/html/chapter-gtype.html +++ b/docs/reference/gobject/html/chapter-gtype.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -114,7 +84,7 @@ GType g_type_register_fundamental (GType type_id, g_type_register_fundamental (you have to be Tim Janik to do that) but in case you want to, the last chapter explains how to create new fundamental types. - [2] + [2]

    Fundamental types are top-level types which do not derive from any other type @@ -278,7 +248,7 @@ struct _GTypeValueTable



    -

    [2] +

    [2] Please note that there exists another registration function: the g_type_register_dynamic. We will not discuss this function here since its use is very similar to the _static @@ -288,6 +258,6 @@ struct _GTypeValueTable

    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/gobject/html/chapter-intro.html b/docs/reference/gobject/html/chapter-intro.html index 8637ae5..e28671a 100644 --- a/docs/reference/gobject/html/chapter-intro.html +++ b/docs/reference/gobject/html/chapter-intro.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    @@ -53,7 +23,7 @@

    Background

    @@ -82,7 +52,7 @@

    -Data types and programming

    +Data types and programming

    One could say (I have seen such definitions used in some textbooks on programming language theory) that a programming language is merely a way to create data types and manipulate them. Most languages @@ -117,6 +87,6 @@ print "this is an integer converted to a string:" . $tmp . "\n";

    + Generated by GTK-Doc V1.14 \ No newline at end of file diff --git a/docs/reference/gobject/html/chapter-signal.html b/docs/reference/gobject/html/chapter-signal.html index ab54721..b809853 100644 --- a/docs/reference/gobject/html/chapter-signal.html +++ b/docs/reference/gobject/html/chapter-signal.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -55,8 +25,8 @@
    Closures
    -
    C Closures
    -
    Non-C closures (for the fearless)
    +
    C Closures
    +
    Non-C closures (for the fearless)
    Signals
    @@ -100,7 +70,7 @@ return_type function_callback (... , gpointer user_data); The GClosure structure represents the common functionality of all closure implementations: there exists a different Closure implementation for each separate runtime which wants to use the GObject type system. - [6] + [6] The GObject library provides a simple GCClosure type which is a specific implementation of closures to be used with C/C++ callbacks.

    @@ -123,13 +93,13 @@ return_type function_callback (... , gpointer user_data); events (g_closure_remove_finalize_notifier and g_closure_remove_invalidate_notifier) but not for the invocation process. - [7]

    + [7]

    -C Closures

    +C Closures

    If you are using C or C++ to connect a callback to a given event, you will either use simple GCClosures @@ -164,7 +134,7 @@ GClosure *g_signal_type_cclosure_new (GType itype,

    -Non-C closures (for the fearless)

    +Non-C closures (for the fearless)

    As was explained above, closures hide the details of callback invocation. In C, callback invocation is just like function invocation: it is a matter of creating @@ -223,7 +193,7 @@ g_cclosure_marshal_VOID__INT (GClosure *closure,



    -

    [6] +

    [6] In practice, closures sit at the boundary of language runtimes: if you are writing Python code and one of your Python callbacks receives a signal from a GTK+ widget, the C code in GTK+ needs to execute your Python @@ -231,7 +201,7 @@ g_cclosure_marshal_VOID__INT (GClosure *closure, it behaves as a normal C object for GTK+ and as a normal Python object for Python code.

    -

    [7] +

    [7] Closures are reference counted and notify listeners of their destruction in a two-stage process: the invalidation notifiers are invoked before the finalization notifiers.

    @@ -239,6 +209,6 @@ g_cclosure_marshal_VOID__INT (GClosure *closure,
    + Generated by GTK-Doc V1.14
    \ No newline at end of file diff --git a/docs/reference/gobject/html/glib-genmarshal.html b/docs/reference/gobject/html/glib-genmarshal.html index e5e318a..c3129be 100644 --- a/docs/reference/gobject/html/glib-genmarshal.html +++ b/docs/reference/gobject/html/glib-genmarshal.html @@ -8,38 +8,8 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    @@ -63,7 +33,7 @@

    glib-genmarshal [options...] [files...]

    -

    Description

    +

    Description

    glib-genmarshal is a small utility that generates C code marshallers for callback functions of the GClosure mechanism in the GObject sublibrary of GLib. The marshaller functions have a standard signature, @@ -75,13 +45,13 @@ collect its return value.

    -

    Invocation

    +

    Invocation

    glib-genmarshal takes a list of marshallers to generate as input. The marshaller list is either read from standard input or from files passed as additional arguments on the command line.

    -

    Options

    +

    Options

    @@ -139,7 +109,7 @@ Print version and exit.
    -

    Marshaller list format

    +

    Marshaller list format

    The marshaller lists are processed line by line, a line can contain a comment in the form of @@ -167,7 +137,7 @@ which are always pointers.


    -

    Parameter types

    +

    Parameter types

    Currently, the following types are supported:

    @@ -309,7 +279,7 @@ deprecated alias for BOOLEAN
    -

    Example

    +

    Example

    To generate marshallers for the following callback functions:

    @@ -357,19 +327,19 @@ g_closure_set_marshal (cc_baz, g_cclosure_marshal_FLOAT__BOOLEAN_UCHAR);
    -

    See also

    +

    See also

    glib-mkenums(1)

    -

    Bugs

    +

    Bugs

    None known yet.

    -

    Author

    +

    Author

    glib-genmarshal has been written by Tim Janik .

    @@ -380,6 +350,6 @@ This manual page was provided by Tim Janik

    boxed :

    The boxed structure to be copied. +The boxed structure to be copied.

    boxed :

    The boxed structure to be freed. +The boxed structure to be freed.