glib2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/ChangeLog +46 -0
- data/Rakefile +1 -0
- data/ext/glib2/rbglib.h +1 -1
- data/ext/glib2/rbglib_iochannel.c +15 -6
- data/ext/glib2/rbgobj_signal.c +1 -1
- data/ext/glib2/rbgobject.h +1 -1
- data/lib/1.8/glib2.so +0 -0
- data/lib/1.9/glib2.so +0 -0
- data/lib/gnome2-raketask.rb +3 -2
- data/lib/mkmf-gnome2.rb +47 -23
- data/test/glib-test-init.rb +1 -3
- data/vendor/local/bin/glib-genmarshal.exe +0 -0
- data/vendor/local/bin/glib-gettextize +2 -2
- data/vendor/local/bin/glib-mkenums +3 -2
- data/vendor/local/bin/gobject-query.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
- data/vendor/local/bin/libgio-2.0-0.dll +0 -0
- data/vendor/local/bin/libglib-2.0-0.dll +0 -0
- data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
- data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
- data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
- data/vendor/local/include/glib-2.0/gio/gaction.h +91 -0
- data/vendor/local/include/glib-2.0/gio/gactiongroup.h +151 -0
- data/vendor/local/include/glib-2.0/gio/gappinfo.h +11 -1
- data/vendor/local/include/glib-2.0/gio/gapplication.h +165 -0
- data/vendor/local/include/glib-2.0/gio/gapplicationcommandline.h +118 -0
- data/vendor/local/include/glib-2.0/gio/gasyncresult.h +2 -2
- data/vendor/local/include/glib-2.0/gio/gcancellable.h +2 -0
- data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +15 -0
- data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +2 -2
- data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfileiostream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gio.h +14 -0
- data/vendor/local/include/glib-2.0/gio/gioenums.h +158 -2
- data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +12 -0
- data/vendor/local/include/glib-2.0/gio/giomodule.h +1 -1
- data/vendor/local/include/glib-2.0/gio/giostream.h +11 -0
- data/vendor/local/include/glib-2.0/gio/giotypes.h +48 -0
- data/vendor/local/include/glib-2.0/gio/goutputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gpollableinputstream.h +101 -0
- data/vendor/local/include/glib-2.0/gio/gpollableoutputstream.h +98 -0
- data/vendor/local/include/glib-2.0/gio/gsettings.h +9 -2
- data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +6 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleaction.h +95 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleactiongroup.h +87 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +11 -1
- data/vendor/local/include/glib-2.0/gio/gsocketclient.h +7 -0
- data/vendor/local/include/glib-2.0/gio/gtcpwrapperconnection.h +68 -0
- data/vendor/local/include/glib-2.0/gio/gtlsbackend.h +92 -0
- data/vendor/local/include/glib-2.0/gio/gtlscertificate.h +83 -0
- data/vendor/local/include/glib-2.0/gio/gtlsclientconnection.h +72 -0
- data/vendor/local/include/glib-2.0/gio/gtlsconnection.h +136 -0
- data/vendor/local/include/glib-2.0/gio/gtlsserverconnection.h +61 -0
- data/vendor/local/include/glib-2.0/glib/glist.h +2 -0
- data/vendor/local/include/glib-2.0/glib/gmain.h +27 -6
- data/vendor/local/include/glib-2.0/glib/gmarkup.h +80 -5
- data/vendor/local/include/glib-2.0/glib/grand.h +1 -1
- data/vendor/local/include/glib-2.0/glib/gsequence.h +8 -0
- data/vendor/local/include/glib-2.0/glib/gslist.h +2 -0
- data/vendor/local/include/glib-2.0/glib/gtimezone.h +37 -0
- data/vendor/local/include/glib-2.0/glib/gtypes.h +1 -0
- data/vendor/local/include/glib-2.0/glib/gunicode.h +22 -16
- data/vendor/local/include/glib-2.0/glib/gutils.h +5 -0
- data/vendor/local/include/glib-2.0/glib/gvariant.h +35 -11
- data/vendor/local/include/glib-2.0/gobject/gobject.h +15 -0
- data/vendor/local/include/glib-2.0/gobject/gsignal.h +5 -0
- data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +4 -2
- data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +1 -1
- data/vendor/local/lib/gio-2.0.def +142 -0
- data/vendor/local/lib/gio-2.0.lib +0 -0
- data/vendor/local/lib/glib-2.0.def +21 -0
- data/vendor/local/lib/glib-2.0.lib +0 -0
- data/vendor/local/lib/glib-2.0/include/glibconfig.h +1 -1
- data/vendor/local/lib/gmodule-2.0.lib +0 -0
- data/vendor/local/lib/gobject-2.0.def +3 -0
- data/vendor/local/lib/gobject-2.0.lib +0 -0
- data/vendor/local/lib/gthread-2.0.lib +0 -0
- data/vendor/local/lib/libgio-2.0.dll.a +0 -0
- data/vendor/local/lib/libglib-2.0.dll.a +0 -0
- data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
- data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/gio-2.0.pc +2 -2
- data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/glib-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gobject-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gthread-2.0.pc +1 -1
- data/vendor/local/manifest/{glib-dev_2.26.1-1_win32.mft → glib-dev_2.28.1-1_win32.mft} +55 -19
- data/vendor/local/manifest/{glib_2.26.1-1_win32.mft → glib_2.28.1-1_win32.mft} +3 -2
- data/vendor/local/share/aclocal/glib-2.0.m4 +4 -4
- data/vendor/local/share/doc/{glib-2.26.1 → glib-2.28.1}/COPYING +0 -0
- data/vendor/local/share/doc/{glib-dev-2.26.1 → glib-dev-2.28.1}/COPYING +0 -0
- data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +72 -21
- data/vendor/local/share/glib-2.0/schemas/gschema.dtd +21 -8
- data/vendor/local/share/gtk-doc/html/gio/GAction.html +469 -0
- data/vendor/local/share/gtk-doc/html/gio/GActionGroup.html +754 -0
- data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +296 -249
- data/vendor/local/share/gtk-doc/html/gio/GApplication.html +1458 -0
- data/vendor/local/share/gtk-doc/html/gio/GApplicationCommandLine.html +815 -0
- data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +61 -97
- data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +31 -38
- data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +52 -68
- data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +38 -50
- data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +120 -77
- data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +26 -34
- data/vendor/local/share/gtk-doc/html/gio/GConverter.html +49 -51
- data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +39 -62
- data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +26 -35
- data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +415 -650
- data/vendor/local/share/gtk-doc/html/gio/{gio-GDBusError.html → GDBusError.html} +118 -147
- data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +204 -347
- data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +66 -111
- data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +210 -309
- data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +68 -87
- data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +190 -232
- data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +89 -118
- data/vendor/local/share/gtk-doc/html/gio/GDrive.html +196 -270
- data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +40 -46
- data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +56 -24
- data/vendor/local/share/gtk-doc/html/gio/GFile.html +1090 -1443
- data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +13 -16
- data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +66 -86
- data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +31 -45
- data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +19 -21
- data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +466 -602
- data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +32 -40
- data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +60 -59
- data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +32 -47
- data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +37 -45
- data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +22 -26
- data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +22 -26
- data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +32 -38
- data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +184 -52
- data/vendor/local/share/gtk-doc/html/gio/GIcon.html +45 -54
- data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +96 -125
- data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +21 -25
- data/vendor/local/share/gtk-doc/html/gio/GInitable.html +49 -71
- data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +102 -134
- data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +43 -54
- data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +21 -24
- data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +34 -41
- data/vendor/local/share/gtk-doc/html/gio/GMount.html +223 -294
- data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +127 -153
- data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +35 -46
- data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +37 -46
- data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +138 -174
- data/vendor/local/share/gtk-doc/html/gio/GPermission.html +46 -68
- data/vendor/local/share/gtk-doc/html/gio/GPollableInputStream.html +398 -0
- data/vendor/local/share/gtk-doc/html/gio/GPollableOutputStream.html +340 -0
- data/vendor/local/share/gtk-doc/html/gio/GProxy.html +89 -32
- data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +42 -56
- data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +59 -34
- data/vendor/local/share/gtk-doc/html/gio/GResolver.html +82 -95
- data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +58 -72
- data/vendor/local/share/gtk-doc/html/gio/GSettings.html +597 -357
- data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +125 -75
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAction.html +339 -0
- data/vendor/local/share/gtk-doc/html/gio/GSimpleActionGroup.html +200 -0
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +232 -167
- data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +15 -16
- data/vendor/local/share/gtk-doc/html/gio/GSocket.html +291 -406
- data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +39 -45
- data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +301 -223
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +41 -44
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +41 -49
- data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +22 -32
- data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +88 -107
- data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +26 -32
- data/vendor/local/share/gtk-doc/html/gio/{gio-GSrvTarget.html → GSrvTarget.html} +74 -77
- data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +21 -22
- data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html +156 -0
- data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +40 -46
- data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +29 -35
- data/vendor/local/share/gtk-doc/html/gio/GTlsBackend.html +260 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsCertificate.html +396 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html +428 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html +869 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsServerConnection.html +158 -0
- data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +32 -41
- data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +28 -34
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +44 -54
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +36 -41
- data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +35 -32
- data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +35 -32
- data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +59 -67
- data/vendor/local/share/gtk-doc/html/gio/GVfs.html +49 -57
- data/vendor/local/share/gtk-doc/html/gio/GVolume.html +142 -187
- data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +99 -132
- data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +33 -32
- data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +22 -24
- data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +43 -13
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +10 -3
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +20 -20
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +36 -28
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-28.html +744 -0
- data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +915 -107
- data/vendor/local/share/gtk-doc/html/gio/application.html +50 -0
- data/vendor/local/share/gtk-doc/html/gio/async.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/ch01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch02.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/ch03.html +23 -24
- data/vendor/local/share/gtk-doc/html/gio/ch26.html +54 -36
- data/vendor/local/share/gtk-doc/html/gio/ch27.html +188 -41
- data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +19 -108
- data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +16 -179
- data/vendor/local/share/gtk-doc/html/gio/ch28.html +57 -0
- data/vendor/local/share/gtk-doc/html/gio/{ch26s02.html → ch28s02.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s03.html → ch28s03.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s04.html → ch28s04.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s05.html → ch28s05.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s06.html → ch28s06.html} +17 -15
- data/vendor/local/share/gtk-doc/html/gio/{ch26s07.html → ch28s07.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/ch29.html +70 -0
- data/vendor/local/share/gtk-doc/html/gio/ch29s02.html +130 -0
- data/vendor/local/share/gtk-doc/html/gio/ch29s03.html +202 -0
- data/vendor/local/share/gtk-doc/html/gio/{ch27s04.html → ch29s04.html} +11 -11
- data/vendor/local/share/gtk-doc/html/gio/{ch27s05.html → ch29s05.html} +12 -12
- data/vendor/local/share/gtk-doc/html/gio/{ch27s06.html → ch29s06.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/conversion.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +27 -14
- data/vendor/local/share/gtk-doc/html/gio/extending.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/file_mon.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/file_ops.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/gdbus.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +39 -62
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +141 -248
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +28 -40
- data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +29 -112
- data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +45 -57
- data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +58 -68
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +16 -18
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +18 -20
- data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +82 -76
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +34 -28
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +25 -33
- data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +87 -113
- data/vendor/local/share/gtk-doc/html/gio/gio-TLS-Overview.html +287 -0
- data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +119 -151
- data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +62 -95
- data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +66 -6
- data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +312 -91
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +386 -133
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/gsettings-tool.html +162 -0
- data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +7 -4
- data/vendor/local/share/gtk-doc/html/gio/icons.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/index.html +88 -36
- data/vendor/local/share/gtk-doc/html/gio/index.sgml +506 -95
- data/vendor/local/share/gtk-doc/html/gio/migrating.html +23 -23
- data/vendor/local/share/gtk-doc/html/gio/networking.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/permissions.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/pt01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/pt02.html +68 -17
- data/vendor/local/share/gtk-doc/html/gio/resolver.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/settings.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/streaming.html +9 -3
- data/vendor/local/share/gtk-doc/html/gio/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/gio/tls.html +50 -0
- data/vendor/local/share/gtk-doc/html/gio/tools.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/types.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/utils.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +8 -11
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +25 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-28.html +112 -0
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +6 -6
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +15 -11
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +9 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +201 -89
- data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +144 -210
- data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +97 -136
- data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +40 -58
- data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +99 -128
- data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +104 -155
- data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +42 -71
- data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +40 -43
- data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +224 -314
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +104 -142
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +193 -308
- data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +51 -76
- data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +170 -307
- data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +154 -198
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +45 -67
- data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +60 -97
- data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +390 -428
- data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +265 -333
- data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +306 -330
- data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +60 -99
- data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +122 -152
- data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +241 -571
- data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +233 -330
- data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +310 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +739 -590
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +136 -143
- data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +22 -29
- data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +210 -297
- data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +294 -355
- data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +27 -39
- data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +102 -95
- data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +402 -486
- data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +308 -442
- data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +75 -116
- data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +229 -297
- data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +36 -36
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +121 -187
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +23 -27
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +80 -107
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +46 -69
- data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +63 -99
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +121 -115
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +304 -327
- data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +307 -366
- data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +39 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +230 -343
- data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +121 -167
- data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +31 -45
- data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +73 -113
- data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +75 -106
- data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +229 -184
- data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +31 -40
- data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +247 -286
- data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +281 -283
- data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +83 -337
- data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +65 -80
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +36 -42
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +408 -621
- data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +253 -322
- data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +161 -252
- data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +677 -590
- data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +88 -111
- data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +378 -475
- data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +27 -48
- data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +39 -48
- data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +19 -25
- data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +57 -93
- data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +413 -534
- data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +117 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +38 -53
- data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +60 -114
- data/vendor/local/share/gtk-doc/html/glib/glib-building.html +38 -39
- data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +7 -13
- data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/glib-core.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +6 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +82 -82
- data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +9 -9
- data/vendor/local/share/gtk-doc/html/glib/glib-running.html +26 -26
- data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +144 -103
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +170 -105
- data/vendor/local/share/gtk-doc/html/glib/glib.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/gtester.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +48 -43
- data/vendor/local/share/gtk-doc/html/glib/gvariant-text.html +660 -0
- data/vendor/local/share/gtk-doc/html/glib/index.html +8 -4
- data/vendor/local/share/gtk-doc/html/glib/index.sgml +67 -2
- data/vendor/local/share/gtk-doc/html/glib/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/glib/tools.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +72 -90
- data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +79 -108
- data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +67 -85
- data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +63 -9
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-28.html +47 -0
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +65 -53
- data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +8 -11
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +19 -19
- data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +18 -18
- data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +22 -22
- data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +16 -16
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +40 -54
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +405 -512
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +170 -213
- data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +242 -292
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +91 -127
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +407 -573
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +951 -1268
- data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +383 -441
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +648 -829
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +82 -95
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +31 -49
- data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +8 -8
- data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +15 -14
- data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +10 -10
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +62 -58
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +62 -58
- data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +11 -11
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +14 -14
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +10 -10
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/index.html +11 -10
- data/vendor/local/share/gtk-doc/html/gobject/index.sgml +13 -1
- data/vendor/local/share/gtk-doc/html/gobject/pr01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/pt01.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/pt02.html +8 -8
- data/vendor/local/share/gtk-doc/html/gobject/pt03.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/rn01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/rn02.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/signal.html +13 -13
- data/vendor/local/share/gtk-doc/html/gobject/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +3 -3
- data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/man/man1/glib-genmarshal.1 +2 -2
- data/vendor/local/share/man/man1/glib-mkenums.1 +2 -2
- data/vendor/local/share/man/man1/gobject-query.1 +2 -2
- data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.log → glib_2.28.1-1_win32.log} +690 -773
- data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.sh → glib_2.28.1-1_win32.sh} +2 -4
- metadata +78 -146
- data/ext/glib2/Makefile +0 -169
- data/ext/glib2/glib-enum-types.c +0 -1065
- data/ext/glib2/glib-enum-types.h +0 -144
- data/ext/glib2/ruby-glib2.pc +0 -3
- data/test-unit/COPYING +0 -56
- data/test-unit/GPL +0 -340
- data/test-unit/History.txt +0 -279
- data/test-unit/Manifest.txt +0 -110
- data/test-unit/PSFL +0 -271
- data/test-unit/README.txt +0 -75
- data/test-unit/Rakefile +0 -53
- data/test-unit/TODO +0 -5
- data/test-unit/bin/testrb +0 -5
- data/test-unit/html/bar.png +0 -0
- data/test-unit/html/bar.svg +0 -153
- data/test-unit/html/developer.png +0 -0
- data/test-unit/html/developer.svg +0 -469
- data/test-unit/html/famfamfam-logo.png +0 -0
- data/test-unit/html/favicon.ico +0 -0
- data/test-unit/html/favicon.png +0 -0
- data/test-unit/html/favicon.svg +0 -82
- data/test-unit/html/heading-mark.png +0 -0
- data/test-unit/html/heading-mark.svg +0 -393
- data/test-unit/html/index.html +0 -285
- data/test-unit/html/index.html.ja +0 -299
- data/test-unit/html/install.png +0 -0
- data/test-unit/html/install.svg +0 -636
- data/test-unit/html/jp.png +0 -0
- data/test-unit/html/kinotan-failure.png +0 -0
- data/test-unit/html/kinotan-pass.png +0 -0
- data/test-unit/html/logo.png +0 -0
- data/test-unit/html/logo.svg +0 -483
- data/test-unit/html/reference.png +0 -0
- data/test-unit/html/rubyforge.png +0 -0
- data/test-unit/html/tango-logo.png +0 -0
- data/test-unit/html/test-unit.css +0 -339
- data/test-unit/html/tutorial.png +0 -0
- data/test-unit/html/tutorial.svg +0 -559
- data/test-unit/html/us.png +0 -0
- data/test-unit/images/color-diff.png +0 -0
- data/test-unit/lib/test/unit.rb +0 -328
- data/test-unit/lib/test/unit/assertionfailederror.rb +0 -25
- data/test-unit/lib/test/unit/assertions.rb +0 -1792
- data/test-unit/lib/test/unit/attribute.rb +0 -125
- data/test-unit/lib/test/unit/autorunner.rb +0 -415
- data/test-unit/lib/test/unit/collector.rb +0 -38
- data/test-unit/lib/test/unit/collector/descendant.rb +0 -23
- data/test-unit/lib/test/unit/collector/dir.rb +0 -108
- data/test-unit/lib/test/unit/collector/load.rb +0 -187
- data/test-unit/lib/test/unit/collector/objectspace.rb +0 -34
- data/test-unit/lib/test/unit/collector/xml.rb +0 -250
- data/test-unit/lib/test/unit/color-scheme.rb +0 -106
- data/test-unit/lib/test/unit/color.rb +0 -96
- data/test-unit/lib/test/unit/diff.rb +0 -740
- data/test-unit/lib/test/unit/error.rb +0 -131
- data/test-unit/lib/test/unit/exceptionhandler.rb +0 -39
- data/test-unit/lib/test/unit/failure.rb +0 -136
- data/test-unit/lib/test/unit/fixture.rb +0 -185
- data/test-unit/lib/test/unit/notification.rb +0 -129
- data/test-unit/lib/test/unit/omission.rb +0 -191
- data/test-unit/lib/test/unit/pending.rb +0 -150
- data/test-unit/lib/test/unit/priority.rb +0 -180
- data/test-unit/lib/test/unit/runner/console.rb +0 -52
- data/test-unit/lib/test/unit/runner/emacs.rb +0 -8
- data/test-unit/lib/test/unit/runner/tap.rb +0 -8
- data/test-unit/lib/test/unit/runner/xml.rb +0 -15
- data/test-unit/lib/test/unit/testcase.rb +0 -515
- data/test-unit/lib/test/unit/testresult.rb +0 -125
- data/test-unit/lib/test/unit/testsuite.rb +0 -134
- data/test-unit/lib/test/unit/ui/console/outputlevel.rb +0 -14
- data/test-unit/lib/test/unit/ui/console/testrunner.rb +0 -467
- data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +0 -63
- data/test-unit/lib/test/unit/ui/tap/testrunner.rb +0 -82
- data/test-unit/lib/test/unit/ui/testrunner.rb +0 -53
- data/test-unit/lib/test/unit/ui/testrunnermediator.rb +0 -86
- data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +0 -41
- data/test-unit/lib/test/unit/ui/xml/testrunner.rb +0 -224
- data/test-unit/lib/test/unit/util/backtracefilter.rb +0 -42
- data/test-unit/lib/test/unit/util/method-owner-finder.rb +0 -28
- data/test-unit/lib/test/unit/util/observable.rb +0 -90
- data/test-unit/lib/test/unit/util/output.rb +0 -31
- data/test-unit/lib/test/unit/util/procwrapper.rb +0 -48
- data/test-unit/lib/test/unit/version.rb +0 -7
- data/test-unit/sample/adder.rb +0 -13
- data/test-unit/sample/subtracter.rb +0 -12
- data/test-unit/sample/test_adder.rb +0 -20
- data/test-unit/sample/test_subtracter.rb +0 -20
- data/test-unit/sample/test_user.rb +0 -23
- data/test-unit/test/collector/test-descendant.rb +0 -133
- data/test-unit/test/collector/test-load.rb +0 -442
- data/test-unit/test/collector/test_dir.rb +0 -406
- data/test-unit/test/collector/test_objectspace.rb +0 -100
- data/test-unit/test/run-test.rb +0 -22
- data/test-unit/test/test-assertions.rb +0 -1849
- data/test-unit/test/test-attribute.rb +0 -86
- data/test-unit/test/test-color-scheme.rb +0 -69
- data/test-unit/test/test-color.rb +0 -47
- data/test-unit/test/test-diff.rb +0 -518
- data/test-unit/test/test-emacs-runner.rb +0 -60
- data/test-unit/test/test-fixture.rb +0 -324
- data/test-unit/test/test-notification.rb +0 -33
- data/test-unit/test/test-omission.rb +0 -81
- data/test-unit/test/test-pending.rb +0 -70
- data/test-unit/test/test-priority.rb +0 -119
- data/test-unit/test/test-testcase.rb +0 -569
- data/test-unit/test/test_error.rb +0 -26
- data/test-unit/test/test_failure.rb +0 -33
- data/test-unit/test/test_testresult.rb +0 -113
- data/test-unit/test/test_testsuite.rb +0 -137
- data/test-unit/test/testunit-test-util.rb +0 -14
- data/test-unit/test/ui/test_tap.rb +0 -33
- data/test-unit/test/ui/test_testrunmediator.rb +0 -20
- data/test-unit/test/util/test-method-owner-finder.rb +0 -38
- data/test-unit/test/util/test-output.rb +0 -11
- data/test-unit/test/util/test_backtracefilter.rb +0 -41
- data/test-unit/test/util/test_observable.rb +0 -102
- data/test-unit/test/util/test_procwrapper.rb +0 -36
- data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
- data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
- data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
- data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="up" href="glib-data-types.html" title="GLib Data Types">
|
|
9
9
|
<link rel="prev" href="glib-Relations-and-Tuples.html" title="Relations and Tuples">
|
|
10
10
|
<link rel="next" href="glib-Memory-Allocators.html" title="Memory Allocators">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
13
|
</head>
|
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
<a href="#glib-Caches.description" class="shortcut">Description</a>
|
|
27
27
|
</td></tr>
|
|
28
28
|
</table>
|
|
29
|
-
<div class="refentry"
|
|
29
|
+
<div class="refentry">
|
|
30
30
|
<a name="glib-Caches"></a><div class="titlepage"></div>
|
|
31
31
|
<div class="refnamediv"><table width="100%"><tr>
|
|
32
32
|
<td valign="top">
|
|
@@ -36,13 +36,13 @@
|
|
|
36
36
|
</td>
|
|
37
37
|
<td valign="top" align="right"></td>
|
|
38
38
|
</tr></table></div>
|
|
39
|
-
<div class="refsynopsisdiv"
|
|
39
|
+
<div class="refsynopsisdiv">
|
|
40
40
|
<a name="glib-Caches.synopsis"></a><h2>Synopsis</h2>
|
|
41
41
|
<pre class="synopsis">
|
|
42
42
|
#include <glib.h>
|
|
43
43
|
|
|
44
44
|
<a class="link" href="glib-Caches.html#GCache" title="GCache">GCache</a>;
|
|
45
|
-
<a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="returnvalue">GCache</span></a
|
|
45
|
+
<a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="returnvalue">GCache</span></a> * <a class="link" href="glib-Caches.html#g-cache-new" title="g_cache_new ()">g_cache_new</a> (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheNewFunc" title="GCacheNewFunc ()"><span class="type">GCacheNewFunc</span></a> value_new_func</code></em>,
|
|
46
46
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDestroyFunc" title="GCacheDestroyFunc ()"><span class="type">GCacheDestroyFunc</span></a> value_destroy_func</code></em>,
|
|
47
47
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDupFunc" title="GCacheDupFunc ()"><span class="type">GCacheDupFunc</span></a> key_dup_func</code></em>,
|
|
48
48
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDestroyFunc" title="GCacheDestroyFunc ()"><span class="type">GCacheDestroyFunc</span></a> key_destroy_func</code></em>,
|
|
@@ -67,15 +67,15 @@
|
|
|
67
67
|
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="glib-Caches.html#GCacheNewFunc" title="GCacheNewFunc ()">*GCacheNewFunc</a>) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> key</code></em>);
|
|
68
68
|
</pre>
|
|
69
69
|
</div>
|
|
70
|
-
<div class="refsect1"
|
|
70
|
+
<div class="refsect1">
|
|
71
71
|
<a name="glib-Caches.description"></a><h2>Description</h2>
|
|
72
72
|
<p>
|
|
73
73
|
A <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> allows sharing of complex data structures, in order to
|
|
74
74
|
save system resources.
|
|
75
75
|
</p>
|
|
76
76
|
<p>
|
|
77
|
-
GTK+ uses caches for <a href="http://library.gnome.org/devel/gtk/
|
|
78
|
-
resources, so a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> is used to see if a <a href="http://library.gnome.org/devel/gtk/
|
|
77
|
+
GTK+ uses caches for <a href="http://library.gnome.org/devel/gtk/2.24/GtkStyle.html"><span class="type">GtkStyles</span></a> and <span class="type">GdkGCs</span>. These consume a lot of
|
|
78
|
+
resources, so a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> is used to see if a <a href="http://library.gnome.org/devel/gtk/2.24/GtkStyle.html"><span class="type">GtkStyle</span></a> or <span class="type">GdkGC</span> with
|
|
79
79
|
the required properties already exists. If it does, then the
|
|
80
80
|
existing object is used instead of creating a new one.
|
|
81
81
|
</p>
|
|
@@ -84,9 +84,9 @@ existing object is used instead of creating a new one.
|
|
|
84
84
|
of a particular resource. A <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value is the actual resource.
|
|
85
85
|
</p>
|
|
86
86
|
</div>
|
|
87
|
-
<div class="refsect1"
|
|
87
|
+
<div class="refsect1">
|
|
88
88
|
<a name="glib-Caches.details"></a><h2>Details</h2>
|
|
89
|
-
<div class="refsect2"
|
|
89
|
+
<div class="refsect2">
|
|
90
90
|
<a name="GCache"></a><h3>GCache</h3>
|
|
91
91
|
<pre class="programlisting">typedef struct _GCache GCache;</pre>
|
|
92
92
|
<p>
|
|
@@ -96,9 +96,9 @@ following functions.
|
|
|
96
96
|
</p>
|
|
97
97
|
</div>
|
|
98
98
|
<hr>
|
|
99
|
-
<div class="refsect2"
|
|
99
|
+
<div class="refsect2">
|
|
100
100
|
<a name="g-cache-new"></a><h3>g_cache_new ()</h3>
|
|
101
|
-
<pre class="programlisting"><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="returnvalue">GCache</span></a
|
|
101
|
+
<pre class="programlisting"><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="returnvalue">GCache</span></a> * g_cache_new (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheNewFunc" title="GCacheNewFunc ()"><span class="type">GCacheNewFunc</span></a> value_new_func</code></em>,
|
|
102
102
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDestroyFunc" title="GCacheDestroyFunc ()"><span class="type">GCacheDestroyFunc</span></a> value_destroy_func</code></em>,
|
|
103
103
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDupFunc" title="GCacheDupFunc ()"><span class="type">GCacheDupFunc</span></a> key_dup_func</code></em>,
|
|
104
104
|
<em class="parameter"><code><a class="link" href="glib-Caches.html#GCacheDestroyFunc" title="GCacheDestroyFunc ()"><span class="type">GCacheDestroyFunc</span></a> key_destroy_func</code></em>,
|
|
@@ -114,58 +114,50 @@ Creates a new <a class="link" href="glib-Caches.html#GCache" title="GCache"><spa
|
|
|
114
114
|
<tr>
|
|
115
115
|
<td><p><span class="term"><em class="parameter"><code>value_new_func</code></em> :</span></p></td>
|
|
116
116
|
<td>a function to create a new object given a key.
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
</td>
|
|
117
|
+
This is called by <a class="link" href="glib-Caches.html#g-cache-insert" title="g_cache_insert ()"><code class="function">g_cache_insert()</code></a> if an object
|
|
118
|
+
with the given key does not already exist.</td>
|
|
120
119
|
</tr>
|
|
121
120
|
<tr>
|
|
122
121
|
<td><p><span class="term"><em class="parameter"><code>value_destroy_func</code></em> :</span></p></td>
|
|
123
122
|
<td>a function to destroy an object. It is called
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
</td>
|
|
123
|
+
by <a class="link" href="glib-Caches.html#g-cache-remove" title="g_cache_remove ()"><code class="function">g_cache_remove()</code></a> when the object is no
|
|
124
|
+
longer needed (i.e. its reference count drops
|
|
125
|
+
to 0).</td>
|
|
128
126
|
</tr>
|
|
129
127
|
<tr>
|
|
130
128
|
<td><p><span class="term"><em class="parameter"><code>key_dup_func</code></em> :</span></p></td>
|
|
131
129
|
<td>a function to copy a key. It is called by
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
</td>
|
|
130
|
+
<a class="link" href="glib-Caches.html#g-cache-insert" title="g_cache_insert ()"><code class="function">g_cache_insert()</code></a> if the key does not already exist in
|
|
131
|
+
the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
135
132
|
</tr>
|
|
136
133
|
<tr>
|
|
137
134
|
<td><p><span class="term"><em class="parameter"><code>key_destroy_func</code></em> :</span></p></td>
|
|
138
135
|
<td>a function to destroy a key. It is called by
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
</td>
|
|
136
|
+
<a class="link" href="glib-Caches.html#g-cache-remove" title="g_cache_remove ()"><code class="function">g_cache_remove()</code></a> when the object is no longer
|
|
137
|
+
needed (i.e. its reference count drops to 0).</td>
|
|
142
138
|
</tr>
|
|
143
139
|
<tr>
|
|
144
140
|
<td><p><span class="term"><em class="parameter"><code>hash_key_func</code></em> :</span></p></td>
|
|
145
|
-
<td>a function to create a hash value from a key
|
|
146
|
-
</td>
|
|
141
|
+
<td>a function to create a hash value from a key.</td>
|
|
147
142
|
</tr>
|
|
148
143
|
<tr>
|
|
149
144
|
<td><p><span class="term"><em class="parameter"><code>hash_value_func</code></em> :</span></p></td>
|
|
150
|
-
<td>a function to create a hash value from a value
|
|
151
|
-
</td>
|
|
145
|
+
<td>a function to create a hash value from a value.</td>
|
|
152
146
|
</tr>
|
|
153
147
|
<tr>
|
|
154
148
|
<td><p><span class="term"><em class="parameter"><code>key_equal_func</code></em> :</span></p></td>
|
|
155
149
|
<td>a function to compare two keys. It should return
|
|
156
|
-
|
|
157
|
-
</td>
|
|
150
|
+
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys are equivalent.</td>
|
|
158
151
|
</tr>
|
|
159
152
|
<tr>
|
|
160
153
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
161
|
-
<td>a new <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
162
|
-
</td>
|
|
154
|
+
<td>a new <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
163
155
|
</tr>
|
|
164
156
|
</tbody>
|
|
165
157
|
</table></div>
|
|
166
158
|
</div>
|
|
167
159
|
<hr>
|
|
168
|
-
<div class="refsect2"
|
|
160
|
+
<div class="refsect2">
|
|
169
161
|
<a name="g-cache-insert"></a><h3>g_cache_insert ()</h3>
|
|
170
162
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> g_cache_insert (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> *cache</code></em>,
|
|
171
163
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> key</code></em>);</pre>
|
|
@@ -184,24 +176,21 @@ are inserted into the <a class="link" href="glib-Caches.html#GCache" title="GCac
|
|
|
184
176
|
<tbody>
|
|
185
177
|
<tr>
|
|
186
178
|
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
|
|
187
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
188
|
-
</td>
|
|
179
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
189
180
|
</tr>
|
|
190
181
|
<tr>
|
|
191
182
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
192
|
-
<td>a key describing a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> object
|
|
193
|
-
</td>
|
|
183
|
+
<td>a key describing a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> object.</td>
|
|
194
184
|
</tr>
|
|
195
185
|
<tr>
|
|
196
186
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
197
|
-
<td>a pointer to a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value
|
|
198
|
-
</td>
|
|
187
|
+
<td>a pointer to a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value.</td>
|
|
199
188
|
</tr>
|
|
200
189
|
</tbody>
|
|
201
190
|
</table></div>
|
|
202
191
|
</div>
|
|
203
192
|
<hr>
|
|
204
|
-
<div class="refsect2"
|
|
193
|
+
<div class="refsect2">
|
|
205
194
|
<a name="g-cache-remove"></a><h3>g_cache_remove ()</h3>
|
|
206
195
|
<pre class="programlisting"><span class="returnvalue">void</span> g_cache_remove (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> *cache</code></em>,
|
|
207
196
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> value</code></em>);</pre>
|
|
@@ -215,19 +204,17 @@ then the value and its corresponding key are destroyed, using the
|
|
|
215
204
|
<tbody>
|
|
216
205
|
<tr>
|
|
217
206
|
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
|
|
218
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
219
|
-
</td>
|
|
207
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
220
208
|
</tr>
|
|
221
209
|
<tr>
|
|
222
210
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
223
|
-
<td>the value to remove
|
|
224
|
-
</td>
|
|
211
|
+
<td>the value to remove.</td>
|
|
225
212
|
</tr>
|
|
226
213
|
</tbody>
|
|
227
214
|
</table></div>
|
|
228
215
|
</div>
|
|
229
216
|
<hr>
|
|
230
|
-
<div class="refsect2"
|
|
217
|
+
<div class="refsect2">
|
|
231
218
|
<a name="g-cache-destroy"></a><h3>g_cache_destroy ()</h3>
|
|
232
219
|
<pre class="programlisting"><span class="returnvalue">void</span> g_cache_destroy (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> *cache</code></em>);</pre>
|
|
233
220
|
<p>
|
|
@@ -241,13 +228,12 @@ contained in the <a class="link" href="glib-Caches.html#GCache" title="GCache"><
|
|
|
241
228
|
<col align="left" valign="top">
|
|
242
229
|
<tbody><tr>
|
|
243
230
|
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
|
|
244
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
245
|
-
</td>
|
|
231
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
246
232
|
</tr></tbody>
|
|
247
233
|
</table></div>
|
|
248
234
|
</div>
|
|
249
235
|
<hr>
|
|
250
|
-
<div class="refsect2"
|
|
236
|
+
<div class="refsect2">
|
|
251
237
|
<a name="g-cache-key-foreach"></a><h3>g_cache_key_foreach ()</h3>
|
|
252
238
|
<pre class="programlisting"><span class="returnvalue">void</span> g_cache_key_foreach (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> *cache</code></em>,
|
|
253
239
|
<em class="parameter"><code><a class="link" href="glib-Hash-Tables.html#GHFunc" title="GHFunc ()"><span class="type">GHFunc</span></a> func</code></em>,
|
|
@@ -266,29 +252,26 @@ pairs to its callback function !
|
|
|
266
252
|
<tbody>
|
|
267
253
|
<tr>
|
|
268
254
|
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
|
|
269
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
270
|
-
</td>
|
|
255
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
271
256
|
</tr>
|
|
272
257
|
<tr>
|
|
273
258
|
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
|
274
|
-
<td>the function to call with each <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key
|
|
275
|
-
</td>
|
|
259
|
+
<td>the function to call with each <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key.</td>
|
|
276
260
|
</tr>
|
|
277
261
|
<tr>
|
|
278
262
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
279
|
-
<td>user data to pass to the function
|
|
280
|
-
</td>
|
|
263
|
+
<td>user data to pass to the function.</td>
|
|
281
264
|
</tr>
|
|
282
265
|
</tbody>
|
|
283
266
|
</table></div>
|
|
284
267
|
</div>
|
|
285
268
|
<hr>
|
|
286
|
-
<div class="refsect2"
|
|
269
|
+
<div class="refsect2">
|
|
287
270
|
<a name="g-cache-value-foreach"></a><h3>g_cache_value_foreach ()</h3>
|
|
288
271
|
<pre class="programlisting"><span class="returnvalue">void</span> g_cache_value_foreach (<em class="parameter"><code><a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> *cache</code></em>,
|
|
289
272
|
<em class="parameter"><code><a class="link" href="glib-Hash-Tables.html#GHFunc" title="GHFunc ()"><span class="type">GHFunc</span></a> func</code></em>,
|
|
290
273
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
|
291
|
-
<div class="warning"
|
|
274
|
+
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
|
|
292
275
|
<h3 class="title">Warning</h3>
|
|
293
276
|
<p><code class="literal">g_cache_value_foreach</code> 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
|
|
294
277
|
data structures to <em class="parameter"><code>func</code></em>; use <a class="link" href="glib-Caches.html#g-cache-key-foreach" title="g_cache_key_foreach ()"><code class="function">g_cache_key_foreach()</code></a>
|
|
@@ -302,24 +285,21 @@ Calls the given function for each of the values in the <a class="link" href="gli
|
|
|
302
285
|
<tbody>
|
|
303
286
|
<tr>
|
|
304
287
|
<td><p><span class="term"><em class="parameter"><code>cache</code></em> :</span></p></td>
|
|
305
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a
|
|
306
|
-
</td>
|
|
288
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a>.</td>
|
|
307
289
|
</tr>
|
|
308
290
|
<tr>
|
|
309
291
|
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
|
|
310
|
-
<td>the function to call with each <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value
|
|
311
|
-
</td>
|
|
292
|
+
<td>the function to call with each <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value.</td>
|
|
312
293
|
</tr>
|
|
313
294
|
<tr>
|
|
314
295
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
315
|
-
<td>user data to pass to the function
|
|
316
|
-
</td>
|
|
296
|
+
<td>user data to pass to the function.</td>
|
|
317
297
|
</tr>
|
|
318
298
|
</tbody>
|
|
319
299
|
</table></div>
|
|
320
300
|
</div>
|
|
321
301
|
<hr>
|
|
322
|
-
<div class="refsect2"
|
|
302
|
+
<div class="refsect2">
|
|
323
303
|
<a name="GCacheDestroyFunc"></a><h3>GCacheDestroyFunc ()</h3>
|
|
324
304
|
<pre class="programlisting"><span class="returnvalue">void</span> (*GCacheDestroyFunc) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> value</code></em>);</pre>
|
|
325
305
|
<p>
|
|
@@ -332,13 +312,12 @@ memory and other resources associated with it.
|
|
|
332
312
|
<col align="left" valign="top">
|
|
333
313
|
<tbody><tr>
|
|
334
314
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
335
|
-
<td>the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value to destroy
|
|
336
|
-
</td>
|
|
315
|
+
<td>the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value to destroy.</td>
|
|
337
316
|
</tr></tbody>
|
|
338
317
|
</table></div>
|
|
339
318
|
</div>
|
|
340
319
|
<hr>
|
|
341
|
-
<div class="refsect2"
|
|
320
|
+
<div class="refsect2">
|
|
342
321
|
<a name="GCacheDupFunc"></a><h3>GCacheDupFunc ()</h3>
|
|
343
322
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> (*GCacheDupFunc) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> value</code></em>);</pre>
|
|
344
323
|
<p>
|
|
@@ -353,19 +332,17 @@ should return a duplicate of the key.
|
|
|
353
332
|
<tr>
|
|
354
333
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
355
334
|
<td>the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key to destroy (<span class="emphasis"><em>not</em></span> a
|
|
356
|
-
|
|
357
|
-
</td>
|
|
335
|
+
<a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value as it seems).</td>
|
|
358
336
|
</tr>
|
|
359
337
|
<tr>
|
|
360
338
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
361
|
-
<td>a copy of the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key
|
|
362
|
-
</td>
|
|
339
|
+
<td>a copy of the <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key.</td>
|
|
363
340
|
</tr>
|
|
364
341
|
</tbody>
|
|
365
342
|
</table></div>
|
|
366
343
|
</div>
|
|
367
344
|
<hr>
|
|
368
|
-
<div class="refsect2"
|
|
345
|
+
<div class="refsect2">
|
|
369
346
|
<a name="GCacheNewFunc"></a><h3>GCacheNewFunc ()</h3>
|
|
370
347
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> (*GCacheNewFunc) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> key</code></em>);</pre>
|
|
371
348
|
<p>
|
|
@@ -378,13 +355,11 @@ value corresponding to the key.
|
|
|
378
355
|
<tbody>
|
|
379
356
|
<tr>
|
|
380
357
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
381
|
-
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key
|
|
382
|
-
</td>
|
|
358
|
+
<td>a <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> key.</td>
|
|
383
359
|
</tr>
|
|
384
360
|
<tr>
|
|
385
361
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
386
|
-
<td>a new <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value corresponding to the key
|
|
387
|
-
</td>
|
|
362
|
+
<td>a new <a class="link" href="glib-Caches.html#GCache" title="GCache"><span class="type">GCache</span></a> value corresponding to the key.</td>
|
|
388
363
|
</tr>
|
|
389
364
|
</tbody>
|
|
390
365
|
</table></div>
|
|
@@ -393,6 +368,6 @@ value corresponding to the key.
|
|
|
393
368
|
</div>
|
|
394
369
|
<div class="footer">
|
|
395
370
|
<hr>
|
|
396
|
-
Generated by GTK-Doc V1.
|
|
371
|
+
Generated by GTK-Doc V1.16.1</div>
|
|
397
372
|
</body>
|
|
398
373
|
</html>
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
|
|
9
9
|
<link rel="prev" href="glib-String-Utility-Functions.html" title="String Utility Functions">
|
|
10
10
|
<link rel="next" href="glib-Unicode-Manipulation.html" title="Unicode Manipulation">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
|
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
13
13
|
</head>
|
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
<a href="#glib-Character-Set-Conversion.description" class="shortcut">Description</a>
|
|
27
27
|
</td></tr>
|
|
28
28
|
</table>
|
|
29
|
-
<div class="refentry"
|
|
29
|
+
<div class="refentry">
|
|
30
30
|
<a name="glib-Character-Set-Conversion"></a><div class="titlepage"></div>
|
|
31
31
|
<div class="refnamediv"><table width="100%"><tr>
|
|
32
32
|
<td valign="top">
|
|
@@ -35,33 +35,33 @@
|
|
|
35
35
|
</td>
|
|
36
36
|
<td valign="top" align="right"></td>
|
|
37
37
|
</tr></table></div>
|
|
38
|
-
<div class="refsynopsisdiv"
|
|
38
|
+
<div class="refsynopsisdiv">
|
|
39
39
|
<a name="glib-Character-Set-Conversion.synopsis"></a><h2>Synopsis</h2>
|
|
40
40
|
<pre class="synopsis">
|
|
41
41
|
#include <glib.h>
|
|
42
42
|
|
|
43
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
43
|
+
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-convert" title="g_convert ()">g_convert</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
44
44
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
45
45
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
46
46
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>,
|
|
47
47
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
48
48
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
49
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
50
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
49
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
|
|
50
|
+
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-convert-with-fallback" title="g_convert_with_fallback ()">g_convert_with_fallback</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
51
51
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
52
52
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
53
53
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>,
|
|
54
54
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *fallback</code></em>,
|
|
55
55
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
56
56
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
57
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
57
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
|
|
58
58
|
<a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv">GIConv</a>;
|
|
59
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
59
|
+
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-convert-with-iconv" title="g_convert_with_iconv ()">g_convert_with_iconv</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
60
60
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
61
61
|
<em class="parameter"><code><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="type">GIConv</span></a> converter</code></em>,
|
|
62
62
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
63
63
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
64
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
64
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
|
|
65
65
|
#define <a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR:CAPS" title="G_CONVERT_ERROR">G_CONVERT_ERROR</a>
|
|
66
66
|
<a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="returnvalue">GIConv</span></a> <a class="link" href="glib-Character-Set-Conversion.html#g-iconv-open" title="g_iconv_open ()">g_iconv_open</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
67
67
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>);
|
|
@@ -71,42 +71,36 @@
|
|
|
71
71
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **outbuf</code></em>,
|
|
72
72
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *outbytes_left</code></em>);
|
|
73
73
|
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Character-Set-Conversion.html#g-iconv-close" title="g_iconv_close ()">g_iconv_close</a> (<em class="parameter"><code><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="type">GIConv</span></a> converter</code></em>);
|
|
74
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
74
|
+
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-locale-to-utf8" title="g_locale_to_utf8 ()">g_locale_to_utf8</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *opsysstring</code></em>,
|
|
75
75
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
76
76
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
77
77
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
78
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
82
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
83
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
84
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8 ()">g_filename_from_utf8</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *utf8string</code></em>,
|
|
85
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
86
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
87
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
88
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
78
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
|
|
79
|
+
#define <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8">g_filename_to_utf8</a>
|
|
80
|
+
#define <a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8">g_filename_from_utf8</a>
|
|
89
81
|
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Character-Set-Conversion.html#g-get-filename-charsets" title="g_get_filename_charsets ()">g_get_filename_charsets</a> (<em class="parameter"><code>G_CONST_RETURN <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> ***charsets</code></em>);
|
|
90
82
|
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-filename-display-name" title="g_filename_display_name ()">g_filename_display_name</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>);
|
|
91
83
|
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-filename-display-basename" title="g_filename_display_basename ()">g_filename_display_basename</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>);
|
|
92
|
-
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
84
|
+
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Character-Set-Conversion.html#g-locale-from-utf8" title="g_locale_from_utf8 ()">g_locale_from_utf8</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *utf8string</code></em>,
|
|
93
85
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
94
86
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
95
87
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
96
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
|
|
88
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
|
|
97
89
|
enum <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError">GConvertError</a>;
|
|
98
90
|
|
|
99
91
|
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Character-Set-Conversion.html#g-get-charset" title="g_get_charset ()">g_get_charset</a> (<em class="parameter"><code>G_CONST_RETURN <span class="type">char</span> **charset</code></em>);
|
|
100
92
|
</pre>
|
|
101
93
|
</div>
|
|
102
|
-
<div class="refsect1"
|
|
94
|
+
<div class="refsect1">
|
|
103
95
|
<a name="glib-Character-Set-Conversion.description"></a><h2>Description</h2>
|
|
104
96
|
<p>
|
|
105
97
|
The <a class="link" href="glib-Character-Set-Conversion.html#g-convert" title="g_convert ()"><code class="function">g_convert()</code></a> family of function wraps the functionality of <code class="function">iconv()</code>. In
|
|
106
98
|
addition to pure character set conversions, GLib has functions to deal
|
|
107
99
|
with the extra complications of encodings for file names.
|
|
108
100
|
</p>
|
|
109
|
-
<
|
|
101
|
+
<p>
|
|
102
|
+
</p>
|
|
103
|
+
<div class="refsect2">
|
|
110
104
|
<a name="file-name-encodings"></a><h3>File Name Encodings</h3>
|
|
111
105
|
<p>
|
|
112
106
|
Historically, Unix has not had a defined encoding for file
|
|
@@ -133,7 +127,7 @@ Hex code: 50 72 65 73 65 6e 74 61 63 69 c3 b3 6e 2e 73 78 69
|
|
|
133
127
|
<p>
|
|
134
128
|
Glib uses UTF-8 for its strings, and GUI toolkits like GTK+
|
|
135
129
|
that use Glib do the same thing. If you get a file name from
|
|
136
|
-
the file system, for example, from readdir(3) or from <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name
|
|
130
|
+
the file system, for example, from readdir(3) or from <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name"><code class="function">g_dir_read_name()</code></a>,
|
|
137
131
|
and you wish to display the file name to the user, you
|
|
138
132
|
<span class="emphasis"><em>will</em></span> need to convert it into UTF-8. The
|
|
139
133
|
opposite case is when the user types the name of a file he
|
|
@@ -161,8 +155,8 @@ ISO-8859-1 for file names, you can put this in your
|
|
|
161
155
|
export G_FILENAME_ENCODING=ISO-8859-1
|
|
162
156
|
</pre>
|
|
163
157
|
<p>
|
|
164
|
-
Glib provides the functions <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8
|
|
165
|
-
<a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8
|
|
158
|
+
Glib provides the functions <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8"><code class="function">g_filename_to_utf8()</code></a> and
|
|
159
|
+
<a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8"><code class="function">g_filename_from_utf8()</code></a> to perform the necessary conversions. These
|
|
166
160
|
functions convert file names from the encoding specified in
|
|
167
161
|
<code class="envar">G_FILENAME_ENCODING</code> to UTF-8 and vice-versa.
|
|
168
162
|
<a class="xref" href="glib-Character-Set-Conversion.html#file-name-encodings-diagram" title="Figure 2. Conversion between File Name Encodings">Figure 2, “Conversion between File Name Encodings”</a> illustrates how
|
|
@@ -173,7 +167,7 @@ encoding for file names in the file system.
|
|
|
173
167
|
<a name="file-name-encodings-diagram"></a><p class="title"><b>Figure 2. Conversion between File Name Encodings</b></p>
|
|
174
168
|
<div class="figure-contents"><div><img src="file-name-encodings.png" alt="Conversion between File Name Encodings"></div></div>
|
|
175
169
|
</div>
|
|
176
|
-
<br class="figure-break"><div class="refsect3"
|
|
170
|
+
<br class="figure-break"><div class="refsect3">
|
|
177
171
|
<a name="file-name-encodings-checklist"></a><h4>Checklist for Application Writers</h4>
|
|
178
172
|
<p>
|
|
179
173
|
This section is a practical summary of the detailed
|
|
@@ -184,7 +178,7 @@ name encodings correctly.
|
|
|
184
178
|
<div class="orderedlist"><ol class="orderedlist" type="1">
|
|
185
179
|
<li class="listitem"><p>
|
|
186
180
|
If you get a file name from the file system from a function
|
|
187
|
-
such as readdir(3) or <a href="http://library.gnome.org/devel/gtk/
|
|
181
|
+
such as readdir(3) or <a href="http://library.gnome.org/devel/gtk/2.24/GtkFileChooser.html#gtk-file-chooser-get-filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
|
|
188
182
|
you do not need to do any conversion to pass that
|
|
189
183
|
file name to functions like open(2), rename(2), or
|
|
190
184
|
fopen(3) — those are "raw" file names which the file
|
|
@@ -192,7 +186,7 @@ system understands.
|
|
|
192
186
|
</p></li>
|
|
193
187
|
<li class="listitem"><p>
|
|
194
188
|
If you need to display a file name, convert it to UTF-8 first by
|
|
195
|
-
using <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8
|
|
189
|
+
using <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8"><code class="function">g_filename_to_utf8()</code></a>. If conversion fails, display a string like
|
|
196
190
|
"<code class="literal">Unknown file name</code>". <span class="emphasis"><em>Do not</em></span>
|
|
197
191
|
convert this string back into the encoding used for file names if you
|
|
198
192
|
wish to pass it to the file system; use the original file name instead.
|
|
@@ -206,7 +200,7 @@ encoded in UTF-8.
|
|
|
206
200
|
<li class="listitem"><p>
|
|
207
201
|
If your user interface lets the user type a file name for saving or
|
|
208
202
|
renaming, convert it to the encoding used for file names in the file
|
|
209
|
-
system by using <a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8
|
|
203
|
+
system by using <a class="link" href="glib-Character-Set-Conversion.html#g-filename-from-utf8" title="g_filename_from_utf8"><code class="function">g_filename_from_utf8()</code></a>. Pass the converted file name
|
|
210
204
|
to functions like fopen(3). If conversion fails, ask the user to enter
|
|
211
205
|
a different file name. This can happen if the user types Japanese
|
|
212
206
|
characters when <code class="envar">G_FILENAME_ENCODING</code> is set to
|
|
@@ -215,18 +209,20 @@ characters when <code class="envar">G_FILENAME_ENCODING</code> is set to
|
|
|
215
209
|
</ol></div>
|
|
216
210
|
</div>
|
|
217
211
|
</div>
|
|
212
|
+
<p>
|
|
213
|
+
</p>
|
|
218
214
|
</div>
|
|
219
|
-
<div class="refsect1"
|
|
215
|
+
<div class="refsect1">
|
|
220
216
|
<a name="glib-Character-Set-Conversion.details"></a><h2>Details</h2>
|
|
221
|
-
<div class="refsect2"
|
|
217
|
+
<div class="refsect2">
|
|
222
218
|
<a name="g-convert"></a><h3>g_convert ()</h3>
|
|
223
|
-
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
219
|
+
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_convert (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
224
220
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
225
221
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
226
222
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>,
|
|
227
223
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
228
224
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
229
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
225
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
230
226
|
<p>
|
|
231
227
|
Converts a string from one character set to another.
|
|
232
228
|
</p>
|
|
@@ -239,14 +235,12 @@ conversions<sup>[<a href="glib-Character-Set-Conversion.html#ftn.streaming-state
|
|
|
239
235
|
<tbody>
|
|
240
236
|
<tr>
|
|
241
237
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
242
|
-
<td>the string to convert
|
|
243
|
-
</td>
|
|
238
|
+
<td>the string to convert</td>
|
|
244
239
|
</tr>
|
|
245
240
|
<tr>
|
|
246
241
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
247
|
-
<td>the length of the string, or -1 if the string is
|
|
248
|
-
|
|
249
|
-
</td>
|
|
242
|
+
<td>the length of the string, or -1 if the string is
|
|
243
|
+
nul-terminated<sup>[<a name="nul-unsafe" href="#ftn.nul-unsafe" class="footnote">1</a>]</sup>.</td>
|
|
250
244
|
</tr>
|
|
251
245
|
<tr>
|
|
252
246
|
<td><p><span class="term"><em class="parameter"><code>to_codeset</code></em> :</span></p></td>
|
|
@@ -255,54 +249,49 @@ conversions<sup>[<a href="glib-Character-Set-Conversion.html#ftn.streaming-state
|
|
|
255
249
|
</tr>
|
|
256
250
|
<tr>
|
|
257
251
|
<td><p><span class="term"><em class="parameter"><code>from_codeset</code></em> :</span></p></td>
|
|
258
|
-
<td>character set of <em class="parameter"><code>str</code></em
|
|
259
|
-
</td>
|
|
252
|
+
<td>character set of <em class="parameter"><code>str</code></em>.</td>
|
|
260
253
|
</tr>
|
|
261
254
|
<tr>
|
|
262
255
|
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
263
256
|
<td>location to store the number of bytes in the
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
</td>
|
|
257
|
+
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
258
|
+
Even if the conversion was successful, this may be
|
|
259
|
+
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
260
|
+
at the end of the input. If the error
|
|
261
|
+
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
262
|
+
stored will the byte offset after the last valid
|
|
263
|
+
input sequence.</td>
|
|
272
264
|
</tr>
|
|
273
265
|
<tr>
|
|
274
266
|
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
275
|
-
<td>the number of bytes stored in the output buffer (not
|
|
276
|
-
|
|
277
|
-
</td>
|
|
267
|
+
<td>the number of bytes stored in the output buffer (not
|
|
268
|
+
including the terminating nul).</td>
|
|
278
269
|
</tr>
|
|
279
270
|
<tr>
|
|
280
271
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
281
272
|
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
282
|
-
|
|
283
|
-
</td>
|
|
273
|
+
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.</td>
|
|
284
274
|
</tr>
|
|
285
275
|
<tr>
|
|
286
276
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
287
|
-
<td>
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
</td>
|
|
277
|
+
<td>If the conversion was successful, a newly allocated
|
|
278
|
+
nul-terminated string, which must be freed with
|
|
279
|
+
<a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>. Otherwise <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and <em class="parameter"><code>error</code></em> will be set.</td>
|
|
291
280
|
</tr>
|
|
292
281
|
</tbody>
|
|
293
282
|
</table></div>
|
|
294
283
|
</div>
|
|
295
284
|
<hr>
|
|
296
|
-
<div class="refsect2"
|
|
285
|
+
<div class="refsect2">
|
|
297
286
|
<a name="g-convert-with-fallback"></a><h3>g_convert_with_fallback ()</h3>
|
|
298
|
-
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
287
|
+
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_convert_with_fallback (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
299
288
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
300
289
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
301
290
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>,
|
|
302
291
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *fallback</code></em>,
|
|
303
292
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
304
293
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
305
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
294
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
306
295
|
<p>
|
|
307
296
|
Converts a string from one character set to another, possibly
|
|
308
297
|
including fallback sequences for characters not representable
|
|
@@ -321,14 +310,12 @@ conversions<sup>[<a href="glib-Character-Set-Conversion.html#ftn.streaming-state
|
|
|
321
310
|
<tbody>
|
|
322
311
|
<tr>
|
|
323
312
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
324
|
-
<td>the string to convert
|
|
325
|
-
</td>
|
|
313
|
+
<td>the string to convert</td>
|
|
326
314
|
</tr>
|
|
327
315
|
<tr>
|
|
328
316
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
329
|
-
<td>the length of the string, or -1 if the string is
|
|
330
|
-
|
|
331
|
-
</td>
|
|
317
|
+
<td>the length of the string, or -1 if the string is
|
|
318
|
+
nul-terminated<sup>[<a href="glib-Character-Set-Conversion.html#ftn.nul-unsafe" class="footnoteref">1</a>]</sup>.</td>
|
|
332
319
|
</tr>
|
|
333
320
|
<tr>
|
|
334
321
|
<td><p><span class="term"><em class="parameter"><code>to_codeset</code></em> :</span></p></td>
|
|
@@ -337,65 +324,59 @@ conversions<sup>[<a href="glib-Character-Set-Conversion.html#ftn.streaming-state
|
|
|
337
324
|
</tr>
|
|
338
325
|
<tr>
|
|
339
326
|
<td><p><span class="term"><em class="parameter"><code>from_codeset</code></em> :</span></p></td>
|
|
340
|
-
<td>character set of <em class="parameter"><code>str</code></em
|
|
341
|
-
</td>
|
|
327
|
+
<td>character set of <em class="parameter"><code>str</code></em>.</td>
|
|
342
328
|
</tr>
|
|
343
329
|
<tr>
|
|
344
330
|
<td><p><span class="term"><em class="parameter"><code>fallback</code></em> :</span></p></td>
|
|
345
331
|
<td>UTF-8 string to use in place of character not
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
</td>
|
|
332
|
+
present in the target encoding. (The string must be
|
|
333
|
+
representable in the target encoding).
|
|
334
|
+
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, characters not in the target encoding will
|
|
335
|
+
be represented as Unicode escapes \uxxxx or \Uxxxxyyyy.</td>
|
|
351
336
|
</tr>
|
|
352
337
|
<tr>
|
|
353
338
|
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
354
339
|
<td>location to store the number of bytes in the
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
</td>
|
|
340
|
+
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
341
|
+
Even if the conversion was successful, this may be
|
|
342
|
+
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
343
|
+
at the end of the input.</td>
|
|
360
344
|
</tr>
|
|
361
345
|
<tr>
|
|
362
346
|
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
363
|
-
<td>the number of bytes stored in the output buffer (not
|
|
364
|
-
|
|
365
|
-
</td>
|
|
347
|
+
<td>the number of bytes stored in the output buffer (not
|
|
348
|
+
including the terminating nul).</td>
|
|
366
349
|
</tr>
|
|
367
350
|
<tr>
|
|
368
351
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
369
352
|
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
370
|
-
|
|
371
|
-
</td>
|
|
353
|
+
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.</td>
|
|
372
354
|
</tr>
|
|
373
355
|
<tr>
|
|
374
356
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
375
|
-
<td>
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
</td>
|
|
357
|
+
<td>If the conversion was successful, a newly allocated
|
|
358
|
+
nul-terminated string, which must be freed with
|
|
359
|
+
<a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>. Otherwise <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and <em class="parameter"><code>error</code></em> will be set.</td>
|
|
379
360
|
</tr>
|
|
380
361
|
</tbody>
|
|
381
362
|
</table></div>
|
|
382
363
|
</div>
|
|
383
364
|
<hr>
|
|
384
|
-
<div class="refsect2"
|
|
365
|
+
<div class="refsect2">
|
|
385
366
|
<a name="GIConv"></a><h3>GIConv</h3>
|
|
386
367
|
<pre class="programlisting">typedef struct _GIConv GIConv;</pre>
|
|
387
368
|
<p>
|
|
388
369
|
</p>
|
|
389
370
|
</div>
|
|
390
371
|
<hr>
|
|
391
|
-
<div class="refsect2"
|
|
372
|
+
<div class="refsect2">
|
|
392
373
|
<a name="g-convert-with-iconv"></a><h3>g_convert_with_iconv ()</h3>
|
|
393
|
-
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
374
|
+
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_convert_with_iconv (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
|
|
394
375
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
395
376
|
<em class="parameter"><code><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="type">GIConv</span></a> converter</code></em>,
|
|
396
377
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
397
378
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
398
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
379
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
399
380
|
<p>
|
|
400
381
|
Converts a string from one character set to another.
|
|
401
382
|
</p>
|
|
@@ -408,14 +389,12 @@ conversions<sup>[<a name="streaming-state" href="#ftn.streaming-state" class="fo
|
|
|
408
389
|
<tbody>
|
|
409
390
|
<tr>
|
|
410
391
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
411
|
-
<td>the string to convert
|
|
412
|
-
</td>
|
|
392
|
+
<td>the string to convert</td>
|
|
413
393
|
</tr>
|
|
414
394
|
<tr>
|
|
415
395
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
416
|
-
<td>the length of the string, or -1 if the string is
|
|
417
|
-
|
|
418
|
-
</td>
|
|
396
|
+
<td>the length of the string, or -1 if the string is
|
|
397
|
+
nul-terminated<sup>[<a href="glib-Character-Set-Conversion.html#ftn.nul-unsafe" class="footnoteref">1</a>]</sup>.</td>
|
|
419
398
|
</tr>
|
|
420
399
|
<tr>
|
|
421
400
|
<td><p><span class="term"><em class="parameter"><code>converter</code></em> :</span></p></td>
|
|
@@ -425,50 +404,46 @@ conversions<sup>[<a name="streaming-state" href="#ftn.streaming-state" class="fo
|
|
|
425
404
|
<tr>
|
|
426
405
|
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
427
406
|
<td>location to store the number of bytes in the
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
</td>
|
|
407
|
+
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
408
|
+
Even if the conversion was successful, this may be
|
|
409
|
+
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
410
|
+
at the end of the input. If the error
|
|
411
|
+
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
412
|
+
stored will the byte offset after the last valid
|
|
413
|
+
input sequence.</td>
|
|
436
414
|
</tr>
|
|
437
415
|
<tr>
|
|
438
416
|
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
439
|
-
<td>the number of bytes stored in the output buffer (not
|
|
440
|
-
|
|
441
|
-
</td>
|
|
417
|
+
<td>the number of bytes stored in the output buffer (not
|
|
418
|
+
including the terminating nul).</td>
|
|
442
419
|
</tr>
|
|
443
420
|
<tr>
|
|
444
421
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
445
422
|
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
446
|
-
|
|
447
|
-
</td>
|
|
423
|
+
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.</td>
|
|
448
424
|
</tr>
|
|
449
425
|
<tr>
|
|
450
426
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
451
|
-
<td>
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
</td>
|
|
427
|
+
<td>If the conversion was successful, a newly allocated
|
|
428
|
+
nul-terminated string, which must be freed with
|
|
429
|
+
<a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>. Otherwise <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and <em class="parameter"><code>error</code></em> will be set.</td>
|
|
455
430
|
</tr>
|
|
456
431
|
</tbody>
|
|
457
432
|
</table></div>
|
|
458
433
|
</div>
|
|
459
434
|
<hr>
|
|
460
|
-
<div class="refsect2"
|
|
435
|
+
<div class="refsect2">
|
|
461
436
|
<a name="G-CONVERT-ERROR:CAPS"></a><h3>G_CONVERT_ERROR</h3>
|
|
462
437
|
<pre class="programlisting">#define G_CONVERT_ERROR g_convert_error_quark()
|
|
463
438
|
</pre>
|
|
464
439
|
<p>
|
|
465
440
|
Error domain for character set conversions. Errors in this domain will
|
|
466
|
-
be from the <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for information on
|
|
441
|
+
be from the <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> for information on
|
|
467
442
|
error domains.
|
|
468
443
|
</p>
|
|
469
444
|
</div>
|
|
470
445
|
<hr>
|
|
471
|
-
<div class="refsect2"
|
|
446
|
+
<div class="refsect2">
|
|
472
447
|
<a name="g-iconv-open"></a><h3>g_iconv_open ()</h3>
|
|
473
448
|
<pre class="programlisting"><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="returnvalue">GIConv</span></a> g_iconv_open (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *to_codeset</code></em>,
|
|
474
449
|
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *from_codeset</code></em>);</pre>
|
|
@@ -486,25 +461,22 @@ more convenient than the raw iconv wrappers.
|
|
|
486
461
|
<tbody>
|
|
487
462
|
<tr>
|
|
488
463
|
<td><p><span class="term"><em class="parameter"><code>to_codeset</code></em> :</span></p></td>
|
|
489
|
-
<td>destination codeset
|
|
490
|
-
</td>
|
|
464
|
+
<td>destination codeset</td>
|
|
491
465
|
</tr>
|
|
492
466
|
<tr>
|
|
493
467
|
<td><p><span class="term"><em class="parameter"><code>from_codeset</code></em> :</span></p></td>
|
|
494
|
-
<td>source codeset
|
|
495
|
-
</td>
|
|
468
|
+
<td>source codeset</td>
|
|
496
469
|
</tr>
|
|
497
470
|
<tr>
|
|
498
471
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
499
|
-
<td>
|
|
500
|
-
|
|
501
|
-
</td>
|
|
472
|
+
<td>a "conversion descriptor", or (GIConv)-1 if
|
|
473
|
+
opening the converter failed.</td>
|
|
502
474
|
</tr>
|
|
503
475
|
</tbody>
|
|
504
476
|
</table></div>
|
|
505
477
|
</div>
|
|
506
478
|
<hr>
|
|
507
|
-
<div class="refsect2"
|
|
479
|
+
<div class="refsect2">
|
|
508
480
|
<a name="g-iconv"></a><h3>g_iconv ()</h3>
|
|
509
481
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_iconv (<em class="parameter"><code><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="type">GIConv</span></a> converter</code></em>,
|
|
510
482
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **inbuf</code></em>,
|
|
@@ -530,8 +502,7 @@ more convenient than the raw iconv wrappers.
|
|
|
530
502
|
</tr>
|
|
531
503
|
<tr>
|
|
532
504
|
<td><p><span class="term"><em class="parameter"><code>inbuf</code></em> :</span></p></td>
|
|
533
|
-
<td>bytes to convert
|
|
534
|
-
</td>
|
|
505
|
+
<td>bytes to convert</td>
|
|
535
506
|
</tr>
|
|
536
507
|
<tr>
|
|
537
508
|
<td><p><span class="term"><em class="parameter"><code>inbytes_left</code></em> :</span></p></td>
|
|
@@ -540,8 +511,7 @@ more convenient than the raw iconv wrappers.
|
|
|
540
511
|
</tr>
|
|
541
512
|
<tr>
|
|
542
513
|
<td><p><span class="term"><em class="parameter"><code>outbuf</code></em> :</span></p></td>
|
|
543
|
-
<td>converted output bytes
|
|
544
|
-
</td>
|
|
514
|
+
<td>converted output bytes</td>
|
|
545
515
|
</tr>
|
|
546
516
|
<tr>
|
|
547
517
|
<td><p><span class="term"><em class="parameter"><code>outbytes_left</code></em> :</span></p></td>
|
|
@@ -550,14 +520,13 @@ more convenient than the raw iconv wrappers.
|
|
|
550
520
|
</tr>
|
|
551
521
|
<tr>
|
|
552
522
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
553
|
-
<td>
|
|
554
|
-
</td>
|
|
523
|
+
<td>count of non-reversible conversions, or -1 on error</td>
|
|
555
524
|
</tr>
|
|
556
525
|
</tbody>
|
|
557
526
|
</table></div>
|
|
558
527
|
</div>
|
|
559
528
|
<hr>
|
|
560
|
-
<div class="refsect2"
|
|
529
|
+
<div class="refsect2">
|
|
561
530
|
<a name="g-iconv-close"></a><h3>g_iconv_close ()</h3>
|
|
562
531
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_iconv_close (<em class="parameter"><code><a class="link" href="glib-Character-Set-Conversion.html#GIConv" title="GIConv"><span class="type">GIConv</span></a> converter</code></em>);</pre>
|
|
563
532
|
<p>
|
|
@@ -581,20 +550,19 @@ more convenient than the raw iconv wrappers.
|
|
|
581
550
|
</tr>
|
|
582
551
|
<tr>
|
|
583
552
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
584
|
-
<td
|
|
585
|
-
</td>
|
|
553
|
+
<td>-1 on error, 0 on success</td>
|
|
586
554
|
</tr>
|
|
587
555
|
</tbody>
|
|
588
556
|
</table></div>
|
|
589
557
|
</div>
|
|
590
558
|
<hr>
|
|
591
|
-
<div class="refsect2"
|
|
559
|
+
<div class="refsect2">
|
|
592
560
|
<a name="g-locale-to-utf8"></a><h3>g_locale_to_utf8 ()</h3>
|
|
593
|
-
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
561
|
+
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_locale_to_utf8 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *opsysstring</code></em>,
|
|
594
562
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
595
563
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
596
564
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
597
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
565
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
598
566
|
<p>
|
|
599
567
|
Converts a string which is in the encoding used for strings by
|
|
600
568
|
the C runtime (usually the same as that used by the operating
|
|
@@ -607,55 +575,45 @@ UTF-8 string.
|
|
|
607
575
|
<tr>
|
|
608
576
|
<td><p><span class="term"><em class="parameter"><code>opsysstring</code></em> :</span></p></td>
|
|
609
577
|
<td>a string in the encoding of the current locale. On Windows
|
|
610
|
-
|
|
611
|
-
</td>
|
|
578
|
+
this means the system codepage.</td>
|
|
612
579
|
</tr>
|
|
613
580
|
<tr>
|
|
614
581
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
615
582
|
<td>the length of the string, or -1 if the string is
|
|
616
|
-
|
|
617
|
-
</td>
|
|
583
|
+
nul-terminated<sup>[<a href="glib-Character-Set-Conversion.html#ftn.nul-unsafe" class="footnoteref">1</a>]</sup>.</td>
|
|
618
584
|
</tr>
|
|
619
585
|
<tr>
|
|
620
586
|
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
621
587
|
<td>location to store the number of bytes in the
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
</td>
|
|
588
|
+
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
589
|
+
Even if the conversion was successful, this may be
|
|
590
|
+
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
591
|
+
at the end of the input. If the error
|
|
592
|
+
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
593
|
+
stored will the byte offset after the last valid
|
|
594
|
+
input sequence.</td>
|
|
630
595
|
</tr>
|
|
631
596
|
<tr>
|
|
632
597
|
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
633
|
-
<td>the number of bytes stored in the output buffer (not
|
|
634
|
-
|
|
635
|
-
</td>
|
|
598
|
+
<td>the number of bytes stored in the output buffer (not
|
|
599
|
+
including the terminating nul).</td>
|
|
636
600
|
</tr>
|
|
637
601
|
<tr>
|
|
638
602
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
639
603
|
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
640
|
-
|
|
641
|
-
</td>
|
|
604
|
+
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.</td>
|
|
642
605
|
</tr>
|
|
643
606
|
<tr>
|
|
644
607
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
645
|
-
<td>
|
|
646
|
-
</td>
|
|
608
|
+
<td>The converted string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on an error.</td>
|
|
647
609
|
</tr>
|
|
648
610
|
</tbody>
|
|
649
611
|
</table></div>
|
|
650
612
|
</div>
|
|
651
613
|
<hr>
|
|
652
|
-
<div class="refsect2"
|
|
653
|
-
<a name="g-filename-to-utf8"></a><h3>g_filename_to_utf8
|
|
654
|
-
<pre class="programlisting"
|
|
655
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
656
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
657
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
658
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
614
|
+
<div class="refsect2">
|
|
615
|
+
<a name="g-filename-to-utf8"></a><h3>g_filename_to_utf8</h3>
|
|
616
|
+
<pre class="programlisting">#define g_filename_to_utf8</pre>
|
|
659
617
|
<p>
|
|
660
618
|
Converts a string which is in the encoding used by GLib for
|
|
661
619
|
filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
|
|
@@ -664,58 +622,16 @@ the <a class="link" href="glib-running.html#setlocale" title="Locale">current lo
|
|
|
664
622
|
</p>
|
|
665
623
|
<div class="variablelist"><table border="0">
|
|
666
624
|
<col align="left" valign="top">
|
|
667
|
-
<tbody>
|
|
668
|
-
<tr>
|
|
669
|
-
<td><p><span class="term"><em class="parameter"><code>opsysstring</code></em> :</span></p></td>
|
|
670
|
-
<td>a string in the encoding for filenames
|
|
671
|
-
</td>
|
|
672
|
-
</tr>
|
|
673
|
-
<tr>
|
|
674
|
-
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
675
|
-
<td>the length of the string, or -1 if the string is
|
|
676
|
-
nul-terminated<sup>[<a href="glib-Character-Set-Conversion.html#ftn.nul-unsafe" class="footnoteref">1</a>]</sup>.
|
|
677
|
-
</td>
|
|
678
|
-
</tr>
|
|
679
|
-
<tr>
|
|
680
|
-
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
681
|
-
<td>location to store the number of bytes in the
|
|
682
|
-
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
683
|
-
Even if the conversion was successful, this may be
|
|
684
|
-
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
685
|
-
at the end of the input. If the error
|
|
686
|
-
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
687
|
-
stored will the byte offset after the last valid
|
|
688
|
-
input sequence.
|
|
689
|
-
</td>
|
|
690
|
-
</tr>
|
|
691
|
-
<tr>
|
|
692
|
-
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
693
|
-
<td>the number of bytes stored in the output buffer (not
|
|
694
|
-
including the terminating nul).
|
|
695
|
-
</td>
|
|
696
|
-
</tr>
|
|
697
|
-
<tr>
|
|
698
|
-
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
699
|
-
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
700
|
-
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.
|
|
701
|
-
</td>
|
|
702
|
-
</tr>
|
|
703
|
-
<tr>
|
|
625
|
+
<tbody><tr>
|
|
704
626
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
705
|
-
<td>
|
|
706
|
-
</
|
|
707
|
-
</tr>
|
|
708
|
-
</tbody>
|
|
627
|
+
<td>The converted string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on an error.</td>
|
|
628
|
+
</tr></tbody>
|
|
709
629
|
</table></div>
|
|
710
630
|
</div>
|
|
711
631
|
<hr>
|
|
712
|
-
<div class="refsect2"
|
|
713
|
-
<a name="g-filename-from-utf8"></a><h3>g_filename_from_utf8
|
|
714
|
-
<pre class="programlisting"
|
|
715
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
716
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
717
|
-
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
718
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
632
|
+
<div class="refsect2">
|
|
633
|
+
<a name="g-filename-from-utf8"></a><h3>g_filename_from_utf8</h3>
|
|
634
|
+
<pre class="programlisting">#define g_filename_from_utf8</pre>
|
|
719
635
|
<p>
|
|
720
636
|
Converts a string from UTF-8 to the encoding GLib uses for
|
|
721
637
|
filenames. Note that on Windows GLib uses UTF-8 for filenames;
|
|
@@ -724,52 +640,14 @@ on other platforms, this function indirectly depends on the
|
|
|
724
640
|
</p>
|
|
725
641
|
<div class="variablelist"><table border="0">
|
|
726
642
|
<col align="left" valign="top">
|
|
727
|
-
<tbody>
|
|
728
|
-
<tr>
|
|
729
|
-
<td><p><span class="term"><em class="parameter"><code>utf8string</code></em> :</span></p></td>
|
|
730
|
-
<td>a UTF-8 encoded string.
|
|
731
|
-
</td>
|
|
732
|
-
</tr>
|
|
733
|
-
<tr>
|
|
734
|
-
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
735
|
-
<td>the length of the string, or -1 if the string is
|
|
736
|
-
nul-terminated.
|
|
737
|
-
</td>
|
|
738
|
-
</tr>
|
|
739
|
-
<tr>
|
|
740
|
-
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
741
|
-
<td>location to store the number of bytes in the
|
|
742
|
-
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
743
|
-
Even if the conversion was successful, this may be
|
|
744
|
-
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
745
|
-
at the end of the input. If the error
|
|
746
|
-
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
747
|
-
stored will the byte offset after the last valid
|
|
748
|
-
input sequence.
|
|
749
|
-
</td>
|
|
750
|
-
</tr>
|
|
751
|
-
<tr>
|
|
752
|
-
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
753
|
-
<td>the number of bytes stored in the output buffer (not
|
|
754
|
-
including the terminating nul).
|
|
755
|
-
</td>
|
|
756
|
-
</tr>
|
|
757
|
-
<tr>
|
|
758
|
-
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
759
|
-
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
760
|
-
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.
|
|
761
|
-
</td>
|
|
762
|
-
</tr>
|
|
763
|
-
<tr>
|
|
643
|
+
<tbody><tr>
|
|
764
644
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
765
|
-
<td>
|
|
766
|
-
</
|
|
767
|
-
</tr>
|
|
768
|
-
</tbody>
|
|
645
|
+
<td>The converted string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on an error.</td>
|
|
646
|
+
</tr></tbody>
|
|
769
647
|
</table></div>
|
|
770
648
|
</div>
|
|
771
649
|
<hr>
|
|
772
|
-
<div class="refsect2"
|
|
650
|
+
<div class="refsect2">
|
|
773
651
|
<a name="g-get-filename-charsets"></a><h3>g_get_filename_charsets ()</h3>
|
|
774
652
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_get_filename_charsets (<em class="parameter"><code>G_CONST_RETURN <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> ***charsets</code></em>);</pre>
|
|
775
653
|
<p>
|
|
@@ -808,28 +686,26 @@ on a system might be in any random encoding or just gibberish.
|
|
|
808
686
|
<tbody>
|
|
809
687
|
<tr>
|
|
810
688
|
<td><p><span class="term"><em class="parameter"><code>charsets</code></em> :</span></p></td>
|
|
811
|
-
<td>return location for the <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated list of encoding names
|
|
812
|
-
</td>
|
|
689
|
+
<td>return location for the <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated list of encoding names</td>
|
|
813
690
|
</tr>
|
|
814
691
|
<tr>
|
|
815
692
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
816
|
-
<td>
|
|
817
|
-
|
|
818
|
-
</td>
|
|
693
|
+
<td>
|
|
694
|
+
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the filename encoding is UTF-8.</td>
|
|
819
695
|
</tr>
|
|
820
696
|
</tbody>
|
|
821
697
|
</table></div>
|
|
822
698
|
<p class="since">Since 2.6</p>
|
|
823
699
|
</div>
|
|
824
700
|
<hr>
|
|
825
|
-
<div class="refsect2"
|
|
701
|
+
<div class="refsect2">
|
|
826
702
|
<a name="g-filename-display-name"></a><h3>g_filename_display_name ()</h3>
|
|
827
703
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_filename_display_name (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
|
|
828
704
|
<p>
|
|
829
705
|
Converts a filename into a valid UTF-8 string. The conversion is
|
|
830
706
|
not necessarily reversible, so you should keep the original around
|
|
831
707
|
and use the return value of this function only for display purposes.
|
|
832
|
-
Unlike <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8
|
|
708
|
+
Unlike <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8"><code class="function">g_filename_to_utf8()</code></a>, the result is guaranteed to be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
|
|
833
709
|
even if the filename actually isn't in the GLib file name encoding.
|
|
834
710
|
</p>
|
|
835
711
|
<p>
|
|
@@ -849,22 +725,19 @@ translation of filenames.
|
|
|
849
725
|
<tbody>
|
|
850
726
|
<tr>
|
|
851
727
|
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
|
|
852
|
-
<td>a pathname hopefully in the GLib file name encoding
|
|
853
|
-
</td>
|
|
728
|
+
<td>a pathname hopefully in the GLib file name encoding</td>
|
|
854
729
|
</tr>
|
|
855
730
|
<tr>
|
|
856
731
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
857
|
-
<td>
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
</td>
|
|
732
|
+
<td>a newly allocated string containing
|
|
733
|
+
a rendition of the filename in valid UTF-8</td>
|
|
861
734
|
</tr>
|
|
862
735
|
</tbody>
|
|
863
736
|
</table></div>
|
|
864
737
|
<p class="since">Since 2.6</p>
|
|
865
738
|
</div>
|
|
866
739
|
<hr>
|
|
867
|
-
<div class="refsect2"
|
|
740
|
+
<div class="refsect2">
|
|
868
741
|
<a name="g-filename-display-basename"></a><h3>g_filename_display_basename ()</h3>
|
|
869
742
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_filename_display_basename (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
|
|
870
743
|
<p>
|
|
@@ -893,28 +766,25 @@ whole path, as it allows translation.
|
|
|
893
766
|
<tbody>
|
|
894
767
|
<tr>
|
|
895
768
|
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
|
|
896
|
-
<td>an absolute pathname in the GLib file name encoding
|
|
897
|
-
</td>
|
|
769
|
+
<td>an absolute pathname in the GLib file name encoding</td>
|
|
898
770
|
</tr>
|
|
899
771
|
<tr>
|
|
900
772
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
901
|
-
<td>
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
</td>
|
|
773
|
+
<td>a newly allocated string containing
|
|
774
|
+
a rendition of the basename of the filename in valid UTF-8</td>
|
|
905
775
|
</tr>
|
|
906
776
|
</tbody>
|
|
907
777
|
</table></div>
|
|
908
778
|
<p class="since">Since 2.6</p>
|
|
909
779
|
</div>
|
|
910
780
|
<hr>
|
|
911
|
-
<div class="refsect2"
|
|
781
|
+
<div class="refsect2">
|
|
912
782
|
<a name="g-locale-from-utf8"></a><h3>g_locale_from_utf8 ()</h3>
|
|
913
|
-
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a
|
|
783
|
+
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_locale_from_utf8 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *utf8string</code></em>,
|
|
914
784
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
|
|
915
785
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
|
|
916
786
|
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *bytes_written</code></em>,
|
|
917
|
-
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
787
|
+
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
|
918
788
|
<p>
|
|
919
789
|
Converts a string from UTF-8 to the encoding used for strings by
|
|
920
790
|
the C runtime (usually the same as that used by the operating
|
|
@@ -926,49 +796,43 @@ Windows this means the system codepage.
|
|
|
926
796
|
<tbody>
|
|
927
797
|
<tr>
|
|
928
798
|
<td><p><span class="term"><em class="parameter"><code>utf8string</code></em> :</span></p></td>
|
|
929
|
-
<td>a UTF-8 encoded string
|
|
930
|
-
</td>
|
|
799
|
+
<td>a UTF-8 encoded string</td>
|
|
931
800
|
</tr>
|
|
932
801
|
<tr>
|
|
933
802
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
934
803
|
<td>the length of the string, or -1 if the string is
|
|
935
|
-
|
|
936
|
-
</td>
|
|
804
|
+
nul-terminated<sup>[<a href="glib-Character-Set-Conversion.html#ftn.nul-unsafe" class="footnoteref">1</a>]</sup>.</td>
|
|
937
805
|
</tr>
|
|
938
806
|
<tr>
|
|
939
807
|
<td><p><span class="term"><em class="parameter"><code>bytes_read</code></em> :</span></p></td>
|
|
940
808
|
<td>location to store the number of bytes in the
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
</td>
|
|
809
|
+
input string that were successfully converted, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
|
|
810
|
+
Even if the conversion was successful, this may be
|
|
811
|
+
less than <em class="parameter"><code>len</code></em> if there were partial characters
|
|
812
|
+
at the end of the input. If the error
|
|
813
|
+
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-ILLEGAL-SEQUENCE:CAPS"><span class="type">G_CONVERT_ERROR_ILLEGAL_SEQUENCE</span></a> occurs, the value
|
|
814
|
+
stored will the byte offset after the last valid
|
|
815
|
+
input sequence.</td>
|
|
949
816
|
</tr>
|
|
950
817
|
<tr>
|
|
951
818
|
<td><p><span class="term"><em class="parameter"><code>bytes_written</code></em> :</span></p></td>
|
|
952
|
-
<td>the number of bytes stored in the output buffer (not
|
|
953
|
-
|
|
954
|
-
</td>
|
|
819
|
+
<td>the number of bytes stored in the output buffer (not
|
|
820
|
+
including the terminating nul).</td>
|
|
955
821
|
</tr>
|
|
956
822
|
<tr>
|
|
957
823
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
958
824
|
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
|
|
959
|
-
|
|
960
|
-
</td>
|
|
825
|
+
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> may occur.</td>
|
|
961
826
|
</tr>
|
|
962
827
|
<tr>
|
|
963
828
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
964
|
-
<td>
|
|
965
|
-
</td>
|
|
829
|
+
<td>The converted string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on an error.</td>
|
|
966
830
|
</tr>
|
|
967
831
|
</tbody>
|
|
968
832
|
</table></div>
|
|
969
833
|
</div>
|
|
970
834
|
<hr>
|
|
971
|
-
<div class="refsect2"
|
|
835
|
+
<div class="refsect2">
|
|
972
836
|
<a name="GConvertError"></a><h3>enum GConvertError</h3>
|
|
973
837
|
<pre class="programlisting">typedef enum
|
|
974
838
|
{
|
|
@@ -1021,7 +885,7 @@ Error codes returned by character set conversion routines.
|
|
|
1021
885
|
</table></div>
|
|
1022
886
|
</div>
|
|
1023
887
|
<hr>
|
|
1024
|
-
<div class="refsect2"
|
|
888
|
+
<div class="refsect2">
|
|
1025
889
|
<a name="g-get-charset"></a><h3>g_get_charset ()</h3>
|
|
1026
890
|
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_get_charset (<em class="parameter"><code>G_CONST_RETURN <span class="type">char</span> **charset</code></em>);</pre>
|
|
1027
891
|
<p>
|
|
@@ -1051,13 +915,12 @@ freed.
|
|
|
1051
915
|
<tbody>
|
|
1052
916
|
<tr>
|
|
1053
917
|
<td><p><span class="term"><em class="parameter"><code>charset</code></em> :</span></p></td>
|
|
1054
|
-
<td>return location for character set name
|
|
1055
|
-
</td>
|
|
918
|
+
<td>return location for character set name</td>
|
|
1056
919
|
</tr>
|
|
1057
920
|
<tr>
|
|
1058
921
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1059
|
-
<td>
|
|
1060
|
-
</td>
|
|
922
|
+
<td>
|
|
923
|
+
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the returned charset is UTF-8</td>
|
|
1061
924
|
</tr>
|
|
1062
925
|
</tbody>
|
|
1063
926
|
</table></div>
|
|
@@ -1066,10 +929,10 @@ freed.
|
|
|
1066
929
|
<div class="footnotes">
|
|
1067
930
|
<br><hr width="100" align="left">
|
|
1068
931
|
<div class="footnote"><p><sup>[<a id="ftn.nul-unsafe" href="#nul-unsafe" class="para">1</a>] </sup>
|
|
1069
|
-
|
|
1070
|
-
|
|
1071
|
-
|
|
1072
|
-
|
|
932
|
+
Note that some encodings may allow nul bytes to
|
|
933
|
+
occur inside strings. In that case, using -1 for
|
|
934
|
+
the <em class="parameter"><code>len</code></em> parameter is unsafe.
|
|
935
|
+
</p></div>
|
|
1073
936
|
<div class="footnote"><p><sup>[<a id="ftn.streaming-state" href="#streaming-state" class="para">2</a>] </sup>
|
|
1074
937
|
Despite the fact that <em class="parameter"><code>byes_read</code></em> can return information about partial
|
|
1075
938
|
characters, the <code class="literal">g_convert_...</code> functions
|
|
@@ -1085,6 +948,6 @@ character.)
|
|
|
1085
948
|
</div>
|
|
1086
949
|
<div class="footer">
|
|
1087
950
|
<hr>
|
|
1088
|
-
Generated by GTK-Doc V1.
|
|
951
|
+
Generated by GTK-Doc V1.16.1</div>
|
|
1089
952
|
</body>
|
|
1090
953
|
</html>
|