glib2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- 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>
|