/docs/reference/Doxyfile
/docs/reference/doxygen.log
/docs/reference/doxygen*.db
-/docs/reference/glibmm-*.devhelp2
-/docs/reference/glibmm-*.tag
+/docs/reference/glibmm-2.4.devhelp2
+/docs/reference/glibmm-2.4.tag
/docs/reference/html/
# examples/
/examples/settings/gschemas.compiled
/examples/thread/dispatcher
/examples/thread/dispatcher2
+/examples/thread/thread
+/examples/thread/threadpool
# gio/
/gio/giomm-*.pc
/glib/glibmm/shell.h
/glib/glibmm/spawn.cc
/glib/glibmm/spawn.h
+/glib/glibmm/thread.cc
+/glib/glibmm/thread.h
+/glib/glibmm/threads.cc
+/glib/glibmm/threads.h
/glib/glibmm/timezone.cc
/glib/glibmm/timezone.h
/glib/glibmm/unicode.cc
/glib/glibmm/uriutils.h
/glib/glibmm/value_basictypes.cc
/glib/glibmm/value_basictypes.h
+/glib/glibmm/valuearray.cc
+/glib/glibmm/valuearray.h
/glib/glibmm/variant.cc
/glib/glibmm/variant.h
/glib/glibmm/variant_basictypes.cc
!if "$(VALID_CFGSET)" == "TRUE"
-# We need Visual Studio 2017 or later
-!if $(VSVER) < 15
+# We need Visual Studio 2015 or later
+!if $(VSVER) < 14
VALID_MSC = FALSE
!else
VALID_MSC = TRUE
!endif
-!if $(VCVERSION) < 1915
-!message Some tests may fail to build for Visual Studio 2017 15.7 or earlier!
-!endif
-
!if "$(VALID_MSC)" == "TRUE"
# Include the Makefile portion to convert the source and header lists
!else # "$(VALID_MSC)" == "TRUE"
all:
- @echo You need Visual Studio 2017 or later.
+ @echo You need Visual Studio 2015 or later.
!endif # "$(VALID_MSC)" == "TRUE"
# For building the glibmm tests
$(CFG)\$(PLAT)\test-glibmm_base64.exe: ..\tests\glibmm_base64\main.cc $(GLIBMM_LIB)
+$(CFG)\$(PLAT)\test-glibmm_bool_arrayhandle.exe: ..\tests\glibmm_bool_arrayhandle\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_bool_vector.exe: ..\tests\glibmm_bool_vector\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_btree.exe: ..\tests\glibmm_btree\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_buildfilename.exe: ..\tests\glibmm_buildfilename\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_ustring_format.exe: ..\tests\glibmm_ustring_format\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_ustring_make_valid.exe: ..\tests\glibmm_ustring_make_valid\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_value.exe: ..\tests\glibmm_value\main.cc $(GLIBMM_LIB)
+$(CFG)\$(PLAT)\test-glibmm_valuearray.exe: ..\tests\glibmm_valuearray\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_variant.exe: ..\tests\glibmm_variant\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_base64.exe \
+$(CFG)\$(PLAT)\test-glibmm_bool_arrayhandle.exe \
$(CFG)\$(PLAT)\test-glibmm_bool_vector.exe \
$(CFG)\$(PLAT)\test-glibmm_btree.exe \
$(CFG)\$(PLAT)\test-glibmm_buildfilename.exe \
$(CFG)\$(PLAT)\test-glibmm_ustring_format.exe \
$(CFG)\$(PLAT)\test-glibmm_ustring_make_valid.exe \
$(CFG)\$(PLAT)\test-glibmm_value.exe \
+$(CFG)\$(PLAT)\test-glibmm_valuearray.exe \
$(CFG)\$(PLAT)\test-glibmm_variant.exe:
@if not exist $(CFG)\$(PLAT)\glibmm-tests $(MAKE) -f Makefile.vc CFG=$(CFG) $(CFG)\$(PLAT)\glibmm-tests
$(CXX) $(GLIBMM_EX_CFLAGS) $(CFLAGS) /Fo$(CFG)\$(PLAT)\glibmm-tests\ $** /link $(LDFLAGS) $(GLIBMM_EX_LIBS) /out:$@
$(CFG)\$(PLAT)\test-giomm_stream_vfuncs.exe: ..\tests\giomm_stream_vfuncs\main.cc $(GIOMM_LIB)
$(CFG)\$(PLAT)\test-giomm_tls_client.exe: ..\tests\giomm_tls_client\main.cc $(GIOMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_interface_implementation.exe: ..\tests\glibmm_interface_implementation\main.cc $(GIOMM_LIB)
+$(CFG)\$(PLAT)\test-glibmm_null_containerhandle.exe: ..\tests\glibmm_null_containerhandle\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_null_vectorutils.exe: ..\tests\glibmm_null_vectorutils\main.cc $(GIOMM_LIB)
$(CFG)\$(PLAT)\test-glibmm_vector.exe: ..\tests\glibmm_vector\main.cc $(GIOMM_LIB)
+$(CFG)\$(PLAT)\test-glibmm_weakref.exe: ..\tests\glibmm_weakref\main.cc $(GLIBMM_LIB)
$(CFG)\$(PLAT)\test-giomm_asyncresult_sourceobject.exe \
$(CFG)\$(PLAT)\test-giomm_ioerror.exe \
$(CFG)\$(PLAT)\test-giomm_stream_vfuncs.exe \
$(CFG)\$(PLAT)\test-giomm_tls_client.exe \
$(CFG)\$(PLAT)\test-glibmm_interface_implementation.exe \
+$(CFG)\$(PLAT)\test-glibmm_null_containerhandle.exe \
$(CFG)\$(PLAT)\test-glibmm_null_vectorutils.exe \
-$(CFG)\$(PLAT)\test-glibmm_vector.exe:
+$(CFG)\$(PLAT)\test-glibmm_vector.exe \
+$(CFG)\$(PLAT)\test-glibmm_weakref.exe:
@if not exist $(CFG)\$(PLAT)\giomm-tests $(MAKE) -f Makefile.vc CFG=$(CFG) $(CFG)\$(PLAT)\giomm-tests
$(CXX) $(GIOMM_EX_CFLAGS) $(CFLAGS) /Fo$(CFG)\$(PLAT)\giomm-tests\ $** /link $(LDFLAGS) $(GIOMM_EX_LIBS) /out:$@
GLIB_API_VERSION = 2.0
GLIBMM_MAJOR_VERSION = 2
-GLIBMM_MINOR_VERSION = 58
+GLIBMM_MINOR_VERSION = 4
-LIBSIGC_MAJOR_VERSION = 3
+LIBSIGC_MAJOR_VERSION = 2
LIBSIGC_MINOR_VERSION = 0
!if "$(CFG)" == "debug" || "$(CFG)" == "Debug"
GLIBMM_BASE_CFLAGS = \
/I..\glib /I.\glibmm \
- /wd4530 /std:c++17 \
+ /wd4530 /EHsc \
/FImsvc_recommended_pragmas.h
GIOMM_BASE_CFLAGS = /I..\gio /I.\giomm $(GLIBMM_BASE_CFLAGS)
GLIBMM_EX_CFLAGS = $(GLIBMM_BASE_CFLAGS) $(GLIBMM_EXTRA_INCLUDES)
GIOMM_EX_CFLAGS = $(GIOMM_BASE_CFLAGS) $(GLIBMM_EXTRA_INCLUDES)
-# We build glibmm-vc$(VSVER)0-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll or
-# glibmm-vc$(VSVER)0-d-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll at least
-# giomm-vc$(VSVER)0-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll or
-# giomm-vc$(VSVER)0-d-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll at least
+# We build glibmm-vc$(PDBVER)0-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll or
+# glibmm-vc$(PDBVER)0-d-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll at least
+# giomm-vc$(PDBVER)0-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll or
+# giomm-vc$(PDBVER)0-d-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION).dll at least
-LIBSIGC_LIBNAME = sigc-vc$(VSVER)0$(DEBUG_SUFFIX)-$(LIBSIGC_MAJOR_VERSION)_$(LIBSIGC_MINOR_VERSION)
+LIBSIGC_LIBNAME = sigc-vc$(PDBVER)0$(DEBUG_SUFFIX)-$(LIBSIGC_MAJOR_VERSION)_$(LIBSIGC_MINOR_VERSION)
LIBSIGC_DLL = $(LIBSIGC_LIBNAME).dll
LIBSIGC_LIB = $(LIBSIGC_LIBNAME).lib
-GLIBMM_LIBNAME = glibmm-vc$(VSVER)0$(DEBUG_SUFFIX)-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION)
+GLIBMM_LIBNAME = glibmm-vc$(PDBVER)0$(DEBUG_SUFFIX)-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION)
GLIBMM_DLL = $(CFG)\$(PLAT)\$(GLIBMM_LIBNAME).dll
GLIBMM_LIB = $(CFG)\$(PLAT)\$(GLIBMM_LIBNAME).lib
-GIOMM_LIBNAME = giomm-vc$(VSVER)0$(DEBUG_SUFFIX)-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION)
+GIOMM_LIBNAME = giomm-vc$(PDBVER)0$(DEBUG_SUFFIX)-$(GLIBMM_MAJOR_VERSION)_$(GLIBMM_MINOR_VERSION)
GIOMM_DLL = $(CFG)\$(PLAT)\$(GIOMM_LIBNAME).dll
GIOMM_LIB = $(CFG)\$(PLAT)\$(GIOMM_LIBNAME).lib
@echo object files and binaries for the specified configuration.
@echo.
@echo An 'install' target is supported to copy the build (DLLs, utility programs,
- @echo LIBs, along with the introspection files if applicable) to appropriate
- @echo locations under ^$(PREFIX).
+ @echo LIBs, along with the header files) to appropriate locations under ^$(PREFIX).
@echo.
@echo A 'tests' target is supported to build the test programs.
@echo ======
-2.59.1: (unstable):
-Distro packagers should probably not package this yet.
+2.60.0 (stable):
Glib:
-* ustring: Fix wchar conversion on macOS with libc++
- (Clemens Lang) Bug #795338
-* Avoid compiler warnings from function pointer conversions
- (Kjell Ahlstedt) Issue libsigcplusplus#1 (sharkcz)
- (Kjell Ahlstedt) Issue libsigcplusplus#8 (db0451)
-* ustring: Simplify format() using C++17 fold expression.
- (Daniel Boles) Merge request !4
+* Add DateTime::get_timezone()
+ Add KeyFile::get_locale_for_key()
+ Add TimeZone::get_identifier()
+ (Kjell Ahlstedt)
+* Add Value_RefPtrBoxed<>
+ Add Value<std::vector<string>> specializations and other Value
+ specializations that are necessary for _WRAP_PROPERTY
+ (Kjell Ahlstedt)
+* Object construction: Add custom class init and instance init functions
+ (Kjell Ahlstedt) Issue #33
Gio:
-* Application: Add set_option_context_parameter_string(),
- set_option_context_summary(), set_option_context_description().
+* Add AppInfo::launch_uris_async() and launch_uris_async()
+ Add DBusConnection::get_flags() and property_flags()
(Kjell Ahlstedt)
-* DesktopAppInfo: Add get_locale_string()
+* Settings: Add property_settings_schema()
(Kjell Ahlstedt)
-* SocketClient: Take copy in RefPtrs for signal args
- (Daniel Boles) Issue #28 (Jens Mühlenhoff)
-* Make SignalProxy_async_callback() available to e.g. gtkmm
+* TlsClientConnection: Deprecate property_accepted_cas()
(Kjell Ahlstedt)
-
-gmmproc:
-* _WRAP_METHOD: Accept ":" in slot_callback parameter
- (Kjell Ahlstedt)
-
-Build:
-* Require C++17.
- (Murray Cumming)
-* Require glib-2.0 >= 2.55.1
- (Kjell Ahlstedt) Issue #29 (Mart Raudsepp)
-* Replace the Visual Studio project files with MSVC NMake project files
- (Chun-wei Fan) Merge request !2
-* Change the ABI to glibmm-2.60
+* ThemedIcon: Add create(const std::vector<Glib::ustring>& iconnames)
(Kjell Ahlstedt)
-
-Documentation:
-* Use libsigc++-3.0.tag for libsigc++ documentation
+* Remove NO_GTYPE from some _WRAP_ENUMs
+ (Kjell Ahlstedt) Issue #37 (Jan Tojnar)
+* TlsConnection: Deprecate rehandshake API
(Kjell Ahlstedt)
-
-
-2.57.1: (unstable):
-Distro packagers should probably not package this yet.
-
-Gio:
-* DataOutputStream::put_string(): Don't pass std:string by value
+* Application: Add signal_name_lost()
(Kjell Ahlstedt)
gmmproc:
-* Add _MEMBER_SET_STR() macro
- (Pavlo Solntsev) Bug #793778
+* Add _IS_REFCOUNTED_BOXEDTYPE
+ (Kjell Ahlstedt)
Build:
-* Change the ABI to glibmm-2.58
+* Require glib-2.0 >= 2.59.2
(Kjell Ahlstedt)
-2.55.2: (unstable):
-Distro packagers should probably not package this yet.
-
-Glib:
-* IOCondition: Add an IO_ prefix to the enumerator names
- (Kjell Ahlstedt)
-* TimeoutSource: Use monotonic time consistently
- (Kjell Ahlstedt) Bug #792524 (Dainis Jonitis)
-* Source: Remove get_current_time().
- (Kjell Ahlstedt)
-* KeyFile, OptionContext, Regex: Add exception specs to errthrow.
- (Kjell Ahlstedt)
-* ustring:
- - Replace 8×format() with 1 variadic template.
- - Replace 9×compose() with 1 variadic template.
- - Use std::initializer_list instead of pointer + size
- (Daniel Boles) Bug #784211
-* VariantBase:
- - Add operator==() and operator!=().
- (Kjell Ahlstedt) Bug #789330 (Daniel Boles)
- - cast_dynamic(): Remove noexcept(false).
- (Kjell Ahlstedt)
-
-Glib::Gio:
-* AppInfo: Update the name of the AppLaunchContext parameters
- (Kjell Ahlstedt)
-* Action: Add exception specs to errthrow.
- (Kjell Ahlstedt)
-* Application: Fix property_resource_base_path()'s type
- (Kjell Ahlstedt)
-* Credentials, et al.: Add exception specs to errthrow.
- (Kjell Ahlstedt)
-* DataInputStream:
- - Remove read_until*().
- - Fix the documentation of read_line_utf8().
- (Kjell Ahlstedt)
-* InetSocketAddress, ProxyAddress: No guint16 in _WRAP_PROPERTY().
- (Kjell Ahlstedt)
-* Settings: set_int() and friends shall return bool.
- (Kjell Ahlstedt) Bug #784211
-* TlsClientConnection: Remove get/set/property_use_ssl3().
- (Kjell Ahlstedt)
+2.58.1 (stable):
gmmproc:
-* Warn if parameter lists are not compatible
- (Kjell Ahlstedt)
-* _WRAP_METHOD: Accept optional list of exceptions in errthrow
+* _WRAP_ENUM and _WRAP_GERROR: Add gtype_func parameter
(Kjell Ahlstedt)
-* _WRAP_METHOD_DOCS_ONLY: Optionally suppress @return section.
- (Kjell Ahlstedt) Bug #787978
* docextract_to_xml.py: Add --exclude-file option.
(Kjell Ahlstedt)
-* Suppress the @return section if return type is void.
- (Kjell Ahlstedt)
-* generate_extra_defs.cc:
- - Write signal flags to .defs files.
- - Write default values of properties to .defs files.
- - Write default values of properties to generated documentation.
- (Kjell Ahlstedt) Bug #785895 (Daniel Boles)
-* Warn for unmatched deprecations in signals and properties.
- (Kjell Ahlstedt)
Documentation:
-* Glib::ObjectBase: Don't mention GtkObject in comments.
- (Kjell Ahlstedt)
-* Glib::Variant: Hide namespace Glib::detail from Doxygen
- (Kjell Ahlstedt) Bug #787698 (Daniel Boles)
-* Glib::Variant: Slightly elaborate Variant<Variant> docs.
- (Daniel Boles) Bug #778219 (Daniel Boles)
+* README: Add installation instructions
+ (Tapasweni Pathak) Merge request !10
+* Don’t use @retval on out args, use @param[out]
+ (Daniel Boles) Merge request !6
+
+
+2.58.0 (stable):
+This release is identical to 2.56.1.
-2.55.1: (unstable):
-Distro packagers should probably not package this yet.
+
+2.56.1 (stable):
Glib:
-* Object: Value_Pointer class should take only one template argument.
- (Marcin Kolny)
-* Variant: Improved support for D-Bus object paths and signatures.
- (Kjell Ahlstedt) Bug #785700 (Johannes Dohmen)
-* Glib::Value_Flags<>: static_cast to correct type.
- (Kjell Ahlstedt)
+* ustring: Fix wchar conversion on macOS with libc++
+ (Clemens Lang) Bug #795338
+* Avoid compiler warnings from function pointer conversions
+ (Kjell Ahlstedt) Issue libsigcplusplus#1 (sharkcz)
+ (Kjell Ahlstedt) Issue libsigcplusplus#8 (db0451)
Gio:
-* Derive all interfaces directly from Glib::Interface
- (Kjell Ahltedt) Bug #776537
-* Application: OptionType: Make this an enum class.
- (Kjell Ahlstedt)
-* BufferedInputStream, BufferedOutputStream, DataOutputStream:
- Implement Seekable.
-* CharsetConverter: Implement the Gio::Initable interface.
- and call Initable::init() from CharsetConverter's constructor.
- (Kjell Ahlstedt) Bug #776537
-* Add FileDescriptorBased interface and make GUnixInputStream and
- GUnixOutputStream implement it.
-* MemoryInputStream, UnixInputStream: Implement PollableInputStream.
- (Kjell Ahlstedt)
-* MemoryOutputStream, UnixOutputStream: Implement PollableOutputStream.
- (Kjell Ahlstedt)
-* TlsDatabase: create_certificate_handle_vfunc():
- Fix memory leak, and correctly return nulltpr.
- (Kjell Ahlstedt) Bug #783360
-
-gmmproc:
-* Accept curly braces in default values in _WRAP macros
- (Khell Ahlstedt) Bug #783216 comment 13
-* Don't accept unpaired double quotes.
- (Khell Ahlstedt)
-* gmmproc: Fix _WRAP_ENUM for enumerators with apostrophes.
- (Khell Ahlstedt)
-* gmmproc, _WRAP_ENUM: Add optional CONV_TO_INT parameter.
- (Khell Ahlstedt)
+* SocketClient: Take copy in RefPtrs for signal args
+ (Daniel Boles) Issue #28 (Jens Mühlenhoff)
Build:
-* Change the ABI to glibmm-2.56.
- (Murray Cumming)
-* Really exclude DesktopAppInfo from wrap_init.cc on MacOS.
- (Kjell Ahlstedt) Bug #781947
-
-Documentation:
-* miscutils: Update docs of get_*_name() from GLib.
- (Daniel Boles)
-* Fix documentation of enum Glib::IOCondition.
- (Khell Ahlstedt)
+* Require glib-2.0 >= 2.55.1
+ (Kjell Ahlstedt) Issue #29 (Mart Raudsepp)
+* Replace the Visual Studio project files with MSVC NMake project files
+ (Chun-wei Fan) Merge request !5
-2.53.2 (unstable):
-Distro packagers should probably not package this yet.
+2.56.0 (stable):
Glib:
-* ConstructParams: Do not increment allocation size twice
- (Daniel Elstner)
+* Threads::Private: Fix gobj().
+ (Kjell Ahlstedt) Bug #791711 (octoploid)
+* TimeoutSource: Use monotonic time consistently.
+ (Kjell Ahlstedt) Bug #792524 (Dainis Jonitis)
+* Add RefPtr::get().
+ (Kjell Ahlstedt) Bug #495762 (Hubert Figuiere)
Gio:
-* ActionMap: Really fix add_action_with_parameter().
- (Daniel Boles) Bug 774444#c31
-* UnixSocketAddress::create(): Remove a default value to avoid ambiguity.
- (Kjell Ahlstedt) Bug #782592
-
-Gio::DBus
-* Proxy: Wrap call() and call_sync() methods.
- (Vyacheslav Yurkov) Bug #781818
+* TlsClientConnection: Deprecate set/get/property_use_ssl3().
+ (Kjell Ahlstedt)
+* DataInputStream: Deprecate read_until().
+ (Kjell Ahlstedt)
+* Application: Add property_resource_base_path_string().
+ This is a replacement for property_resource_base_path() which can't be
+ fixed without breaking ABI.
+ (Kjell Ahlstedt) Bug #787496 (Daniel Boles)
+* Application: Add three set_option_context_*() methods.
+ (Kjell Ahlstedt)
+* DesktopAppInfo: Add get_locale_string().
+ (Kjell Ahlstedt)
-gmmproc:
-* Use of static_cast<> instead of C-style casts.
- (Murray Cumming)
+Documentation:
+* Slightly elaborate Glib::Variant<Variant> docs.
+ (Daniel Boles) Bug #778219
-Build:
-* Fix the build on MacOS, where glib doesn't have gdesktopinfo.
- (John Ralls) Bug #781947
-* Really use desktopappinfo.hg to fix the build.
+tests:
+* glibmm_variant: Don't use C++14 features when a C++11 compiler is used.
+ (Kjell Ahlstedt, Jonathan Wakely) Bug #787648 (Armin K.)
+* glibmm_interface_move test: Avoid unused function warnings.
(Murray Cumming)
-Documentation:
-* Glib, Gio: Update documentation of in-class enums.
- (Kjell Ahlstedt)
-* ActionMap: Improve add_action_with_parameter docs
- (Daniel Boles)
+gmmproc:
+* _WRAP_METHOD: Accept optional list of exceptions in errthrow.
+ (Kjell Ahlstedt) Bug #787979 (Daniel Boles)
+* _WRAP_METHOD: Suppress the @return section in generated documentation
+ if return type is void.
+ (Kjell Ahlstedt) Bug #787978 (Daniel Boles)
+* Add _MEMBER_SET_STR macro, setter for strings.
+ (Pavlo Solntsev) Bug #793778
-2.53.1.1 (unstable):
+2.54.1 (stable):
Glib:
-* Use C++11 enum classes instead of old-style enums, and put many enums
- inside relevant class declarations:
- - Glib::NodeTree: Move enums into class.
- - Glib::BindingFlags is now Glib::Binding::Flags.
- - Glib::KeyfileFlags is now Glib::Keyfile::Flags.
- - Glib::ModuleFlags is now Glib::Module::Flags.
- - Glib::ChecksumType is now Glib::Checksum::Type.
- - Glib::Regex: Move enums inside class.
- - Glib::Resource: Move enums into class.
- (Murray Cumming, Kjell Ahlstedt)
-* RefPtr: Make this an alias for std::shared_ptr<> instead.
- - Use std::dynamic_pointer_cast<>() instead of RefPtr<>::cast_dynamic().
- - Use std::static_pointer_cast<>() instead of RefPtr<>::cast_static().
- - Use std::const_pointer_cast<>() instead of RefPtr<>::cast_const().
- - When creating RefPtr directly, instead of using create() methods,
- use Glib::make_refptr_for_instance() so the std::shared_ptr<> has the
- necessary Deleter.
- (Murray Cumming) Bug #755037
-* Remove Glib::WeakRef. Use std::weak_ref<> instead.
- (Murray Cumming) Bug #755037
-* Object: Use g_object_new_with_properties() instead of (deprecated)
- g_object_newv() and (deprecated) GParameter.
- (Murray Cumming)
-* IOChannel: Avoid creating a RefPtr to this.
- (Murray Cumming) Bug #755037
-* SignalProxy:
- connect(): Signals with non-void return values now have no default value
- for the "after" parameter, forcing application developers to think about
- whether they should connect before or after already-connected signal
- handlers, and default signal handlers. This is awkward but necessary.
- Just provide "true" to get the previous behaviour, or use connect_notify().
- connect_notify(): Signals with void return values have no connect_notify(),
- because it is not useful with those signals.
- (Kjell Ahlstedt) Bug #126213.
+* Variant: Don't use std::index_sequence from C++14.
+ (Kjell Ahlstedt, Jonathan Wakely) Bug #787648 (Armin K.)
-Gio:
-* Use C++11 enum classes instead of old-style enums, and put many enums
- inside relevant class declarations:
- - Gio::Drive: Move enums into class.
- - Gio::TlsDatabase: Move enums into class.
- - Gio::UnixSocketAddressType is now Gio::UnixSocketAddress::Type.
- - Gio::Mount: Move enums into class.
- - Gio::TlsPasswordFlags is now Gio::TlsPassword::Flags.
- - Gio::IOStreamSpliceFlags is now Gio::IOStream::SpliceFlags.
- - Gio::SettingsBindFlags is now Gio::Settings::BindFlags.
- - Gio::ResolverRecordType is now Gio::Resolver::RecordType.
- - Gio::Socket: Move enums into class.
- - Gio::File: Move some flags enums into the class.
- - Gio::OutputStreamSpliceFlags is now Gio::OuputStream::SpliceFlags.
- - Gio::CredentialsType is now Gio::Credentials::Type.
- - Gio::NotificationPriority is now Gio::Notification::Priority.
- - Gio::FileMonitorEvent is now Gio::FileMonitor::Event.
- - Gio::FileAttributeInfoFlags is now Gio::FileAttributeInfo::Flags.
- - Gio::EmblemOrigin is now Gio::Emblem::Origin.
- - Gio::Converter: Put enums inside class.
- - Gio::ConverterFlags is now Gio::Converter::Flags.
- - Gio::ConverterResult is now Gio::Converter::Result.
- - Gio::AppInfoCreateFlags is now Gio::AppInfo::CreateFlags.
- - Gio::ApplicationFlags is now Gio::Application::Flags.
- (Murray Cumming, Kjell Ahlstedt)
-* Remove duplicate ErrorEnum declaration.
- (Kjell Ahlstedt)
-* ConstructParams:
- - Remove (hopefully really unnecessary) copy constructor.
- - C++11: =delete the operator=, instead of making it private.
- (Murray Cumming)
-* Value:
- - Remove the CType alias, which should be unnecessary.
- - value_custom: Replace a template parameter with C++11 type traits.
- - Value<RefPtr<T>>: Only use this specialization if T has get_base_type().
- (Murray Cumming) Bug #755037
-* Variant:
- - operator bool(): Simplify to avoid clang++ warnings.
- - C++11: Variant: Replace throw(std::bad_cast) with noexcept(false).
- See https://bugzilla.redhat.com/show_bug.cgi?id=1438766
- (Murray Cumming)
-* Socket: Avoid creating a RefPtr to this.
- (Murray Cumming) Bug #755037
-
-Gio:DBus:
-* Use C++11 enum classes instead of old-style enums, and put many enums
- inside relevant class declarations:
- - Gio::DBus::InterfaceSkeletonFlags is now Gio::DBus::InterfaceSkeleton::Flags.
- - Gio::DBus::ServerFlags is now Gio::DBus::Server::Flags.
- (Murray Cumming, Kjell Ahlstedt)
+Documentation:
+* Note that Gio::Application::property_resource_base_path() shall not
+ be used. It has a bug that's hard to fix without breaking ABI.
+ (Kjell Ahlstedt) Bug #787496 (Daniel Boles)
gmmproc:
-* _WRAP_ENUM(): Generate C++ enum classes instead of enums, and let the enums
- be inside class declarations.
- (Kjell Ahlstedt) Bug #86864
-
-Build
-* Windows: Visual Studio builds: Update ABI version
- (Chun-wei Fan)
-
+* Convert all property documentation to C++.
+ (Kjell Ahlstedt) Bug #787698 (Daniel Boles)
-2.53.1 (unstable):
+2.54.0 (stable):
Glib:
-* OptionGroup:
- - Don't allow copy or move.
- - Remove the OptionGroup& parameter in on_pre_parse(), on_post_parse() and
- on_error().
+* Added DBusObjectPathString and DBusSignatureString, for Variants with D-Bus object paths or D-Bus signatures,
+ and add Variant specializations for Variant<Glib::DBusObjectPathString>,
+ Variant<Glib::DBusSignatureString> and Variant<std::vector<Glib::DBusObjectPathString>>.
+ (Kjell Ahlstedt) Bug #785700
+* Variant: Add template specialization for std::tuple.
+ (Alexander Rössler) Bug #777791
+
+Gio:
+* ActionGroup: Add optional action_name parameters to some signals.
(Kjell Ahlstedt)
-* IOChannel, StreamIOChannel: Remove deprecated parts.
+* Settings: Add optional key parameter to the writable_changed signal.
(Kjell Ahlstedt)
-* ustring: Add make_valid().
- (Krzysztof Piecuch) Bug #780075
-* Remove (unused) Sequence and sequence().
- (Murray Cumming)
-* Remove ListHandle, SListHandle, ArrayHandle, SArrayHandle, and
- StringArrayHandle, replacing them with std::vector in API.
- (Murray Cumming)
gmmproc:
-* _WRAP_METHOD(): Some more use of auto in generated code.
- (Murray Cumming)
-
-Build:
-* Change the ABI to glibmm-2.54.
- (Murray Cumming)
-* Add some #include directives.
+* Write signal flags to generated documentation
+ (Kjell Ahlstedt) Bug #785895 (Daniel Boles)
+* Write default values of properties to generated documentation
+ (Kjell Ahlstedt) Bug #785895 (Daniel Boles)
+* Warn for unmatched deprecations in signals and properties.
+ (Kjell Ahlstedt)
+* Accept curly braces in default values in _WRAP macros.
+ (Kjell Ahlstedt) Bug #783216 comment #13 (Daniel Boles)
+* Fix _WRAP_ENUM for enumerators with apostrophes.
(Kjell Ahlstedt)
-* Visual Studio: Require Visual Studio 2017 and update the glibmm project.
- (Chu-wei Fan)
+* Add new elements types for the docs_override:
+ substitute_type_name and substitute_enumerator_name.
+ (Kjell Ahlstedt) Bug #86864
-2.51.5
+2.52.1 (stable):
Gio:
-* Application: get_default(): Correct the reference counting.
- (KJell Ahlstedt) Bug #779936 (James Legg)
-* Add PropertyAction.
- (Kjell Ahlstedt)
-
-Glib:
-* Remove Glib::unconst() because it is unused and unnecessary.
- (Kjell Ahlstedt)
-* Variant: Add template specialization for std::tuple,
- and a test.
- (Alexander Rössler, Kjell Ahlstedt) Bug #777791
+* TlsDatabase: Fix memory leak in a vfunc.
+ (Kjell Ahlstedt) Bug #783360
+Documentation:
+* Update docs of get_*_name().
+ (Daniel Boles)
-2.51.2 (unstable):
-Distro packagers should probably not package this yet.
+Build:
+* MacOS: Really correct build without gdesktopinfo.
+ (Kjell Ahlstedt) Bug #781947
-Glib:
-* Object construction: Add custom class init and instance init functions
- An extra class init function is useful in Gtk::WidgetCustomDraw and
- Gtk::WidgetCustomSnapshot.
- (Kjell Ahlstedt) Bug #775348
+2.52.0 (stable):
Gio:
-* Action: #include <glibmm/variant.h>, for convenience.
- (Daniel Boles) Bug #777953
-* SimpleAction: Make set_state() public.
- (Daniel Boles) Bug #777953
+* UnixSocketAddress::create(): Remove the default value for the type
+ parameter to avoid ambiguity.
+ (Kjell Ahlstedt) Bug #782592
-Documentation:
-* Glib::Variant: Explain how to create "maybe" type.
- (Daniel Boles) Bug #778219
+Gio::DBus
+* Proxy: Wrap call() and call_sync() methods.
+ (Vyacheslav Yurkov) Bug #781818
+Documentation:
+* RefPtr: Clarify comment about undefined behaviour.
+ (Daniel Boles)
-2.51.1.2 (unstable):
-Distro packagers should probably not package this yet.
+2.51.7 (unstable):
Glib:
-* Remove some deprecated API
- (Kjell Ahlstedt)
-* Variant: Remove the string specializations of cast_dynamic.
- (Kjell Ahlstedt)
-* Glib::VariantType: Add get_item_types(), removing first() and
- next().
+* SettingsSchemaKey: Add missing value/range methods.
+ (Daniel Boles) Bug #774903
+* Variant: Replace throw(std::bad_cast) with noexcept(false),
+ to fix the build with C++17.
+ See https://bugzilla.redhat.com/show_bug.cgi?id=1438766
+ (Murray Cumming)
+* VariantType: Deprecate first() and next(). Add get_item_types()
(Kjell Ahlstedt) Bug #775741
-
Gio:
-* init(): Set the global locale.
- (Kjell Ahlstedt) Bug #661588
-* ActionBase: get_state_hint_variant() now returns VariantContainerBase.
- (Kjell Ahlstedt)
-* ActionMap: add_action_with_parameter(): Register the parameter type,
- to make this work.
- (Daniel Boles) Bug #774444
-* ActionResult: Add is_tagged_vfunc().
- (Kjell Ahlstedt)
-* Glib::Dispatcher: Implement the pimpl idiom
- (Kjell Ahlstedt) Bug #651942
-* File, FileInfo, FileIOStream, FileOutputStream: Use Glib::ustring for
- (UTF-8) file attributes of string type.
- (Kjell Ahlstedt) Bug #615950
-* NetworkMonitor: Derive from Gio::Initable.
- (Kjell Ahlstedt)
-* RemoteActionGroup: Rename some vfuncs to add _full().
- (Murray Cumming)
-
-Documentation:
-* ActionMap:
- - ActivateSlot: Mention add_action_bool().
- - ActivateWithParameterSlot: Be more specific.
+* ActionMap: Add add_action_with_parameter() that takes a parameter type,
+ and deprecated the existing method, because it cannot work.
(Daniel Boles) Bug #774444
+* SimpleAction: Make set_state() public.
+ (Daniel Boles) Bug #777953
Build:
-* Update the Visual Studio project files.
- (Chun-wei Fan)
-* Some minor cppcheck fixes.
- (Murray Cumming)
+* MacOS: Correct build without gdesktopinfo.
+ (John Ralls) Bug #781947
+* Glib::Object: Suppress deprecation warning for g_object_newv() with glib 2.54.
+ (Kjell Ahlstedt)
-2.51.1.1 (unstable):
+2.51.6 (unstable):
-General:
-* Remove no_default_handler in some _WRAP_SIGNAL()s
- This allows application developers to simply override
- the default on_*() signal handlers for these signals too,
- as they can already with most other signals.
- If you are using, for instance, the -Wsuggest-override
- compiler option, watch out for new compiler warnings suggesting
- that your existing signal handler should now be marked with the
- override keyword - that means you should do so but you should
- also stop connecting the signal handler in your code.
- (Kjell Ahlstedt)
-* Build: examples/Makefile.am: Re-insert the dispatcher examples
- (Kjell Ahlstedt)
+This is version 2.51.6 of glibmm-2.24. Ignore versions 2.51.1 to 2.51.5 of
+unstable glibmm-2.52. Unstable glibmm-2.52 is now unstable glibmm-2.54,
+leaving the 2.51/52 version numbers again for use by stable glibmm-2.52.
Glib:
-* Dispatcher: Don't cast a HANDLE to an int on Windows.
+* Dispatcher:
+ - autodeduce the type of the fd field.
+ (Marcin Kolny) Bug #772074
+ - Don't cast a HANDLE to an int on Windows.
(Kjell Ahlstedt) Bug #772074
-* ObjectBase:
- - Remove connect_property_changed_with_return()
- and let connect_property_changed() return a sigc::connection.
- (Kjell Ahlstedt)
- - Use std::forward_list for interface class pointers.
- (Kjell Ahlstedt)
- - Replace extra_object_base_data map by instance data.
- (Kjell Ahlstedt)
-* ObjectBase: overload get_property().
- (Marcin Kolny)
-* Main, IOSource: autodeduce type of fd field.
- (Marcin Kolny) Bug #770274
-* Settings: Add property_settings_schema(), and update
- signal_changed().
- (Kjell Ahlstedt)
-* Settings: Make set_enum() + set_flags() usable
- (djb) Bug #774647
-* SettingsSchemaKey: Add missing value/range methods
- (Daniel Boles) Bug #774903
-* SignalProxyNormal: Remove connect_() and connect_notify_(),
- adding connect_impl().
- (Kjell Ahlstedt)
-* Rename SignalProxyDetailed to SignalProxyDetailedBase, and
- SignalProxyDetailedAnyType to SignalProxyDetailed.
- Remove SignalProxyDetailed# aliases (# = 0..6).
- (Kjell Ahlstedt)
-* Source: Replace extra_source_data by instance data.
- (Kjell Ahlstedt) Bug #561885
+* ustring: Add cbegin() and cend().
+ (Murray Cumming)
Gio:
-* ActionMap::add_action_vfunc(): Const correction.
- (Murray Cumming)
-* Application: Add dbus_register/unregister_vfunc.
- (Ritesh Khadgaray, Kjell Ahlstedt) Bug #762191
-* Menu: insert/prepend/add_item(): Const correction.
- (Murray Cumming)
-* MenuAttributeIter: get_value(): Const correction.
- (Murray Cumming)
-* MenuModel: get_item_atribute(): const correction.
- (Murray Cumming)
-* RemoteActionGroup: Derive from Gio::ActionGroup.
- (Murray Cumming)
+* Action: Include variant.h in the heaer.
+ (Daniel Boles) Bug #777953
+* Application: get_default(): Correct the reference counting.
+ (Kjell Ahlstedt) Bug #779936
+* Settings:
+ - Really add set_enum() and set_flags().
+ (djb) Bug #774647
+ - Writable-change-event signal: Correct the type of the key parameter.
+ (Marcin Kolny) Bug #773977
+* SettingsSchemaSource: get_default(): Correct the refcounting.
+ (Marcin Kolny) Bug #774593
-Gio::Dbus:
+Gio::DBus:
* Proxy: Fix memory leak in get_cached_property_names().
(Kjell Ahlstedt) Bug #775210
-* Proxy: Derive from (and implement) Gio::DBus::Interface.
- (Murray Cumming)
-
-
-2.51.1 (unstable):
-This is the first release of the glibmm-2.52 API/ABI.
-It installs in parallel with the gtkmm-2.4 API/ABI, of which
-the most recent version is glibmm 2.50. We know that is a bit
-confusing. We are taking the opportunity to do this glibmm ABI
-break while GTK+ (and therefore gtkmm) is also doing an ABI
-break. But we cannot call this glibmm-3.0 because there is no
-glib 3.0.
+Documentation:
+* Glib::Variant: Improve documentation of maybe types.
+ (Daniel Boles) Bug #778219
+* Gio::ActionMap: Clarify doc of ActivateWithParameterSlot
+ (Daniel Boles)
Build:
-* Require C++14.
- (Murray Cumming)
-* Use libsigc++-3.0 instead of libsigc++-2.0.
- https://www.murrayc.com/permalink/2016/03/07/libsigc-3-0-very-variadic/
- (Murray Cumming)
-* Remove lots of deprecated API.
- (Kjell Ahlstedt)
-
-Gio:
-* BufferedInputStream, InputStream, OutputStream: Add vfuncs,
- allowing implementation in C++.
- (Krzysztof Kosiński, Kjell Ahlstedt) Bug #572471
-* SettingsSchemaSource::get_default(): Correct the reference count.
- (Marcin Kolny) Bug #774593
-* Settings: Fix type of 'key' parameter of writable-change-event signal
- (Marcin Kolny) Bug #773977
-
-Glib:
-* ustring: Add cbegin() and cend().
+* Visual Studio builds: "Install" the .pdb files
+ (Chun-wei Fan)
2.50.0:
* Remove DocsParser::non_object_method_name()
(Kjell Ahlstedt)
* swap() implementations: Use std::swap().
- (Murray Cumming)
+ (Murray Cumming <murrayc@murrayc.com>
Documentation:
* Gio::SocketService: Update the class documentation
This is glibmm, a C++ API for parts of glib that are useful for C++.
See http://www.gtkmm.org
+Installation Procedure
+----------------------
+
+$ tar xf glibmm-@GLIBMM_VERSION@.tar.gz
+$ cd glibmm-@GLIBMM_VERSION@
+$ ./configure --prefix=/some_directory
+$ make
+$ make install
-Building glibmm on Win32\r
-===========================\r
-\r
-Currently, both the mingw (native win32) gcc compiler and MS Visual\r
-Studio 2017 and later are supported. glibmm can be built with\r
-mingw32-gcc using the gnu autotools (automake, autoconf, libtool).\r
-As explicitly stated in the gtk+ for win32 distribution\r
-(http://www.gimp.org/win32/), the gcc compiler provided by the cygwin\r
-distribution should not be used to build glib/glibmm libraries and/or\r
-applications (see the README.win32 that comes with the gtk+ DLLs).\r
-This MIGHT cause conflicts between the cygwin and msvcrt runtime\r
-environments.\r
-\r
-1. Mingw\r
-\r
-The mingw distribution which has been tested with this release is the\r
-following :\r
-\r
-* MinGW-4.1 as the base distribution.\r
-\r
-The bare mingw distribution does not provide the necessary tools (sh, perl, m4\r
-, autoconf, automake, ..) to run the provided configure script "as is". One\r
-(currently non supported) solution is to use mingw in conjunction with msys,\r
-which is readily available on the mingw website (http://www.mingw.org/).\r
-\r
-The preferred method is to combine the cygwin distribution (for the unix tools\r
-that were mentioned above) with mingw by making sure that the mingw\r
-tools (gcc, ld, dlltool, ..) are called first.\r
-\r
-First, make sure that you have working distribution of the native port\r
-of both libsigc++-3.0.x and glib-2.0 on win32 (see\r
-http://www.gimp.org/win32). If you can't compile a simple glib example\r
-using gcc and `pkg-config --cflags --libs`, you should not even think\r
-about trying to compile glibmm, let alone using precompiled libglibmm\r
-DLLs to port your glibmm application !\r
-\r
-The configure script can then be called using (as an example) the\r
-following options\r
-\r
-./configure --prefix=/target --build=i386-pc-mingw32 --disable-static\r
-\r
-then\r
-\r
-make\r
-make check\r
-make install\r
-\r
-2. MS Visual Studio 2017\r
-\r
-In a Visual Studio command prompt, navigate to the MSVC_NMake directory.\r
-Run 'nmake /f Makefile.vc CFG=[release|debug]' to build the glibmm and\r
-giomm DLLs, along with their example programs. If a prefix other than\r
-$(srcroot)\..\vs15\$(Platform) is desired, pass in PREFIX=$(your_prefix)\r
-in the NMake command line. In order to build the giomm settings example\r
-program, the glib-compile-schemas needs to reside in $(PREFIX)\bin, or\r
-it must be specified via passing in GLIB_COMPILE_SCHEMAS.\r
-\r
-A 'tests' target will build the test programs for glibmm and giomm, an\r
-'install' target is provided to copy the built DLLs and LIBs, along with\r
-with the public headers to appropriate subdirs of $(PREFIX). A 'clean'\r
-target is also provided to remove all the built files.\r
-\r
-3. Glibmm methods and signals not available on win32\r
-\r
-All glibmm methods and signals are available on win32.\r
-\r
+Building glibmm on Win32
+===========================
+
+Currently, both the mingw (native win32) gcc compiler and MS Visual
+Studio 2015 and later are supported. glibmm can be built with
+mingw32-gcc using the gnu autotools (automake, autoconf, libtool).
+As explicitly stated in the gtk+ for win32 distribution
+(http://www.gimp.org/win32/), the gcc compiler provided by the cygwin
+distribution should not be used to build glib/glibmm libraries and/or
+applications (see the README.win32 that comes with the gtk+ DLLs).
+This MIGHT cause conflicts between the cygwin and msvcrt runtime
+environments.
+
+1. Mingw
+
+The mingw distribution which has been tested with this release is the
+following :
+
+* MinGW-4.1 as the base distribution.
+
+The bare mingw distribution does not provide the necessary tools (sh, perl, m4
+, autoconf, automake, ..) to run the provided configure script "as is". One
+(currently non supported) solution is to use mingw in conjunction with msys,
+which is readily available on the mingw website (http://www.mingw.org/).
+
+The preferred method is to combine the cygwin distribution (for the unix tools
+that were mentioned above) with mingw by making sure that the mingw
+tools (gcc, ld, dlltool, ..) are called first.
+
+First, make sure that you have working distribution of the native port
+of both libsigc++-2.10.x and glib-2.0 on win32 (see
+http://www.gimp.org/win32). If you can't compile a simple glib example
+using gcc and `pkg-config --cflags --libs`, you should not even think
+about trying to compile glibmm, let alone using precompiled libglibmm
+DLLs to port your glibmm application !
+
+The configure script can then be called using (as an example) the
+following options
+
+./configure --prefix=/target --build=i386-pc-mingw32 --disable-static
+
+then
+
+make
+make check
+make install
+
+2. MS Visual Studio 2015
+
+In a Visual Studio command prompt, navigate to the MSVC_NMake directory.
+Run 'nmake /f Makefile.vc CFG=[release|debug]' to build the glibmm and
+giomm DLLs, along with their example programs. If a prefix other than
+$(srcroot)\..\vs$(VSVER)\$(Platform) is desired, pass in PREFIX=$(your_prefix)
+in the NMake command line. In order to build the giomm settings example
+program, the glib-compile-schemas needs to reside in $(PREFIX)\bin, or
+it must be specified via passing in GLIB_COMPILE_SCHEMAS.
+
+Note that $(VSVER) refers to 14 for Visual Studio 2015 and 15 for Visual
+Studio 2017.
+
+A 'tests' target will build the test programs for glibmm and giomm, an
+'install' target is provided to copy the built DLLs and LIBs, along with
+with the public headers to appropriate subdirs of $(PREFIX). A 'clean'
+target is also provided to remove all the built files.
+
+3. Glibmm methods and signals not available on win32
+
+All glibmm methods and signals are available on win32.
+
## You should have received a copy of the GNU Lesser General Public License
## along with this library. If not, see <http://www.gnu.org/licenses/>.
-AC_INIT([glibmm], [2.59.1],
+AC_INIT([glibmm], [2.60.0],
[https://gitlab.gnome.org/GNOME/glibmm/issues],
[glibmm], [http://www.gtkmm.org/])
AC_PREREQ([2.59])
AM_MAINTAINER_MODE
AC_ARG_VAR([ACLOCAL_FLAGS], [aclocal flags, e.g. -I <macro dir>])
-MM_PREREQ([0.9.12])
-MM_INIT_MODULE([glibmm-2.60])
-MM_INIT_MODULE([giomm-2.60])
+MM_PREREQ([0.9.10])
+MM_INIT_MODULE([glibmm-2.4])
+MM_INIT_MODULE([giomm-2.4])
# Copy the mm-common .pl scripts into docs/,
# and use them from there,
AC_SUBST([LIBGLIBMM_SO_VERSION], [4:0:3])
AC_PROG_CXX
-MM_AX_CXX_COMPILE_STDCXX([17], [noext],[mandatory])
+MM_AX_CXX_COMPILE_STDCXX([11], [noext], [mandatory])
AC_DISABLE_STATIC
LT_INIT([win32-dll])
AC_DEFINE([GIOMM_STATIC_LIB], [1], [Define if giomm is built as a static library])
])
-glibreq='2.0 >= 2.55.1'
+glibreq='2.0 >= 2.59.2'
-GLIBMM_MODULES="sigc++-3.0 >= 2.99.5 glib-$glibreq gobject-$glibreq gmodule-$glibreq"
+GLIBMM_MODULES="sigc++-2.0 >= 2.9.1 glib-$glibreq gobject-$glibreq gmodule-$glibreq"
GIOMM_MODULES="$GLIBMM_MODULES gio-$glibreq"
test "x$glibmm_host_windows" = xyes || GIOMM_MODULES="$GIOMM_MODULES gio-unix-$glibreq"
MM_ARG_ENABLE_DOCUMENTATION
MM_ARG_WITH_TAGFILE_DOC([libstdc++.tag], [mm-common-libstdc++])
-MM_ARG_WITH_TAGFILE_DOC([libsigc++-3.0.tag], [sigc++-3.0])
+MM_ARG_WITH_TAGFILE_DOC([libsigc++-2.0.tag], [sigc++-2.0])
# Check whether --enable-debug-refcounting was given.
GLIBMM_ARG_ENABLE_DEBUG_REFCOUNTING
web_host = gtkmm.org
-web_path_gtkmm = /home/murrayc/gtkmm.org/docs/glibmm-2.60/
-#web_path_gtkmm = /home/groups/g/gt/gtkmm/htdocs/docs/glibmm-2.60/
+web_path_gtkmm = /home/murrayc/gtkmm.org/docs/glibmm-2.4/
+#web_path_gtkmm = /home/groups/g/gt/gtkmm/htdocs/docs/glibmm-2.4/
web_path_docs = $(web_path_gtkmm)docs/
rsync_args = -vz --rsh ssh
-gtkmm_docdir = $(datadir)/doc/glibmm-2.60/docs
+gtkmm_docdir = $(datadir)/doc/glibmm-2.4/docs
options/example \
properties/example \
regex/example \
- settings/settings \
- thread/dispatcher \
- thread/dispatcher2
+ settings/settings \
+ thread/dispatcher \
+ thread/dispatcher2 \
+ thread/thread \
+ thread/threadpool
glibmm_includes = -I$(top_builddir)/glib $(if $(srcdir:.=),-I$(top_srcdir)/glib)
giomm_includes = -I$(top_builddir)/gio $(if $(srcdir:.=),-I$(top_srcdir)/gio)
LDADD = $(GLIBMM_LIBS) $(local_libglibmm)
giomm_ldadd = $(GIOMM_LIBS) $(local_libglibmm) $(local_libgiomm)
+thread_ldadd = $(GLIBMM_LIBS) $(local_libglibmm)
child_watch_child_watch_SOURCES = child_watch/main.cc
iochannel_stream_example_SOURCES = \
regex_example_SOURCES = regex/main.cc
thread_dispatcher_SOURCES = thread/dispatcher.cc
+thread_dispatcher_LDADD = $(thread_ldadd)
thread_dispatcher2_SOURCES = thread/dispatcher2.cc
+thread_dispatcher2_LDADD = $(thread_ldadd)
+thread_thread_SOURCES = thread/thread.cc
+thread_thread_LDADD = $(thread_ldadd)
+thread_threadpool_SOURCES = thread/threadpool.cc
+thread_threadpool_LDADD = $(thread_ldadd)
# giomm examples
dbus_session_bus_service_SOURCES = dbus/session_bus_service.cc
class ChildWatch : public sigc::trackable
{
public:
- explicit ChildWatch(const Glib::RefPtr<Glib::MainLoop>& mainLoop) : m_mainLoop(mainLoop) {}
+ ChildWatch(const Glib::RefPtr<Glib::MainLoop>& mainLoop) : m_mainLoop(mainLoop) {}
void on_child_exited(GPid pid, int status);
void run(); // fork a child and call signal_child_watch
loop = Glib::MainLoop::create();
// Get the user session bus connection.
- auto connection = Gio::DBus::Connection::get_sync(Gio::DBus::BusType::SESSION);
+ auto connection = Gio::DBus::Connection::get_sync(Gio::DBus::BUS_TYPE_SESSION);
// Check for an unavailable connection.
if (!connection)
std::cout << "Client connected." << std::endl
<< "Peer credentials: " << credentials_str << std::endl
<< "Negotiated capabilities: unix-fd-passing="
- << ((connection->get_capabilities() & Gio::DBus::CapabilityFlags::UNIX_FD_PASSING)
- == Gio::DBus::CapabilityFlags::UNIX_FD_PASSING)
+ << (connection->get_capabilities() & Gio::DBus::CAPABILITY_FLAGS_UNIX_FD_PASSING)
<< std::endl;
// If there is already an active connection, do not accept this new one.
std::cout << "Server is listening at: " << server->get_client_address() << "." << std::endl;
- server->signal_new_connection().connect(sigc::ptr_fun(&on_server_new_connection), false);
+ server->signal_new_connection().connect(sigc::ptr_fun(&on_server_new_connection));
// Keep the server running until the process is killed:
auto loop = Glib::MainLoop::create();
return 1;
}
- const auto id = Gio::DBus::own_name(Gio::DBus::BusType::SESSION, "org.glibmm.DBusExample",
+ const auto id = Gio::DBus::own_name(Gio::DBus::BUS_TYPE_SESSION, "org.glibmm.DBusExample",
sigc::ptr_fun(&on_bus_acquired), sigc::ptr_fun(&on_name_acquired),
sigc::ptr_fun(&on_name_lost));
bool
MyCallback(Glib::IOCondition io_condition)
{
- if ((io_condition & Glib::IOCondition::IO_IN) != Glib::IOCondition::IO_IN)
+ if ((io_condition & Glib::IO_IN) == 0)
{
std::cerr << "Invalid fifo response" << std::endl;
}
}
input_stream.attach(read_fd);
- input_stream.connect(sigc::ptr_fun(MyCallback), Glib::IOCondition::IO_IN);
+ input_stream.connect(sigc::ptr_fun(MyCallback), Glib::IO_IN);
// and last but not least - run the application main loop
mainloop->run();
static void
print_resolved_addresses(
- const Glib::ustring& name, const std::vector<Glib::RefPtr<Gio::InetAddress>>& addresses)
+ const Glib::ustring& name, const std::list<Glib::RefPtr<Gio::InetAddress>>& addresses)
{
std::lock_guard<std::mutex> lock_guard(response_mutex);
std::cout << Glib::ustring::compose("Name: %1\n", name);
}
static void
-print_resolved_service(const Glib::ustring& service, const std::vector<Gio::SrvTarget>& targets)
+print_resolved_service(const Glib::ustring& service, const std::list<Gio::SrvTarget>& targets)
{
std::lock_guard<std::mutex> lock_guard(response_mutex);
std::cout << Glib::ustring::compose("Service: %1\n", service);
}
else
{
+ std::list<Glib::RefPtr<Gio::InetAddress>> addresses;
+
try
{
- const auto addresses = resolver->lookup_by_name(arg, cancellable);
+ addresses = resolver->lookup_by_name(arg, cancellable);
print_resolved_addresses(arg, addresses);
}
catch (const Gio::ResolverError& err)
print_connectable_sockaddr(Glib::RefPtr<Gio::SocketAddress> sockaddr)
{
Glib::ustring phys;
- auto isa = std::dynamic_pointer_cast<Gio::InetSocketAddress>(sockaddr);
+ auto isa = Glib::RefPtr<Gio::InetSocketAddress>::cast_dynamic(sockaddr);
if (!isa)
{
signal(SIGINT, interrupted);
chan = Glib::IOChannel::create_from_fd(cancel_fds[0]);
- const auto source = chan->create_watch(Glib::IOCondition::IO_IN);
+ const auto source = chan->create_watch(Glib::IO_IN);
watch_conn = source->connect(sigc::bind(sigc::ptr_fun(async_cancel), cancellable));
#endif
Glib::ustring str, res;
int port;
- auto isockaddr = std::dynamic_pointer_cast<Gio::InetSocketAddress>(address);
+ auto isockaddr = Glib::RefPtr<Gio::InetSocketAddress>::cast_dynamic(address);
if (!isockaddr)
return Glib::ustring();
inet_address = isockaddr->get_address();
class JoinAndDelete
{
public:
- void operator()(std::thread* thread) const
+ void operator()(std::thread* thread)
{
stop_thread = true;
cond_thread.notify_all();
Glib::RefPtr<Gio::Socket> socket;
Glib::RefPtr<Gio::SocketAddress> src_address;
Glib::RefPtr<Gio::SocketAddress> address;
- Gio::Socket::Type socket_type;
+ Gio::SocketType socket_type;
Gio::SocketFamily socket_family;
Glib::RefPtr<Gio::Cancellable> cancellable;
Glib::RefPtr<Gio::SocketAddressEnumerator> enumerator;
loop = Glib::MainLoop::create();
- socket_type = use_udp ? Gio::Socket::Type::DATAGRAM : Gio::Socket::Type::STREAM;
- socket_family = use_ipv6 ? Gio::SocketFamily::IPV6 : Gio::SocketFamily::IPV4;
+ socket_type = use_udp ? Gio::SOCKET_TYPE_DATAGRAM : Gio::SOCKET_TYPE_STREAM;
+ socket_family = use_ipv6 ? Gio::SOCKET_FAMILY_IPV6 : Gio::SOCKET_FAMILY_IPV4;
try
{
- socket = Gio::Socket::create(socket_family, socket_type, Gio::Socket::Protocol::DEFAULT);
+ socket = Gio::Socket::create(socket_family, socket_type, Gio::SOCKET_PROTOCOL_DEFAULT);
}
catch (const Gio::Error& error)
{
buffer[to_send] = '\0';
while (to_send > 0)
{
- ensure_condition(socket, "send", cancellable, Glib::IOCondition::IO_OUT);
+ ensure_condition(socket, "send", cancellable, Glib::IO_OUT);
try
{
if (use_udp)
to_send -= size;
}
- ensure_condition(socket, "receive", cancellable, Glib::IOCondition::IO_IN);
+ ensure_condition(socket, "receive", cancellable, Glib::IO_IN);
try
{
if (use_udp)
Glib::ustring
socket_address_to_string(const Glib::RefPtr<Gio::SocketAddress>& address)
{
- auto isockaddr = std::dynamic_pointer_cast<Gio::InetSocketAddress>(address);
+ auto isockaddr = Glib::RefPtr<Gio::InetSocketAddress>::cast_dynamic(address);
if (!isockaddr)
return Glib::ustring();
class JoinAndDelete
{
public:
- void operator()(std::thread* thread) const
+ void operator()(std::thread* thread)
{
stop_thread = true;
cond_thread.notify_all();
loop = Glib::MainLoop::create();
- auto socket_type = use_udp ? Gio::Socket::Type::DATAGRAM : Gio::Socket::Type::STREAM;
- auto socket_family = use_ipv6 ? Gio::SocketFamily::IPV6 : Gio::SocketFamily::IPV4;
+ auto socket_type = use_udp ? Gio::SOCKET_TYPE_DATAGRAM : Gio::SOCKET_TYPE_STREAM;
+ auto socket_family = use_ipv6 ? Gio::SOCKET_FAMILY_IPV6 : Gio::SOCKET_FAMILY_IPV4;
try
{
- socket = Gio::Socket::create(socket_family, socket_type, Gio::Socket::Protocol::DEFAULT);
+ socket = Gio::Socket::create(socket_family, socket_type, Gio::SOCKET_PROTOCOL_DEFAULT);
}
catch (const Gio::Error& error)
{
std::cout << Glib::ustring::compose("listening on port %1...\n", port);
- ensure_condition(socket, "accept", cancellable, Glib::IOCondition::IO_IN);
+ ensure_condition(socket, "accept", cancellable, Glib::IO_IN);
try
{
new_socket = socket->accept(cancellable);
gchar buffer[4096] = {};
gssize size;
- ensure_condition(recv_socket, "receive", cancellable, Glib::IOCondition::IO_IN);
+ ensure_condition(recv_socket, "receive", cancellable, Glib::IO_IN);
try
{
if (use_udp)
while (to_send > 0)
{
- ensure_condition(recv_socket, "send", cancellable, Glib::IOCondition::IO_OUT);
+ ensure_condition(recv_socket, "send", cancellable, Glib::IO_OUT);
try
{
if (use_udp)
ExampleOptionGroup();
private:
- bool on_pre_parse(Glib::OptionContext& context) override;
- bool on_post_parse(Glib::OptionContext& context) override;
- void on_error(Glib::OptionContext& context, const Glib::Error& error) override;
+ bool on_pre_parse(Glib::OptionContext& context, Glib::OptionGroup& group) override;
+ bool on_post_parse(Glib::OptionContext& context, Glib::OptionGroup& group) override;
+ void on_error(Glib::OptionContext& context, Glib::OptionGroup& group) override;
bool on_option_arg_string(
const Glib::ustring& option_name, const Glib::ustring& value, bool has_value);
entry6.set_long_name("x-string");
entry6.set_short_name('x');
entry6.set_description("A string with custom parsing");
- entry6.set_flags(Glib::OptionEntry::Flags::OPTIONAL_ARG);
+ entry6.set_flags(Glib::OptionEntry::FLAG_OPTIONAL_ARG);
m_arg_x_string = "not specified";
add_entry(entry6, sigc::mem_fun(*this, &ExampleOptionGroup::on_option_arg_string));
entry7.set_long_name("x-filename");
entry7.set_short_name('X');
entry7.set_description("A filename with custom parsing");
- entry7.set_flags(Glib::OptionEntry::Flags::OPTIONAL_ARG);
+ entry7.set_flags(Glib::OptionEntry::FLAG_OPTIONAL_ARG);
m_arg_x_filename = "not specified";
add_entry_filename(entry7, sigc::mem_fun(*this, &ExampleOptionGroup::on_option_arg_filename));
}
bool
-ExampleOptionGroup::on_pre_parse(Glib::OptionContext& /* context */)
+ExampleOptionGroup::on_pre_parse(Glib::OptionContext& /* context */, Glib::OptionGroup& /* group */)
{
// This is called before the m_arg_* instances are given their values.
// You do not need to override this method. This is just here to show you how,
bool
ExampleOptionGroup::on_post_parse(
- Glib::OptionContext& /* context */)
+ Glib::OptionContext& /* context */, Glib::OptionGroup& /* group */)
{
// This is called after the m_arg_* instances are given their values.
// You do not need to override this method. This is just here to show you how,
}
void
-ExampleOptionGroup::on_error(Glib::OptionContext& /* context */, const Glib::Error& /* error */)
+ExampleOptionGroup::on_error(Glib::OptionContext& /* context */, Glib::OptionGroup& /* group */)
{
std::cout << "on_error called" << std::endl;
}
--- /dev/null
+
+#include <condition_variable>
+#include <iostream>
+#include <memory>
+#include <mutex>
+#include <queue>
+#include <thread>
+#if defined(_MSC_VER) && (_MSC_VER < 1900)
+/* For using noexcept on Visual Studio 2013 */
+#include <glibmmconfig.h>
+#endif
+#include <glibmm/init.h>
+#include <glibmm/random.h>
+#include <glibmm/timer.h>
+
+namespace
+{
+
+class MessageQueue
+{
+public:
+ MessageQueue();
+ ~MessageQueue();
+
+ void producer();
+ void consumer();
+
+private:
+ std::mutex mutex_;
+ std::condition_variable cond_push_;
+ std::condition_variable cond_pop_;
+ std::queue<int> queue_;
+};
+
+MessageQueue::MessageQueue()
+{
+}
+
+MessageQueue::~MessageQueue()
+{
+}
+
+void
+MessageQueue::producer()
+{
+ Glib::Rand rand(1234);
+
+ for (auto i = 0; i < 200; ++i)
+ {
+ {
+ std::unique_lock<std::mutex> lock(mutex_);
+
+ cond_pop_.wait(lock, [this]() -> bool { return queue_.size() < 64; });
+
+ queue_.push(i);
+ std::cout << '*';
+ std::cout.flush();
+
+ // We unlock before notifying, because that is what the documentation suggests:
+ // http://en.cppreference.com/w/cpp/thread/condition_variable
+ lock.unlock();
+ cond_push_.notify_one();
+ }
+
+ if (rand.get_bool())
+ continue;
+
+ Glib::usleep(rand.get_int_range(0, 100000));
+ }
+}
+
+void
+MessageQueue::consumer()
+{
+ Glib::Rand rand(4567);
+
+ for (;;)
+ {
+ {
+ std::unique_lock<std::mutex> lock(mutex_);
+
+ cond_push_.wait(lock, [this]() -> bool { return !queue_.empty(); });
+
+ const int i = queue_.front();
+ queue_.pop();
+ std::cout << "\x08 \x08";
+ std::cout.flush();
+
+ // We unlock before notifying, because that is what the documentation suggests:
+ // http://en.cppreference.com/w/cpp/thread/condition_variable
+ lock.unlock();
+ cond_pop_.notify_one();
+
+ if (i >= 199)
+ break;
+ }
+
+ if (rand.get_bool())
+ continue;
+
+ Glib::usleep(rand.get_int_range(10000, 200000));
+ }
+}
+}
+
+int
+main(int, char**)
+{
+ Glib::init();
+
+ MessageQueue queue;
+
+ // TODO: Use std::make_unique() when we use C++14:
+ const auto producer =
+ std::unique_ptr<std::thread>(new std::thread(&MessageQueue::producer, &queue));
+
+ const auto consumer =
+ std::unique_ptr<std::thread>(new std::thread(&MessageQueue::consumer, &queue));
+
+ producer->join();
+ consumer->join();
+
+ std::cout << std::endl;
+
+ return 0;
+}
--- /dev/null
+
+#include <iostream>
+#include <mutex>
+#include <thread>
+
+// TODO: Remove this example sometime. Glib::ThreadPool is deprecated.
+// TODO: Maybe use std::async() instead?
+#undef GLIBMM_DISABLE_DEPRECATED
+
+#include <glibmmconfig.h>
+
+#ifdef GLIBMM_DISABLE_DEPRECATED
+int
+main(int, char**)
+{
+ // If glibmm is configured with --disable-deprecated-api,
+ // GLIBMM_DISABLE_DEPRECATED is defined in glibmmconfig.h.
+ std::cout << "Glib::ThreadPool not available because deprecated API has been disabled."
+ << std::endl;
+ return 77; // Tell automake's test harness to skip this test.
+}
+
+#else
+
+#include <glibmm/random.h>
+#include <glibmm/threadpool.h>
+#include <glibmm/timer.h>
+
+namespace
+{
+
+std::mutex mutex;
+
+void
+print_char(char c)
+{
+ Glib::Rand rand;
+
+ for (auto i = 0; i < 100; ++i)
+ {
+ {
+ std::lock_guard<std::mutex> lock(mutex);
+ std::cout << c;
+ std::cout.flush();
+ }
+ Glib::usleep(rand.get_int_range(10000, 100000));
+ }
+}
+
+} // anonymous namespace
+
+int
+main(int, char**)
+{
+ Glib::ThreadPool pool(10);
+
+ for (auto c = 'a'; c <= 'z'; ++c)
+ {
+ pool.push(sigc::bind(sigc::ptr_fun(&print_char), c));
+ }
+
+ pool.shutdown();
+
+ std::cout << std::endl;
+
+ return 0;
+}
+#endif // GLIBMM_DISABLE_DEPRECATED
#include <giomm/dbuserror.h>
#include <giomm/dbuserrorutils.h>
#include <giomm/dbusinterface.h>
+#include <giomm/dbusinterfaceskeleton.h>
#include <giomm/dbusinterfacevtable.h>
#include <giomm/dbusintrospection.h>
#include <giomm/dbusmenumodel.h>
#include <giomm/file.h>
#include <giomm/fileattributeinfo.h>
#include <giomm/fileattributeinfolist.h>
-#ifndef G_OS_WIN32
-#include <giomm/filedescriptorbased.h>
-#endif
#include <giomm/fileenumerator.h>
#include <giomm/fileicon.h>
#include <giomm/fileinfo.h>
#include <giomm/mount.h>
#include <giomm/mountoperation.h>
#include <giomm/networkaddress.h>
+#include <giomm/networkmonitor.h>
#include <giomm/networkservice.h>
#include <giomm/notification.h>
#include <giomm/outputstream.h>
#include <giomm/permission.h>
#include <giomm/pollableinputstream.h>
#include <giomm/pollableoutputstream.h>
-#include <giomm/propertyaction.h>
#include <giomm/proxy.h>
#include <giomm/proxyaddress.h>
#include <giomm/proxyresolver.h>
include $(top_srcdir)/build/compile-binding.am
+dist_noinst_HEADERS = slot_async.h
+
local_includes = -I$(top_builddir)/glib $(if $(srcdir:.=),-I$(top_srcdir)/glib)
local_cppflags = $(binding_includes) $(local_includes) $(binding_cppflags) -DGIOMM_BUILD=1
*/
#include <giomm/contenttype.h>
-#include <glibmm/vectorutils.h>
#include <gio/gio.h>
namespace Gio
return Glib::convert_return_gchar_ptr_to_ustring(cresult);
}
-std::vector<Glib::ustring>
+Glib::StringArrayHandle
content_type_guess_for_tree(const Glib::RefPtr<const File>& root)
{
- return Glib::ArrayHandler<Glib::ustring>::array_to_vector(
+ return Glib::StringArrayHandle(
g_content_type_guess_for_tree(const_cast<GFile*>(root->gobj())), Glib::OWNERSHIP_DEEP);
}
-std::vector<Glib::ustring>
+Glib::ListHandle<Glib::ustring>
content_types_get_registered()
{
- return Glib::ListHandler<Glib::ustring>::list_to_vector(g_content_types_get_registered(), Glib::OWNERSHIP_DEEP);
+ return Glib::ListHandle<Glib::ustring>(g_content_types_get_registered(), Glib::OWNERSHIP_DEEP);
}
} // namespace Gio
#define _GIOMM_CONTENTTYPE_H
#include <glibmm/ustring.h>
+#include <glibmm/listhandle.h>
#include <giomm/icon.h>
#include <giomm/file.h>
#include <string>
*
* @newin{2,18}
*/
-std::vector<Glib::ustring> content_type_guess_for_tree(const Glib::RefPtr<const File>& root);
+Glib::StringArrayHandle content_type_guess_for_tree(const Glib::RefPtr<const File>& root);
/**
* Gets a list of strings containing all the registered content types
*
* @return List of the registered content types.
*/
-std::vector<Glib::ustring> content_types_get_registered();
+Glib::ListHandle<Glib::ustring> content_types_get_registered();
/** @} group giommContentType */
giomm_files_built_h = $(giomm_files_used_hg:.hg=.h)
giomm_files_extra_cc = contenttype.cc init.cc slot_async.cc socketsource.cc
-giomm_files_extra_h = contenttype.h init.h slot_async.h socketsource.h wrap_init.h
+giomm_files_extra_h = contenttype.h init.h socketsource.h wrap_init.h
giomm_files_extra_ph =
giomm_files_all_h = $(giomm_files_hg:.hg=.h) $(giomm_files_extra_h)
include $(top_srcdir)/gio/giomm/filelist.am
+# Taken out from $(top_srcdir)/gio/giomm/filelist.am
giomm_files_built_ph = $(patsubst %.hg,private/%_p.h,$(giomm_files_used_hg))
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include "slot_async.h"
#include <glibmm/exceptionhandler.h>
#include <giomm/asyncresult.h>
-#include <giomm/slot_async.h>
namespace Gio
{
-#ifndef _GIOMM_SLOT_ASYNC_H
-#define _GIOMM_SLOT_ASYNC_H
-
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
*/
#include <gio/gio.h>
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-
namespace Gio
{
-/** Callback function, used in combination with Gio::SlotAsyncReady.
- *
- * Example:
- * @code
- * _WRAP_METHOD(void acquire_async(const SlotAsyncReady& slot{callback},
- * const Glib::RefPtr<Cancellable>& cancellable{.?}), g_permission_acquire_async,
- * slot_name slot, slot_callback SignalProxy_async_callback)
- * @endcode
- */
void SignalProxy_async_callback(GObject*, GAsyncResult* res, void* data);
} // namespace Gio
-
-#endif /* DOXYGEN_SHOULD_SKIP_THIS */
-
-#endif /* _GIOMM_SLOT_ASYNC_H */
try
{
// Recreate the specific slot from the generic slot node.
- return (*static_cast<sigc::slot<bool(Glib::IOCondition)>*>(slot))((Glib::IOCondition)condition);
+ return (*static_cast<sigc::slot<bool, Glib::IOCondition>*>(slot))((Glib::IOCondition)condition);
}
catch (...)
{
}
sigc::connection
-SignalSocket::connect(const sigc::slot<bool(Glib::IOCondition)>& slot,
+SignalSocket::connect(const sigc::slot<bool, Glib::IOCondition>& slot,
const Glib::RefPtr<Socket>& socket, Glib::IOCondition condition,
const Glib::RefPtr<Cancellable>& cancellable, int priority)
{
SocketSource::create(const Glib::RefPtr<Socket>& socket, Glib::IOCondition condition,
const Glib::RefPtr<Cancellable>& cancellable)
{
- return Glib::make_refptr_for_instance<SocketSource>(new SocketSource(socket, condition, cancellable));
-}
-
-// static
-Glib::RefPtr<SocketSource>
-SocketSource::create(GSocket* socket, Glib::IOCondition condition,
- const Glib::RefPtr<Cancellable>& cancellable)
-{
- return Glib::make_refptr_for_instance<SocketSource>(new SocketSource(socket, condition, cancellable));
+ return Glib::RefPtr<SocketSource>(new SocketSource(socket, condition, cancellable));
}
SocketSource::SocketSource(const Glib::RefPtr<Socket>& socket, Glib::IOCondition condition,
{
}
-SocketSource::SocketSource(GSocket* socket, Glib::IOCondition condition,
- const Glib::RefPtr<Cancellable>& cancellable)
-: IOSource(
- g_socket_create_source(socket, (GIOCondition)condition, Glib::unwrap(cancellable)),
- Glib::function_pointer_cast<GSourceFunc>(&giomm_socketsource_callback))
-{
-}
-
SocketSource::~SocketSource() noexcept
{
}
#include <giomm/cancellable.h>
#include <sigc++/sigc++.h>
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-using GSocket = struct _GSocket;
-#endif /* DOXYGEN_SHOULD_SKIP_THIS */
-
namespace Gio
{
class Socket;
* @param priority The priority of the new event source.
* @return A connection handle, which can be used to disconnect the handler.
*/
- sigc::connection connect(const sigc::slot<bool(Glib::IOCondition)>& slot,
+ sigc::connection connect(const sigc::slot<bool, Glib::IOCondition>& slot,
const Glib::RefPtr<Socket>& socket, Glib::IOCondition condition,
const Glib::RefPtr<Cancellable>& cancellable = Glib::RefPtr<Cancellable>(),
int priority = Glib::PRIORITY_DEFAULT);
Glib::IOCondition condition,
const Glib::RefPtr<Cancellable>& cancellable = Glib::RefPtr<Cancellable>());
-
protected:
SocketSource(const Glib::RefPtr<Socket>& socket, Glib::IOCondition condition,
const Glib::RefPtr<Cancellable>& cancellable);
~SocketSource() noexcept override;
-
-private:
- friend Socket;
-
- // This is just to avoid the need for Gio::Socket to create a RefPtr<> to itself.
- static Glib::RefPtr<SocketSource> create(GSocket* socket,
- Glib::IOCondition condition,
- const Glib::RefPtr<Cancellable>& cancellable = Glib::RefPtr<Cancellable>());
-
- // This is just to avoid the need for Gio::Socket to create a RefPtr<> to itself.
- SocketSource(GSocket* socket, Glib::IOCondition condition,
- const Glib::RefPtr<Cancellable>& cancellable);
};
} // namespace Gio
template <typename T_Value>
void get_state_hint(T_Value& value) const;
- _WRAP_METHOD(Glib::VariantContainerBase get_state_hint_variant() const, g_action_get_state_hint)
+ //TODO: When we can break ABI, Return a Glib::VariantContainerBase,
+ // as we already do for ActionGroup::get_action_state_hint(),
+ // because that is what this returns (to specify a range).
+ _WRAP_METHOD(Glib::VariantBase get_state_hint_variant() const, g_action_get_state_hint)
_WRAP_METHOD(bool get_enabled() const, g_action_get_enabled)
_WRAP_METHOD(void change_state_variant(const Glib::VariantBase& value), g_action_change_state)
+ _WRAP_METHOD(void change_state(const Glib::VariantBase& value), g_action_change_state, deprecated "Use the templated method instead, passing a normal C++ type.")
+
/** Queries the current state of the action.
*
* If the action is not stateful then a null Variant will be returned. If the
_WRAP_METHOD(void activate_variant(const Glib::VariantBase& parameter), g_action_activate)
+ _WRAP_METHOD(void activate(const Glib::VariantBase& parameter), g_action_activate, deprecated "Use the templated method instead, passing a normal C++ type.")
+
_WRAP_METHOD(static bool name_is_valid(const Glib::ustring& action_name), g_action_name_is_valid )
/** Parses a detailed action name into its separate name and target components.
static void parse_detailed_name(const Glib::ustring& detailed_name, Glib::ustring& action_name, T_Value& target_value);
_WRAP_METHOD(static void parse_detailed_name_variant(const Glib::ustring& detailed_name,
- Glib::ustring& action_name{>>}, Glib::VariantBase& target_value{>>}), g_action_parse_detailed_name, errthrow "Glib::VariantParseError")
+ Glib::ustring& action_name{>>}, Glib::VariantBase& target_value{>>}), g_action_parse_detailed_name, errthrow "Glib::VariantParseError", errthrow)
/** Formats a detailed action name from the action's action_name and @a target_value.
*
_WRAP_METHOD(Glib::VariantType get_action_parameter_type(const Glib::ustring& action_name) const, g_action_group_get_action_parameter_type)
_WRAP_METHOD(Glib::VariantType get_action_state_type(const Glib::ustring& action_name) const, g_action_group_get_action_state_type)
+
+ _WRAP_METHOD(Glib::VariantContainerBase get_action_state_hint(const Glib::ustring& action_name) const, g_action_group_get_action_state_hint, deprecated "Use the get_action_state() method that takes an output parameter instead.")
+
//TODO: How do we check for a nullptr Variant?
/**
* Requests a hint about the valid range of values for the state of the
_WRAP_METHOD(Glib::VariantContainerBase get_action_state_hint_variant(const Glib::ustring& action_name) const, g_action_group_get_action_state_hint)
+
+ _WRAP_METHOD(Glib::VariantBase get_action_state(const Glib::ustring& action_name) const, g_action_group_get_action_state, deprecated "Use the get_action_state() method that takes an output parameter instead.")
+
//TODO: How do we check for a nullptr Variant?
/** Queries the current state of the named action within the action group.
*
//TODO: Add templated method, renaming this to action_state_changed_variant).
_WRAP_METHOD(void action_state_changed (const Glib::ustring& action_name, const Glib::VariantBase& state), g_action_group_action_state_changed)
- _WRAP_SIGNAL(void action_added(const Glib::ustring& action_name), "action-added", detail_name action_name)
- _WRAP_SIGNAL(void action_enabled_changed(const Glib::ustring& action_name, bool enabled), "action-enabled-changed", detail_name action_name)
- _WRAP_SIGNAL(void action_removed(const Glib::ustring& action_name), "action-removed", detail_name action_name)
+ //TODO: Remove two_signal_methods when we can break ABI.
+ _WRAP_SIGNAL(void action_added(const Glib::ustring& action_name), "action-added", detail_name action_name, two_signal_methods)
+ _WRAP_SIGNAL(void action_enabled_changed(const Glib::ustring& action_name, bool enabled), "action-enabled-changed", detail_name action_name, two_signal_methods)
+ _WRAP_SIGNAL(void action_removed(const Glib::ustring& action_name), "action-removed", detail_name action_name, two_signal_methods)
#m4 _CONVERSION(`GVariant*', `const Glib::VariantBase&', `Glib::wrap($3, true)')
- _WRAP_SIGNAL(void action_state_changed(const Glib::ustring& action_name, const Glib::VariantBase& value), "action-state-changed", detail_name action_name)
+ _WRAP_SIGNAL(void action_state_changed(const Glib::ustring& action_name, const Glib::VariantBase& value), "action-state-changed", detail_name action_name, two_signal_methods)
_WRAP_VFUNC(bool has_action(const Glib::ustring& name) const, "has_action")
return action;
}
+_DEPRECATE_IFDEF_START
+Glib::RefPtr<SimpleAction>
+ActionMap::add_action_with_parameter(
+ const Glib::ustring& name, const ActivateWithParameterSlot& slot)
+{
+ auto action = add_action(name);
+ action->signal_activate().connect(slot);
+ return action;
+}
+_DEPRECATE_IFDEF_END
+
Glib::RefPtr<SimpleAction>
ActionMap::add_action_with_parameter(
const Glib::ustring& name, const Glib::VariantType& parameter_type, const ActivateWithParameterSlot& slot)
on_action_radio_string(
const Glib::VariantBase& parameter, const Gio::ActionMap::ActivateWithStringParameterSlot& slot)
{
- const auto variantDerived = Glib::VariantBase::cast_dynamic<Glib::Variant<Glib::ustring>>(parameter);
+ // TODO: This syntax is odd:
+ const auto variantDerived = parameter.cast_dynamic<Glib::Variant<Glib::ustring>>(parameter);
const auto str = variantDerived.get();
slot(str);
}
on_action_radio_int(
const Glib::VariantBase& parameter, const Gio::ActionMap::ActivateWithIntParameterSlot& slot)
{
- const auto variantDerived = Glib::VariantBase::cast_dynamic<Glib::Variant<int>>(parameter);
+ // TODO: This syntax is odd:
+ const auto variantDerived = parameter.cast_dynamic<Glib::Variant<int>>(parameter);
const auto str = variantDerived.get();
slot(str);
}
class Action;
+//TODO: Instead derive from ActionGroup, when we can break ABI,
+//because the GActionMap interface requires the GActionGroup interface.
+//LoadableIcon does a similar thing correctly, for instance.
+
/** ActionMap - Interface for action containers.
* The ActionMap interface is implemented by ActionGroup implementations that
* operate by containing a number of named Action instances, such as
_WRAP_METHOD(Glib::RefPtr<Action> lookup_action(const Glib::ustring& action_name), g_action_map_lookup_action, refreturn)
_WRAP_METHOD(Glib::RefPtr<const Action> lookup_action(const Glib::ustring& action_name) const, g_action_map_lookup_action, constversion, refreturn)
-
/** A convenience method for creating a SimpleAction instance
* and adding it to the ActionMap.
*
* For instance,
* void on_slot_activated();
*/
- using ActivateSlot = sigc::slot<void()>;
+ using ActivateSlot = sigc::slot<void>;
/** A convenience method for creating a SimpleAction instance
* and adding it to the ActionMap.
* For instance,
* void on_slot_activated(const Glib::VariantBase& parameter);
*/
- using ActivateWithParameterSlot = sigc::slot<void(const Glib::VariantBase&)>;
+ using ActivateWithParameterSlot = sigc::slot<void, const Glib::VariantBase&>;
+
+_DEPRECATE_IFDEF_START
+ /** A convenience method for creating a SimpleAction instance
+ * and adding it to the ActionMap.
+ *
+ * @param name The name of the Action.
+ * @param slot The callback method to be called when the action is activated.
+ * @return The Action.
+ *
+ * @deprecated This overload does not work as it does not set a parameter
+ * type on the Action, so activating it with a parameter cannot work. Use the
+ * other add_action_with_parameter() overload, which takes a parameter type.
+ */
+ Glib::RefPtr<SimpleAction> add_action_with_parameter(const Glib::ustring& name, const ActivateWithParameterSlot& slot);
+_DEPRECATE_IFDEF_END
/** A convenience method for creating a SimpleAction instance, which when
* activated will call a slot receiving a given type of parameter, and adding
* For instance,
* void on_slot_activated(const Glib::ustring& parameter);
*/
- using ActivateWithStringParameterSlot = sigc::slot<void(const Glib::ustring&)>;
+ using ActivateWithStringParameterSlot = sigc::slot<void, const Glib::ustring&>;
//TODO: Docs: Add hints about how to specify the various possible states in the GtkBuilder XML.
/** A convenience method for creating a string-based radio SimpleAction instance
* For instance,
* void on_slot_activated(int parameter);
*/
- using ActivateWithIntParameterSlot = sigc::slot<void(int)>;
-
+ using ActivateWithIntParameterSlot = sigc::slot<void, int>;
+
//TODO: Docs: Add hints about how to specify the various possible states in the GtkBuilder XML.
/** A convenience method for creating an integer-based radio SimpleAction instance
* and adding it to the ActionMap.
#m4 _CONVERSION(`Glib::RefPtr<Action>', `GAction*', `Glib::unwrap($3)')
_WRAP_VFUNC(Glib::RefPtr<Action> lookup_action(const Glib::ustring& name) const, "lookup_action", refreturn)
-#m4 _CONVERSION(`GAction*', `const Glib::RefPtr<Action>&', `Glib::wrap($3, true)')
- _WRAP_VFUNC(void add_action(const Glib::RefPtr<Action>& action) const, "add_action")
-
+ //TODO: Change this to use const & when we can break ABI.
+ // ( Changing it causes a symbol lookup error when trying to run already-built applications. )
+#m4 _CONVERSION(`GAction*', `Glib::RefPtr<Action>', `Glib::wrap($3, true)')
+ _WRAP_VFUNC(void add_action(Glib::RefPtr<Action> action) const, "add_action")
_WRAP_VFUNC(void remove_action(const Glib::ustring& name), "remove_action")
};
*/
#include <giomm/file.h>
+#include <glibmm/listhandle.h>
#include <glibmm/vectorutils.h>
#include "slot_async.h"
#include <gio/gio.h>
Glib::RefPtr<AppInfo>
AppInfo::create_from_commandline(
- const std::string& commandline, const std::string& application_name, CreateFlags flags)
+ const std::string& commandline, const std::string& application_name, AppInfoCreateFlags flags)
{
GAppInfo* capp_info = nullptr;
GError* gerror = nullptr;
bool
AppInfo::launch(
- const Glib::RefPtr<Gio::File>& file, const Glib::RefPtr<AppLaunchContext>& launch_context)
+ const Glib::RefPtr<Gio::File>& file, const Glib::RefPtr<AppLaunchContext>& context)
{
std::vector<Glib::RefPtr<Gio::File>> vec = { file };
GError* gerror = nullptr;
const bool retvalue = g_app_info_launch(gobj(),
Glib::ListHandler<Glib::RefPtr<Gio::File>>::vector_to_list(vec).data(),
- Glib::unwrap(launch_context), &(gerror));
+ Glib::unwrap(context), &(gerror));
if (gerror)
::Glib::Error::throw_exception(gerror);
}
bool
-AppInfo::launch_uri(const std::string& uri, const Glib::RefPtr<AppLaunchContext>& launch_context)
+AppInfo::launch_uri(const std::string& uri, const Glib::RefPtr<AppLaunchContext>& context)
{
std::vector<std::string> vec = { uri };
GError* gerror = nullptr;
const bool retvalue =
g_app_info_launch_uris(gobj(), Glib::ListHandler<std::string>::vector_to_list(vec).data(),
- Glib::unwrap(launch_context), &(gerror));
+ Glib::unwrap(context), &(gerror));
if (gerror)
::Glib::Error::throw_exception(gerror);
#include <string>
#include <glibmm/interface.h>
+#include <glibmm/listhandle.h>
+#include <glibmm/arrayhandle.h>
#include <glibmm/object.h>
//#include <giomm/file.h>
#include <giomm/icon.h>
namespace Gio
{
+_WRAP_ENUM(AppInfoCreateFlags, GAppInfoCreateFlags, NO_GTYPE)
class File;
_CLASS_INTERFACE(AppInfo, GAppInfo, G_APP_INFO, GAppInfoIface)
public:
- _WRAP_ENUM(CreateFlags, GAppInfoCreateFlags, NO_GTYPE)
-
static Glib::RefPtr<AppInfo> create_from_commandline(const std::string& commandline,
const std::string& application_name,
- CreateFlags flags);
+ AppInfoCreateFlags flags);
/** Creates a duplicate of this AppInfo.
* @return A duplicate of this AppInfo.
_WRAP_METHOD(bool supports_uris() const, g_app_info_supports_uris)
_WRAP_METHOD(bool supports_files() const, g_app_info_supports_files)
- #m4 _CONVERSION(`const std::vector<std::string>&',`GList*',`Glib::ListHandler<std::string>::vector_to_list($3).data()')
+#m4 _CONVERSION(`const Glib::ListHandle<std::string>&',`GList*',`$3.data()')
+ _WRAP_METHOD(bool launch_uris(const Glib::ListHandle<std::string>& uris,
+ GAppLaunchContext* context),
+ g_app_info_launch_uris,
+ errthrow, deprecated "Use the method that takes an AppLaunchContext")
//TODO: I think we use Glib::ustring elsewhere for URIs:
- _WRAP_METHOD(bool launch_uris(const std::vector<std::string>& uris,
+ // 2019-03-18 kjellahl: Glibmm is inconsistent; Glib::ustring in convert.hg,
+ // std::string in uriutils.hg.
+ // The reporter of libxml++ bug https://bugzilla.gnome.org/show_bug.cgi?id=790034
+ // proposes std::string.
+#m4 _CONVERSION(`const std::vector<std::string>&',`GList*',`Glib::ListHandler<std::string>::vector_to_list($3).data()')
+ _WRAP_METHOD(bool launch_uris(const Glib::ListHandle<std::string>& uris,
const Glib::RefPtr<AppLaunchContext>& context{?}),
g_app_info_launch_uris,
errthrow)
* Note that even if the launch is successful the application launched
* can fail to start if it runs into problems during startup. There is
* no way to detect this.
- * @param uris A URIs to launch.
+ * @param uri A URI to launch.
* @param context An AppLaunchContext.
* @return <tt>true</tt> on successful launch, <tt>false</tt> otherwise.
*
* @newin{2,30}
*/
- bool launch_uri(const std::string& uri
s, const Glib::RefPtr<AppLaunchContext>& context);
+ bool launch_uri(const std::string& uri, const Glib::RefPtr<AppLaunchContext>& context);
/** A launch_uri() convenience overload.
*
*/
bool launch_uri(const std::string& uris);
+ _WRAP_METHOD(void launch_uris_async(const std::vector<std::string>& uris,
+ const Glib::RefPtr<AppLaunchContext>& context{.},
+ const SlotAsyncReady& slot{callback?},
+ const Glib::RefPtr<Cancellable>& cancellable{.} = {}),
+ g_app_info_launch_uris_async, slot_name slot, slot_callback SignalProxy_async_callback, newin "2,60")
+ _WRAP_METHOD(bool launch_uris_finish(const Glib::RefPtr<AsyncResult>& result),
+ g_app_info_launch_uris_finish, errthrow, newin "2,60")
+
_WRAP_METHOD(bool should_show() const, g_app_info_should_show)
// FIXME: use better terminology than delete/do_delete
_WRAP_METHOD(bool can_delete() const, g_app_info_can_delete)
g_app_info_remove_supports_type,
errthrow)
-#m4 _CONVERSION(`const char**', `std::vector<Glib::ustring>', `Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_NONE)')
- _WRAP_METHOD(std::vector<Glib::ustring> get_supported_types() const, g_app_info_get_supported_types)
+#m4 _CONVERSION(`const char**', `Glib::StringArrayHandle', `Glib::StringArrayHandle($3, Glib::OWNERSHIP_NONE)')
+ _WRAP_METHOD(Glib::StringArrayHandle get_supported_types() const, g_app_info_get_supported_types)
_WRAP_METHOD(bool set_as_last_used_for_type(const std::string& content_type), g_app_info_set_as_last_used_for_type, errthrow)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<AppInfo>>',`Glib::ListHandler<Glib::RefPtr<AppInfo>>::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(static std::vector<Glib::RefPtr<AppInfo>> get_all(), g_app_info_get_all)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle<Glib::RefPtr<AppInfo> >',`Glib::ListHandle<Glib::RefPtr<AppInfo> >($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(static Glib::ListHandle<Glib::RefPtr<AppInfo> > get_all(), g_app_info_get_all)
- _WRAP_METHOD(static std::vector<Glib::RefPtr<AppInfo>> get_all_for_type(const std::string& content_type), g_app_info_get_all_for_type)
+ _WRAP_METHOD(static Glib::ListHandle<Glib::RefPtr<AppInfo> > get_all_for_type(const std::string& content_type), g_app_info_get_all_for_type)
_WRAP_METHOD(static Glib::RefPtr<AppInfo> get_default_for_type(const std::string& content_type, bool must_support_uris = true), g_app_info_get_default_for_type)
_WRAP_METHOD(static Glib::RefPtr<AppInfo> get_default_for_uri_scheme(const std::string& uri_scheme), g_app_info_get_default_for_uri_scheme)
_WRAP_METHOD(static void reset_type_associations(const std::string& content_type), g_app_info_reset_type_associations)
//_WRAP_VFUNC(std::string get_description() const, "get_description")
//_WRAP_VFUNC(std::string get_executable() const, "get_executable")
//_WRAP_VFUNC(Glib::RefPtr<Icon> get_icon() const, "get_icon")
+//#m4 _CONVERSION(`const Glib::ListHandle<std::string>&',`GList*',`$3.data()')
+//#m4 _CONVERSION(`GList*',`const Glib::ListHandle<std::string>&',`Glib::ListHandle<std::string>($3, Glib::OWNERSHIP_NONE)')
//_WRAP_VFUNC(bool launch(const std::vector<Gio::File>& filenames, const Glib::RefPtr<AppLaunchContext>& context, GError** error), "launch")
//_WRAP_VFUNC(bool supports_uris() const, "supports_uris")
//_WRAP_VFUNC(bool supports_files() const, "supports_files")
- //_WRAP_VFUNC(bool launch_uris(const
std::vector<std::string>& uris, const Glib::RefPtr<AppLaunchContext>& context, GError** error), "launch_uris")
+ //_WRAP_VFUNC(bool launch_uris(const
Glib::ListHandle<std::string>& uris, const Glib::RefPtr<AppLaunchContext>& context, GError** error), "launch_uris")
//_WRAP_VFUNC(bool should_show() const, "should_show")
//_WRAP_VFUNC(bool set_as_default_for_type(const std::string& content_type, GError** error), "set_as_default_for_type")
//_WRAP_VFUNC(bool set_as_default_for_extension(const std::string& extension, GError** error), "set_as_default_for_extension")
#include <string>
#include <glibmm/interface.h>
+#include <glibmm/listhandle.h>
#include <glibmm/object.h>
//#include <giomm/file.h>
#include <giomm/icon.h>
#m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
_WRAP_METHOD(std::vector<Glib::ustring> get_environment() const, g_app_launch_context_get_environment)
-#m4 _CONVERSION(`const std::vector<std::string>&',`GList*',`Glib::ListHandler<std::string>::vector_to_list$3.data()')
- _WRAP_METHOD(std::string get_display(const Glib::RefPtr<AppInfo>& info, const std::vector<Glib::RefPtr<Gio::File>>& files),
+#m4 _CONVERSION(`const Glib::ListHandle<std::string>&',`GList*',`$3.data()')
+ _WRAP_METHOD(std::string get_display(const Glib::RefPtr<AppInfo>& info, const Glib::ListHandle< Glib::RefPtr<Gio::File> >& files),
g_app_launch_context_get_display)
- _WRAP_METHOD(std::string get_startup_notify_id(const Glib::RefPtr<AppInfo>& info, const std::vector<Glib::RefPtr<Gio::File>>& files),
+ _WRAP_METHOD(std::string get_startup_notify_id(const Glib::RefPtr<AppInfo>& info, const Glib::ListHandle< Glib::RefPtr<Gio::File> >& files),
g_app_launch_context_get_startup_notify_id)
_WRAP_METHOD(void launch_failed(const std::string& startup_notify_id),
g_app_launch_context_launch_failed)
#include <giomm/init.h>
#include <cstring> // std::memset()
#include <map>
-#include <mutex>
#include <vector>
-using Flags = Gio::Application::Flags;
-
namespace // anonymous
{
+// TODO: At the next ABI break, implement the pimpl idiom. Then we need not use
+// a GQuark for ExtraApplicationData, which should be renamed to
+// struct Gio::Application::Impl.
+// These are new data members that can't be added to Gio::Application now,
+// because it would break ABI.
+struct ExtraApplicationData
+{
+ std::vector<gchar*> option_entry_strings;
+
+ ~ExtraApplicationData()
+ {
+ for (auto str : option_entry_strings)
+ {
+ g_free(str);
+ }
+ }
+};
+
+GQuark quark_extra_application_data =
+ g_quark_from_static_string("glibmm__Gio::Application::quark_extra_application_data");
+
+void
+Application_delete_extra_application_data(gpointer data)
+{
+ ExtraApplicationData* extra_application_data = static_cast<ExtraApplicationData*>(data);
+ delete extra_application_data;
+}
static void
Application_signal_open_callback(
GApplication* self, GFile** files, gint n_files, const gchar* hint, void* data)
{
- using SlotType = sigc::slot<void(const Gio::Application::type_vec_files&, const Glib::ustring&)>;
+ using SlotType = sigc::slot<void, const Gio::Application::type_vec_files&, const Glib::ustring&>;
Gio::Application::type_vec_files vec_files(n_files);
for (int i = 0; i < n_files; ++i)
GApplication* self, GFile** files, gint n_files, const gchar* hint, void* data)
{
using namespace Gio;
- using SlotType = sigc::slot<void(const Application::type_vec_files&, const Glib::ustring&)>;
+ using SlotType = sigc::slot<void, const Application::type_vec_files&, const Glib::ustring&>;
Application::type_vec_files vec_files(n_files);
for (int i = 0; i < n_files; i++)
class OptionArgCallbackData
{
public:
- explicit OptionArgCallbackData(const Gio::Application* application,
- const Glib::ustring& long_name, gchar short_name,
- const Glib::ustring& description, const Glib::ustring& arg_description,
+ explicit OptionArgCallbackData(const Gio::Application* application, gchar short_name,
const Glib::OptionGroup::SlotOptionArgString& slot)
- :
- application_(application),
- long_name_(g_strdup(long_name.c_str())), // must not be nullptr
+ : application_(application),
short_name_(short_name),
- description_(g_strdup(Glib::c_str_or_nullptr(description))),
- arg_description_(g_strdup(Glib::c_str_or_nullptr(arg_description))),
slot_string_(new Glib::OptionGroup::SlotOptionArgString(slot)),
slot_filename_(nullptr)
{
}
- explicit OptionArgCallbackData(const Gio::Application* application,
- const Glib::ustring& long_name, gchar short_name,
- const Glib::ustring& description, const Glib::ustring& arg_description,
+ explicit OptionArgCallbackData(const Gio::Application* application, gchar short_name,
const Glib::OptionGroup::SlotOptionArgFilename& slot)
- :
- application_(application),
- long_name_(g_strdup(long_name.c_str())), // must not be nullptr
+ : application_(application),
short_name_(short_name),
- description_(g_strdup(Glib::c_str_or_nullptr(description))),
- arg_description_(g_strdup(Glib::c_str_or_nullptr(arg_description))),
slot_string_(nullptr),
slot_filename_(new Glib::OptionGroup::SlotOptionArgFilename(slot))
{
}
const Gio::Application* get_application() const { return application_; }
- const gchar* get_long_name() const { return long_name_; }
gchar get_short_name() const { return short_name_; }
- const gchar* get_description() const { return description_; }
- const gchar* get_arg_description() const { return arg_description_; }
bool is_filename_option() const { return slot_filename_ != nullptr; }
const Glib::OptionGroup::SlotOptionArgString* get_slot_string() const { return slot_string_; }
~OptionArgCallbackData()
{
- g_free(long_name_);
- g_free(description_);
- g_free(arg_description_);
delete slot_string_;
delete slot_filename_;
// Don't delete application_. It's not owned by this class.
private:
const Gio::Application* application_;
- gchar* long_name_;
gchar short_name_;
- gchar* description_;
- gchar* arg_description_;
// One of these slot pointers is nullptr and the other one points to a slot.
Glib::OptionGroup::SlotOptionArgString* slot_string_;
Glib::OptionGroup::SlotOptionArgFilename* slot_filename_;
// Not copyable
- OptionArgCallbackData(const OptionArgCallbackData&) = delete;
- OptionArgCallbackData& operator=(const OptionArgCallbackData&) = delete;
-
-}; // end class OptionArgCallbackData
+ OptionArgCallbackData(const OptionArgCallbackData&);
+ OptionArgCallbackData& operator=(const OptionArgCallbackData&);
+};
using OptionArgCallbackDataMap = std::map<Glib::ustring, OptionArgCallbackData*>;
OptionArgCallbackDataMap option_arg_callback_data;
return application_class_.init();
}
-Application::Application(const Glib::ustring& application_id, Flags flags)
+Application::Application(const Glib::ustring& application_id, ApplicationFlags flags)
: // Mark this class as non-derived to allow C++ vfuncs to be skipped.
- // GApplication complains about "" but allows nullptr, so we avoid passing "".
Glib::ObjectBase(nullptr),
- Glib::Object(Glib::ConstructParams(custom_class_init(),
- "application_id", Glib::c_str_or_nullptr(application_id),
- "flags", static_cast<GApplicationFlags>(flags), nullptr))
+ Glib::Object(Glib::ConstructParams(custom_class_init(), "application_id",
+ Glib::c_str_or_nullptr(application_id), "flags", ((GApplicationFlags)(flags)), nullptr))
{
}
(*base->open)(self, files, n_files, hint);
}
-Glib::SignalProxy<void(const Application::type_vec_files&, const Glib::ustring&)>
+Glib::SignalProxy<void, const Application::type_vec_files&, const Glib::ustring&>
Application::signal_open()
{
- return Glib::SignalProxy<void(const Application::type_vec_files&, const Glib::ustring&)>(
+ return Glib::SignalProxy<void, const Application::type_vec_files&, const Glib::ustring&>(
this, &Application_signal_open_info);
}
void
Application::add_main_option_entry(OptionType arg_type, const Glib::ustring& long_name,
gchar short_name, const Glib::ustring& description, const Glib::ustring& arg_description,
- Glib::OptionEntry::Flags flags)
+ int flags)
{
- // g_application_add_main_option() saves copies of the strings.
- // No need to keep copies in Gio::Application.
- g_application_add_main_option(gobj(), long_name.c_str(), short_name,
- static_cast<GOptionFlags>(flags), static_cast<GOptionArg>(arg_type),
- description.c_str(), Glib::c_str_or_nullptr(arg_description));
+ add_main_option_entry_private(
+ (GOptionArg)arg_type, long_name, short_name, description, arg_description, flags);
}
void
Application::add_main_option_entry(const Glib::OptionGroup::SlotOptionArgString& slot,
const Glib::ustring& long_name, gchar short_name, const Glib::ustring& description,
- const Glib::ustring& arg_description, Glib::OptionEntry::Flags flags)
+ const Glib::ustring& arg_description, int flags)
{
- OptionArgCallbackData* callback_data = nullptr;
{
std::lock_guard<std::mutex> lock(option_arg_callback_data_mutex);
OptionArgCallbackDataMap::iterator iterFind = option_arg_callback_data.find(long_name);
if (iterFind != option_arg_callback_data.end())
return; // Ignore duplicates
- callback_data = new OptionArgCallbackData(
- this, long_name, short_name, description, arg_description, slot);
+ auto callback_data = new OptionArgCallbackData(this, short_name, slot);
option_arg_callback_data[long_name] = callback_data;
} // option_arg_callback_data_mutex.unlock()
- add_main_option_entry_private(callback_data->get_long_name(), short_name,
- callback_data->get_description(), callback_data->get_arg_description(),
- flags & ~Glib::OptionEntry::Flags::FILENAME);
+ add_main_option_entry_private(G_OPTION_ARG_CALLBACK, long_name, short_name, description,
+ arg_description, flags & ~Glib::OptionEntry::FLAG_FILENAME);
}
void
Application::add_main_option_entry_filename(const Glib::OptionGroup::SlotOptionArgFilename& slot,
const Glib::ustring& long_name, gchar short_name, const Glib::ustring& description,
- const Glib::ustring& arg_description, Glib::OptionEntry::Flags flags)
+ const Glib::ustring& arg_description, int flags)
{
- OptionArgCallbackData* callback_data = nullptr;
{
std::lock_guard<std::mutex> lock(option_arg_callback_data_mutex);
OptionArgCallbackDataMap::iterator iterFind = option_arg_callback_data.find(long_name);
if (iterFind != option_arg_callback_data.end())
return; // Ignore duplicates
- callback_data = new OptionArgCallbackData(
- this, long_name, short_name, description, arg_description, slot);
+ auto callback_data = new OptionArgCallbackData(this, short_name, slot);
option_arg_callback_data[long_name] = callback_data;
} // option_arg_callback_data_mutex.unlock()
- add_main_option_entry_private(callback_data->get_long_name(), short_name,
- callback_data->get_description(), callback_data->get_arg_description(),
- flags | Glib::OptionEntry::Flags::FILENAME);
+ add_main_option_entry_private(G_OPTION_ARG_CALLBACK, long_name, short_name, description,
+ arg_description, flags | Glib::OptionEntry::FLAG_FILENAME);
}
void
-Application::add_main_option_entry_private(const gchar* long_name,
- gchar short_name, const gchar* description,
- const gchar* arg_description, Glib::OptionEntry::Flags flags)
+Application::add_main_option_entry_private(GOptionArg arg, const Glib::ustring& long_name,
+ gchar short_name, const Glib::ustring& description, const Glib::ustring& arg_description,
+ int flags)
{
- // g_application_add_main_option() can't be used for options with
- // a callback slot, because GOptionEntry.arg_data must be non-null.
-
// Create a temporary array, just so we can give the correct thing to
// g_application_add_main_option_entries():
GOptionEntry array[2];
// g_application_add_main_option_entries() does not take its own copy
// of the strings. We must keep them alive, and keep pointers to them,
// so we can delete them when the Application instance is deleted.
- // This is handled in OptionArgCallbackData.
+
+ // GOptionEntry.long_name must be set, even if it's an empty string.
+ gchar* lname = g_strdup(long_name.c_str());
+ gchar* desc = description.empty() ? nullptr : g_strdup(description.c_str());
+ gchar* arg_desc = arg_description.empty() ? nullptr : g_strdup(arg_description.c_str());
+
+ ExtraApplicationData* extra_application_data =
+ static_cast<ExtraApplicationData*>(g_object_get_qdata(gobject_, quark_extra_application_data));
+ if (!extra_application_data)
+ {
+ extra_application_data = new ExtraApplicationData();
+ g_object_set_qdata_full(gobject_, quark_extra_application_data, extra_application_data,
+ Application_delete_extra_application_data);
+ }
+
+ extra_application_data->option_entry_strings.emplace_back(lname);
+ if (desc)
+ extra_application_data->option_entry_strings.emplace_back(desc);
+ if (arg_desc)
+ extra_application_data->option_entry_strings.emplace_back(arg_desc);
// Fill in array[0].
- array[0].arg = G_OPTION_ARG_CALLBACK;
- array[0].long_name = long_name;
+ array[0].arg = arg;
+ array[0].long_name = lname;
array[0].short_name = short_name;
- array[0].description = description;
- array[0].arg_description = arg_description;
- array[0].flags = static_cast<int>(flags);
-
- // GoptionEntry.arg_data is a function pointer, cast to void*.
- // See Glib::OptionGroup::CppOptionEntry::allocate_c_arg() for a discussion
- // of this hack.
- union {
- void* dp;
- GOptionArgFunc fp;
- } u;
- u.fp = &Application_option_arg_callback;
- array[0].arg_data = u.dp;
+ array[0].description = desc;
+ array[0].arg_description = arg_desc;
+ array[0].flags = flags;
+
+ if (arg == G_OPTION_ARG_CALLBACK)
+ {
+ // GoptionEntry.arg_data is a function pointer, cast to void*.
+ // See Glib::OptionGroup::CppOptionEntry::allocate_c_arg() for a discussion
+ // of this hack.
+ union {
+ void* dp;
+ GOptionArgFunc fp;
+ } u;
+ u.fp = &Application_option_arg_callback;
+ array[0].arg_data = u.dp;
+ }
+ else
+ // We ensure that this is null to ensure that it is not used,
+ // telling GApplication to put the parsed value in the options VariantDict instead.
+ array[0].arg_data = nullptr;
g_application_add_main_option_entries(gobj(), array);
}
g_application_set_resource_base_path(gobj(), nullptr /* see the C docs. */);
}
+Glib::PropertyProxy< std::string > Application::property_resource_base_path_string()
+{
+ return Glib::PropertyProxy< std::string >(this, "resource-base-path");
+}
+
+Glib::PropertyProxy_ReadOnly< std::string > Application::property_resource_base_path_string() const
+{
+ return Glib::PropertyProxy_ReadOnly< std::string >(this, "resource-base-path");
+}
+
} // namespace Gio
namespace Gio
{
+_WRAP_ENUM(ApplicationFlags, GApplicationFlags)
/** Application - Core application class.
* An Application is the foundation of an application, unique for a given
_IMPLEMENTS_INTERFACE(ActionGroup)
_IMPLEMENTS_INTERFACE(ActionMap)
-public:
- _WRAP_ENUM(Flags, GApplicationFlags, NO_GTYPE, s#^FLAGS_##)
-
protected:
/** Constructs an application instance.
* If no application ID is given then some features (most notably application uniqueness) will be disabled.
* @param application_id The application ID.
* @param flags The application flags.
*/
- explicit Application(const Glib::ustring& application_id = Glib::ustring(), Flags flags = Flags::NONE);
+ explicit Application(const Glib::ustring& application_id = Glib::ustring(), ApplicationFlags flags = APPLICATION_FLAGS_NONE);
_IGNORE(g_application_new)
public:
_CUSTOM_DTOR()
- // Application::OptionType wraps GOptionArg, but _WRAP_ENUM can't be used here.
- // GOptionArg is defined in glib_enums.defs, not in gio_enums.defs.
/** The OptionType enum values determine the expected type of a command line option.
* If an option expects an extra argument, it can be specified in several ways;
* with a short option: "-x arg", with a long option: "--name arg" or combined
- * in a single argument: "--name=arg". All option types except OptionType::BOOL
- * expect an extra argument. OptionType::STRING_VECTOR and
- * OptionType::FILENAME_VECTOR accept more than one extra argument.
+ * in a single argument: "--name=arg". All option types except OPTION_TYPE_BOOL
+ * expect an extra argument. OPTION_TYPE_STRING_VECTOR and
+ * OPTION_TYPE_FILENAME_VECTOR accept more than one extra argument.
*
* The descriptions of the enum values show what type of Glib::Variant<>
* is stored in a Glib::VariantDict.
*
* @ingroup glibmmEnums
*/
- enum class OptionType
+ enum OptionType
{
- BOOL, ///< bool
- STRING, ///< Glib::ustring
- INT, ///< gint32
- // CALLBACK,
- FILENAME = INT+2, ///< std::string
- STRING_VECTOR, ///< std::vector<Glib::ustring>
- FILENAME_VECTOR, ///< std::vector<std::string>
- DOUBLE, ///< double
- INT64 ///< gint64
+ OPTION_TYPE_BOOL, ///< bool
+ OPTION_TYPE_STRING, ///< Glib::ustring
+ OPTION_TYPE_INT, ///< gint32
+ //OPTION_TYPE_CALLBACK,
+ OPTION_TYPE_FILENAME = OPTION_TYPE_INT+2, ///< std::string
+ OPTION_TYPE_STRING_VECTOR, ///< std::vector<Glib::ustring>
+ OPTION_TYPE_FILENAME_VECTOR, ///< std::vector<std::string>
+ OPTION_TYPE_DOUBLE, ///< double
+ OPTION_TYPE_INT64 ///< gint64
};
/** Creates an application instance.
* @param application_id The application ID.
* @param flags The application flags.
*/
- _WRAP_CREATE(const Glib::ustring& application_id = Glib::ustring(), Flags flags = Flags::NONE)
+ _WRAP_CREATE(const Glib::ustring& application_id = Glib::ustring(), ApplicationFlags flags = APPLICATION_FLAGS_NONE)
_WRAP_METHOD(static bool id_is_valid(const Glib::ustring& application_id), g_application_id_is_valid)
_WRAP_METHOD(guint get_inactivity_timeout() const, g_application_get_inactivity_timeout)
_WRAP_METHOD(void set_inactivity_timeout(guint inactivity_timeout), g_application_set_inactivity_timeout)
- _WRAP_METHOD(Flags get_flags() const, g_application_get_flags)
- _WRAP_METHOD(void set_flags(Flags flags), g_application_set_flags)
+ _WRAP_METHOD(ApplicationFlags get_flags() const, g_application_get_flags)
+ _WRAP_METHOD(void set_flags(ApplicationFlags flags), g_application_set_flags)
_WRAP_METHOD(std::string get_resource_base_path() const, g_application_get_resource_base_path, newin "2,44")
_WRAP_METHOD(void set_resource_base_path(const std::string& resource_path), g_application_set_resource_base_path, newin "2,44")
*/
void unset_resource_base_path();
- _IGNORE(g_application_set_action_group)
+ _WRAP_METHOD(void set_action_group(const Glib::RefPtr<ActionGroup>& action_group), g_application_set_action_group,
+ deprecated "Use the Gio::ActionMap interface instead.")
//Note: We would like to add a group, not just some entries,
//so we can do pre and post parsing. See https://bugzilla.gnome.org/show_bug.cgi?id=727602
* Unlike OptionGroup + OptionContext, Application packs the arguments
* into a Glib::VariantDict which is passed to the
* signal_handle_local_options() handler, where it can be
- * inspected and modified. If Gio::Application::Flags::HANDLES_COMMAND_LINE is
+ * inspected and modified. If Gio::APPLICATION_HANDLES_COMMAND_LINE is
* set, then the resulting dictionary is sent to the primary instance,
* where Gio::ApplicationCommandLine::get_options_dict() will return it.
* This "packing" is done according to the type of the argument --
* on the local side. Calling this function "opts in" to the new
* behaviour, and in particular, means that unrecognised options will be
* treated as errors. Unrecognised options have never been ignored when
- * Gio::Application::Flags::HANDLES_COMMAND_LINE is unset.
+ * Gio::APPLICATION_HANDLES_COMMAND_LINE is unset.
*
* If signal_handle_local_options() needs to see the list of
* filenames, then the use of G_OPTION_REMAINING as @a long_name is recommended.
* @param description The description for the option in `--help` output.
* @param arg_description The placeholder to use for the extra argument parsed
* by the option in `--help` output.
- * @param flags Flags from Glib::OptionEntry::Flags. Do not set OptionEntry::Flags::FILENAME.
+ * @param flags Flags from Glib::OptionEntry::Flags. Do not set FLAG_FILENAME.
* Character encoding is chosen with @a arg_type.
*/
void add_main_option_entry(OptionType arg_type, const Glib::ustring& long_name,
gchar short_name = '\0', const Glib::ustring& description = Glib::ustring(),
- const Glib::ustring& arg_description = Glib::ustring(),
- Glib::OptionEntry::Flags flags = Glib::OptionEntry::Flags::NONE);
- _IGNORE(g_application_add_main_option_entries, g_application_add_main_option)
+ const Glib::ustring& arg_description = Glib::ustring(), int flags = 0);
+ _IGNORE(g_application_add_main_option_entries)
+
+ //g_application_add_main_option() seems to be just a new convenience function,
+ //TODO: Use it for some of our add_main_option_entry(without slot) implementation.
+ _IGNORE(g_application_add_main_option)
/** Adds a main option entry to be handled by the Application.
*
* @newin{2,42}
*
* @see add_main_option_entry(OptionType, const Glib::ustring&,
- * gchar, const Glib::ustring&, const Glib::ustring&, Glib::OptionEntry::Flags)
+ * gchar, const Glib::ustring&, const Glib::ustring&, int)
*/
void add_main_option_entry(const Glib::OptionGroup::SlotOptionArgString& slot,
const Glib::ustring& long_name,
gchar short_name = '\0', const Glib::ustring& description = Glib::ustring(),
- const Glib::ustring& arg_description = Glib::ustring(),
- Glib::OptionEntry::Flags flags = Glib::OptionEntry::Flags::NONE);
+ const Glib::ustring& arg_description = Glib::ustring(), int flags = 0);
/** Adds a main option entry to be handled by the Application.
*
* @newin{2,42}
*
* @see add_main_option_entry(OptionType, const Glib::ustring&,
- * gchar, const Glib::ustring&, const Glib::ustring&, Glib::OptionEntry::Flags)
+ * gchar, const Glib::ustring&, const Glib::ustring&, int)
*/
void add_main_option_entry_filename(const Glib::OptionGroup::SlotOptionArgFilename& slot,
const Glib::ustring& long_name,
gchar short_name = '\0', const Glib::ustring& description = Glib::ustring(),
- const Glib::ustring& arg_description = Glib::ustring(),
- Glib::OptionEntry::Flags flags = Glib::OptionEntry::Flags::NONE);
+ const Glib::ustring& arg_description = Glib::ustring(), int flags = 0);
// _WRAP_METHOD(void add_option_group(Glib::OptionGroup& group), g_application_add_option_group)
// add_option_group() is probably not very useful. If implemented, it must probably
* opening files (eg: "view" vs "edit", etc).
*
* The application must be registered before calling this method
- * and it must have the Application::Flags::HANDLES_OPEN flag set.
+ * and it must have the APPLICATION_HANDLES_OPEN flag set.
*
* @param files The files to open. This must be non-empty.
* @param hint A hint.
* opening files (eg: "view" vs "edit", etc).
*
* The application must be registered before calling this method
- * and it must have the Application::Flags::HANDLES_OPEN flag set.
+ * and it must have the APPLICATION_HANDLES_OPEN flag set.
*
* @param file The file to open. This must be non-empty.
* @param hint A hint.
// _WRAP_METHOD(void bind_busy_property(const Glib::RefPtr<Glib::ObjectBase>& object, const Glib::ustring& property), g_application_bind_busy_property)
// _WRAP_METHOD(void unbind_busy_property(const Glib::RefPtr<Glib::ObjectBase>& object, const Glib::ustring& property), g_application_unbind_busy_property)
- _IGNORE_PROPERTY("action-group")
+ _WRAP_PROPERTY("action-group", Glib::RefPtr<ActionGroup>, deprecated "Use the Gio::ActionMap interface instead.")
_WRAP_PROPERTY("application-id", Glib::ustring)
- _WRAP_PROPERTY("flags", Flags)
+ _WRAP_PROPERTY("flags", ApplicationFlags)
_WRAP_PROPERTY("inactivity-timeout", guint)
_WRAP_PROPERTY("is-registered", bool)
_WRAP_PROPERTY("is-remote", bool)
- _WRAP_PROPERTY("resource-base-path", std::string, newin "2,44")
+
+ //TODO: Change bool to std::string when we can break API/ABI.
+ _WRAP_PROPERTY("resource-base-path", bool, newin "2,44",
+ deprecated "This method has the wrong return type. Will be fixed at the next ABI break. Use property_resource_base_path_string() instead.")
+
+ /** The base resource path for the application.
+ *
+ * @newin{2,56}
+ *
+ * Default value: ""
+ *
+ * @return A PropertyProxy that allows you to get or set the value of the property,
+ * or receive notification when the value of the property changes.
+ */
+ Glib::PropertyProxy< std::string > property_resource_base_path_string();
+
+ /** The base resource path for the application.
+ *
+ * @newin{2,56}
+ *
+ * Default value: ""
+ *
+ * @return A PropertyProxy_ReadOnly that allows you to get the value of the property,
+ * or receive notification when the value of the property changes.
+ */
+ Glib::PropertyProxy_ReadOnly< std::string > property_resource_base_path_string() const;
+
_WRAP_PROPERTY("is-busy", bool)
+//#m4 _CONVERSION(`const gchar*', `const Glib::ustring&', `Glib::ustring($3)')
+//#m4 _CONVERSION(`GVariant*', `const Glib::VariantBase&', `Glib::wrap($3, true)')
+
_WRAP_SIGNAL(void startup(), "startup")
- _WRAP_SIGNAL(void shutdown(), "shutdown", newin "2,46")
+ //TODO: Remove no_default_handler when we can break ABI
+ _WRAP_SIGNAL(void shutdown(), "shutdown", no_default_handler, newin "2,46")
_WRAP_SIGNAL(void activate(), "activate")
//We wrap the open signal without _WRAP_SIGNAL(), because we need to change its parameters.
//See bug https://bugzilla.gnome.org/show_bug.cgi?id=637457
- Glib::SignalProxy<void(const type_vec_files&, const Glib::ustring&)> signal_open();
+ Glib::SignalProxy< void, const type_vec_files&, const Glib::ustring& > signal_open();
_IGNORE_SIGNAL(open)
#m4 _CONVERSION(`GApplicationCommandLine*', `const Glib::RefPtr<ApplicationCommandLine>&',`Glib::wrap($3, true)')
_WRAP_SIGNAL(int command_line(const Glib::RefPtr<ApplicationCommandLine>& command_line), "command-line")
+ //TODO: Remove no_default_handler when we can break ABI
//TODO: Avoid the use of the Variants in the VariantDict?
//options must be non-const. The handler is meant to modify it. See the description
//of add_main_option_entry(OptionType, ...).
#m4 _CONVERSION(`GVariantDict*',`const Glib::RefPtr<Glib::VariantDict>&',`Glib::wrap($3, true)')
-#m4 _CONVERSION(`const Glib::RefPtr<Glib::VariantDict>&',`GVariantDict*',__CONVERT_REFPTR_TO_P)
- _WRAP_SIGNAL(int handle_local_options(const Glib::RefPtr<Glib::VariantDict>& options), "handle-local-options")
+ _WRAP_SIGNAL(int handle_local_options(const Glib::RefPtr<Glib::VariantDict>& options), "handle-local-options", no_default_handler)
+
+ //TODO: Remove no_default_handler when we can break ABI
+ _WRAP_SIGNAL(bool name_lost(), "name-lost", no_default_handler)
protected:
virtual void on_open(const type_vec_files& files, const Glib::ustring& hint);
_WRAP_VFUNC(bool local_command_line(char**& arguments, int& exit_status), local_command_line)
#m4 _CONVERSION(`GVariant*',`const Glib::VariantBase&',`Glib::wrap($3,true)')
+
_WRAP_VFUNC(void before_emit(const Glib::VariantBase& platform_data), "before_emit")
_WRAP_VFUNC(void after_emit(const Glib::VariantBase& platform_data), "after_emit")
_WRAP_VFUNC(void quit_mainloop(), "quit_mainloop")
_WRAP_VFUNC(void run_mainloop(), "run_mainloop")
-#m4 _CONVERSION(`GDBusConnection*', `const Glib::RefPtr<DBus::connection>&', `Glib::wrap($3, true)')
-#m4 _CONVERSION(`const Glib::RefPtr<DBus::Connection>&',`GDBusConnection*',__CONVERT_REFPTR_TO_P)
- _WRAP_VFUNC(bool dbus_register(const Glib::RefPtr<DBus::Connection>& connection, const Glib::ustring& object_path), "dbus_register", errthrow)
- _WRAP_VFUNC(void dbus_unregister(const Glib::RefPtr<DBus::Connection>& connection, const Glib::ustring& object_path), "dbus_unregister")
private:
- /** This is just a way to call Glib::init() before calling a Glib::Object ctor,
- * so that glibmm's GQuarks are created before they are used.
+ /** This is just a way to call Glib::init() (which calls g_type_init()) before
+ * calling application_class_.init(), so that
+ * g_application_get_type() will always succeed.
+ * See https://bugzilla.gnome.org/show_bug.cgi?id=639925
*/
const Glib::Class& custom_class_init();
- // Code, common to the public add_main_option_entry*() methods with a callback slot.
- void add_main_option_entry_private(const gchar* long_name, gchar short_name,
- const gchar* description, const gchar* arg_description,
- Glib::OptionEntry::Flags flags);
+ // Code, common to the public add_main_option_entry*() methods.
+ void add_main_option_entry_private(GOptionArg arg, const Glib::ustring& long_name,
+ gchar short_name, const Glib::ustring& description,
+ const Glib::ustring& arg_description, int flags);
};
} // namespace Gio
Glib::RefPtr<Glib::ObjectBase>
AsyncResult::get_source_object_base()
{
+ // Glib::wrap(cobj) can't be used here. See tests/giomm_asyncresult_sourceobject
+ // for a case where it would fail, and an explanation of why.
+ // In short, the source object is not necessarily a Glib::Object. It may be
+ // a Glib::Interface.
+
auto cobj = g_async_result_get_source_object(gobj());
auto cppobj = Glib::wrap_auto(cobj); // ObjectBase::_get_current_wrapper(cobj);
- return Glib::make_refptr_for_instance<Glib::ObjectBase>(
+ return Glib::RefPtr<Glib::ObjectBase>(
cppobj); // g_async_result_get_source_object() gives us a ref, unusually.
- // TODO: For some reason this fails: Glib::wrap(cobj);
}
Glib::RefPtr<const Glib::ObjectBase>
*
* @newin{2,16}
*/
-using SlotAsyncReady = sigc::slot<void(Glib::RefPtr<AsyncResult>&)>;
+using SlotAsyncReady = sigc::slot<void, Glib::RefPtr<AsyncResult>&>;
/** Provides a base class for implementing asynchronous function results.
* Asynchronous operations are broken up into two separate operations which are chained together by a SlotAsyncReady.
public:
_IGNORE(g_async_result_get_user_data)
- _IGNORE(g_async_result_get_source_object)
+
+ //Note that this returns a reference, unlike most GTK+ get_*() functions,
+ //so we don't need to use refreturn.
+ _WRAP_METHOD(Glib::RefPtr<Glib::Object> get_source_object(),
+ g_async_result_get_source_object, deprecated "Use get_source_object_base()")
+ _WRAP_METHOD(Glib::RefPtr<const Glib::Object> get_source_object() const,
+ g_async_result_get_source_object, constversion, deprecated "Use get_source_object_base()")
//Note that this returns a reference, unlike most GTK+ get_*() functions,
//so we don't need to use refreturn.
Glib::RefPtr<Glib::ObjectBase> get_source_object_base();
Glib::RefPtr<const Glib::ObjectBase> get_source_object_base() const;
- //TODO?: gboolean g_async_result_legacy_propagate_error (GAsyncResult *res, GError **error);
+ _IGNORE(g_async_result_legacy_propagate_error)dnl// Shall not be used in new code
_WRAP_METHOD(bool is_tagged(gpointer source_tag) const, g_async_result_is_tagged)
- // The compiler cannot find an unwrap() for ObjectBase, because
- // ObjectBase::BaseObjectType is not declared.
+
+ // TODO: For some reason, the compiler cannot find an unwrap() for ObjectBase.
//#m4 _CONVERSION(`Glib::RefPtr<Glib::ObjectBase>',`GObject*',__CONVERT_REFPTR_TO_P)
#m4 _CONVERSION(`Glib::RefPtr<Glib::ObjectBase>',`GObject*',`unwrap_objectbase_custom($3)')
- _WRAP_VFUNC(Glib::RefPtr<Glib::ObjectBase> get_source_object(), "get_source_object")
- _WRAP_VFUNC(bool is_tagged(gpointer source_tag), "is_tagged")
+ _WRAP_VFUNC(Glib::RefPtr<Glib::ObjectBase> get_source_object(),
+ "get_source_object")
+
+ //TODO: is_tagged() vfunc when we can break ABI.
};
} // namespace Gio
+
Glib::RefPtr<BufferedInputStream>
BufferedInputStream::create_sized(const Glib::RefPtr<InputStream>& base_stream, gsize buffer_size)
{
- return Glib::make_refptr_for_instance<Gio::BufferedInputStream>(new BufferedInputStream(base_stream, buffer_size));
+ return Glib::RefPtr<Gio::BufferedInputStream>(new BufferedInputStream(base_stream, buffer_size));
}
void
*/
#include <giomm/filterinputstream.h>
-#include <giomm/seekable.h>
#include <glibmm/object.h>
_DEFS(giomm,gio)
*
* @newin{2,16}
*/
-class BufferedInputStream : public Gio::FilterInputStream, public Gio::Seekable
+class BufferedInputStream : public Gio::FilterInputStream
{
_CLASS_GOBJECT(BufferedInputStream, GBufferedInputStream, G_BUFFERED_INPUT_STREAM, Gio::FilterInputStream, GFilterInputStream)
- _IMPLEMENTS_INTERFACE(Seekable)
-
protected:
_WRAP_CTOR(BufferedInputStream(const Glib::RefPtr<InputStream>& base_stream), g_buffered_input_stream_new)
_WRAP_PROPERTY("buffer-size", guint)
protected:
+ //TODO: When we can break ABI, add vfunc. See https://bugzilla.gnome.org/show_bug.cgi?id=572471
#m4 _CONVERSION(`GCancellable*', `const Glib::RefPtr<Cancellable>&', `Glib::wrap($3, true)')
- _WRAP_VFUNC(gssize fill(gssize count, const Glib::RefPtr<Cancellable>& cancellable), fill, errthrow, err_return_value -1)
+ //_WRAP_VFUNC(gssize fill(gssize count, const Glib::RefPtr<Cancellable>& cancellable), fill, errthrow, err_return_value -1)
};
} // namespace Gio
Glib::RefPtr<BufferedOutputStream>
BufferedOutputStream::create_sized(const Glib::RefPtr<OutputStream>& base_stream, gsize size)
{
- return Glib::make_refptr_for_instance<Gio::BufferedOutputStream>(new BufferedOutputStream(base_stream, size));
+ return Glib::RefPtr<Gio::BufferedOutputStream>(new BufferedOutputStream(base_stream, size));
}
} // namespace Gio
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2008 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
*/
#include <giomm/filteroutputstream.h>
-#include <giomm/seekable.h>
#include <glibmm/object.h>
_DEFS(giomm,gio)
*
* @newin{2,16}
*/
-class BufferedOutputStream : public Gio::FilterOutputStream, public Gio::Seekable
+class BufferedOutputStream : public Gio::FilterOutputStream
{
_CLASS_GOBJECT(BufferedOutputStream, GBufferedOutputStream, G_BUFFERED_OUTPUT_STREAM, Gio::FilterOutputStream, GFilterOutputStream)
- _IMPLEMENTS_INTERFACE(Seekable)
-
protected:
_WRAP_CTOR(BufferedOutputStream(const Glib::RefPtr<OutputStream>& base_stream), g_buffered_output_stream_new)
_CTOR_DEFAULT
public:
- using SlotCancelledCallback = sigc::slot<void()>;
+ using SlotCancelledCallback = sigc::slot<void>;
_WRAP_CREATE()
const Glib::ustring& to_charset, const Glib::ustring& from_charset)
: _CONSTRUCT("to-charset", to_charset.c_str(), "from-charset", from_charset.c_str())
{
- init();
}
} // namespace Gio
#include <glibmm/object.h>
#include <giomm/converter.h>
-#include <giomm/initable.h>
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
* CharsetConverter is an implementation of Converter based on GIConv.
* @newin{2,34}
*/
-class CharsetConverter
-: public Glib::Object, public Converter, public Initable
+class CharsetConverter : public Glib::Object, public Converter
{
_CLASS_GOBJECT(CharsetConverter, GCharsetConverter, G_CHARSET_CONVERTER, Glib::Object, GObject)
_IMPLEMENTS_INTERFACE(Converter)
- _IMPLEMENTS_INTERFACE(Initable)
protected:
- // Handwritten to ignore the final GError** parameter in the *_new() function.
- // But it can throw, due to its call to Initable::init().
+ // Handwritten to ignore the final GError** parameter in the *_new()
+ // function.
explicit CharsetConverter(const Glib::ustring& to_charset, const Glib::ustring& from_charset);
_IGNORE(g_charset_converter_new)
*
* @param to_charset Destination charset.
* @param from_charset Source charset.
- * @return A new CharsetConverter, or <tt>nullptr</tt> on error.
- * @throw Gio::Error
+ * @return A new CharsetConverter, or <tt>0</tt> on error.
*/
_WRAP_CREATE(const Glib::ustring& to_charset, const Glib::ustring& from_charset)
#include <gio/gio.h>
-using Flags = Gio::Converter::Flags;
-using Result = Gio::Converter::Result;
-
namespace Gio
{
namespace Gio
{
+_WRAP_ENUM(ConverterResult, GConverterResult)
+_WRAP_ENUM(ConverterFlags, GConverterFlags)
/** Converter - Data conversion interface.
* Converter is implemented by objects that convert binary data in various
_CLASS_INTERFACE(Converter, GConverter, G_CONVERTER, GConverterIface)
public:
- _WRAP_ENUM(Result, GConverterResult)
- _WRAP_ENUM(Flags, GConverterFlags)
-
- _WRAP_METHOD(Result convert(const void* inbuf, gsize inbuf_size, void* outbuf, gsize outbuf_size, Flags flags, gsize& bytes_read, gsize& bytes_written), g_converter_convert, errthrow)
+ _WRAP_METHOD(ConverterResult convert(const void* inbuf, gsize inbuf_size, void* outbuf, gsize outbuf_size, ConverterFlags flags, gsize& bytes_read, gsize& bytes_written), g_converter_convert, errthrow)
_WRAP_METHOD(void reset(), g_converter_reset)
#m4 _CONVERSION(`gsize*',`gsize&',`*($3)')
- _WRAP_VFUNC(Result convert(const void* inbuf, gsize inbuf_size, void* outbuf, gsize outbuf_size, Flags flags, gsize& bytes_read, gsize& bytes_written), "convert", errthrow)
+ _WRAP_VFUNC(ConverterResult convert(const void* inbuf, gsize inbuf_size, void* outbuf, gsize outbuf_size, ConverterFlags flags, gsize& bytes_read, gsize& bytes_written), "convert", errthrow)
_WRAP_VFUNC(void reset(), "reset")
};
namespace Gio
{
+_WRAP_ENUM(CredentialsType, GCredentialsType, NO_GTYPE)
/** An object containing credentials.
* The Credentials type is a reference-counted wrapper for native credentials.
_IGNORE(g_credentials_new)
public:
- _WRAP_ENUM(Type, GCredentialsType, NO_GTYPE)
-
_WRAP_CREATE()
_WRAP_METHOD(Glib::ustring to_string() const, g_credentials_to_string)
- _WRAP_METHOD(gpointer get_native(Type native_type), g_credentials_get_native)
- _WRAP_METHOD(void set_native(Type native_type, gpointer native), g_credentials_set_native)
- _WRAP_METHOD(bool is_same_user(const Glib::RefPtr<const Credentials>& other_credentials), g_credentials_is_same_user, errthrow "Gio::Error")
+ _WRAP_METHOD(gpointer get_native(CredentialsType native_type), g_credentials_get_native)
+ _WRAP_METHOD(void set_native(CredentialsType native_type, gpointer native), g_credentials_set_native)
+ _WRAP_METHOD(bool is_same_user(const Glib::RefPtr<const Credentials>& other_credentials), g_credentials_is_same_user, errthrow)
- _WRAP_METHOD(uid_t get_unix_user(), g_credentials_get_unix_user, errthrow "Gio::Error", ifdef G_OS_UNIX)
- _WRAP_METHOD(bool set_unix_user(uid_t uid), g_credentials_set_unix_user, errthrow "Gio::Error", ifdef G_OS_UNIX)
+ _WRAP_METHOD(uid_t get_unix_user(), g_credentials_get_unix_user, errthrow, ifdef G_OS_UNIX)
+ _WRAP_METHOD(bool set_unix_user(uid_t uid), g_credentials_set_unix_user, errthrow, ifdef G_OS_UNIX)
- _WRAP_METHOD(pid_t get_unix_pid() const, g_credentials_get_unix_pid, errthrow "Gio::Error", ifdef G_OS_UNIX)
+ _WRAP_METHOD(pid_t get_unix_pid() const, g_credentials_get_unix_pid, errthrow, ifdef G_OS_UNIX)
};
return retval;
}
+_DEPRECATE_IFDEF_START
+G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+bool
+DataInputStream::read_until(
+ std::string& data, const std::string& stop_chars, const Glib::RefPtr<Cancellable>& cancellable)
+{
+ GError* gerror = nullptr;
+ char* c_str = g_data_input_stream_read_until(gobj(), stop_chars.c_str(),
+ nullptr, // pass nullptr since we can easily determine the length from the returned std::string
+ Glib::unwrap(cancellable), &gerror);
+ if (gerror)
+ ::Glib::Error::throw_exception(gerror);
+ if (c_str)
+ {
+ data = c_str;
+ g_free(c_str);
+ return true;
+ }
+ // end of stream reached, return failure status
+ return false;
+}
+
+/** non-cancellable version of read_until()
+ */
+bool
+DataInputStream::read_until(std::string& data, const std::string& stop_chars)
+{
+ GError* gerror = nullptr;
+ char* c_str = g_data_input_stream_read_until(gobj(), stop_chars.c_str(),
+ nullptr, // pass nullptr since we can easily determine the length from the returned std::string
+ nullptr, &gerror);
+ if (gerror)
+ ::Glib::Error::throw_exception(gerror);
+ if (c_str)
+ {
+ data = c_str;
+ g_free(c_str);
+ return true;
+ }
+ // end of stream reached, return failure status
+ return false;
+}
+
+void
+DataInputStream::read_until_async(const std::string& stop_chars, const SlotAsyncReady& slot,
+ const Glib::RefPtr<Cancellable>& cancellable, int io_priority)
+{
+ // Create a copy of the slot.
+ // A pointer to it will be passed through the callback's data parameter
+ // and deleted in the callback.
+ auto slot_copy = new SlotAsyncReady(slot);
+
+ g_data_input_stream_read_until_async(gobj(), stop_chars.c_str(), io_priority,
+ Glib::unwrap(cancellable), &SignalProxy_async_callback, slot_copy);
+}
+
+bool
+DataInputStream::read_until_finish(const Glib::RefPtr<AsyncResult>& result, std::string& data)
+{
+ GError* gerror = nullptr;
+ gsize size = 0;
+ gchar* buffer =
+ g_data_input_stream_read_until_finish(gobj(), Glib::unwrap(result), &size, &(gerror));
+ if (gerror)
+ ::Glib::Error::throw_exception(gerror);
+
+ bool retval = false;
+ if (buffer && size)
+ {
+ retval = (buffer != nullptr);
+ data = std::string(buffer, size);
+ g_free(buffer);
+ }
+
+ return retval;
+}
+G_GNUC_END_IGNORE_DEPRECATIONS
+_DEPRECATE_IFDEF_END
+
bool
DataInputStream::read_upto(
std::string& data, const std::string& stop_chars, const Glib::RefPtr<Cancellable>& cancellable)
*/
_WRAP_METHOD(void read_line_finish_utf8(const Glib::RefPtr<AsyncResult>& result{.}, std::string& data{OUT}, gsize& length{.?}), g_data_input_stream_read_line_finish_utf8, errthrow)
+_DEPRECATE_IFDEF_START
+ /** Reads a string from the data input stream, up to the first
+ * occurrence of any of the stop characters.
+ *
+ * Note that, in contrast to read_until_async(),
+ * this function consumes the stop character that it finds.
+ *
+ * Don't use this function in new code. Its functionality is
+ * inconsistent with read_until_async(). Use
+ * read_upto() instead, but note that that method
+ * does not consume the stop character.
+ *
+ * @param[out] data A string to fill with the read data.
+ * @param stop_chars Characters to terminate the read.
+ * @param cancellable A cancellable object.
+ * @result true if the read succeeded without error.
+ *
+ * @deprecated Use read_upto() instead, which has more consistent behaviour regarding the stop character.
+ */
+ bool read_until(std::string& data, const std::string& stop_chars, const Glib::RefPtr<Cancellable>& cancellable);
+ _IGNORE(g_data_input_stream_read_until)
+
+ /** A non-cancellable version of read_until().
+ *
+ * Note that, in contrast to read_until_async(),
+ * this function consumes the stop character that it finds.
+ *
+ * Don't use this function in new code. Its functionality is
+ * inconsistent with read_until_async(). Use
+ * read_upto() instead, but note that that method
+ * does not consume the stop character.
+ *
+ * @param[out] data A string to fill with the read data.
+ * @param stop_chars Characters to terminate the read.
+ * @result true if the read succeeded without error.
+ *
+ * @deprecated Use read_upto() instead, which has more consistent behaviour regarding the stop character.
+ */
+ bool read_until(std::string& data, const std::string& stop_chars);
+
+ /** The asynchronous version of read_until(). It is
+ * an error to have two outstanding calls to this function.
+ *
+ * Note that, in contrast to read_until(),
+ * this function does not consume the stop character that it finds. You
+ * must read it for yourself.
+ *
+ * Don't use this function in new code. Its functionality is
+ * inconsistent with read_until(). Use read_upto_async() instead.
+ *
+ * @param stop_chars Characters to terminate the read.
+ * @param slot The slot to call when the request is satisfied.
+ * @param cancellable A cancellable object.
+ * @param io_priority The I/O priority of the request.
+ *
+ * @deprecated Use read_upto_async() instead, which has more consistent behaviour regarding the stop character.
+ */
+ void read_until_async(const std::string& stop_chars, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT);
+ _IGNORE(g_data_input_stream_read_until_async)
+
+ /** Finish an asynchronous call started by read_until_async().
+ *
+ * @param result The AsyncResult that was provided to the callback slot.
+ * @param[out] data A string to fill with the read data.
+ * @result true if the read succeeded without error.
+ *
+ * @deprecated Use read_upto_finish() instead, which has more consistent behaviour regarding the stop character.
+ */
+ bool read_until_finish(const Glib::RefPtr<AsyncResult>& result, std::string& data);
+ _IGNORE(g_data_input_stream_read_until_finish)
+_DEPRECATE_IFDEF_END
+
/** Reads a string from the data input stream, up to the first
* occurrence of any of the stop characters.
*
- * This method does <em>not</em> consume the stop character. You have
- * to use read_byte() to get it before calling %read_upto() again.
+ * In contrast to read_until(), this method
+ * does <em>not</em> consume the stop character. You have
+ * to use read_byte() to get it before calling
+ * read_upto() again.
*
* @param[out] data A string to fill with the read data.
* @param stop_chars Characters to terminate the read.
/** The asynchronous version of read_upto(). It is
* an error to have two outstanding calls to this function.
*
- * This method does <em>not</em> consume the stop character. You have
- * to use read_byte() to get it before calling %read_upto_async() again.
+ * In contrast to read_until(), this method
+ * does <em>not</em> consume the stop character. You have
+ * to use read_byte() to get it before calling
+ * read_upto() again.
*
* @param stop_chars Characters to terminate the read.
* @param slot The slot to call when the request is satisfied.
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <giomm/filteroutputstream.h>
-#include <giomm/seekable.h>
+#include <giomm/bufferedoutputstream.h>
#include <giomm/enums.h>
_DEFS(giomm,gio)
-_PINCLUDE(giomm/private/filteroutputstream_p.h)
+_PINCLUDE(giomm/private/bufferedoutputstream_p.h)
namespace Gio
{
/**
- * An implementation of FilterOutputStream that allows for high-level data
+ * An implementation of BufferedOutputStream that allows for high-level data
* manipulation of arbitrary data (including binary operations).
*
* @ingroup Streams
*
* @newin{2,16}
*/
-class DataOutputStream : public Gio::FilterOutputStream, public Gio::Seekable
+class DataOutputStream : public Gio::BufferedOutputStream
{
- _CLASS_GOBJECT(DataOutputStream, GDataOutputStream, G_DATA_OUTPUT_STREAM, Gio::FilterOutputStream, GFilterOutputStream)
- _IMPLEMENTS_INTERFACE(Seekable)
+ _CLASS_GOBJECT(DataOutputStream, GDataOutputStream, G_DATA_OUTPUT_STREAM, Gio::BufferedOutputStream, GBufferedOutputStream)
protected:
_WRAP_CTOR(DataOutputStream(const Glib::RefPtr<OutputStream>& base_stream), g_data_output_stream_new)
_WRAP_METHOD(bool put_uint64(guint64 data, const Glib::RefPtr<Cancellable>& cancellable{?}), g_data_output_stream_put_uint64, errthrow)
- _WRAP_METHOD(bool put_string(const std::string& str, const Glib::RefPtr<Cancellable>& cancellable{?}), g_data_output_stream_put_string, errthrow)
+ _WRAP_METHOD(bool put_string(std::string str, const Glib::RefPtr<Cancellable>& cancellable{?}), g_data_output_stream_put_string, errthrow)
_WRAP_PROPERTY("byte-order", DataStreamByteOrder)
};
} // namespace Gio
+
* @newin{2,32}
*/
class ActionGroup
-: public Glib::Object, public Gio::ActionGroup, public Gio::RemoteActionGroup
+: public Glib::Object, public ::Gio::ActionGroup, public RemoteActionGroup
{
_CLASS_GOBJECT(ActionGroup, GDBusActionGroup, G_DBUS_ACTION_GROUP, Glib::Object, GObject)
- _IMPLEMENTS_INTERFACE(Gio::ActionGroup)
- _IMPLEMENTS_INTERFACE(Gio::RemoteActionGroup)
+ _IMPLEMENTS_INTERFACE(::Gio::ActionGroup)
+ _IMPLEMENTS_INTERFACE(RemoteActionGroup)
protected:
_CTOR_DEFAULT
const Glib::RefPtr<AuthObserver>& observer, const Glib::RefPtr<Cancellable>& cancellable,
ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(stream, guid, observer, cancellable, flags));
+ return Glib::RefPtr<Connection>(new Connection(stream, guid, observer, cancellable, flags));
}
// static
Connection::create_sync(const Glib::RefPtr<IOStream>& stream, const std::string& guid,
const Glib::RefPtr<Cancellable>& cancellable, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(stream, guid, cancellable, flags));
+ return Glib::RefPtr<Connection>(new Connection(stream, guid, cancellable, flags));
}
// static
Connection::create_sync(const Glib::RefPtr<IOStream>& stream, const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(stream, guid, observer, flags));
+ return Glib::RefPtr<Connection>(new Connection(stream, guid, observer, flags));
}
// static
Connection::create_sync(
const Glib::RefPtr<IOStream>& stream, const std::string& guid, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(stream, guid, flags));
+ return Glib::RefPtr<Connection>(new Connection(stream, guid, flags));
}
// static
const Glib::RefPtr<AuthObserver>& observer, const Glib::RefPtr<Cancellable>& cancellable,
ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(address, observer, cancellable, flags));
+ return Glib::RefPtr<Connection>(new Connection(address, observer, cancellable, flags));
}
// static
Connection::create_for_address_sync(
const std::string& address, const Glib::RefPtr<Cancellable>& cancellable, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(address, cancellable, flags));
+ return Glib::RefPtr<Connection>(new Connection(address, cancellable, flags));
}
// static
Connection::create_for_address_sync(
const std::string& address, const Glib::RefPtr<AuthObserver>& observer, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(address, observer, flags));
+ return Glib::RefPtr<Connection>(new Connection(address, observer, flags));
}
// static
Glib::RefPtr<Connection>
Connection::create_for_address_sync(const std::string& address, ConnectionFlags flags)
{
- return Glib::make_refptr_for_instance<Connection>(new Connection(address, flags));
+ return Glib::RefPtr<Connection>(new Connection(address, flags));
}
// static
{
_WRAP_ENUM(BusType, GBusType)
-_WRAP_ENUM(CallFlags, GDBusCallFlags, NO_GTYPE)
-_WRAP_ENUM(ConnectionFlags, GDBusConnectionFlags, NO_GTYPE)
-_WRAP_ENUM(SendMessageFlags, GDBusSendMessageFlags, NO_GTYPE)
-_WRAP_ENUM(SignalFlags, GDBusSignalFlags, NO_GTYPE)
-_WRAP_ENUM(SubtreeFlags, GDBusSubtreeFlags, NO_GTYPE)
+_WRAP_ENUM(CallFlags, GDBusCallFlags, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(ConnectionFlags, GDBusConnectionFlags, s#^DBUS_##, gtype_func g_dbus_connection_flags_get_type)
+_WRAP_ENUM(SendMessageFlags, GDBusSendMessageFlags, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(SignalFlags, GDBusSignalFlags, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(SubtreeFlags, GDBusSubtreeFlags, s#^DBUS_##, NO_GTYPE)
_GMMPROC_EXTRA_NAMESPACE(DBus)
* Glib::ustring& signal_name, const Glib::VariantContainerBase& parameters);.
* @endcode
*/
- using SlotSignal = sigc::slot<void(const Glib::RefPtr<Connection>&,
+ using SlotSignal = sigc::slot<void, const Glib::RefPtr<Connection>&,
const Glib::ustring&, const Glib::ustring&, const Glib::ustring&,
- const Glib::ustring&, const Glib::VariantContainerBase&)>;
+ const Glib::ustring&, const Glib::VariantContainerBase&>;
/** Signature for slot used in add_filter().
* For example,
* drop a message can simply return <tt>0</tt>. And filter function may
* modify a message by copying it and return the copy.
*/
- using SlotMessageFilter = sigc::slot<Glib::RefPtr<Message>(
+ using SlotMessageFilter = sigc::slot<Glib::RefPtr<Message>,
const Glib::RefPtr<Connection>&,
- const Glib::RefPtr<Message>&, bool)>;
+ const Glib::RefPtr<Message>&, bool>;
/** Asynchronously connects to the message bus specified by @a bus_type.
*
*/
static void get(BusType bus_type, const SlotAsyncReady& slot);
+ _WRAP_METHOD_DOCS_ONLY( g_bus_get_finish, errthrow)
+ /// @throw Glib::Error.
_WRAP_METHOD(static Glib::RefPtr<Connection> get_finish(const Glib::RefPtr<AsyncResult>& res), g_bus_get_finish, errthrow)
_WRAP_METHOD(static Glib::RefPtr<Connection> get_sync(BusType bus_type, const Glib::RefPtr<Cancellable>& cancellable{?}), g_bus_get_sync, errthrow)
const Glib::RefPtr<AuthObserver>& observer,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new)
static void create(const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create().
static void create(const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
const SlotAsyncReady& slot,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create().
static void create(const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const SlotAsyncReady& slot,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_finish)
+ /// @throw Glib::Error.
_WRAP_METHOD(static Glib::RefPtr<Connection> create_finish(const Glib::RefPtr<AsyncResult>& res), g_dbus_connection_new_finish, errthrow)
_WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address)
const Glib::RefPtr<AuthObserver>& observer,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address)
static void create_for_address(const std::string& address,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_for_address().
static void create_for_address(const std::string& address,
const Glib::RefPtr<AuthObserver>& observer,
const SlotAsyncReady& slot,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_for_address().
static void create_for_address(const std::string& address,
const SlotAsyncReady& slot,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address_finish)
+ /// @throw Glib::Error.
_WRAP_METHOD(static Glib::RefPtr<Connection> create_for_address_finish(const Glib::RefPtr<AsyncResult>& res), g_dbus_connection_new_for_address_finish, errthrow)
- _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_sync, errthrow)
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_sync)
+ /// @throw Glib::Error.
static Glib::RefPtr<Connection> create_sync(
const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
- _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_sync, errthrow)
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_sync)
+ /// @throw Glib::Error.
static Glib::RefPtr<Connection> create_sync(
const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<Connection> create_sync(
const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<Connection> create_sync(
const Glib::RefPtr<IOStream>& stream,
const std::string& guid,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
- _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address_sync, errthrow)
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address_sync)
+ /// @throw Glib::Error.
static Glib::RefPtr<Connection> create_for_address_sync(
const std::string& address,
const Glib::RefPtr<AuthObserver>& observer,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
- _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address_sync, errthrow)
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_new_for_address_sync)
+ /// @throw Glib::Error.
static Glib::RefPtr<Connection> create_for_address_sync(
const std::string& address,
const Glib::RefPtr<Cancellable>& cancellable,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_for_address_sync().
static Glib::RefPtr<Connection> create_for_address_sync(
const std::string& address,
const Glib::RefPtr<AuthObserver>& observer,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/// Non-cancellable version of create_for_address_sync().
static Glib::RefPtr<Connection> create_for_address_sync(
const std::string& address,
- ConnectionFlags flags = Gio::DBus::ConnectionFlags::NONE);
+ ConnectionFlags flags = Gio::DBus::CONNECTION_FLAGS_NONE);
/** Closes the connection. Note that this never causes the process to exit
* (this might only happen if the other end of a shared message bus
/// A send_message() without an "out_serial" parameter.
bool send_message(const Glib::RefPtr<Message>& message,
- SendMessageFlags flags = Gio::DBus::SendMessageFlags::NONE);
+ SendMessageFlags flags = Gio::DBus::SEND_MESSAGE_FLAGS_NONE);
/** Asynchronously sends message to the peer represented by the connection.
*
- * Unless flags contain the Gio::DBus::SendMessageFlags::PRESERVE_SERIAL
+ * Unless flags contain the Gio::DBus::SEND_MESSAGE_FLAGS_PRESERVE_SERIAL
* flag, the serial number will be assigned by the connection and set on
* message via Gio::DBus::Message::set_serial().
*
* send_message_with_reply_sync() for the synchronous version.
*
* Note that message must be unlocked, unless flags contain the
- * Gio::DBus::SendMessageFlags::PRESERVE_SERIAL flag.
+ * Gio::DBus::SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
*
* See the C API docs for examples.
*
int timeout_msec,
const SlotAsyncReady& slot);
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_connection_send_message_with_reply_finish)
+ /// @throw Glib::Error.
_WRAP_METHOD(Glib::RefPtr<Message> send_message_with_reply_finish(const Glib::RefPtr<AsyncResult>& res), g_dbus_connection_send_message_with_reply_finish, errthrow)
/** Synchronously sends @a message to the peer represented by the connection
* reached. See send_message_with_reply() for the asynchronous version of
* this method.
*
- * Unless flags contain the Gio::DBus::SendMessageFlags::PRESERVE_SERIAL
+ * Unless flags contain the Gio::DBus::SEND_MESSAGE_FLAGS_PRESERVE_SERIAL
* flag, the serial number will be assigned by the connection and set on
* message via Gio::DBus::Message::set_serial().
*
* See the C API docs for examples.
*
* Note that message must be unlocked, unless flags contain the
- * Gio::DBus::SendMessageFlags::PRESERVE_SERIAL flag.
+ * Gio::DBus::SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
*
* @param message A Message.
* @param cancellable A Cancellable.
_WRAP_METHOD(Glib::ustring get_unique_name() const, g_dbus_connection_get_unique_name)
_WRAP_METHOD(CapabilityFlags get_capabilities() const, g_dbus_connection_get_capabilities)
+ _WRAP_METHOD(ConnectionFlags get_flags() const, g_dbus_connection_get_flags, newin "2,60")
_WRAP_METHOD(Glib::RefPtr<Credentials> get_peer_credentials(), g_dbus_connection_get_peer_credentials, refreturn)
_WRAP_METHOD(Glib::RefPtr<const Credentials> get_peer_credentials() const, g_dbus_connection_get_peer_credentials, refreturn, constversion)
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
_IGNORE(g_dbus_connection_call)
const SlotAsyncReady& slot,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
/** Finishes an operation started with call().
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
_IGNORE(g_dbus_connection_call_sync)
const Glib::VariantContainerBase& parameters,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
#ifdef G_OS_UNIX
const Glib::RefPtr<UnixFDList>& fd_list,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
_IGNORE(g_dbus_connection_call_with_unix_fd_list)
const Glib::RefPtr<UnixFDList>& fd_list,
const Glib::ustring& bus_name = Glib::ustring(),
int timeout_msec = -1,
- CallFlags flags = Gio::DBus::CallFlags::NONE,
+ CallFlags flags = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type = Glib::VariantType());
#endif // G_OS_UNIX
Glib::RefPtr<UnixFDList>& out_fd_list{.>>},
const Glib::ustring& bus_name{.NULL} = Glib::ustring(),
int timeout_msec{.} = -1,
- CallFlags flags{.} = Gio::DBus::CallFlags::NONE,
+ CallFlags flags{.} = Gio::DBus::CALL_FLAGS_NONE,
const Glib::VariantType& reply_type{.} = Glib::VariantType()
),
g_dbus_connection_call_with_unix_fd_list_sync, errthrow, ifdef G_OS_UNIX
const Glib::ustring& member = Glib::ustring(),
const Glib::ustring& object_path = Glib::ustring(),
const Glib::ustring& arg0 = Glib::ustring(),
- SignalFlags flags = Gio::DBus::SignalFlags::NONE);
+ SignalFlags flags = Gio::DBus::SIGNAL_FLAGS_NONE);
_IGNORE(g_dbus_connection_signal_subscribe)
_WRAP_METHOD(void signal_unsubscribe(guint subscription_id), g_dbus_connection_signal_unsubscribe)
*
* When handling remote calls into any node in the subtree, first the
* enumerate slot is used to check if the node exists. If the node
- * exists or the Gio::DBus::SubtreeFlags::DISPATCH_TO_UNENUMERATED_NODES flag
+ * exists or the Gio::DBus::SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag
* is set the introspection slot is used to check if the node supports the
* requested method. If so, the dispatch function is used to determine where
* to dispatch the call. The collected InterfaceVTable will be used to
*/
guint register_subtree(const Glib::ustring& object_path,
const SubtreeVTable& vtable,
- SubtreeFlags flags = Gio::DBus::SubtreeFlags::NONE);
+ SubtreeFlags flags = Gio::DBus::SUBTREE_FLAGS_NONE);
_IGNORE(g_dbus_connection_register_subtree)
_WRAP_METHOD(bool unregister_subtree(guint registration_id), g_dbus_connection_unregister_subtree)
_WRAP_PROPERTY("capabilities", CapabilityFlags)
_WRAP_PROPERTY("closed", bool)
_WRAP_PROPERTY("exit-on-close", bool)
- //_WRAP_PROPERTY("flags", ConnectionFlags) // write-only construct-only
+ _WRAP_PROPERTY("flags", ConnectionFlags, newin "2,60")
_WRAP_PROPERTY("guid", std::string)
_WRAP_PROPERTY("stream", Glib::RefPtr<IOStream>)
_WRAP_PROPERTY("unique-name", Glib::ustring)
_GMMPROC_EXTRA_NAMESPACE(DBus)
+//TODO: Have Proxy derive from this interface when there is an ABI break.
+
/** Interface - Base type for D-Bus interfaces.
* The Interface type is the base type for D-Bus interfaces both on the service
* side (see InterfaceSkeleton) and client side (see Proxy).
#include <giomm/dbusconnection.h>
#include <giomm/dbusintrospection.h>
#include <giomm/dbusmethodinvocation.h>
-
-using Flags = Gio::DBus::InterfaceSkeleton::Flags;
namespace DBus
{
+_WRAP_ENUM(InterfaceSkeletonFlags, GDBusInterfaceSkeletonFlags, gtype_func g_dbus_interface_skeleton_flags_get_type)
+
class InterfaceInfo;
class Connection;
class MethodInvocation;
_IMPLEMENTS_INTERFACE(Interface)
public:
- _WRAP_ENUM(Flags, GDBusInterfaceSkeletonFlags, NO_GTYPE)
-
_WRAP_METHOD(void flush(), g_dbus_interface_skeleton_flush)
_WRAP_METHOD(Glib::RefPtr<InterfaceInfo> get_info(), g_dbus_interface_skeleton_get_info)
_WRAP_METHOD(Glib::ustring get_object_path() const, g_dbus_interface_skeleton_get_object_path)
- _WRAP_METHOD(Flags get_flags() const, g_dbus_interface_skeleton_get_flags)
- _WRAP_METHOD(void set_flags(Flags flags), g_dbus_interface_skeleton_set_flags)
+ _WRAP_METHOD(InterfaceSkeletonFlags get_flags() const, g_dbus_interface_skeleton_get_flags)
+ _WRAP_METHOD(void set_flags(InterfaceSkeletonFlags flags), g_dbus_interface_skeleton_set_flags)
- _WRAP_PROPERTY("g-flags", Flags)
+ _WRAP_PROPERTY("g-flags", InterfaceSkeletonFlags)
#m4 _CONVERSION(`GDBusMethodInvocation*',`const Glib::RefPtr<MethodInvocation>&',`Glib::wrap($3, true)')
_WRAP_SIGNAL(bool authorize_method(const Glib::RefPtr<MethodInvocation>& invocation), "g_authorize_method")
* @endcode
*/
using SlotInterfaceMethodCall = sigc::slot<
- void(
+ void,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::VariantContainerBase&,
- const Glib::RefPtr<MethodInvocation>&)
+ const Glib::RefPtr<MethodInvocation>&
>;
/** The type for a slot which handles getting a property for a D-Bus
* @throw Glib::Error.
*/
using SlotInterfaceGetProperty = sigc::slot<
- void(
+ void,
Glib::VariantBase&,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
- const Glib::ustring&)
+ const Glib::ustring&
>;
/** The type for a slot which handles setting a property for a D-Bus
* @throw Glib::Error.
*/
using SlotInterfaceSetProperty = sigc::slot<
- bool(
+ bool,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
- const Glib::VariantBase&)
+ const Glib::VariantBase&
>;
/** Constructs a new InterfaceVTable using the specified slots.
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <glibmm/refptr.h>
#include <gio/gio.h>
-#include <vector>
+#include <glibmm/arrayhandle.h>
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
namespace DBus
{
-_WRAP_ENUM(PropertyInfoFlags, GDBusPropertyInfoFlags, NO_GTYPE)
+_WRAP_ENUM(PropertyInfoFlags, GDBusPropertyInfoFlags, s#^DBUS_##, NO_GTYPE)
/** Stores information about an annotation.
*
_IGNORE(g_dbus_annotation_info_ref, g_dbus_annotation_info_unref)
public:
-#m4 _CONVERSION(`const std::vector<Glib::RefPtr<AnnotationInfo>>&', `GDBusAnnotationInfo**',`Glib::ArrayHandler<Glib::RefPtr<AnnotationInfo>>::vector_to_array($3).data()')
- _WRAP_METHOD(static Glib::ustring info_lookup(const std::vector<Glib::RefPtr<AnnotationInfo>>& annotations, const Glib::ustring& name), g_dbus_annotation_info_lookup)
+#m4 _CONVERSION(`const Glib::ArrayHandle< Glib::RefPtr<AnnotationInfo> >&', `GDBusAnnotationInfo**', `const_cast<GDBusAnnotationInfo**>($3.data())')
+ _WRAP_METHOD(static Glib::ustring info_lookup(const Glib::ArrayHandle< Glib::RefPtr<AnnotationInfo> >& annotations, const Glib::ustring& name), g_dbus_annotation_info_lookup)
};
/** ArgInfo - Stores information about an argument for a method or a
class InterfaceInfo final
{
_CLASS_OPAQUE_REFCOUNTED(InterfaceInfo, GDBusInterfaceInfo, NONE, g_dbus_interface_info_ref, g_dbus_interface_info_unref)
+ _IS_REFCOUNTED_BOXEDTYPE(g_dbus_interface_info_get_type)
_IGNORE(g_dbus_interface_info_ref, g_dbus_interface_info_unref)
public:
_IGNORE(g_dbus_node_info_ref, g_dbus_node_info_unref)
public:
- _WRAP_METHOD(static Glib::RefPtr<NodeInfo> create_for_xml(const Glib::ustring& xml_data), g_dbus_node_info_new_for_xml, errthrow "Glib::MarkupError")
+ _WRAP_METHOD_DOCS_ONLY(g_dbus_node_info_new_for_xml)
+ /// @throw Glib::Error.
+ _WRAP_METHOD(static Glib::RefPtr<NodeInfo> create_for_xml(const Glib::ustring& xml_data), g_dbus_node_info_new_for_xml, errthrow)
_WRAP_METHOD(Glib::RefPtr<InterfaceInfo> lookup_interface(const Glib::ustring& name), g_dbus_node_info_lookup_interface, refreturn)
_WRAP_METHOD(Glib::RefPtr<const InterfaceInfo> lookup_interface(const Glib::ustring& name) const, g_dbus_node_info_lookup_interface, constversion, refreturn)
namespace DBus
{
-_WRAP_ENUM(MessageType, GDBusMessageType, NO_GTYPE)
-_WRAP_ENUM(MessageFlags, GDBusMessageFlags, NO_GTYPE)
-_WRAP_ENUM(MessageHeaderField, GDBusMessageHeaderField, NO_GTYPE)
-_WRAP_ENUM(CapabilityFlags, GDBusCapabilityFlags, NO_GTYPE)
+_WRAP_ENUM(MessageType, GDBusMessageType, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(MessageFlags, GDBusMessageFlags, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(MessageHeaderField, GDBusMessageHeaderField, s#^DBUS_##, NO_GTYPE)
+_WRAP_ENUM(CapabilityFlags, GDBusCapabilityFlags, s#^DBUS_##, gtype_func g_dbus_capability_flags_get_type)
_GMMPROC_EXTRA_NAMESPACE(DBus)
// Ignore variable argument functions.
_IGNORE(g_dbus_message_new_method_error, g_dbus_message_new_method_error_valist)
- _WRAP_METHOD(static Glib::RefPtr<Message> create_from_blob(const guchar* blob, gsize blob_len, CapabilityFlags capabilities = CapabilityFlags::NONE), g_dbus_message_new_from_blob, errthrow "Gio::Error")
+ _WRAP_METHOD(static Glib::RefPtr<Message> create_from_blob(const guchar* blob, gsize blob_len, CapabilityFlags capabilities = CAPABILITY_FLAGS_NONE), g_dbus_message_new_from_blob, errthrow)
_WRAP_METHOD(Glib::ustring print(guint indent), g_dbus_message_print)
_WRAP_METHOD(bool get_locked() const, g_dbus_message_get_locked)
_WRAP_METHOD(void lock() ,g_dbus_message_lock)
- _WRAP_METHOD(Glib::RefPtr<Message> copy() const, g_dbus_message_copy, errthrow "Gio::Error")
+ _WRAP_METHOD(Glib::RefPtr<Message> copy() const, g_dbus_message_copy, errthrow)
_WRAP_METHOD(MessageType get_message_type() const, g_dbus_message_get_message_type)
_WRAP_METHOD(void set_message_type(MessageType type), g_dbus_message_set_message_type)
- // BIG_ENDIAN and LITTLE_ENDIAN are defined as preprocessor macros somewhere.
- _WRAP_ENUM(ByteOrder, GDBusMessageByteOrder, NO_GTYPE, s#ENDIAN$#ENDIAN_ORDER#)
+ //gmmproc can't handle the character literals, and this won't be expanded in future,
+ //so we just wrap it by hand.
+ enum ByteOrder
+ {
+ BYTE_ORDER_BIG_ENDIAN = 'B',
+ BYTE_ORDER_LITTLE_ENDIAN = 'l'
+ };
+
+ #m4 _CONVERSION(`ByteOrder',`GDBusMessageByteOrder',`(GDBusMessageByteOrder)($3)')
+ #m4 _CONVERSION(`GDBusMessageByteOrder',`ByteOrder',`(ByteOrder)($3)')
_WRAP_METHOD(ByteOrder get_byte_order() const, g_dbus_message_get_byte_order)
_WRAP_METHOD(void set_byte_order(ByteOrder byte_order), g_dbus_message_set_byte_order)
_WRAP_METHOD(void set_header(MessageHeaderField header_field, const Glib::VariantBase& value), g_dbus_message_set_header)
- #m4 _CONVERSION(`guchar*',`std::vector<guchar>',`Glib::ArrayHandler<guchar>::array_to_vector($3, Glib::OWNERSHIP_SHALLOW)')
- _WRAP_METHOD(std::vector<guchar> get_header_fields() const, g_dbus_message_get_header_fields)
+ #m4 _CONVERSION(`guchar*',`Glib::ArrayHandle<guchar>',`Glib::ArrayHandle<guchar>($3)')
+ _WRAP_METHOD(Glib::ArrayHandle<guchar> get_header_fields() const, g_dbus_message_get_header_fields)
_WRAP_METHOD(Glib::ustring get_destination() const, g_dbus_message_get_destination)
_WRAP_METHOD(void set_destination(const Glib::ustring& value), g_dbus_message_set_destination)
_WRAP_METHOD(Glib::ustring get_arg0() const, g_dbus_message_get_arg0)
- _WRAP_METHOD(static gssize bytes_needed(const guchar* blob, gsize blob_len), g_dbus_message_bytes_needed, errthrow "Gio::Error")
+ _WRAP_METHOD(static gssize bytes_needed(const guchar* blob, gsize blob_len), g_dbus_message_bytes_needed, errthrow)
- _WRAP_METHOD(guchar* to_blob(gsize& out_size, CapabilityFlags capabilities = CapabilityFlags::NONE), g_dbus_message_to_blob, errthrow "Gio::Error")
+ _WRAP_METHOD(guchar* to_blob(gsize& out_size, CapabilityFlags capabilities = CAPABILITY_FLAGS_NONE), g_dbus_message_to_blob, errthrow)
_WRAP_METHOD(void to_exception(), g_dbus_message_to_gerror, errthrow)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2010 The giomm Development Team
*
* This library is free software; you can redistribute it and/or
namespace DBus
{
-_WRAP_ENUM(BusNameOwnerFlags, GBusNameOwnerFlags)
+_WRAP_ENUM(BusNameOwnerFlags, GBusNameOwnerFlags, s#^DBUS_##)
/** For example,
* void on_bus_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection,
* @newin{2,28}
* @ingroup DBus
*/
-using SlotBusAcquired = sigc::slot<void(const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring)>;
+using SlotBusAcquired = sigc::slot<void, const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring>;
/** For example,
* void on_name_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection,
* const Glib::ustring& name);
* @ingroup DBus
*/
-using SlotNameAcquired = sigc::slot<void(const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring)>;
+using SlotNameAcquired = sigc::slot<void, const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring>;
/** For example,
* void on_name_lost(const Glib::RefPtr<Gio::DBus::Connection>& connection,
* const Glib::ustring& name);
* @ingroup DBus
*/
-using SlotNameLost = sigc::slot<void(const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring)>;
+using SlotNameLost = sigc::slot<void, const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring>;
//TODO: See https://bugzilla.gnome.org/show_bug.cgi?id=646427 about the apparent uselessness of SlotNameAcquired.
//TODO: Add example from C API in class docs.
const SlotBusAcquired& bus_acquired_slot = SlotBusAcquired(),
const SlotNameAcquired& name_acquired_slot = SlotNameAcquired(),
const SlotNameLost& name_lost_slot = SlotNameLost(),
- BusNameOwnerFlags flags = Gio::DBus::BusNameOwnerFlags::NONE
+ BusNameOwnerFlags flags = Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE
);
_IGNORE(g_bus_own_name)
const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<InterfaceInfo>& info,
ProxyFlags flags)
{
- return Glib::
make_refptr_for_instance<Proxy>(
+ return Glib::
RefPtr<Proxy>(
new Proxy(connection, name, object_path, interface_name, cancellable, info, flags));
}
const Glib::ustring& object_path, const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info, ProxyFlags flags)
{
- return Glib::
make_refptr_for_instance<Proxy>(new Proxy(connection, name, object_path, interface_name, info, flags));
+ return Glib::
RefPtr<Proxy>(new Proxy(connection, name, object_path, interface_name, info, flags));
}
void
const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<InterfaceInfo>& info,
ProxyFlags flags)
{
- return Glib::
make_refptr_for_instance<Proxy>(
+ return Glib::
RefPtr<Proxy>(
new Proxy(bus_type, name, object_path, interface_name, cancellable, info, flags));
}
const Glib::ustring& object_path, const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info, ProxyFlags flags)
{
- return Glib::
make_refptr_for_instance<Proxy>(new Proxy(bus_type, name, object_path, interface_name, info, flags));
+ return Glib::
RefPtr<Proxy>(new Proxy(bus_type, name, object_path, interface_name, info, flags));
}
void
#include <glibmm/object.h>
#include <giomm/asyncresult.h>
#include <giomm/dbusintrospection.h>
-#include <giomm/dbusinterface.h>
#include <giomm/initable.h>
#include <giomm/asyncinitable.h>
#include <giomm/dbusconnection.h>
//The GMMPROC_EXTRA_NAMESPACE() macro is a hint to generate_wrap_init.pl to put it in the DBus sub-namespace
_GMMPROC_EXTRA_NAMESPACE(DBus)
-_WRAP_ENUM(ProxyFlags, GDBusProxyFlags, NO_GTYPE)
+_WRAP_ENUM(ProxyFlags, GDBusProxyFlags, s#^DBUS_##, gtype_func g_dbus_proxy_flags_get_type)
/** A client-side proxy.
* This is a base class used for proxies to access a D-Bus interface on
class Proxy
: public Glib::Object,
public Initable,
- public AsyncInitable,
- public Interface
+ public AsyncInitable
{
_CLASS_GOBJECT(Proxy, GDBusProxy, G_DBUS_PROXY, Glib::Object, GObject)
_IMPLEMENTS_INTERFACE(Initable)
_IMPLEMENTS_INTERFACE(AsyncInitable)
- _IMPLEMENTS_INTERFACE(DBus::Interface)
protected:
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(const Glib::RefPtr<Connection>& connection,
const Glib::ustring& name,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(const Glib::RefPtr<Connection>& connection,
const Glib::ustring& name,
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(const Glib::RefPtr<Connection>& connection,
const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(BusType bus_type,
const Glib::ustring& name,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(BusType bus_type,
const Glib::ustring& name,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(BusType bus_type,
const Glib::ustring& name,
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
Proxy(BusType bus_type,
const Glib::ustring& name,
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
public:
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
/// Non-cancellable version of create().
static void create(const Glib::RefPtr<Connection>& connection,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_proxy_new_finish)
/// @throw Glib::Error.
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<Proxy>
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_proxy_new_for_bus)
static void create_for_bus(BusType bus_type,
const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
/// Non-cancellable version of create_for_bus().
static void create_for_bus(BusType bus_type,
const Glib::ustring& interface_name,
const SlotAsyncReady& slot,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_proxy_new_for_bus_finish)
/// @throw Glib::Error.
const Glib::ustring& interface_name,
const Glib::RefPtr<Cancellable>& cancellable,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
/// Non-cancellable version of create_for_bus_sync().
static Glib::RefPtr<Proxy>
const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::RefPtr<InterfaceInfo>& info = Glib::RefPtr<InterfaceInfo>(),
- ProxyFlags flags = ProxyFlags::NONE);
+ ProxyFlags flags = PROXY_FLAGS_NONE);
_WRAP_METHOD(ProxyFlags get_flags() const, g_dbus_proxy_get_flags)
_WRAP_METHOD(void set_cached_property(const Glib::ustring& property_name, const Glib::VariantBase& value), g_dbus_proxy_set_cached_property)
-#m4 _CONVERSION(`gchar**', `std::vector<Glib::ustring>', `Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> get_cached_property_names() const, g_dbus_proxy_get_cached_property_names)
+#m4 _CONVERSION(`gchar**', `Glib::StringArrayHandle', `Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle get_cached_property_names() const, g_dbus_proxy_get_cached_property_names)
_WRAP_METHOD(void set_interface_info(const Glib::RefPtr<InterfaceInfo>& info), g_dbus_proxy_set_interface_info)
_WRAP_METHOD(Glib::RefPtr<InterfaceInfo> get_interface_info(), g_dbus_proxy_get_interface_info)
const Glib::RefPtr<Cancellable>& cancellable{.?},
const Glib::VariantContainerBase& parameters{.} = Glib::VariantContainerBase(),
int timeout_msec{.} = -1,
- CallFlags flags{.} = Gio::DBus::CallFlags::NONE
+ CallFlags flags{.} = Gio::DBus::CALL_FLAGS_NONE
),
g_dbus_proxy_call, slot_name slot, slot_callback SignalProxy_async_callback
)
const Glib::RefPtr<Cancellable>& cancellable{.?},
const Glib::VariantContainerBase& parameters{.} = Glib::VariantContainerBase(),
int timeout_msec{.} = -1,
- CallFlags flags{.} = Gio::DBus::CallFlags::NONE
+ CallFlags flags{.} = Gio::DBus::CALL_FLAGS_NONE
),
g_dbus_proxy_call_sync, errthrow
)
const Glib::RefPtr<Cancellable>& cancellable{.?},
const Glib::RefPtr<UnixFDList>& fd_list{.},
int timeout_msec{.} = -1,
- CallFlags flags{.} = Gio::DBus::CallFlags::NONE
+ CallFlags flags{.} = Gio::DBus::CALL_FLAGS_NONE
),
g_dbus_proxy_call_with_unix_fd_list, ifdef G_OS_UNIX,
slot_name slot, slot_callback SignalProxy_async_callback
const Glib::RefPtr<UnixFDList>& fd_list{.},
Glib::RefPtr<UnixFDList>& out_fd_list{.>>},
int timeout_msec{.} = -1,
- CallFlags flags{.} = Gio::DBus::CallFlags::NONE
+ CallFlags flags{.} = Gio::DBus::CALL_FLAGS_NONE
),
g_dbus_proxy_call_with_unix_fd_list_sync, errthrow, ifdef G_OS_UNIX
)
#include <giomm/dbusconnection.h>
#include <giomm/dbusauthobserver.h>
-using Flags = Gio::DBus::Server::Flags;
-
namespace Gio
{
Server::Server(const std::string& address, const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer, const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags)
+ ServerFlags flags)
: _CONSTRUCT("address", Glib::c_str_or_nullptr(address), "flags",
static_cast<GDBusServerFlags>(flags), "guid", Glib::c_str_or_nullptr(guid),
"authentication-observer", Glib::unwrap(observer))
}
Server::Server(const std::string& address, const std::string& guid,
- const Glib::RefPtr<Cancellable>& cancellable, Flags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, ServerFlags flags)
: _CONSTRUCT("address", Glib::c_str_or_nullptr(address), "flags",
static_cast<GDBusServerFlags>(flags), "guid", Glib::c_str_or_nullptr(guid),
"authentication-observer", static_cast<GDBusAuthObserver*>(nullptr))
}
Server::Server(const std::string& address, const std::string& guid,
- const Glib::RefPtr<AuthObserver>& observer, Flags flags)
+ const Glib::RefPtr<AuthObserver>& observer, ServerFlags flags)
: _CONSTRUCT("address", Glib::c_str_or_nullptr(address), "flags",
static_cast<GDBusServerFlags>(flags), "guid", Glib::c_str_or_nullptr(guid),
"authentication-observer", Glib::unwrap(observer))
init();
}
-Server::Server(const std::string& address, const std::string& guid, Flags flags)
+Server::Server(const std::string& address, const std::string& guid, ServerFlags flags)
: _CONSTRUCT("address", Glib::c_str_or_nullptr(address), "flags",
static_cast<GDBusServerFlags>(flags), "guid", Glib::c_str_or_nullptr(guid),
"authentication-observer", static_cast<GDBusAuthObserver*>(nullptr))
Glib::RefPtr<Server>
Server::create_sync(const std::string& address, const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer, const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags)
+ ServerFlags flags)
{
- return Glib::make_refptr_for_instance<Server>(new Server(address, guid, observer, cancellable, flags));
+ return Glib::RefPtr<Server>(new Server(address, guid, observer, cancellable, flags));
}
Glib::RefPtr<Server>
Server::create_sync(const std::string& address, const std::string& guid,
- const Glib::RefPtr<Cancellable>& cancellable, Flags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, ServerFlags flags)
{
- return Glib::make_refptr_for_instance<Server>(new Server(address, guid, cancellable, flags));
+ return Glib::RefPtr<Server>(new Server(address, guid, cancellable, flags));
}
Glib::RefPtr<Server>
Server::create_sync(const std::string& address, const std::string& guid,
- const Glib::RefPtr<AuthObserver>& observer, Flags flags)
+ const Glib::RefPtr<AuthObserver>& observer, ServerFlags flags)
{
- return Glib::make_refptr_for_instance<Server>(new Server(address, guid, observer, flags));
+ return Glib::RefPtr<Server>(new Server(address, guid, observer, flags));
}
Glib::RefPtr<Server>
-Server::create_sync(const std::string& address, const std::string& guid, Flags flags)
+Server::create_sync(const std::string& address, const std::string& guid, ServerFlags flags)
{
- return Glib::make_refptr_for_instance<Server>(new Server(address, guid, flags));
+ return Glib::RefPtr<Server>(new Server(address, guid, flags));
}
} // namespace DBus
namespace DBus
{
+_WRAP_ENUM(ServerFlags, GDBusServerFlags, s#^DBUS_##, gtype_func g_dbus_server_flags_get_type)
+
_GMMPROC_EXTRA_NAMESPACE(DBus)
//TODO: Add example from the C API in class docs.
_CLASS_GOBJECT(Server, GDBusServer, G_DBUS_SERVER, Glib::Object, GObject)
_IMPLEMENTS_INTERFACE(Initable)
-public:
- _WRAP_ENUM(Flags, GDBusServerFlags, NO_GTYPE)
-
protected:
+
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags);
+ ServerFlags flags);
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags);
+ ServerFlags flags);
Server(const std::string& address,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
- Flags flags);
+ ServerFlags flags);
Server(const std::string& address,
const std::string& guid,
- Flags flags);
+ ServerFlags flags);
public:
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags = Gio::DBus::Server::Flags::NONE);
+ ServerFlags flags = Gio::DBus::SERVER_FLAGS_NONE);
_WRAP_METHOD_DOCS_ONLY(g_dbus_server_new_sync)
/// @throw Glib::Error.
static Glib::RefPtr<Server> create_sync(const std::string& address,
const std::string& guid,
const Glib::RefPtr<Cancellable>& cancellable,
- Flags flags = Gio::DBus::Server::Flags::NONE);
+ ServerFlags flags = Gio::DBus::SERVER_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<Server> create_sync(const std::string& address,
const std::string& guid,
const Glib::RefPtr<AuthObserver>& observer,
- Flags flags = Gio::DBus::Server::Flags::NONE);
+ ServerFlags flags = Gio::DBus::SERVER_FLAGS_NONE);
/// Non-cancellable version of create_sync().
static Glib::RefPtr<Server> create_sync(const std::string& address,
const std::string& guid,
- Flags flags = Gio::DBus::Server::Flags::NONE);
+ ServerFlags flags = Gio::DBus::SERVER_FLAGS_NONE);
_WRAP_METHOD(void start(), g_dbus_server_start)
_WRAP_METHOD(void stop(), g_dbus_server_stop)
_WRAP_METHOD(bool is_active() const, g_dbus_server_is_active)
_WRAP_METHOD(std::string get_guid() const, g_dbus_server_get_guid)
- _WRAP_METHOD(Flags get_flags() const, g_dbus_server_get_flags)
+ _WRAP_METHOD(ServerFlags get_flags() const, g_dbus_server_get_flags)
_WRAP_METHOD(std::string get_client_address() const, g_dbus_server_get_client_address)
_WRAP_PROPERTY("active", bool)
_WRAP_PROPERTY("address", std::string)
_WRAP_PROPERTY("authentication-observer", Glib::RefPtr<AuthObserver>)
_WRAP_PROPERTY("client-address", std::string)
- _WRAP_PROPERTY("flags", Flags)
+ _WRAP_PROPERTY("flags", ServerFlags)
_WRAP_PROPERTY("guid", std::string)
#m4 _CONVERSION(`GDBusConnection*', `const Glib::RefPtr<Connection>&', `Glib::wrap($3, true)')
* @endcode
*/
using SlotSubtreeEnumerate = sigc::slot<
- std::vector<Glib::ustring>(
+ std::vector<Glib::ustring>,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
- const Glib::ustring&)
+ const Glib::ustring&
>;
/** The type for a slot which handles introspecting a child node.
* @endcode
*/
using SlotSubtreeIntrospect = sigc::slot<
- std::vector< Glib::RefPtr<Gio::DBus::InterfaceInfo> >(
+ std::vector< Glib::RefPtr<Gio::DBus::InterfaceInfo> >,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
const Glib::ustring&,
- const Glib::ustring&)
+ const Glib::ustring&
>;
/** The type for a slot which handles dispatching a remote call on a child
* @endcode
*/
using SlotSubtreeDispatch = sigc::slot<
- const InterfaceVTable*(
+ const InterfaceVTable*,
const Glib::RefPtr<Connection>&,
const Glib::ustring&,
const Glib::ustring&,
const Glib::ustring&,
- const Glib::ustring&)
+ const Glib::ustring&
>;
/** Constructs a new SubtreeVTable using specified slots.
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2010 The giomm Development Team
*
* This library is free software; you can redistribute it and/or
namespace DBus
{
-_WRAP_ENUM(BusNameWatcherFlags, GBusNameWatcherFlags, NO_GTYPE)
+_WRAP_ENUM(BusNameWatcherFlags, GBusNameWatcherFlags, s#^DBUS_##, NO_GTYPE)
/** For example,
* void on_name_appeared(const Glib::RefPtr<Gio::DBus::Connection>& connection,
* const Glib::ustring& name, const Glib::ustring& name_owner);
* @ingroup DBus
*/
-using SlotNameAppeared = sigc::slot<void(const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring, const Glib::ustring&)>;
+using SlotNameAppeared = sigc::slot<void, const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring, const Glib::ustring&>;
/** For example,
* void on_name_vanished(const Glib::RefPtr<Gio::DBus::Connection>& connection,
* const Glib::ustring& name);
* @ingroup DBus
*/
-using SlotNameVanished = sigc::slot<void(const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring)>;
+using SlotNameVanished = sigc::slot<void, const Glib::RefPtr<Gio::DBus::Connection>&, Glib::ustring>;
//TODO: Add example from C API in class docs?
/** Starts watching @a name on the bus specified by @a bus_type and calls
const Glib::ustring& name,
const SlotNameAppeared& name_appeared_slot = SlotNameAppeared(),
const SlotNameVanished& name_vanished_slot = SlotNameVanished(),
- BusNameWatcherFlags flags = Gio::DBus::BusNameWatcherFlags::NONE
+ BusNameWatcherFlags flags = Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE
);
_IGNORE(g_bus_watch_name)
const Glib::ustring& name,
const SlotNameAppeared& name_appeared_slot = SlotNameAppeared(),
const SlotNameVanished& name_vanished_slot = SlotNameVanished(),
- BusNameWatcherFlags flags = Gio::DBus::BusNameWatcherFlags::NONE
+ BusNameWatcherFlags flags = Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE
);
_IGNORE(g_bus_watch_name_on_connection)
_WRAP_METHOD(std::string get_filename() const, g_desktop_app_info_get_filename)
_WRAP_METHOD(bool is_hidden() const, g_desktop_app_info_get_is_hidden)
-
- _IGNORE(g_desktop_app_info_set_desktop_env)
+ _WRAP_METHOD(static void set_desktop_env(const std::string& desktop_env), g_desktop_app_info_set_desktop_env,
+ deprecated "Do not use this API. Since 2.42 the value of the `XDG_CURRENT_DESKTOP` environment variable will be used.")
#m4 _CONVERSION(`const char* const*', `std::vector<Glib::ustring>', `Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_NONE)')
_WRAP_METHOD(std::vector<Glib::ustring> get_keywords() const, g_desktop_app_info_get_keywords)
#include <glibmm/exceptionhandler.h>
#include "slot_async.h"
-using StartStopType = Gio::Drive::StartStopType;
-
namespace Gio
{
void
Drive::eject(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Drive::eject(const SlotAsyncReady& slot, Mount::UnmountFlags flags)
+Drive::eject(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- Mount::UnmountFlags flags)
+ MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_drive_eject_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
Glib::unwrap(mount_operation),
}
void
-Drive::eject(Mount::UnmountFlags flags)
+Drive::eject(MountUnmountFlags flags)
{
g_drive_eject_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
nullptr, // mount_operation
void
Drive::stop(const Glib::RefPtr<MountOperation>& mount_operation,
- const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, Mount::UnmountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Drive::stop(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- Mount::UnmountFlags flags)
+ MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Drive::start(const Glib::RefPtr<MountOperation>& mount_operation,
- const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, StartFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, DriveStartFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Drive::start(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- StartFlags flags)
+ DriveStartFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmm/listhandle.h>
#include <giomm/mount.h>
#include <giomm/icon.h>
//#include <giomm/volume.h>
namespace Gio
{
+_WRAP_ENUM(DriveStartFlags, GDriveStartFlags)
+_WRAP_ENUM(DriveStartStopType, GDriveStartStopType)
+
/** Virtual File System drive management.
*
* This represent a piece of hardware connected to the machine. It's generally only created for removable hardware or hardware with removable media.
_CLASS_INTERFACE(Drive, GDrive, G_DRIVE, GDriveIface)
public:
- _WRAP_ENUM(StartFlags, GDriveStartFlags)
- _WRAP_ENUM(StartStopType, GDriveStartStopType)
-
_WRAP_METHOD(Glib::ustring get_name() const, g_drive_get_name)
_WRAP_METHOD(Glib::RefPtr<Icon> get_icon(), g_drive_get_icon, refreturn)
_WRAP_METHOD(bool has_volumes() const, g_drive_has_volumes)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<Volume>>',`Glib::ListHandler<Glib::RefPtr<Volume>>::list_to_vector($3, Glib::OWNERSHIP_SHALLOW)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<Volume>> get_volumes(), g_drive_get_volumes)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<Volume> >',`$2($3, Glib::OWNERSHIP_SHALLOW)')
+ _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<Volume> > get_volumes(), g_drive_get_volumes)
_WRAP_METHOD(bool is_media_removable() const, g_drive_is_media_removable)
_WRAP_METHOD(bool is_removable() const, g_drive_is_removable)
* @param flags Flags affecting the unmount if required for eject.
* @param cancellable A cancellable object which can be used to cancel the eject.
*/
- void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Ejects the drive.
* @param slot A callback which will be called when the eject is completed.
* @param flags Flags affecting the unmount if required for eject.
*/
- void eject(const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Ejects the drive.
* @param flags Flags affecting the unmount if required for eject.
*/
- void eject(Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_drive_eject)
_IGNORE(g_drive_eject_with_operation)
_WRAP_METHOD(std::string get_identifier(const std::string& kind) const, g_drive_get_identifier)
- #m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> enumerate_identifiers() const, g_drive_enumerate_identifiers)
+ #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle enumerate_identifiers() const, g_drive_enumerate_identifiers)
/** @newin{2,22} */
- void start(const Glib::RefPtr<MountOperation>& mount_operation, const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, StartFlags flags = StartFlags::NONE);
+ void start(const Glib::RefPtr<MountOperation>& mount_operation, const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, DriveStartFlags flags = DRIVE_START_NONE);
/** @newin{2,22} */
- void start(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, StartFlags flags = StartFlags::NONE);
+ void start(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, DriveStartFlags flags = DRIVE_START_NONE);
_IGNORE(g_drive_start)
_WRAP_METHOD(bool start_finish(const Glib::RefPtr<AsyncResult>& result), g_drive_start_finish, errthrow)
/** @newin{2,22} */
_WRAP_METHOD(bool can_start_degraded() const, g_drive_can_start_degraded)
/** @newin{2,22} */
- void stop(const Glib::RefPtr<MountOperation>& mount_operation, const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void stop(const Glib::RefPtr<MountOperation>& mount_operation, const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** @newin{2,22} */
- void stop(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void stop(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_drive_stop)
_WRAP_METHOD(bool stop_finish(const Glib::RefPtr<AsyncResult>& result), g_drive_stop_finish, errthrow)
/** @newin{2,22} */
_WRAP_METHOD(bool can_stop() const, g_drive_can_stop)
- _WRAP_METHOD(StartStopType get_start_stop_type() const, g_drive_get_start_stop_type)
+ _WRAP_METHOD(DriveStartStopType get_start_stop_type() const, g_drive_get_start_stop_type)
_WRAP_METHOD(Glib::ustring get_sort_key() const, g_drive_get_sort_key)
- _WRAP_SIGNAL(void changed(), changed, newin "2,20")
- _WRAP_SIGNAL(void disconnected(), disconnected, newin "2,20")
- _WRAP_SIGNAL(void eject_button(), eject_button, newin "2,20")
- _WRAP_SIGNAL(void stop_button(), stop_button)
+ /** @newin{2,20}
+ */
+ _WRAP_SIGNAL(void changed(), changed, no_default_handler)
+
+ /** @newin{2,20}
+ */
+ _WRAP_SIGNAL(void disconnected(), disconnected, no_default_handler)
+
+ /** @newin{2,20}
+ */
+ _WRAP_SIGNAL(void eject_button(), eject_button, no_default_handler)
+ _WRAP_SIGNAL(void stop_button(), stop_button, no_default_handler)
//_WRAP_VFUNC(Glib::ustring get_name() const, get_name)
//Careful of ref-counting: //_WRAP_VFUNC(Glib::RefPtr<Icon> get_icon() const, get_icon)
#include <gio/gio.h>
-using Origin = Gio::Emblem::Origin;
-
namespace Gio
{
namespace Gio
{
+_WRAP_ENUM(EmblemOrigin, GEmblemOrigin, NO_GTYPE)
+
/** An object for emblems
*
* Emblem is an implementation of GIcon that supports having an emblem, which
_CLASS_GOBJECT(Emblem, GEmblem, G_EMBLEM, Glib::Object, GObject)
_IMPLEMENTS_INTERFACE(Icon)
-public:
- _WRAP_ENUM(Origin, GEmblemOrigin, NO_GTYPE)
-
protected:
/** Creates a new emblem for @a icon.
* @param icon A Gio::Icon containing the icon.
/** Creates a new emblem for @a icon.
* @param icon A Gio::Icon containing the icon.
- * @param origin An Origin value defining the emblem's origin
+ * @param origin An EmblemOrigin value defining the emblem's origin
*/
- _WRAP_CTOR(Emblem(const Glib::RefPtr<Icon>& icon, Origin origin), g_emblem_new_with_origin)
+ _WRAP_CTOR(Emblem(const Glib::RefPtr<Icon>& icon, EmblemOrigin origin), g_emblem_new_with_origin)
public:
/** Creates a new emblem for @a icon.
/** Creates a new emblem for @a icon.
* @param icon A Gio::Icon containing the icon.
- * @param origin An Origin value defining the emblem's origin
+ * @param origin An EmblemOrigin value defining the emblem's origin
*/
- _WRAP_CREATE(const Glib::RefPtr<Icon>& icon, Origin origin)
+ _WRAP_CREATE(const Glib::RefPtr<Icon>& icon, EmblemOrigin origin)
_WRAP_METHOD(Glib::RefPtr<Icon> get_icon(), g_emblem_get_icon)
_WRAP_METHOD(Glib::RefPtr<const Icon> get_icon() const, g_emblem_get_icon, constversion)
- _WRAP_METHOD(Origin get_origin() const, g_emblem_get_origin)
+ _WRAP_METHOD(EmblemOrigin get_origin() const, g_emblem_get_origin)
};
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmm/listhandle.h>
#include <glibmm/object.h>
#include <giomm/icon.h>
#include <giomm/emblem.h>
_WRAP_METHOD(Glib::RefPtr<Icon> get_icon(), g_emblemed_icon_get_icon)
_WRAP_METHOD(Glib::RefPtr<const Icon> get_icon() const, g_emblemed_icon_get_icon, constversion)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<Emblem>>',`Glib::ListHandler<Glib::RefPtr<Emblem>>::list_to_vector($3, Glib::OWNERSHIP_NONE)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<Emblem>> get_emblems(), g_emblemed_icon_get_emblems)
- dnl// Can't use the constversion parameter in _WRAP_METHOD() when a vector is returned.
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<const Emblem>>',`Glib::ListHandler<Glib::RefPtr<const Emblem>>::list_to_vector($3, Glib::OWNERSHIP_NONE)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<const Emblem>> get_emblems() const, g_emblemed_icon_get_emblems)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle<Glib::RefPtr<Emblem> >',`$2($3, Glib::OWNERSHIP_NONE)')
+ _WRAP_METHOD(Glib::ListHandle<Glib::RefPtr<Emblem> > get_emblems(), g_emblemed_icon_get_emblems)
+
+//TODO: #m4 _CONVERSION(`GList*',`Glib::ListHandle<Glib::RefPtr<const Emblem> >',`$2($3, Glib::OWNERSHIP_NONE)')
+// _WRAP_METHOD(Glib::ListHandle<Glib::RefPtr<const Emblem> > get_emblems() const, g_emblemed_icon_get_emblems, constversion)
_WRAP_METHOD(void add_emblem(const Glib::RefPtr<Emblem>& emblem), g_emblemed_icon_add_emblem)
_WRAP_METHOD(void clear_emblems(), g_emblemed_icon_clear_emblems)
namespace Gio
{
-// BIG_ENDIAN and LITTLE_ENDIAN are defined as preprocessor macros somewhere.
-_WRAP_ENUM(DataStreamByteOrder, GDataStreamByteOrder, NO_GTYPE, s#ENDIAN$#ENDIAN_ORDER#)
-_WRAP_ENUM(DataStreamNewlineType, GDataStreamNewlineType, NO_GTYPE)
+_WRAP_ENUM(DataStreamByteOrder, GDataStreamByteOrder)
+_WRAP_ENUM(DataStreamNewlineType, GDataStreamNewlineType)
+_WRAP_ENUM(ErrorEnum, GIOErrorEnum, NO_GTYPE)
_WRAP_ENUM(SocketFamily, GSocketFamily)
_WRAP_ENUM(TlsAuthenticationMode, GTlsAuthenticationMode)
_WRAP_ENUM(TlsCertificateFlags, GTlsCertificateFlags)
void
File::append_to_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- CreateFlags flags, int io_priority)
+ FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::append_to_async(const SlotAsyncReady& slot, CreateFlags flags, int io_priority)
+File::append_to_async(const SlotAsyncReady& slot, FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::create_file_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- CreateFlags flags, int io_priority)
+ FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::create_file_async(const SlotAsyncReady& slot, CreateFlags flags, int io_priority)
+File::create_file_async(const SlotAsyncReady& slot, FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::create_file_readwrite_async(const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags, int io_priority)
+ const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::create_file_readwrite_async(
- const SlotAsyncReady& slot, CreateFlags flags, int io_priority)
+ const SlotAsyncReady& slot, FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- const std::string& etag, bool make_backup, CreateFlags flags, int io_priority)
+ const std::string& etag, bool make_backup, FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_async(const SlotAsyncReady& slot, const std::string& etag, bool make_backup,
- CreateFlags flags, int io_priority)
+ FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_readwrite_async(const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag, bool make_backup,
- CreateFlags flags, int io_priority)
+ FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_readwrite_async(const SlotAsyncReady& slot, const std::string& etag, bool make_backup,
- CreateFlags flags, int io_priority)
+ FileCreateFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
bool
File::copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot,
- const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
bool
-File::copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, CopyFlags flags)
+File::copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
bool
-File::copy(const Glib::RefPtr<File>& destination, CopyFlags flags)
+File::copy(const Glib::RefPtr<File>& destination, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res = g_file_copy(gobj(), Glib::unwrap(destination), static_cast<GFileCopyFlags>(flags),
void
File::copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress,
const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable,
- CopyFlags flags, int io_priority)
+ FileCopyFlags flags, int io_priority)
{
// Create a new pair which will hold copies of passed slots.
// This will be deleted in the SignalProxy_file_copy_async_callback() callback
void
File::copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready,
- const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags, int io_priority)
+ const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags, int io_priority)
{
// Create copies of slots.
// Pointers to them will be passed through the callbacks' data parameter
void
File::copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress,
- const SlotAsyncReady& slot_ready, CopyFlags flags, int io_priority)
+ const SlotAsyncReady& slot_ready, FileCopyFlags flags, int io_priority)
{
// Create a new pair which will hold copies of passed slots.
// This will be deleted in the SignalProxy_file_copy_async_callback() callback
void
File::copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready,
- CopyFlags flags, int io_priority)
+ FileCopyFlags flags, int io_priority)
{
// Create copies of slots.
// Pointers to them will be passed through the callbacks' data parameter
bool
File::move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot,
- const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
bool
-File::move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, CopyFlags flags)
+File::move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
bool
-File::move(const Glib::RefPtr<File>& destination, CopyFlags flags)
+File::move(const Glib::RefPtr<File>& destination, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
void
File::mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation,
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation,
- const SlotAsyncReady& slot, Mount::MountFlags flags)
+ const SlotAsyncReady& slot, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::mount_mountable(const SlotAsyncReady& slot, Mount::MountFlags flags)
+File::mount_mountable(const SlotAsyncReady& slot, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::mount_mountable(Mount::MountFlags flags)
+File::mount_mountable(MountMountFlags flags)
{
g_file_mount_mountable(
gobj(), static_cast<GMountMountFlags>(flags), nullptr, nullptr, nullptr, nullptr);
void
File::unmount_mountable(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::unmount_mountable(const SlotAsyncReady& slot, Mount::UnmountFlags flags)
+File::unmount_mountable(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::unmount_mountable(Mount::UnmountFlags flags)
+File::unmount_mountable(MountUnmountFlags flags)
{
g_file_unmount_mountable_with_operation(
gobj(), static_cast<GMountUnmountFlags>(flags), nullptr, nullptr, nullptr, nullptr);
void
File::unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::unmount_mountable(const SlotAsyncReady& slot,
- const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::unmount_mountable(
- const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_file_unmount_mountable_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
Glib::unwrap(mount_operation), nullptr, nullptr, nullptr);
void
File::mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation,
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation,
- const SlotAsyncReady& slot, Mount::MountFlags flags)
+ const SlotAsyncReady& slot, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::mount_enclosing_volume(const SlotAsyncReady& slot, Mount::MountFlags flags)
+File::mount_enclosing_volume(const SlotAsyncReady& slot, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::mount_enclosing_volume(Mount::MountFlags flags)
+File::mount_enclosing_volume(MountMountFlags flags)
{
g_file_mount_enclosing_volume(
gobj(), static_cast<GMountMountFlags>(flags), nullptr, nullptr, nullptr, nullptr);
void
File::eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::eject_mountable(const SlotAsyncReady& slot,
- const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::eject_mountable(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+File::eject_mountable(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_file_eject_mountable_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
Glib::unwrap(mount_operation), nullptr, nullptr, nullptr);
void
File::eject_mountable(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::eject_mountable(const SlotAsyncReady& slot, Mount::UnmountFlags flags)
+File::eject_mountable(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-File::eject_mountable(Mount::UnmountFlags flags)
+File::eject_mountable(MountUnmountFlags flags)
{
g_file_eject_mountable_with_operation(
gobj(), static_cast<GMountUnmountFlags>(flags), nullptr, nullptr, nullptr, nullptr);
void
File::replace_contents(const char* contents, gsize length, const std::string& etag,
std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup,
- CreateFlags flags)
+ FileCreateFlags flags)
{
GError* gerror = nullptr;
gchar* c_etag_new = nullptr;
void
File::replace_contents(const char* contents, gsize length, const std::string& etag,
- std::string& new_etag, bool make_backup, CreateFlags flags)
+ std::string& new_etag, bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
gchar* c_etag_new = nullptr;
void
File::replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag,
- const Glib::RefPtr<Cancellable>& cancellable, bool make_backup, CreateFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
gchar* c_etag_new = nullptr;
void
File::replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag,
- bool make_backup, CreateFlags flags)
+ bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
gchar* c_etag_new = nullptr;
void
File::replace_contents_async(const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable, const char* contents, gsize length,
- const std::string& etag, bool make_backup, CreateFlags flags)
+ const std::string& etag, bool make_backup, FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_contents_async(const SlotAsyncReady& slot, const char* contents, gsize length,
- const std::string& etag, bool make_backup, CreateFlags flags)
+ const std::string& etag, bool make_backup, FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_contents_async(const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable, const std::string& contents,
- const std::string& etag, bool make_backup, CreateFlags flags)
+ const std::string& etag, bool make_backup, FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_contents_async(const SlotAsyncReady& slot, const std::string& contents,
- const std::string& etag, bool make_backup, CreateFlags flags)
+ const std::string& etag, bool make_backup, FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_contents_bytes_async(const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<const Glib::Bytes>& contents,
- const std::string& etag, bool make_backup, CreateFlags flags)
+ const std::string& etag, bool make_backup, FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::replace_contents_bytes_async(const SlotAsyncReady& slot,
const Glib::RefPtr<const Glib::Bytes>& contents, const std::string& etag, bool make_backup,
- CreateFlags flags)
+ FileCreateFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
Glib::RefPtr<FileOutputStream>
File::replace(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag,
- bool make_backup, CreateFlags flags)
+ bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_replace(gobj(), Glib::c_str_or_nullptr(etag),
}
Glib::RefPtr<FileOutputStream>
-File::replace(const std::string& etag, bool make_backup, CreateFlags flags)
+File::replace(const std::string& etag, bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_replace(gobj(), Glib::c_str_or_nullptr(etag),
Glib::RefPtr<FileIOStream>
File::replace_readwrite(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag,
- bool make_backup, CreateFlags flags)
+ bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_replace_readwrite(gobj(), Glib::c_str_or_nullptr(etag),
}
Glib::RefPtr<FileIOStream>
-File::replace_readwrite(const std::string& etag, bool make_backup, CreateFlags flags)
+File::replace_readwrite(const std::string& etag, bool make_backup, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_replace_readwrite(gobj(), Glib::c_str_or_nullptr(etag),
void
File::measure_disk_usage(const Glib::RefPtr<Cancellable>& cancellable,
const SlotFileMeasureProgress& slot_progress, guint64& disk_usage, guint64& num_dirs,
- guint64& num_files, MeasureFlags flags)
+ guint64& num_files, FileMeasureFlags flags)
{
GError* gerror = nullptr;
g_file_measure_disk_usage(gobj(), ((GFileMeasureFlags)(flags)),
void
File::measure_disk_usage_async(const SlotAsyncReady& slot_ready,
const Glib::RefPtr<Cancellable>& cancellable, const SlotFileMeasureProgress& slot_progress,
- MeasureFlags flags, int io_priority)
+ FileMeasureFlags flags, int io_priority)
{
// Create a new pair which will hold copies of passed slots.
// This will be deleted in the SignalProxy_file_measure_async_callback() callback
void
File::start_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::RefPtr<MountOperation>& start_operation, Drive::StartFlags flags)
+ const Glib::RefPtr<MountOperation>& start_operation, DriveStartFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::start_mountable(const SlotAsyncReady& slot,
- const Glib::RefPtr<MountOperation>& start_operation, Drive::StartFlags flags)
+ const Glib::RefPtr<MountOperation>& start_operation, DriveStartFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::stop_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- const Glib::RefPtr<MountOperation>& start_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& start_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
File::stop_mountable(const SlotAsyncReady& slot,
- const Glib::RefPtr<MountOperation>& start_operation, Mount::UnmountFlags flags)
+ const Glib::RefPtr<MountOperation>& start_operation, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
bool
File::copy_attributes(const Glib::RefPtr<File>& destination,
- const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
bool
-File::copy_attributes(const Glib::RefPtr<File>& destination, CopyFlags flags)
+File::copy_attributes(const Glib::RefPtr<File>& destination, FileCopyFlags flags)
{
GError* gerror = nullptr;
bool res;
}
Glib::RefPtr<FileOutputStream>
-File::create_file(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags)
+File::create_file(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_create(gobj(), ((GFileCreateFlags)(flags)),
}
Glib::RefPtr<FileOutputStream>
-File::create_file(CreateFlags flags)
+File::create_file(FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue =
}
Glib::RefPtr<FileIOStream>
-File::create_file_readwrite(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags)
+File::create_file_readwrite(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_create_readwrite(gobj(), ((GFileCreateFlags)(flags)),
}
Glib::RefPtr<FileIOStream>
-File::create_file_readwrite(CreateFlags flags)
+File::create_file_readwrite(FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue =
}
Glib::RefPtr<FileOutputStream>
-File::append_to(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags)
+File::append_to(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue = Glib::wrap(g_file_append_to(gobj(), ((GFileCreateFlags)(flags)),
}
Glib::RefPtr<FileOutputStream>
-File::append_to(CreateFlags flags)
+File::append_to(FileCreateFlags flags)
{
GError* gerror = nullptr;
auto retvalue =
class Volume;
_WRAP_ENUM(FileQueryInfoFlags, GFileQueryInfoFlags, NO_GTYPE)
+_WRAP_ENUM(FileCreateFlags, GFileCreateFlags, NO_GTYPE)
+_WRAP_ENUM(FileCopyFlags, GFileCopyFlags, NO_GTYPE)
_WRAP_ENUM(FileMonitorFlags, GFileMonitorFlags, NO_GTYPE)
+_WRAP_ENUM(FileMeasureFlags, GFileMeasureFlags, NO_GTYPE)
/** File and directory handling.
_CLASS_INTERFACE(File, GFile, G_FILE, GFileIface)
public:
- _WRAP_ENUM(CreateFlags, GFileCreateFlags, NO_GTYPE)
- _WRAP_ENUM(CopyFlags, GFileCopyFlags, NO_GTYPE)
- _WRAP_ENUM(MeasureFlags, GFileMeasureFlags, NO_GTYPE)
_IGNORE(g_file_icon_new) //g_file_icon_new is not a GFile method.
* the file doesn't already exist it is created.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* If the file is a directory a Gio::Error with IS_DIRECTORY will be
* thrown. Other errors are possible too, and depend on what kind of
* filesystem the file is on.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param cancellable Optional Cancellable object.
* @return A FileOutputStream.
*/
- Glib::RefPtr<FileOutputStream> append_to(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> append_to(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE);
/** Gets an output stream for appending data to the file. If
* the file doesn't already exist it is created.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* If the file is a directory a Gio::Error with IS_DIRECTORY will be
* thrown. Other errors are possible too, and depend on what kind of
* filesystem the file is on.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @return A FileOutputStream.
*/
- Glib::RefPtr<FileOutputStream> append_to(CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> append_to(FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_append_to)
//We renamed this to create_file from (g_file_create() and g_file_create_readwrite), to avoid confusion with static create() methods,
* The file must not already exist.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* filesystem the file is on.
*
* @param cancellable A Cancellable object which can be used to cancel the operation.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @return A FileOutputStream for the newly created file.
*/
- Glib::RefPtr<FileOutputStream> create_file(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> create_file(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE);
/** Creates a new file and returns an output stream for writing to it.
* The file must not already exist.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* Other errors are possible too, and depend on what kind of
* filesystem the file is on.
*
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @return A FileOutputStream for the newly created file.
*/
- Glib::RefPtr<FileOutputStream> create_file(CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> create_file(FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_create)
/** Creates a new file and returns a stream for reading and writing to it.
* The file must not already exist.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* rather than just opening for reading or writing.
*
* @param cancellable A Cancellable object which can be used to cancel the operation.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @return A FileOutputStream for the newly created file.
*/
- Glib::RefPtr<FileIOStream> create_file_readwrite(const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileIOStream> create_file_readwrite(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE);
/** Creates a new file and returns a stream for reading and writing to it.
* The file must not already exist.
*
* By default files created are generally readable by everyone,
- * but if you pass CreateFlags::PRIVATE in @a flags the file
+ * but if you pass FILE_CREATE_PRIVATE in @a flags the file
* will be made readable only to the current user, to the level that
* is supported on the target filesystem.
*
* supported, so make sure you really need to do read and write streaming,
* rather than just opening for reading or writing.
*
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @return A FileOutputStream for the newly created file.
*/
- Glib::RefPtr<FileIOStream> create_file_readwrite(CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileIOStream> create_file_readwrite(FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_create_readwrite)
* not affect an already existing copy of the file. For instance, for local files it may write to a
* temporary file and then atomically rename over the destination when the stream is closed.
*
- * By default files created are generally readable by everyone, but if you pass CreateFlags::PRIVATE in
+ * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in
* @a flags the file will be made readable only to the current user, to the level that is supported on the
* target filesystem.
*
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param etag An optional entity tag for the current Glib::File.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @return A FileOutputStream.
*/
- Glib::RefPtr<FileOutputStream> replace(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> replace(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Returns an output stream for overwriting the file, possibly creating a backup copy of the file first.
* not affect an already existing copy of the file. For instance, for local files it may write to a
* temporary file and then atomically rename over the destination when the stream is closed.
*
- * By default files created are generally readable by everyone, but if you pass CreateFlags::PRIVATE in
+ * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in
* @a flags the file will be made readable only to the current user, to the level that is supported on the
* target filesystem.
*
*
* @param etag An optional entity tag for the current Glib::File.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @return A FileOutputStream.
*/
- Glib::RefPtr<FileOutputStream> replace(const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileOutputStream> replace(const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_replace)
* When the operation is finished, @a slot will be called. You can then call append_to_finish() to get the result of the operation.
* @param slot A callback slot which will be called when the request is satisfied.
* @param cancellable A Cancellable object which can be used to cancel the operation.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void append_to_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void append_to_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asynchronously opens the file for appending.
* For more details, see append_to() which is the synchronous version of this call.
*
* When the operation is finished, @a slot will be called. You can then call append_to_finish() to get the result of the operation.
* @param slot A callback slot which will be called when the request is satisfied.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void append_to_async(const SlotAsyncReady& slot, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void append_to_async(const SlotAsyncReady& slot, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_append_to_async)
_WRAP_METHOD(Glib::RefPtr<FileOutputStream> append_to_finish(const Glib::RefPtr<AsyncResult>& res),
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param cancellable A Cancellable object which can be used to cancel the operation.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void create_file_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void create_file_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asynchronously creates a new file and returns an output stream for writing to it. The file must not already exist.
* For more details, see create_file() which is the synchronous version of this call.
* When the operation is finished, @a slot will be called. You can then call create_file_finish() to get the result of the operation.
*
* @param slot A callback slot which will be called when the request is satisfied.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void create_file_async(const SlotAsyncReady& slot, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void create_file_async(const SlotAsyncReady& slot, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_create_async)
_WRAP_METHOD(Glib::RefPtr<FileOutputStream> create_file_finish(const Glib::RefPtr<AsyncResult>& res),
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param cancellable A Cancellable object which can be used to cancel the operation.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*
* @newin{2,24}
*/
- void create_file_readwrite_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void create_file_readwrite_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asynchronously creates a new file and returns a stream for reading and
* writing to it. The file must not already exist.
* When the operation is finished, @a slot will be called. You can then call create_file_readwrite_finish() to get the result of the operation.
*
* @param slot A callback slot which will be called when the request is satisfied.
- * @param flags a set of CreateFlags.
+ * @param flags a set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*
* @newin{2,24}
*/
- void create_file_readwrite_async(const SlotAsyncReady& slot, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void create_file_readwrite_async(const SlotAsyncReady& slot, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_create_readwrite_async)
_WRAP_METHOD(Glib::RefPtr<FileIOStream> create_file_readwrite_finish(const Glib::RefPtr<AsyncResult>& res),
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param etag An entity tag for the current Gio::File.
* @param make_backup true if a backup of the existing file should be made.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void replace_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void replace_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asyncronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first.
* For more details, see replace() which is the synchronous version of this call.
* @param slot A callback slot which will be called when the request is satisfied.
* @param etag An entity tag for the current Gio::File.
* @param make_backup true if a backup of the existing file should be made.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*/
- void replace_async(const SlotAsyncReady& slot, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void replace_async(const SlotAsyncReady& slot, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_replace_async)
_WRAP_METHOD(Glib::RefPtr<FileOutputStream> replace_finish(const Glib::RefPtr<AsyncResult>& res),
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param etag An optional entity tag for the current Glib::File.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @return A FileOutputStream.
*
* @newin{2,24}
*/
- Glib::RefPtr<FileIOStream> replace_readwrite(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileIOStream> replace_readwrite(const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Returns an output stream for overwriting the file in readwrite mode, possibly creating a backup copy of the file first.
*
* @param etag An optional entity tag for the current Glib::File.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @return A FileOutputStream.
*
* @newin{2,24}
*/
- Glib::RefPtr<FileIOStream> replace_readwrite(const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ Glib::RefPtr<FileIOStream> replace_readwrite(const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_replace_readwrite)
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param etag An entity tag for the current Gio::File.
* @param make_backup true if a backup of the existing file should be made.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*
* @newin{2,24}
*/
- void replace_readwrite_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void replace_readwrite_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asyncronously overwrites the file in read-write mode, replacing the contents, possibly creating a backup copy of the file first.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param etag An entity tag for the current Gio::File.
* @param make_backup true if a backup of the existing file should be made.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param io_priority The I/O priority of the request.
*
* @newin{2,24}
*/
- void replace_readwrite_async(const SlotAsyncReady& slot, const std::string& etag = std::string(), bool make_backup = false, CreateFlags flags = CreateFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void replace_readwrite_async(const SlotAsyncReady& slot, const std::string& etag = std::string(), bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_replace_readwrite_async)
_WRAP_METHOD(Glib::RefPtr<FileIOStream> replace_readwrite_finish(const Glib::RefPtr<AsyncResult>& res),
*
* For symlinks, normally the information about the target of the
* symlink is returned, rather than information about the symlink itself.
- * However if you pass FileQueryInfoFlags::NOFOLLOW_SYMLINKS in @a flags the
+ * However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @a flags the
* information about the symlink itself will be returned. Also, for symlinks
* that point to non-existing files the information about the symlink itself
* will be returned.
* @param flags: A set of FileQueryInfoFlags.
* @result a FileInfo for the file, or an empty RefPtr on error.
*/
- Glib::RefPtr<FileInfo> query_info(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE) const;
+ Glib::RefPtr<FileInfo> query_info(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE) const;
/** Gets the requested information about the file. The result
* is a FileInfo object that contains key-value attributes (such as the type or size
*
* For symlinks, normally the information about the target of the
* symlink is returned, rather than information about the symlink itself.
- * However if you pass FileQueryInfoFlags::NOFOLLOW_SYMLINKS in @a flags the
+ * However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @a flags the
* information about the symlink itself will be returned. Also, for symlinks
* that point to non-existing files the information about the symlink itself
* will be returned.
* @param flags: A set of FileQueryInfoFlags.
* @result a FileInfo for the file, or an empty RefPtr on error.
*/
- Glib::RefPtr<FileInfo> query_info(const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE) const;
+ Glib::RefPtr<FileInfo> query_info(const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE) const;
_IGNORE(g_file_query_info)
*
* @newin{2,18}
*/
- FileType query_file_type(FileQueryInfoFlags flags = FileQueryInfoFlags::NONE) const;
+ FileType query_file_type(FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE) const;
/** Asynchronously gets the requested information about specified file. The result is a FileInfo object that contains key-value attributes (such as type or size for the file).
*
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void query_info_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT) const;
+ void query_info_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT) const;
/** Asynchronously gets the requested information about specified file. The result is a FileInfo object that contains key-value attributes (such as type or size for the file).
*
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void query_info_async(const SlotAsyncReady& slot, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT) const;
+ void query_info_async(const SlotAsyncReady& slot, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT) const;
_IGNORE(g_file_query_info_async)
* @param flags A set of FileQueryInfoFlags.
* @return A FileEnumerator if successful.
*/
- Glib::RefPtr<FileEnumerator> enumerate_children(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE);
+ Glib::RefPtr<FileEnumerator> enumerate_children(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
_IGNORE(g_file_enumerate_children)
/** Gets the requested information about the files in a directory. The result
* @param flags A set of FileQueryInfoFlags.
* @return A FileEnumerator if successful.
*/
- Glib::RefPtr<FileEnumerator> enumerate_children(const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE);
+ Glib::RefPtr<FileEnumerator> enumerate_children(const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
_IGNORE(g_file_enumerate_children)
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void enumerate_children_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void enumerate_children_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asynchronously gets the requested information about the files in a directory. The result is a GFileEnumerator object that will give out GFileInfo objects for all the files in the directory.
*
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void enumerate_children_async(const SlotAsyncReady& slot, const std::string& attributes = "*", FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void enumerate_children_async(const SlotAsyncReady& slot, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_enumerate_children_async)
_WRAP_METHOD(Glib::RefPtr<FileEnumerator> enumerate_children_finish(const Glib::RefPtr<AsyncResult>& res),
/** A signal handler would be, for instance:
* void on_file_progress(goffset current_num_bytes, goffset total_num_bytes);
*/
- using SlotFileProgress = sigc::slot<void(goffset, goffset)>;
+ using SlotFileProgress = sigc::slot<void, goffset, goffset>;
/** Copies the file source to the location specified by destination. Can not handle recursive copies of directories.
- * If the flag CopyFlags::OVERWRITE is specified an already existing destination file is overwritten.
- * If the flag CopyFlags::NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
+ * If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.
+ * If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
*
* The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a Gio::Error with CANCELLED will be thrown.
*
*
* If the source file does not exist then a Gio::Error with NOT_FOUND will be thrown, independent on the status of the destination.
*
- * If CopyFlags::OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
+ * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
*
* If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown.
* If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown.
*
- * If the source is a directory and the target does not exist, or CopyFlags::OVERWRITE is specified and the target is a file,
+ * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file,
* then a Gio::Error with WOULD_RECURSE will be thrown.
*
* If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup().
*/
- bool copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags = CopyFlags::NONE);
+ bool copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE);
/** Copies the file source to the location specified by destination. Can not handle recursive copies of directories.
- * If the flag CopyFlags::OVERWRITE is specified an already existing destination file is overwritten.
- * If the flag CopyFlags::NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
+ * If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.
+ * If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
*
* The operation can be monitored via the @a slot callback.
*
* If the source file does not exist then a Gio::Error with NOT_FOUND will be thrown, independent on the status of the destination.
*
- * If CopyFlags::OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
+ * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
*
* If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown.
* If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown.
*
- * If the source is a directory and the target does not exist, or CopyFlags::OVERWRITE is specified and the target is a file,
+ * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file,
* then a Gio::Error with WOULD_RECURSE will be thrown.
*
* If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup().
*/
- bool copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, CopyFlags flags = CopyFlags::NONE);
+ bool copy(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, FileCopyFlags flags = FILE_COPY_NONE);
/** Copies the file source to the location specified by destination. Can not handle recursive copies of directories.
- * If the flag CopyFlags::OVERWRITE is specified an already existing destination file is overwritten.
- * If the flag CopyFlags::NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
+ * If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.
+ * If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
*
* If the source file does not exist then a Gio::Error with NOT_FOUND will be thrown, independent on the status of the destination.
*
- * If CopyFlags::OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
+ * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
*
* If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown.
* If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown.
*
- * If the source is a directory and the target does not exist, or CopyFlags::OVERWRITE is specified and the target is a file,
+ * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file,
* then a Gio::Error with WOULD_RECURSE will be thrown.
*
* If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup().
*/
- bool copy(const Glib::RefPtr<File>& destination, CopyFlags flags = CopyFlags::NONE);
+ bool copy(const Glib::RefPtr<File>& destination, FileCopyFlags flags = FILE_COPY_NONE);
_IGNORE(g_file_copy)
/** Copies the file to the location specified by @a destination asynchronously.
* @param slot_progress The callback slot to be called with progress information
* @param slot_ready A SlotAsyncReady to call when the request is satisfied
* @param cancellable A Cancellable object which can be used to cancel the operation
- * @param flags Set of CopyFlags
+ * @param flags Set of FileCopyFlags
* @param io_priority The I/O priority of the request
*/
- void copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress, const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags = CopyFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress, const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Copies the file to the location specified by @a destination asynchronously.
* For details of the behaviour, see copy().
* @param destination Destination File
* @param slot_ready A SlotAsyncReady to call when the request is satisfied
* @param cancellable A Cancellable object which can be used to cancel the operation
- * @param flags Set of CopyFlags
+ * @param flags Set of FileCopyFlags
* @param io_priority The I/O priority of the request
*/
- void copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags = CopyFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Copies the file to the location specified by @a destination asynchronously.
* For details of the behaviour, see copy().
* @param destination Destination File
* @param slot_progress The callback slot to be called with progress information
* @param slot_ready A SlotAsyncReady to call when the request is satisfied
- * @param flags Set of CopyFlags
+ * @param flags Set of FileCopyFlags
* @param io_priority The I/O priority of the request
*/
- void copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress, const SlotAsyncReady& slot_ready, CopyFlags flags = CopyFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void copy_async(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot_progress, const SlotAsyncReady& slot_ready, FileCopyFlags flags = FILE_COPY_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Copies the file to the location specified by @a destination asynchronously.
* For details of the behaviour, see copy().
*
* @param destination Destination File
* @param slot_ready A SlotAsyncReady to call when the request is satisfied
- * @param flags Set of CopyFlags
+ * @param flags Set of FileCopyFlags
* @param io_priority The I/O priority of the request
*/
- void copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready, CopyFlags flags = CopyFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void copy_async(const Glib::RefPtr<File>& destination, const SlotAsyncReady& slot_ready, FileCopyFlags flags = FILE_COPY_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_copy_async)
_WRAP_METHOD(bool copy_finish(const Glib::RefPtr<AsyncResult>& res),
* used, otherwise a copy and delete fallback is used. The native implementation may support moving directories (for instance on moves inside
* the same filesystem), but the fallback code does not.
*
- * If the flag CopyFlags::OVERWRITE is specified an already existing destination file is overwritten.
+ * If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.
*
- * If the flag CopyFlags::NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
+ * If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.
*
* The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a Gio::Error with CANCELLED will be thrown.
*
* The operation can be monitored via the @a slot callback.
* If the source file does not exist then a Gio::Error with NOT_FOUND will be thrown, independent on the status of the destination.
*
- * If G_CopyFlags::OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
+ * If G_FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown.
*
* If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown.
* If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown.
*
- * If the source is a directory and the target does not exist, or CopyFlags::OVERWRITE is specified and the target is a file, then a Gio::Error with WOULD_RECURSE may be thrown (if the native move operation isn't available).
+ * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a Gio::Error with WOULD_RECURSE may be thrown (if the native move operation isn't available).
*/
- bool move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags = CopyFlags::NONE);
+ bool move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE);
- bool move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, CopyFlags flags = CopyFlags::NONE);
+ bool move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, FileCopyFlags flags = FILE_COPY_NONE);
- bool move(const Glib::RefPtr<File>& destination, CopyFlags flags = CopyFlags::NONE);
+ bool move(const Glib::RefPtr<File>& destination, FileCopyFlags flags = FILE_COPY_NONE);
_IGNORE(g_file_move)
_WRAP_METHOD(bool make_directory(const Glib::RefPtr<Cancellable>& cancellable{?}),
* @param flags A set of FileQueryInfoFlags.
* @return <tt>true</tt> if there was any error, <tt>false</tt> otherwise.
*/
- bool set_attributes_from_info(const Glib::RefPtr<FileInfo>& info, const Glib::RefPtr<Cancellable>& cancellable, FileQueryInfoFlags flags = FileQueryInfoFlags::NONE);
+ bool set_attributes_from_info(const Glib::RefPtr<FileInfo>& info, const Glib::RefPtr<Cancellable>& cancellable, FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
/** Tries to set all attributes in the FileInfo on the target values,
* not stopping on the first error.
* @param flags A set of FileQueryInfoFlags.
* @return <tt>true</tt> if there was any error, <tt>false</tt> otherwise.
*/
- bool set_attributes_from_info(const Glib::RefPtr<FileInfo>& info, FileQueryInfoFlags flags = FileQueryInfoFlags::NONE);
+ bool set_attributes_from_info(const Glib::RefPtr<FileInfo>& info, FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
_IGNORE(g_file_set_attributes_from_info)
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void set_attributes_async(const Glib::RefPtr<FileInfo>& info, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void set_attributes_async(const Glib::RefPtr<FileInfo>& info, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Asynchronously sets the attributes of file with info.
*
* @param flags A set of FileQueryInfoFlags.
* @param io_priority The I/O priority of the request.
*/
- void set_attributes_async(const Glib::RefPtr<FileInfo>& info, const SlotAsyncReady& slot, FileQueryInfoFlags flags = FileQueryInfoFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void set_attributes_async(const Glib::RefPtr<FileInfo>& info, const SlotAsyncReady& slot, FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_set_attributes_async)
_IGNORE(g_file_set_attributes_finish) // takes GFileInfo**
bool set_attributes_finish(const Glib::RefPtr<AsyncResult>& result, const Glib::RefPtr<FileInfo>& info);
- _WRAP_METHOD(bool set_attribute_string(const std::string& attribute, const Glib::ustring& value, FileQueryInfoFlags flags, const Glib::RefPtr<Cancellable>& cancellable{?}),
+ _WRAP_METHOD(bool set_attribute_string(const std::string& attribute, const std::string& value, FileQueryInfoFlags flags, const Glib::RefPtr<Cancellable>& cancellable{?}),
g_file_set_attribute_string,
errthrow)
* @param cancellable A Cancellable object.
* @param flags Flags affecting the operation.
*/
- void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Starts a @a mount_operation, mounting the volume that contains the file.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Starts a @a mount_operation, mounting the volume that contains the file.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void mount_enclosing_volume(const SlotAsyncReady& slot, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_enclosing_volume(const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
_IGNORE(g_file_mount_enclosing_volume)
/** Starts a @a mount_operation, mounting the volume that contains the file.
*
* @param flags Flags affecting the operation.
*/
- void mount_enclosing_volume(Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_enclosing_volume(MountMountFlags flags = MOUNT_MOUNT_NONE);
_IGNORE(g_file_mount_enclosing_volume)
_WRAP_METHOD(bool mount_enclosing_volume_finish(const Glib::RefPtr<AsyncResult>& result),
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a file of type FILE_TYPE_MOUNTABLE. Using @a mount_operation, you can request callbacks when, for instance,
* passwords are needed during authentication.
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void mount_mountable(const SlotAsyncReady& slot, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_mountable(const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction.
*
* @param flags Flags affecting the operation.
*/
- void mount_mountable(Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount_mountable(MountMountFlags flags = MOUNT_MOUNT_NONE);
_IGNORE(g_file_mount_mountable)
_WRAP_METHOD(Glib::RefPtr<File> mount_mountable_finish(const Glib::RefPtr<AsyncResult>& result),
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param flags Flags affecting the operation.
*/
- void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Unmounts a file of type FILE_TYPE_MOUNTABLE.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void unmount_mountable(const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Unmounts a file of type FILE_TYPE_MOUNTABLE.
*
* @param flags Flags affecting the operation.
*/
- void unmount_mountable(Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Unmounts a file of type FILE_TYPE_MOUNTABLE.
*
*
* @newin{2,24}
*/
- void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Unmounts a file of type FILE_TYPE_MOUNTABLE.
*
*
* @newin{2,24}
*/
- void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Unmounts a file of type FILE_TYPE_MOUNTABLE.
*
*
* @newin{2,24}
*/
- void unmount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void unmount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_file_unmount_mountable, g_file_unmount_mountable_finish, g_file_unmount_mountable_with_operation)
* @param cancellable A Cancellable object which can be used to cancel the operation.
* @param flags Flags affecting the operation.
*/
- void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Starts an asynchronous eject on a mountable.
*
* @param slot A callback slot which will be called when the request is satisfied.
* @param flags Flags affecting the operation.
*/
- void eject_mountable(const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Starts an asynchronous eject on a mountable.
*
* @param flags Flags affecting the operation.
*/
- void eject_mountable(Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Starts an asynchronous eject on a mountable.
*
*
* @newin{2,24}
*/
- void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Starts an asynchronous eject on a mountable.
*
*
* @newin{2,24}
*/
- void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Starts an asynchronous eject on a mountable.
*
*
* @newin{2,24}
*/
- void eject_mountable(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject_mountable(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_file_eject_mountable, g_file_eject_mountable_finish, g_file_eject_mountable_with_operation)
* Normally only a subset of the file attributes are copied,
* those that are copies in a normal file copy operation
* (which for instance does not include e.g. mtime). However
- * if CopyFlags::ALL_METADATA is specified in @a flags, then
+ * if FILE_COPY_ALL_METADATA is specified in @a flags, then
* all the metadata that is possible to copy is copied.
*
* @param destination A File to copy attributes to.
* @param flags A set of FileMonitorFlags.
* @result true if the attributes were copied successfully, false otherwise.
*/
- bool copy_attributes(const Glib::RefPtr<File>& destination, const Glib::RefPtr<Cancellable>& cancellable, CopyFlags flags = CopyFlags::NONE);
+ bool copy_attributes(const Glib::RefPtr<File>& destination, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE);
/** Copies the file attributes from @a source to @a destination.
*
* Normally only a subset of the file attributes are copied,
* those that are copies in a normal file copy operation
* (which for instance does not include e.g. mtime). However
- * if CopyFlags::ALL_METADATA is specified in @a flags, then
+ * if FILE_COPY_ALL_METADATA is specified in @a flags, then
* all the metadata that is possible to copy is copied.
*
* @param destination A File to copy attributes to.
* @param flags A set of FileMonitorFlags.
* @result true if the attributes were copied successfully, false otherwise.
*/
- bool copy_attributes(const Glib::RefPtr<File>& destination, CopyFlags flags = CopyFlags::NONE);
+ bool copy_attributes(const Glib::RefPtr<File>& destination, FileCopyFlags flags = FILE_COPY_NONE);
_IGNORE(g_file_copy_attributes)
/** Obtains a directory monitor for the given file.
* @param flags A set of FileMonitorFlags.
* @return A FileMonitor for the file.
*/
- Glib::RefPtr<FileMonitor> monitor_directory(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor_directory(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FILE_MONITOR_NONE);
/** Obtains a directory monitor for the given file.
* This may fail if directory monitoring is not supported.
* @param flags A set of FileMonitorFlags.
* @return A FileMonitor for the file.
*/
- Glib::RefPtr<FileMonitor> monitor_directory(FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor_directory(FileMonitorFlags flags = FILE_MONITOR_NONE);
_IGNORE(g_file_monitor_directory)
/** Obtains a file monitor for the given file. If no file notification
* @param flags A set of FileMonitorFlags.
* @return A FileMonitor for the file.
*/
- Glib::RefPtr<FileMonitor> monitor_file(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor_file(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FILE_MONITOR_NONE);
/** Obtains a file monitor for the given file. If no file notification
* mechanism exists, then regular polling of the file is used.
* @param flags A set of FileMonitorFlags.
* @return A FileMonitor for the file.
*/
- Glib::RefPtr<FileMonitor> monitor_file(FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor_file(FileMonitorFlags flags = FILE_MONITOR_NONE);
_IGNORE(g_file_monitor_file)
*
* @newin{2,18}
*/
- Glib::RefPtr<FileMonitor> monitor(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FILE_MONITOR_NONE);
/** Obtains a file monitor for the given file. If no file notification
* mechanism exists, then regular polling of the file is used.
*
* @newin{2,18}
*/
- Glib::RefPtr<FileMonitor> monitor(FileMonitorFlags flags = FileMonitorFlags::NONE);
+ Glib::RefPtr<FileMonitor> monitor(FileMonitorFlags flags = FILE_MONITOR_NONE);
_IGNORE(g_file_monitor)
*
* @newin{2,38}
*/
- using SlotFileMeasureProgress = sigc::slot<void(bool, guint64, guint64, guint64)>;
+ using SlotFileMeasureProgress = sigc::slot<void, bool, guint64, guint64, guint64>;
//We do not use the {callback} syntax with _WRAP_METHOD here, because it expects to use user_data rather than progress_data.
//We ignore the gboolean result, because we throw an exception if it is false.
* @param disk_usage The number of bytes of disk space used.
* @param num_dirs The number of directories encountered.
* @param num_files The number of non-directories encountered.
- * @param flags Set of MeasureFlags.
+ * @param flags Set of FileMeasureFlags.
*/
- void measure_disk_usage(const Glib::RefPtr<Cancellable>& cancellable, const SlotFileMeasureProgress& slot_progress, guint64& disk_usage, guint64& num_dirs, guint64& num_files, MeasureFlags flags = MeasureFlags::NONE);
+ void measure_disk_usage(const Glib::RefPtr<Cancellable>& cancellable, const SlotFileMeasureProgress& slot_progress, guint64& disk_usage, guint64& num_dirs, guint64& num_files, FileMeasureFlags flags = FILE_MEASURE_NONE);
_IGNORE(g_file_measure_disk_usage)
/** Recursively measures the disk usage of the file.
* @param slot_ready A SlotAsyncReady to call when the request is satisfied
* @param cancellable A Cancellable object which can be used to cancel the operation
* @param slot_progress The callback slot to be called with progress information
- * @param flags Set of MeasureFlags
+ * @param flags Set of FileMeasureFlags
* @param io_priority The I/O priority of the request
*/
- void measure_disk_usage_async(const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, const SlotFileMeasureProgress& slot_progress, MeasureFlags flags = MeasureFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void measure_disk_usage_async(const SlotAsyncReady& slot_ready, const Glib::RefPtr<Cancellable>& cancellable, const SlotFileMeasureProgress& slot_progress, FileMeasureFlags flags = FILE_MEASURE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_measure_disk_usage_async)
_WRAP_METHOD(bool measure_disk_usage_finish(const Glib::RefPtr<AsyncResult>& result, guint64& disk_usage, guint64& num_dirs, guint64& num_files), g_file_measure_disk_usage_finish, errthrow)
*
* @newin{2,24}
*/
- void start_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& start_operation, Drive::StartFlags flags = Drive::StartFlags::NONE);
+ void start_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& start_operation, DriveStartFlags flags = DRIVE_START_NONE);
/** Starts a file of type Mountable.
* Using @a start_operation, you can request callbacks when, for instance,
*
* @newin{2,24}
*/
- void start_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& start_operation, Drive::StartFlags flags = Drive::StartFlags::NONE);
+ void start_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& start_operation, DriveStartFlags flags = DRIVE_START_NONE);
_IGNORE(g_file_start_mountable)
_WRAP_METHOD(bool start_mountable_finish(const Glib::RefPtr<AsyncResult>& result),
*
* @newin{2,24}
*/
- void stop_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& start_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void stop_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<MountOperation>& start_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
/** Stops a file of type Mountable.
*
* @newin{2,24}
*/
- void stop_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& start_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void stop_mountable(const SlotAsyncReady& slot, const Glib::RefPtr<MountOperation>& start_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_file_stop_mountable)
_WRAP_METHOD(bool stop_mountable_finish(const Glib::RefPtr<AsyncResult>& result),
/** A signal handler would be, for instance:
* bool on_read_more(const char* file_contents, goffset file_size);
*/
- using SlotReadMore = sigc::slot<bool(const char*, goffset)>;
+ using SlotReadMore = sigc::slot<bool, const char*, goffset>;
//Note that slot_read_more can be nullptr but that would not be a useful method overload, because the documentation says that it would
//then be equivalent to load_contents_async.
* @param etag The old entity tag
* for the document.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param new_etag A location to a new entity tag
* for the document.
* @param cancellable A Cancellable object.
*/
- void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Replaces the contents of the file with @a contents of @a length bytes.
*
* @param etag The old entity tag
* for the document.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param new_etag A location to a new entity tag
* for the document.
*/
- void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Replaces the contents of the file with @a contents.
*
* @param etag The old entity tag
* for the document.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param new_etag A location to a new entity tag
* for the document.
* @param cancellable A Cancellable object.
*/
- void replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Replaces the contents of the file with @a contents.
*
* @param etag The old entity tag
* for the document.
* @param make_backup <tt>true</tt> if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
* @param new_etag A location to a new entity tag
* for the document.
*/
- void replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_replace_contents)
* @param length The length of @a contents in bytes.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const char* contents, gsize length, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const char* contents, gsize length, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Starts an asynchronous replacement of the file with the given
* @a contents of @a length bytes. @a etag will replace the document's
* @param length The length of @a contents in bytes.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_async(const SlotAsyncReady& slot, const char* contents, gsize length, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_async(const SlotAsyncReady& slot, const char* contents, gsize length, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Starts an asynchronous replacement of the file with the given
* @a contents of @a length bytes. @a etag will replace the document's
* @param contents String of contents to replace the file with.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& contents, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& contents, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Starts an asynchronous replacement of the file with the given
* @a contents. @a etag will replace the document's
* @param contents String of contents to replace the file with.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_async(const SlotAsyncReady& slot, const std::string& contents, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_async(const SlotAsyncReady& slot, const std::string& contents, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_replace_contents_async)
* @param contents Bytes of contents to replace the file with.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_bytes_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<const Glib::Bytes>& contents, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_bytes_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const Glib::RefPtr<const Glib::Bytes>& contents, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
/** Same as replace_contents_async() but takes a Gio::Bytes input instead.
*
* @param contents Bytes of contents to replace the file with.
* @param etag a new entity tag for the file.
* @param make_backup true if a backup should be created.
- * @param flags A set of CreateFlags.
+ * @param flags A set of FileCreateFlags.
*/
- void replace_contents_bytes_async(const SlotAsyncReady& slot, const Glib::RefPtr<const Glib::Bytes>& contents, const std::string& etag, bool make_backup = false, CreateFlags flags = CreateFlags::NONE);
+ void replace_contents_bytes_async(const SlotAsyncReady& slot, const Glib::RefPtr<const Glib::Bytes>& contents, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE);
_IGNORE(g_file_replace_contents_async)
FileAttributeInfo::FileAttributeInfo(const GFileAttributeInfo* ginfo)
: m_name(ginfo->name ? ginfo->name : ""),
m_type(static_cast<FileAttributeType>(ginfo->type)),
- m_flags(static_cast<Flags>(ginfo->flags))
+ m_flags(static_cast<FileAttributeInfoFlags>(ginfo->flags))
{
}
return m_type;
}
-FileAttributeInfo::Flags
+FileAttributeInfoFlags
FileAttributeInfo::get_flags() const
{
return m_flags;
{
_WRAP_ENUM(FileAttributeType, GFileAttributeType)
+_WRAP_ENUM(FileAttributeInfoFlags, GFileAttributeInfoFlags)
_WRAP_ENUM(FileAttributeStatus, GFileAttributeStatus)
{
_CLASS_GENERIC(FileAttributeInfo, GFileAttributeInfo)
public:
- _WRAP_ENUM(Flags, GFileAttributeInfoFlags)
-
explicit FileAttributeInfo(const GFileAttributeInfo* ginfo);
FileAttributeInfo(const FileAttributeInfo& other);
std::string get_name() const;
FileAttributeType get_type() const;
- Flags get_flags() const;
+ FileAttributeInfoFlags get_flags() const;
protected:
std::string m_name;
FileAttributeType m_type;
- Flags m_flags;
+ FileAttributeInfoFlags m_flags;
};
} // namespace Gio
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* e.g. "standard::*" will return all of the keys in the "standard" namespace.
*
* Values are stored within the list in Gio::FileAttributeValue structures. Values can store different types, listed in the enum
- * Gio::FileAttributeType. Upon creation of a Gio::FileAttributeValue, the type will be set to Gio::FileAttributeType::INVALID.
+ * Gio::FileAttributeType. Upon creation of a Gio::FileAttributeValue, the type will be set to Gio::FILE_ATTRIBUTE_TYPE_INVALID.
*
* The list of possible attributes for a filesystem (pointed to by a Gio::File) is availible as a Gio::FileAttributeInfoList.
* This list is queryable by key names as indicated earlier.
_WRAP_METHOD(Glib::RefPtr<FileAttributeInfoList> dup() const, g_file_attribute_info_list_dup)
- _WRAP_METHOD(void add(const std::string& name, FileAttributeType type, FileAttributeInfo::Flags flags = FileAttributeInfo::Flags::NONE), g_file_attribute_info_list_add)
+ _WRAP_METHOD(void add(const std::string& name, FileAttributeType type, FileAttributeInfoFlags flags = FILE_ATTRIBUTE_INFO_NONE), g_file_attribute_info_list_add)
};
} // namespace Gio
+++ /dev/null
-/* Copyright (C) 2017 The giomm Development Team
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include <glibmm/interface.h>
-
-_DEFS(giomm,gio)
-_PINCLUDE(glibmm/private/interface_p.h)
-
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-typedef struct _GFileDescriptorBasedIface GFileDescriptorBasedIface;
-#endif /* DOXYGEN_SHOULD_SKIP_THIS */
-
-namespace Gio
-{
-
-/** Interface for file descriptor based IO.
- *
- * %FileDescriptorBased is implemented by streams (implementations of
- * Gio::InputStream or Gio::OutputStream) that are based on file descriptors.
- *
- * @ingroup Streams
- *
- * @newin{2,58}
- */
-class FileDescriptorBased : public Glib::Interface
-{
- _CLASS_INTERFACE(FileDescriptorBased, GFileDescriptorBased, G_FILE_DESCRIPTOR_BASED, GFileDescriptorBasedIface)
- _GTKMMPROC_WIN32_NO_WRAP
-
-public:
- _WRAP_METHOD(int get_fd() const, g_file_descriptor_based_get_fd, newin "2,58")
-
-protected:
- _WRAP_VFUNC(int get_fd() const, "get_fd")
-};
-
-} // namespace Gio
*/
#include <glibmm/object.h>
+#include <glibmm/arrayhandle.h>
+#include <glibmm/listhandle.h>
#include <glibmm/priorities.h>
#include <giomm/asyncresult.h>
#include <giomm/cancellable.h>
void next_files_async(const SlotAsyncReady& slot, int num_files = 1, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_file_enumerator_next_files_async)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<FileInfo>>', `Glib::ListHandler<Glib::RefPtr<FileInfo>>::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(
std::vector<Glib::RefPtr<FileInfo>> next_files_finish(const Glib::RefPtr<AsyncResult>& result),
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<FileInfo> >', `$2(($3), Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(
Glib::ListHandle< Glib::RefPtr<FileInfo> > next_files_finish(const Glib::RefPtr<AsyncResult>& result),
g_file_enumerator_next_files_finish,
errthrow)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
*/
class FileIcon
: public Glib::Object,
- public Icon,
+ //Already derived by LoadableIcon: public Icon,
public LoadableIcon
{
_CLASS_GOBJECT(FileIcon, GFileIcon, G_FILE_ICON, Glib::Object, GObject)
- _IMPLEMENTS_INTERFACE(Icon)
_IMPLEMENTS_INTERFACE(LoadableIcon)
protected:
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmm/arrayhandle.h>
#include <glibmm/datetime.h>
#include <glibmm/object.h>
#include <glibmm/timeval.h>
namespace Gio
{
-_WRAP_ENUM(FileType, GFileType, NO_GTYPE)
+
+// Rename FILE_TYPE_UNKNOWN to FILE_TYPE_NOT_KNOWN because the former is a
+// define in a Windows header (winbase.h, included from windows.h).
+_WRAP_ENUM(FileType, GFileType, NO_GTYPE, s#FILE_TYPE_UNKNOWN#FILE_TYPE_NOT_KNOWN#)
+
+// Provide FILE_TYPE_UNKNOWN for backwards compatibility.
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+#ifndef FILE_TYPE_UNKNOWN
+const FileType FILE_TYPE_UNKNOWN = FILE_TYPE_NOT_KNOWN;
+#endif
+#endif
//TODO: attribute strings
_WRAP_METHOD(bool has_namespace(const std::string& name_space) const, g_file_info_has_namespace)
- #m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> list_attributes(const std::string& name_space{?}) const,
+ #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle list_attributes(const std::string& name_space{?}) const,
g_file_info_list_attributes)
_WRAP_METHOD(FileAttributeType get_attribute_type(const std::string& attribute) const,
_WRAP_METHOD(FileAttributeStatus get_attribute_status(const std::string& attribute) const, g_file_info_get_attribute_status)
- _WRAP_METHOD(Glib::ustring get_attribute_string(const std::string& attribute) const,
+ //TODO: This should return a ustring instead: https://bugzilla.gnome.org/show_bug.cgi?id=615950#c7
+ _WRAP_METHOD(std::string get_attribute_string(const std::string& attribute) const,
g_file_info_get_attribute_string)
#m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_NONE)')
_WRAP_METHOD(bool set_attribute_status(const std::string& attribute, FileAttributeStatus status), g_file_info_set_attribute_status)
- _WRAP_METHOD(void set_attribute_string(const std::string& attribute, const Glib::ustring& attr_value),
+ //TODO: This should take a ustring value instead: https://bugzilla.gnome.org/show_bug.cgi?id=615950#c7
+ _WRAP_METHOD(void set_attribute_string(const std::string& attribute, const std::string& attr_value),
g_file_info_set_attribute_string)
#m4 _CONVERSION(`const std::vector<Glib::ustring>&',`char**',`const_cast<char**>(Glib::ArrayHandler<Glib::ustring>::vector_to_array($3).data())')
_WRAP_METHOD(bool is_symlink() const, g_file_info_get_is_symlink)
_WRAP_METHOD(std::string get_name() const, g_file_info_get_name)
- _WRAP_METHOD(Glib::ustring get_display_name() const, g_file_info_get_display_name)
+ //TODO: This should return a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(std::string get_display_name() const, g_file_info_get_display_name)
- _WRAP_METHOD(Glib::ustring get_edit_name() const, g_file_info_get_edit_name)
+ //TODO: This should return a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(std::string get_edit_name() const, g_file_info_get_edit_name)
_WRAP_METHOD(Glib::RefPtr<Icon> get_icon(), g_file_info_get_icon, refreturn)
_WRAP_METHOD(Glib::RefPtr<const Icon> get_icon() const, g_file_info_get_icon, refreturn, constversion)
_WRAP_METHOD(Glib::RefPtr<Icon> get_symbolic_icon(), g_file_info_get_symbolic_icon, refreturn)
_WRAP_METHOD(Glib::RefPtr<const Icon> get_symbolic_icon() const, g_file_info_get_symbolic_icon, refreturn, constversion)
- _WRAP_METHOD(Glib::ustring get_content_type() const, g_file_info_get_content_type)
+ //TODO: This should return a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(std::string get_content_type() const, g_file_info_get_content_type)
_WRAP_METHOD(goffset get_size() const, g_file_info_get_size)
_WRAP_METHOD(std::string get_symlink_target() const, g_file_info_get_symlink_target)
- _WRAP_METHOD(Glib::ustring get_etag() const, g_file_info_get_etag)
+ //TODO: This should return a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(std::string get_etag() const, g_file_info_get_etag)
_WRAP_METHOD(gint32 get_sort_order() const, g_file_info_get_sort_order)
_WRAP_METHOD(void set_attribute_mask(const Glib::RefPtr<FileAttributeMatcher>& mask),
_WRAP_METHOD(void set_is_symlink(bool symlink = true), g_file_info_set_is_symlink)
_WRAP_METHOD(void set_name(const std::string& name), g_file_info_set_name)
- _WRAP_METHOD(void set_display_name(const Glib::ustring& display_name), g_file_info_set_display_name)
+ //TODO: This should take a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(void set_display_name(const std::string& display_name), g_file_info_set_display_name)
- _WRAP_METHOD(void set_edit_name(const Glib::ustring& edit_name), g_file_info_set_edit_name)
+ //TODO: This should take a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(void set_edit_name(const std::string& edit_name), g_file_info_set_edit_name)
_WRAP_METHOD(void set_icon(const Glib::RefPtr<Icon>& icon), g_file_info_set_icon)
_WRAP_METHOD(void set_symbolic_icon(const Glib::RefPtr<Icon>& icon), g_file_info_set_symbolic_icon)
- _WRAP_METHOD(void set_content_type(const Glib::ustring& content_type), g_file_info_set_content_type)
+ //TODO: This should take a ustring instead. See https://bugzilla.gnome.org/show_bug.cgi?id=615950#c4
+ _WRAP_METHOD(void set_content_type(const std::string& content_type), g_file_info_set_content_type)
_WRAP_METHOD(void set_size(goffset size), g_file_info_set_size)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
_WRAP_METHOD(Glib::RefPtr<FileInfo> query_info_finish(const Glib::RefPtr<AsyncResult>& result),
g_file_io_stream_query_info_finish,
errthrow)
- _WRAP_METHOD(Glib::ustring get_etag() const, g_file_io_stream_get_etag)
+ _WRAP_METHOD(std::string get_etag() const, g_file_io_stream_get_etag)
};
permission.hg \
pollableinputstream.hg \
pollableoutputstream.hg \
- propertyaction.hg \
proxy.hg \
proxyaddress.hg \
proxyresolver.hg \
zlibcompressor.hg
giomm_files_posix_hg = \
- filedescriptorbased.hg \
unixconnection.hg \
unixcredentialsmessage.hg \
unixfdlist.hg \
include $(top_srcdir)/gio/src/filelist.am
+# Split out from $(top_srcdir)/gio/src/filelist.am
if HOST_WINDOWS_NATIVE
giomm_files_arch_hg =
else
#include <giomm/file.h>
#include <gio/gio.h>
-using Event = Gio::FileMonitor::Event;
-
namespace Gio
{
namespace Gio
{
+_WRAP_ENUM(FileMonitorEvent, GFileMonitorEvent, NO_GTYPE)
class File;
public:
- _WRAP_ENUM(Event, GFileMonitorEvent, NO_GTYPE)
-
_WRAP_METHOD(bool cancel(), g_file_monitor_cancel)
_WRAP_METHOD(bool is_cancelled() const, g_file_monitor_is_cancelled)
_WRAP_METHOD(void set_rate_limit(int limit_msecs), g_file_monitor_set_rate_limit)
_IGNORE(g_file_monitor_emit_event)
#m4 _CONVERSION(`GFile*',`const Glib::RefPtr<File>&',`Glib::wrap($3, true)')
- _WRAP_SIGNAL(void changed(const Glib::RefPtr<File>& file, const Glib::RefPtr<File>& other_file, Event event_type), "changed")
+ _WRAP_SIGNAL(void changed(const Glib::RefPtr<File>& file, const Glib::RefPtr<File>& other_file, FileMonitorEvent event_type), "changed")
//_WRAP_VFUNC(bool cancel(), cancel);
*/
//#include <giomm/file.h>
+#include <glibmm/arrayhandle.h>
#include <glibmm/object.h>
_DEFS(giomm,gio)
_WRAP_METHOD(std::string get_completion_suffix(const std::string& initial_text) const, g_filename_completer_get_completion_suffix)
- #m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> get_completions(const std::string& initial_text) const, g_filename_completer_get_completions)
+ #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle get_completions(const std::string& initial_text) const, g_filename_completer_get_completions)
_WRAP_METHOD(void set_dirs_only(bool dirs_only = true), g_filename_completer_set_dirs_only)
_WRAP_SIGNAL(void got_completion_data(), got_completion_data)
g_file_output_stream_query_info_finish,
refreturn, errthrow)
- _WRAP_METHOD(Glib::ustring get_etag() const, g_file_output_stream_get_etag)
+ _WRAP_METHOD(std::string get_etag() const, g_file_output_stream_get_etag)
};
} // namespace Gio
</return>
</signal>
+<signal name="GApplication::name-lost">
+<description>
+The ::name-lost signal is emitted only on the registered primary instance
+when a new instance has taken over. This can only happen if the application
+is using the %G_APPLICATION_ALLOW_REPLACEMENT flag.
+
+The default handler for this signal calls g_application_quit().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> the application
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the signal has been handled
+
+</return>
+</signal>
+
<signal name="GApplication::open">
<description>
The ::open signal is emitted on the primary instance when there are
Since: 2.48
</parameter_description>
</parameter>
+<parameter name="G_APPLICATION_ALLOW_REPLACEMENT">
+<parameter_description> Allow another instance to take over
+the bus name. Since: 2.60
+</parameter_description>
+</parameter>
+<parameter name="G_APPLICATION_REPLACE">
+<parameter_description> Take over from another instance. This flag is
+usually set by passing `--gapplication-replace` on the commandline.
+Since: 2.60
+</parameter_description>
+</parameter>
</parameters>
</enum>
let the user decide whether or not to accept the certificate, you
would have to return %FALSE from the signal handler on the first
attempt, and then after the connection attempt returns a
-%G_TLS_ERROR_HANDSHAKE, you can interact with the user, and if
-the user decides to accept the certificate, remember that fact,
+%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and
+if the user decides to accept the certificate, remember that fact,
create a new connection, and return %TRUE from the signal handler
the next time.
</return>
</signal>
+<property name="GDtlsConnection:advertised-protocols">
+<description>
+The list of application-layer protocols that the connection
+advertises that it is willing to speak. See
+g_dtls_connection_set_advertised_protocols().
+
+Since: 2.60
+
+</description>
+</property>
+
<property name="GDtlsConnection:base-socket">
<description>
The #GDatagramBased that the connection wraps. Note that this may be any
</description>
</property>
+<property name="GDtlsConnection:negotiated-protocol">
+<description>
+The application-layer protocol negotiated during the TLS
+handshake. See g_dtls_connection_get_negotiated_protocol().
+
+Since: 2.60
+
+</description>
+</property>
+
<property name="GDtlsConnection:peer-certificate">
<description>
The connection's peer's certificate, after the TLS handshake has
Since: 2.48
+Deprecated: 2.60. Changing the rehandshake mode is no longer
+required for compatibility. Also, rehandshaking has been removed
+from the TLS protocol in TLS 1.3.
+
</description>
</property>
but should instead treat all unrecognized error codes the same as
#G_IO_ERROR_FAILED.
+See also #GPollableReturn for a cheaper way of returning
+%G_IO_ERROR_WOULD_BLOCK to callers without allocating a #GError.
+
</description>
<parameters>
<parameter name="G_IO_ERROR_FAILED">
</description>
</property>
+<property name="GKeyfileSettingsBackend:default-dir">
+<description>
+The directory where the system defaults and locks are located.
+
+Defaults to `/etc/glib-2.0/settings`.
+
+</description>
+</property>
+
+<property name="GKeyfileSettingsBackend:filename">
+<description>
+The location where the settings are stored on disk.
+
+Defaults to `$XDG_CONFIG_HOME/glib-2.0/settings/keyfile`.
+
+</description>
+</property>
+
+<property name="GKeyfileSettingsBackend:root-group">
+<description>
+If @root_group is non-%NULL then it specifies the name of the keyfile
+group used for keys that are written directly below the root path.
+
+Defaults to NULL.
+
+</description>
+</property>
+
+<property name="GKeyfileSettingsBackend:root-path">
+<description>
+All settings read to or written from the backend must fall under the
+path given in @root_path (which must start and end with a slash and
+not contain two consecutive slashes). @root_path may be "/".
+
+Defaults to "/".
+
+</description>
+</property>
+
<signal name="GListModel::items-changed">
<description>
This signal is emitted whenever items were added or removed to
<property name="GMountOperation:is-tcrypt-hidden-volume">
<description>
Whether the device to be unlocked is a TCRYPT hidden volume.
-See https://www.veracrypt.fr/en/Hidden%20Volume.html.
+See [the VeraCrypt documentation](https://www.veracrypt.fr/en/Hidden%20Volume.html).
Since: 2.58
In this context, a system volume is a volume with a bootloader
and operating system installed. This is only supported for Windows
operating systems. For further documentation, see
-https://www.veracrypt.fr/en/System%20Encryption.html.
+[the VeraCrypt documentation](https://www.veracrypt.fr/en/System%20Encryption.html).
Since: 2.58
<property name="GMountOperation:pim">
<description>
The VeraCrypt PIM value, when unlocking a VeraCrypt volume. See
-https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html.
+[the VeraCrypt documentation](https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html).
Since: 2.58
</description>
</property>
+<enum name="GPollableReturn">
+<description>
+Return value for various IO operations that signal errors via the
+return value and not necessarily via a #GError.
+
+This enum exists to be able to return errors to callers without having to
+allocate a #GError. Allocating #GErrors can be quite expensive for
+regularly happening errors like %G_IO_ERROR_WOULD_BLOCK.
+
+In case of %G_POLLABLE_RETURN_FAILED a #GError should be set for the
+operation to give details about the error that happened.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="G_POLLABLE_RETURN_FAILED">
+<parameter_description> Generic error condition for when an operation fails.
+</parameter_description>
+</parameter>
+<parameter name="G_POLLABLE_RETURN_OK">
+<parameter_description> The operation was successfully finished.
+</parameter_description>
+</parameter>
+<parameter name="G_POLLABLE_RETURN_WOULD_BLOCK">
+<parameter_description> The operation would block.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<property name="GPropertyAction:enabled">
<description>
If @action is currently enabled.
</parameters>
</enum>
+<enum name="GResolverNameLookupFlags">
+<description>
+Flags to modify lookup behavior.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT">
+<parameter_description> default behavior (same as g_resolver_lookup_by_name())
+</parameter_description>
+</parameter>
+<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY">
+<parameter_description> only resolve ipv4 addresses
+</parameter_description>
+</parameter>
+<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY">
+<parameter_description> only resolve ipv6 addresses
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GResolverRecordType">
<description>
The type of record that g_resolver_lookup_records() or
let the user decide whether or not to accept the certificate, you
would have to return %FALSE from the signal handler on the first
attempt, and then after the connection attempt returns a
-%G_TLS_ERROR_HANDSHAKE, you can interact with the user, and if
-the user decides to accept the certificate, remember that fact,
+%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and
+if the user decides to accept the certificate, remember that fact,
create a new connection, and return %TRUE from the signal handler
the next time.
</return>
</signal>
+<property name="GTlsConnection:advertised-protocols">
+<description>
+The list of application-layer protocols that the connection
+advertises that it is willing to speak. See
+g_tls_connection_set_advertised_protocols().
+
+Since: 2.60
+
+</description>
+</property>
+
<property name="GTlsConnection:base-io-stream">
<description>
The #GIOStream that the connection wraps. The connection holds a reference
</description>
</property>
+<property name="GTlsConnection:negotiated-protocol">
+<description>
+The application-layer protocol negotiated during the TLS
+handshake. See g_tls_connection_get_negotiated_protocol().
+
+Since: 2.60
+
+</description>
+</property>
+
<property name="GTlsConnection:peer-certificate">
<description>
The connection's peer's certificate, after the TLS handshake has
</parameter_description>
</parameter>
<parameter name="G_TLS_ERROR_BAD_CERTIFICATE">
-<parameter_description> A certificate could not be parsed
+<parameter_description> The certificate presented could not
+be parsed or failed validation.
</parameter_description>
</parameter>
<parameter name="G_TLS_ERROR_NOT_TLS">
Since: 2.28
+Deprecated: 2.60. Changing the rehandshake mode is no longer
+required for compatibility. Also, rehandshaking has been removed
+from the TLS protocol in TLS 1.3.
+
</description>
<parameters>
<parameter name="G_TLS_REHANDSHAKE_NEVER">
is done on the uri to detect the type of the file if
required.
+The D-Bus–activated applications don't have to be started if your application
+terminates too soon after this function. To prevent this, use
+g_app_info_launch_default_for_uri() instead.
+
</description>
<parameters>
sandboxed and the portal may present an application chooser
dialog to the user.
+This is also useful if you want to be sure that the D-Bus–activated
+applications are really started before termination and if you are interested
+in receiving error information from their activation.
+
Since: 2.50
</description>
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GASyncReadyCallback to call when the request is done
+<parameter_description> a #GAsyncReadyCallback to call when the request is done
</parameter_description>
</parameter>
<parameter name="user_data">
</return>
</function>
+<function name="g_app_info_launch_uris_async">
+<description>
+Async version of g_app_info_launch_uris().
+
+The @callback is invoked immediately after the application launch, but it
+waits for activation in case of D-Bus–activated applications and also provides
+extended error information for sandboxed applications, see notes for
+g_app_info_launch_default_for_uri_async().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="uris">
+<parameter_description> a #GList containing URIs to launch.
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext or %NULL
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_app_info_launch_uris_finish">
+<description>
+Finishes a g_app_info_launch_uris_async() operation.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on successful launch, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_app_info_monitor_get">
<description>
Gets the #GAppInfoMonitor for the current thread-default main
</parameter_description>
</parameter>
</parameters>
-<return> A valid file descriptor. %-1 if the file descriptor
+<return> A valid file descriptor. `-1` if the file descriptor
is not supported, or on errors.
</return>
</function>
</return>
</function>
+<function name="g_content_type_get_mime_dirs">
+<description>
+Get the list of directories which MIME data is loaded from. See
+g_content_type_set_mime_dirs() for details.
+
+Since: 2.60
+
+</description>
+<parameters>
+</parameters>
+<return> %NULL-terminated list of
+directories to load MIME data from, including any `mime/` subdirectory,
+and with the first directory to try listed first
+</return>
+</function>
+
<function name="g_content_type_get_mime_type">
<description>
Gets the mime type for the content type, if one is registered.
</return>
</function>
+<function name="g_content_type_set_mime_dirs">
+<description>
+Set the list of directories used by GIO to load the MIME database.
+If @dirs is %NULL, the directories used are the default:
+
+- the `mime` subdirectory of the directory in `$XDG_DATA_HOME`
+- the `mime` subdirectory of every directory in `$XDG_DATA_DIRS`
+
+This function is intended to be used when writing tests that depend on
+information stored in the MIME database, in order to control the data.
+
+Typically, in case your tests use %G_TEST_OPTION_ISOLATE_DIRS, but they
+depend on the system’s MIME database, you should call this function
+with @dirs set to %NULL before calling g_test_init(), for instance:
+
+|[<!-- language="C" -->
+// Load MIME data from the system
+g_content_type_set_mime_dirs (NULL);
+// Isolate the environment
+g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL);
+
+…
+
+return g_test_run ();
+]|
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="dirs">
+<parameter_description> %NULL-terminated list of
+directories to load MIME data from, including any `mime/` subdirectory,
+and with the first directory to try listed first
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_content_types_get_registered">
<description>
Gets a list of strings containing all the registered content types
known to the system. The list and its data should be freed using
-g_list_free_full (list, g_free).
+`g_list_free_full (list, g_free)`.
</description>
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 8-bit/1-byte value read from the @stream or %0
+<return> an unsigned 8-bit/1-byte value read from the @stream or `0`
if an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> a signed 16-bit/2-byte value read from @stream or %0 if
+<return> a signed 16-bit/2-byte value read from @stream or `0` if
an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> a signed 32-bit/4-byte value read from the @stream or %0 if
+<return> a signed 32-bit/4-byte value read from the @stream or `0` if
an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> a signed 64-bit/8-byte value read from @stream or %0 if
+<return> a signed 64-bit/8-byte value read from @stream or `0` if
an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 16-bit/2-byte value read from the @stream or %0 if
+<return> an unsigned 16-bit/2-byte value read from the @stream or `0` if
an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 32-bit/4-byte value read from the @stream or %0 if
+<return> an unsigned 32-bit/4-byte value read from the @stream or `0` if
an error occurred.
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 64-bit/8-byte read from @stream or %0 if
+<return> an unsigned 64-bit/8-byte read from @stream or `0` if
an error occurred.
</return>
</function>
</return>
</function>
+<function name="g_dbus_connection_get_flags">
+<description>
+Gets the flags used to construct this connection
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> zero or more flags from the #GDBusConnectionFlags enumeration
+
+</return>
+</function>
+
<function name="g_dbus_connection_get_guid">
<description>
The GUID of the peer performing the role of server when
signal is unsubscribed from, and may be called after @connection
has been destroyed.)
+The returned subscription identifier is an opaque value which is guaranteed
+to never be zero.
+
+This function can never fail.
+
Since: 2.26
</description>
The @key is looked up in the "Desktop Entry" group.
-Since: 2.59.0
+Since: 2.60.0
</description>
<parameters>
</return>
</function>
+<function name="g_dtls_connection_get_negotiated_protocol">
+<description>
+Gets the name of the application-layer protocol negotiated during
+the handshake.
+
+If the peer did not use the ALPN extension, or did not advertise a
+protocol that matched one of @conn's protocols, or the TLS backend
+does not support ALPN, then this will be %NULL. See
+g_dtls_connection_set_advertised_protocols().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GDtlsConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> the negotiated protocol, or %NULL
+
+</return>
+</function>
+
<function name="g_dtls_connection_get_peer_certificate">
<description>
Gets @conn's peer's certificate after the handshake has completed.
Likewise, on the server side, although a handshake is necessary at
the beginning of the communication, you do not need to call this
function explicitly unless you want clearer error reporting.
-However, you may call g_dtls_connection_handshake() later on to
-renegotiate parameters (encryption methods, etc) with the client.
+
+If TLS 1.2 or older is in use, you may call
+g_dtls_connection_handshake() after the initial handshake to
+rehandshake; however, this usage is deprecated because rehandshaking
+is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
+behavior of calling this function after the initial handshake is now
+undefined, except it is guaranteed to be reasonable and
+nondestructive so as to preserve compatibility with code written for
+older versions of GLib.
#GDtlsConnection::accept_certificate may be emitted during the
handshake.
</return>
</function>
+<function name="g_dtls_connection_set_advertised_protocols">
+<description>
+Sets the list of application-layer protocols to advertise that the
+caller is willing to speak on this connection. The
+Application-Layer Protocol Negotiation (ALPN) extension will be
+used to negotiate a compatible protocol with the peer; use
+g_dtls_connection_get_negotiated_protocol() to find the negotiated
+protocol after the handshake. Specifying %NULL for the the value
+of @protocols will disable ALPN negotiation.
+
+See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids)
+for a list of registered protocol IDs.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GDtlsConnection
+</parameter_description>
+</parameter>
+<parameter name="protocols">
+<parameter_description> a %NULL-terminated
+array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_dtls_connection_set_certificate">
<description>
This sets the certificate that @conn will present to its peer
Since: 2.48
+Deprecated: 2.60. Changing the rehandshake mode is no longer
+required for compatibility. Also, rehandshaking has been removed
+from the TLS protocol in TLS 1.3.
+
</description>
<parameters>
<parameter name="conn">
</parameter_description>
</parameter>
<parameter name="attr_value">
-<parameter_description> a %NULL terminated array of UTF-8 strings.
+<parameter_description> a %NULL
+terminated array of UTF-8 strings.
</parameter_description>
</parameter>
</parameters>
</return>
</function>
+<function name="g_file_query_default_handler_async">
+<description>
+Async version of g_file_query_default_handler().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile to open
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_query_default_handler_finish">
+<description>
+Finishes a g_file_query_default_handler_async() operation.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile to open
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GAppInfo if the handle was found,
+%NULL if there were errors.
+When you are done with it, release it with g_object_unref()
+
+</return>
+</function>
+
<function name="g_file_query_exists">
<description>
Utility function to check if a particular file exists. This is
characters in your path names or '=' in your key names you may be in
trouble.
+The backend reads default values from a keyfile called `defaults` in
+the directory specified by the #GKeyfileSettingsBackend:defaults-dir property,
+and a list of locked keys from a text file with the name `locks` in
+the same location.
+
</description>
<parameters>
</return>
</function>
+<function name="g_output_stream_writev">
+<description>
+Tries to write the bytes contained in the @n_vectors @vectors into the
+stream. Will block during the operation.
+
+If @n_vectors is 0 or the sum of all bytes in @vectors is 0, returns 0 and
+does nothing.
+
+On success, the number of bytes written to the stream is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. on a partial I/O error, or if there is not enough
+storage in the stream. All writes block until at least one byte
+is written or an error occurs; 0 is never returned (unless
+@n_vectors is 0 or the sum of all bytes in @vectors is 0).
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+Some implementations of g_output_stream_writev() may have limitations on the
+aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these
+are exceeded. For example, when writing to a local file on UNIX platforms,
+the aggregate buffer size must not exceed %G_MAXSSIZE bytes.
+
+Virtual: writev_fn
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> the buffer containing the #GOutputVectors to write.
+</parameter_description>
+</parameter>
+<parameter name="n_vectors">
+<parameter_description> the number of vectors to write
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+
+</return>
+</function>
+
+<function name="g_output_stream_writev_all">
+<description>
+Tries to write the bytes contained in the @n_vectors @vectors into the
+stream. Will block during the operation.
+
+This function is similar to g_output_stream_writev(), except it tries to
+write as many bytes as requested, only stopping on an error.
+
+On a successful write of all @n_vectors vectors, %TRUE is returned, and
+@bytes_written is set to the sum of all the sizes of @vectors.
+
+If there is an error during the operation %FALSE is returned and @error
+is set to indicate the error status.
+
+As a special exception to the normal conventions for functions that
+use #GError, if this function returns %FALSE (and sets @error) then
+@bytes_written will be set to the number of bytes that were
+successfully written before the error was encountered. This
+functionality is only available from C. If you need it from another
+language then you must write your own loop around
+g_output_stream_write().
+
+The content of the individual elements of @vectors might be changed by this
+function.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> the buffer containing the #GOutputVectors to write.
+</parameter_description>
+</parameter>
+<parameter name="n_vectors">
+<parameter_description> the number of vectors to write
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+
+</return>
+</function>
+
+<function name="g_output_stream_writev_all_async">
+<description>
+Request an asynchronous write of the bytes contained in the @n_vectors @vectors into
+the stream. When the operation is finished @callback will be called.
+You can then call g_output_stream_writev_all_finish() to get the result of the
+operation.
+
+This is the asynchronous version of g_output_stream_writev_all().
+
+Call g_output_stream_writev_all_finish() to collect the result.
+
+Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is %G_PRIORITY_DEFAULT.
+
+Note that no copy of @vectors will be made, so it must stay valid
+until @callback is called. The content of the individual elements
+of @vectors might be changed by this function.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> the buffer containing the #GOutputVectors to write.
+</parameter_description>
+</parameter>
+<parameter name="n_vectors">
+<parameter_description> the number of vectors to write
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the I/O priority of the request
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_writev_all_finish">
+<description>
+Finishes an asynchronous stream write operation started with
+g_output_stream_writev_all_async().
+
+As a special exception to the normal conventions for functions that
+use #GError, if this function returns %FALSE (and sets @error) then
+@bytes_written will be set to the number of bytes that were
+successfully written before the error was encountered. This
+functionality is only available from C. If you need it from another
+language then you must write your own loop around
+g_output_stream_writev_async().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were written to the stream
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+
+</return>
+</function>
+
+<function name="g_output_stream_writev_async">
+<description>
+Request an asynchronous write of the bytes contained in @n_vectors @vectors into
+the stream. When the operation is finished @callback will be called.
+You can then call g_output_stream_writev_finish() to get the result of the
+operation.
+
+During an async request no other sync and async calls are allowed,
+and will result in %G_IO_ERROR_PENDING errors.
+
+On success, the number of bytes written will be passed to the
+@callback. It is not an error if this is not the same as the
+requested size, as it can happen e.g. on a partial I/O error,
+but generally we try to write as many bytes as requested.
+
+You are guaranteed that this method will never fail with
+%G_IO_ERROR_WOULD_BLOCK — if @stream can't accept more data, the
+method will just wait until this changes.
+
+Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is %G_PRIORITY_DEFAULT.
+
+The asynchronous methods have a default fallback that uses threads
+to implement asynchronicity, so they are optional for inheriting
+classes. However, if you override one you must override all.
+
+For the synchronous, blocking version of this function, see
+g_output_stream_writev().
+
+Note that no copy of @vectors will be made, so it must stay valid
+until @callback is called.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> the buffer containing the #GOutputVectors to write.
+</parameter_description>
+</parameter>
+<parameter name="n_vectors">
+<parameter_description> the number of vectors to write
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the I/O priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_writev_finish">
+<description>
+Finishes a stream writev operation.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were written to the stream
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+
+</return>
+</function>
+
<function name="g_permission_acquire">
<description>
Attempts to acquire the permission represented by @permission.
to having been cancelled.
Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
-transports like D/TLS require that you send the same @buffer and @count.
+transports like D/TLS require that you re-send the same @buffer and
+@count in the next write call.
Virtual: write_nonblocking
</return>
</function>
+<function name="g_pollable_output_stream_writev_nonblocking">
+<description>
+Attempts to write the bytes contained in the @n_vectors @vectors to @stream,
+as with g_output_stream_writev(). If @stream is not currently writable,
+this will immediately return %@G_POLLABLE_RETURN_WOULD_BLOCK, and you can
+use g_pollable_output_stream_create_source() to create a #GSource
+that will be triggered when @stream is writable. @error will *not* be
+set in that case.
+
+Note that since this method never blocks, you cannot actually
+use @cancellable to cancel it. However, it will return an error
+if @cancellable has already been cancelled when you call, which
+may happen if you call this method after a source triggers due
+to having been cancelled.
+
+Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying
+transports like D/TLS require that you re-send the same @vectors and
+@n_vectors in the next write call.
+
+Virtual: writev_nonblocking
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableOutputStream
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> the buffer containing the #GOutputVectors to write.
+</parameter_description>
+</parameter>
+<parameter name="n_vectors">
+<parameter_description> the number of vectors to write
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK
+if the stream is not currently writable (and @error is *not* set), or
+%G_POLLABLE_RETURN_FAILED if there was an error in which case @error will
+be set.
+
+</return>
+</function>
+
<function name="g_pollable_source_new">
<description>
Utility method for #GPollableInputStream and #GPollableOutputStream
</return>
</function>
+<function name="g_resolver_lookup_by_name_with_flags">
+<description>
+This differs from g_resolver_lookup_by_name() in that you can modify
+the lookup behavior with @flags. For example this can be used to limit
+results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> the hostname to look up
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> extra #GResolverNameLookupFlags for the lookup
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a non-empty #GList
+of #GInetAddress, or %NULL on error. You
+must unref each of the addresses and free the list when you are
+done with it. (You can use g_resolver_free_addresses() to do this.)
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_name_with_flags_async">
+<description>
+Begins asynchronously resolving @hostname to determine its
+associated IP address(es), and eventually calls @callback, which
+must call g_resolver_lookup_by_name_with_flags_finish() to get the result.
+See g_resolver_lookup_by_name() for more details.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> the hostname to look up the address of
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> extra #GResolverNameLookupFlags for the lookup
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_lookup_by_name_with_flags_finish">
+<description>
+Retrieves the result of a call to
+g_resolver_lookup_by_name_with_flags_async().
+
+If the DNS resolution failed, @error (if non-%NULL) will be set to
+a value from #GResolverError. If the operation was cancelled,
+@error will be set to %G_IO_ERROR_CANCELLED.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList
+of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
+for more details.
+
+</return>
+</function>
+
<function name="g_resolver_lookup_records">
<description>
Synchronously performs a DNS record lookup for the given @rrname and returns
The list is exactly the list of strings for which it is not an error
to call g_settings_get_child().
-For GSettings objects that are lists, this value can change at any
-time. Note that there is a race condition here: you may
-request a child after listing it only for it to have been destroyed
-in the meantime. For this reason, g_settings_get_child() may return
-%NULL even for a child that was listed by this function.
-
-For GSettings objects that are not lists, you should probably not be
-calling this function from "normal" code (since you should already
-know what children are in your schema). This function may still be
-useful there for introspection reasons, however.
+There is little reason to call this function from "normal" code, since
+you should already know what children are in your schema. This function
+may still be useful there for introspection reasons, however.
You should free the return value with g_strfreev() when you are done
with it.
and then calls @callback, which must call
g_socket_address_enumerator_next_finish() to get the result.
+It is an error to call this multiple times before the previous callback has finished.
+
</description>
<parameters>
<parameter name="enumerator">
<function name="g_socket_condition_timed_wait">
<description>
-Waits for up to @timeout microseconds for @condition to become true
+Waits for up to @timeout_us microseconds for @condition to become true
on @socket. If the condition is met, %TRUE is returned.
If @cancellable is cancelled before the condition is met, or if
-@timeout (or the socket's #GSocket:timeout) is reached before the
+@timeout_us (or the socket's #GSocket:timeout) is reached before the
condition is met, then %FALSE is returned and @error, if non-%NULL,
is set to the appropriate value (%G_IO_ERROR_CANCELLED or
%G_IO_ERROR_TIMED_OUT).
If you don't want a timeout, use g_socket_condition_wait().
-(Alternatively, you can pass -1 for @timeout.)
+(Alternatively, you can pass -1 for @timeout_us.)
-Note that although @timeout is in microseconds for consistency with
+Note that although @timeout_us is in microseconds for consistency with
other GLib APIs, this function actually only has millisecond
-resolution, and the behavior is undefined if @timeout is not an
+resolution, and the behavior is undefined if @timeout_us is not an
exact number of milliseconds.
Since: 2.32
<parameter_description> a #GIOCondition mask to wait for
</parameter_description>
</parameter>
-<parameter name="timeout">
+<parameter name="timeout_us">
<parameter_description> the maximum time (in microseconds) to wait, or -1
</parameter_description>
</parameter>
</return>
</function>
+<function name="g_socket_send_message_with_timeout">
+<description>
+This behaves exactly the same as g_socket_send_message(), except that
+the choice of timeout behavior is determined by the @timeout_us argument
+rather than by @socket's properties.
+
+On error %G_POLLABLE_RETURN_FAILED is returned and @error is set accordingly, or
+if the socket is currently not writable %G_POLLABLE_RETURN_WOULD_BLOCK is
+returned. @bytes_written will contain 0 in both cases.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> an array of #GOutputVector structs
+</parameter_description>
+</parameter>
+<parameter name="num_vectors">
+<parameter_description> the number of elements in @vectors, or -1
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> a pointer to an
+array of #GSocketControlMessages, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> number of elements in @messages, or -1.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags
+</parameter_description>
+</parameter>
+<parameter name="timeout_us">
+<parameter_description> the maximum time (in microseconds) to wait, or -1
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that were written to the socket
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %G_POLLABLE_RETURN_OK if all data was successfully written,
+%G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or
+%G_POLLABLE_RETURN_FAILED if an error happened and @error is set.
+
+</return>
+</function>
+
<function name="g_socket_send_messages">
<description>
Send multiple data messages from @socket in one go. This is the most
Like g_subprocess_communicate(), but validates the output of the
process as UTF-8, and returns it as a regular NUL terminated string.
+On error, @stdout_buf and @stderr_buf will be set to undefined values and
+should not be used.
+
</description>
<parameters>
<parameter name="subprocess">
#GMainContext with @task's [priority][io-priority], and sets @source's
callback to @callback, with @task as the callback's `user_data`.
+It will set the @source’s name to the task’s name (as set with
+g_task_set_name()), if one has been set.
+
This takes a reference on @task until @source is destroyed.
Since: 2.36
</return>
</function>
+<function name="g_task_get_name">
+<description>
+Gets @task’s name. See g_task_set_name().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="task">
+<parameter_description> a #GTask
+</parameter_description>
+</parameter>
+</parameters>
+<return> @task’s name, or %NULL
+</return>
+</function>
+
<function name="g_task_get_priority">
<description>
Gets @task's priority
<return></return>
</function>
+<function name="g_task_set_name">
+<description>
+Sets @task’s name, used in debugging and profiling. The name defaults to
+%NULL.
+
+The task name should describe in a human readable way what the task does.
+For example, ‘Open file’ or ‘Connect to network host’. It is used to set the
+name of the #GSource used for idle completion of the task.
+
+This function may only be called before the @task is first used in a thread
+other than the one it was constructed in.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="task">
+<parameter_description> a #GTask
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> a human readable name for the task, or %NULL to unset it
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_task_set_priority">
<description>
Sets @task's priority. If you do not call this, it will default to
</return>
</function>
+<function name="g_tls_connection_get_negotiated_protocol">
+<description>
+Gets the name of the application-layer protocol negotiated during
+the handshake.
+
+If the peer did not use the ALPN extension, or did not advertise a
+protocol that matched one of @conn's protocols, or the TLS backend
+does not support ALPN, then this will be %NULL. See
+g_tls_connection_set_advertised_protocols().
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> the negotiated protocol, or %NULL
+
+</return>
+</function>
+
<function name="g_tls_connection_get_peer_certificate">
<description>
Gets @conn's peer's certificate after the handshake has completed.
Since: 2.28
+Deprecated: 2.60. Changing the rehandshake mode is no longer
+required for compatibility. Also, rehandshaking has been removed
+from the TLS protocol in TLS 1.3.
+
</description>
<parameters>
<parameter name="conn">
Likewise, on the server side, although a handshake is necessary at
the beginning of the communication, you do not need to call this
function explicitly unless you want clearer error reporting.
-However, you may call g_tls_connection_handshake() later on to
-rehandshake, if TLS 1.2 or older is in use. With TLS 1.3, this will
-instead perform a rekey.
+
+If TLS 1.2 or older is in use, you may call
+g_tls_connection_handshake() after the initial handshake to
+rehandshake; however, this usage is deprecated because rehandshaking
+is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
+behavior of calling this function after the initial handshake is now
+undefined, except it is guaranteed to be reasonable and
+nondestructive so as to preserve compatibility with code written for
+older versions of GLib.
#GTlsConnection::accept_certificate may be emitted during the
handshake.
</return>
</function>
+<function name="g_tls_connection_set_advertised_protocols">
+<description>
+Sets the list of application-layer protocols to advertise that the
+caller is willing to speak on this connection. The
+Application-Layer Protocol Negotiation (ALPN) extension will be
+used to negotiate a compatible protocol with the peer; use
+g_tls_connection_get_negotiated_protocol() to find the negotiated
+protocol after the handshake. Specifying %NULL for the the value
+of @protocols will disable ALPN negotiation.
+
+See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids)
+for a list of registered protocol IDs.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="protocols">
+<parameter_description> a %NULL-terminated
+array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_tls_connection_set_certificate">
<description>
This sets the certificate that @conn will present to its peer
Since: 2.28
+Deprecated: 2.60. Changing the rehandshake mode is no longer
+required for compatibility. Also, rehandshaking has been removed
+from the TLS protocol in TLS 1.3.
+
</description>
<parameters>
<parameter name="conn">
<description>
Lookup the issuer of @certificate in the database.
-The %issuer property
+The #GTlsCertificate:issuer property
of @certificate is not modified, and the two certificates are not hooked
into a chain.
<root>
-<substitute_type_name from="GAppInfoCreateFlags" to="Gio::AppInfo::CreateFlags" />
-<substitute_type_name from="GApplicationFlags" to="Gio::Application::Flags" />
-<substitute_type_name from="GConverterFlags" to="Gio::Converter::Flags" />
-<substitute_type_name from="GConverterResult" to="Gio::Converter::Result" />
-<substitute_type_name from="GCredentialsType" to="Gio::Credentials::Type" />
-<substitute_type_name from="GDBusActionGroup" to="Gio::DBus::ActionGroup" />
-<substitute_type_name from="GDBusConnection" to="Gio::DBus::Connection" />
-<substitute_type_name from="GDBusAuthObserver" to="Gio::DBus::AuthObserver" />
-<substitute_type_name from="GDBusMessage" to="Gio::DBus::Message" />
-<substitute_type_name from="GDBusCallFlags" to="Gio::DBus::CallFlags" />
-<substitute_type_name from="GDBusInterfaceSkeletonFlags" to="Gio::DBus::InterfaceSkeleton::Flags" />
-<substitute_type_name from="GDBusProxyFlags" to="Gio::DBus::ProxyFlags" />
-<substitute_type_name from="GDBusProxy" to="Gio::DBus::Proxy" />
-<substitute_type_name from="GDBusInterfaceInfo" to="Gio::DBus::InterfaceInfo" />
-<substitute_type_name from="GDBusServer" to="Gio::DBus::Server" />
-<substitute_type_name from="GDBusServerFlags" to="Gio::DBus::Server::Flags" />
-<substitute_type_name from="GDriveStartFlags" to="Gio::Drive::StartFlags" />
-<substitute_type_name from="GDriveStartStopType" to="Gio::Drive::StartStopType" />
-<substitute_type_name from="GEmblemOrigin" to="Gio::Emblem::Origin" />
-<substitute_type_name from="GIOErrorEnum" to="Gio::Error" />
-<substitute_type_name from="GFileAttributeInfoFlags" to="Gio::FileAttributeInfo::Flags" />
-<substitute_type_name from="GFileCopyFlags" to="Gio::File::CopyFlags" />
-<substitute_type_name from="GFileCreateFlags" to="Gio::File::CreateFlags" />
-<substitute_type_name from="GFileMeasureFlags" to="Gio::File::MeasureFlags" />
-<substitute_type_name from="GFileMonitorEvent" to="Gio::FileMonitor::Event" />
-<substitute_type_name from="GIOStreamSpliceFlags" to="Gio::IOStream::SpliceFlags" />
-<substitute_type_name from="GMountMountFlags" to="Gio::Mount::MountFlags" />
-<substitute_type_name from="GMountUnmountFlags" to="Gio::Unmount::MountFlags" />
-<substitute_type_name from="GNotificationPriority" to="Gio::Notification::Priority" />
-<substitute_type_name from="GOutputStreamSpliceFlags" to="Gio::OutputStream::SpliceFlags" />
-<substitute_type_name from="GResolverRecordType" to="Gio::Resolver::RecordType" />
-<substitute_type_name from="GResourceFlags" to="Gio::Resource::Flags" />
-<substitute_type_name from="GResourceLookupFlags" to="Gio::Resource::LookupFlags" />
-<substitute_type_name from="GSettingsBindFlags" to="Gio::Settings::BindFlags" />
-<substitute_type_name from="GSocketMsgFlags" to="Gio::Socket::MsgFlags" />
-<substitute_type_name from="GSocketProtocol" to="Gio::Socket::Protocol" />
-<substitute_type_name from="GSocketType" to="Gio::Socket::Type" />
-<substitute_type_name from="GTlsDatabaseLookupFlags" to="Gio::TlsDatabase::LookupFlags" />
-<substitute_type_name from="GTlsDatabaseVerifyFlags" to="Gio::TlsDatabase::VerifyFlags" />
-<substitute_type_name from="GTlsPasswordFlags" to="Gio::TlsPassword::Flags" />
-<substitute_type_name from="GUnixSocketAddressType" to="Gio::UnixSocketAddress::Type" />
-
-<substitute_enumerator_name from_prefix="G_APPLICATION_" to_prefix="Gio::Application::Flags::" />
-<substitute_enumerator_name from="G_APPLICATION_FLAGS_NONE" to="Gio::Application::Flags::NONE" />
-<!-- GConverterFlags and GConverterResult both have prefix G_CONVERTER_. -->
-<substitute_enumerator_name from="G_CONVERTER_NO_FLAGS" to="Gio::Converter::Flags::NO_FLAGS" />
-<substitute_enumerator_name from="G_CONVERTER_INPUT_AT_END" to="Gio::Converter::Flags::INPUT_AT_END" />
-<substitute_enumerator_name from="G_CONVERTER_FLUSH" to="Gio::Converter::Flags::FLUSH" />
-<substitute_enumerator_name from_prefix="G_CONVERTER_" to_prefix="Gio::Converter::Result::" />
-
-<substitute_enumerator_name from_prefix="G_DATA_STREAM_BYTE_ORDER_" to_prefix="Gio::DataStreamByteOrder::" />
-<substitute_enumerator_name from_prefix="G_DATA_STREAM_NEWLINE_TYPE_" to_prefix="Gio::DataStreamNewlineType::" />
-<substitute_enumerator_name from_prefix="G_IO_ERROR_" to_prefix="Gio::Error::" />
-<substitute_enumerator_name from_prefix="G_DBUS_CAPABILITY_FLAGS_" to_prefix="Gio::DBus::CapabilityFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_CONNECTION_FLAGS_" to_prefix="Gio::DBus::ConnectionFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_SEND_MESSAGE_FLAGS_" to_prefix="Gio::DBus::SendMessageFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_MESSAGE_TYPE_" to_prefix="Gio::DBus::MessageType::" />
-<substitute_enumerator_name from_prefix="G_DBUS_ERROR_" to_prefix="Gio::DBus::Error::" />
-<substitute_enumerator_name from_prefix="G_DBUS_MESSAGE_HEADER_FIELD_" to_prefix="Gio::DBus::MessageHeaderField::" />
-<substitute_enumerator_name from_prefix="G_DBUS_MESSAGE_FLAGS_" to_prefix="Gio::DBus::MessageFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_PROXY_FLAGS_" to_prefix="Gio::DBus::ProxyFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_INTERFACE_SKELETON_FLAGS_" to_prefix="Gio::DBus::InterfaceSkeleton::Flags::" />
-<substitute_enumerator_name from_prefix="G_BUS_NAME_OWNER_FLAGS_" to_prefix="Gio::DBus::BusNameOwnerFlags::" />
-<substitute_enumerator_name from_prefix="G_DBUS_SERVER_FLAGS_" to_prefix="Gio::DBus::Server::Flags::" />
-<substitute_enumerator_name from_prefix="G_FILE_MONITOR_EVENT_" to_prefix="Gio::FileMonitor::Event::" />
-<substitute_enumerator_name from_prefix="G_FILE_MONITOR_" to_prefix="Gio::FileMonitorFlags::" />
-<substitute_enumerator_name from_prefix="G_FILE_TYPE_" to_prefix="Gio::FileType::" />
-<substitute_enumerator_name from_prefix="G_NETWORK_CONNECTIVITY_" to_prefix="Gio::NetworkConnectivity::" />
-<substitute_enumerator_name from_prefix="G_PASSWORD_SAVE_" to_prefix="Gio::PasswordSave::" />
-<substitute_enumerator_name from_prefix="G_RESOLVER_RECORD_" to_prefix="Gio::Resolver::RecordType::" />
-<substitute_enumerator_name from_prefix="G_RESOURCE_ERROR_" to_prefix="Gio::ResourceError::" />
-<substitute_enumerator_name from_prefix="G_SETTINGS_BIND_" to_prefix="Gio::Settings::BindFlags::" />
-<substitute_enumerator_name from_prefix="G_SOCKET_PROTOCOL_" to_prefix="Gio::Socket::Protocol::" />
-<substitute_enumerator_name from_prefix="G_SOCKET_TYPE_" to_prefix="Gio::Socket::Type::" />
-<substitute_enumerator_name from_prefix="G_SOCKET_FAMILY_" to_prefix="Gio::SocketFamily::" />
-<substitute_enumerator_name from_prefix="G_IO_" to_prefix="Glib::IOCondition::" />
-<substitute_enumerator_name from_prefix="G_SOCKET_CLIENT_" to_prefix="Gio::SocketClientEvent::" />
-<substitute_enumerator_name from_prefix="G_TLS_AUTHENTICATION_" to_prefix="Gio::GTlsAuthenticationMode::" />
-<substitute_enumerator_name from_prefix="G_TLS_CERTIFICATE_" to_prefix="Gio::TlsCertificateFlags::" />
-<substitute_enumerator_name from_prefix="G_TLS_REHANDSHAKE_" to_prefix="Gio::TlsRehandshakeMode::" />
-<substitute_enumerator_name from_prefix="G_TLS_DATABASE_VERIFY_" to_prefix="Gio::TlsDatabaseVerifyFlags::" />
-<substitute_enumerator_name from_prefix="G_TLS_INTERACTION_" to_prefix="Gio::TlsInteractionResult::" />
-<substitute_enumerator_name from_prefix="G_TLS_ERROR_" to_prefix="Gio::TlsError::" />
-<substitute_enumerator_name from_prefix="G_TLS_PASSWORD_" to_prefix="Gio::TlsPassword::Flags::" />
-<substitute_enumerator_name from_prefix="G_ZLIB_COMPRESSOR_FORMAT_" to_prefix="Gio::ZlibCompressorFormat::" />
-<substitute_enumerator_name from_prefix="G_UNIX_SOCKET_ADDRESS_" to_prefix="Gio::UnixSocketAddress::Type::" />
<!-- These are preprocessor defines. Don't substitute. -->
<substitute_enumerator_name from="G_MAXSSIZE" to="G_MAXSSIZE" />
<substitute_enumerator_name from="G_MAXINT" to="G_MAXINT" />
<substitute_enumerator_name from="G_RESOURCE_ERROR" to="G_RESOURCE_ERROR" />
<substitute_enumerator_name from="G_RESOLVER_ERROR" to="G_RESOLVER_ERROR" />
<substitute_enumerator_name from="G_TLS_ERROR" to="G_TLS_ERROR" />
-<substitute_enumerator_name from="G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE" to="G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE" />
<substitute_enumerator_name from_prefix="G_FILE_ATTRIBUTE_" to_prefix="G_FILE_ATTRIBUTE_" />
<substitute_enumerator_name from_prefix="G_MENU_ATTRIBUTE_" to_prefix="G_MENU_ATTRIBUTE_" />
<substitute_enumerator_name from_prefix="G_MENU_LINK_" to_prefix="G_MENU_LINK_" />
'("busy" "G_IO_ERROR_BUSY" "26")
'("would-block" "G_IO_ERROR_WOULD_BLOCK" "27")
'("host-not-found" "G_IO_ERROR_HOST_NOT_FOUND" "28")
- '("host-was-not-found" "G_IO_ERROR_HOST_WAS_NOT_FOUND" "28")
+ '("host-not-found" "G_IO_ERROR_HOST_WAS_NOT_FOUND" "28")
'("would-merge" "G_IO_ERROR_WOULD_MERGE" "29")
'("failed-handled" "G_IO_ERROR_FAILED_HANDLED" "30")
'("too-many-open-files" "G_IO_ERROR_TOO_MANY_OPEN_FILES" "31")
;;
;; G_APPLICATION_NON_UNIQUE = (1 << 5),
;;
-;; G_APPLICATION_CAN_OVERRIDE_APP_ID = (1 << 6)
+;; G_APPLICATION_CAN_OVERRIDE_APP_ID = (1 << 6),
+;; G_APPLICATION_ALLOW_REPLACEMENT = (1 << 7),
+;; G_APPLICATION_REPLACE = (1 << 8)
;; } GApplicationFlags;
(define-flags-extended ApplicationFlags
'("send-environment" "G_APPLICATION_SEND_ENVIRONMENT" "(1 << 4)")
'("non-unique" "G_APPLICATION_NON_UNIQUE" "(1 << 5)")
'("can-override-app-id" "G_APPLICATION_CAN_OVERRIDE_APP_ID" "(1 << 6)")
+ '("allow-replacement" "G_APPLICATION_ALLOW_REPLACEMENT" "(1 << 7)")
+ '("replace" "G_APPLICATION_REPLACE" "(1 << 8)")
)
)
)
)
+;; Original typedef:
+;; typedef enum {
+;; G_POLLABLE_RETURN_FAILED = 0,
+;; G_POLLABLE_RETURN_OK = 1,
+;; G_POLLABLE_RETURN_WOULD_BLOCK = -G_IO_ERROR_WOULD_BLOCK
+;; } GPollableReturn;
+
+(define-enum-extended PollableReturn
+ (in-module "G")
+ (c-name "GPollableReturn")
+ (values
+ '("failed" "G_POLLABLE_RETURN_FAILED" "0")
+ '("ok" "G_POLLABLE_RETURN_OK" "1")
+ )
+)
+
+;; From gresolver.h
+
+;; Original typedef:
+;; typedef enum {
+;; G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT = 0,
+;; G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY = 1 << 0,
+;; G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY = 1 << 1,
+;; } GResolverNameLookupFlags;
+
+(define-flags-extended ResolverNameLookupFlags
+ (in-module "G")
+ (c-name "GResolverNameLookupFlags")
+ (values
+ '("default" "G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT" "0x0")
+ '("ipv4-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY" "1 << 0")
+ '("ipv6-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY" "1 << 1")
+ )
+)
+
;; From gsettings.h
;; Original typedef:
'("busy" "G_IO_ERROR_BUSY" "26")
'("would-block" "G_IO_ERROR_WOULD_BLOCK" "27")
'("host-not-found" "G_IO_ERROR_HOST_NOT_FOUND" "28")
-+ '("host-was-not-found" "G_IO_ERROR_HOST_WAS_NOT_FOUND" "28")
++ '("host-not-found" "G_IO_ERROR_HOST_WAS_NOT_FOUND" "28")
'("would-merge" "G_IO_ERROR_WOULD_MERGE" "29")
'("failed-handled" "G_IO_ERROR_FAILED_HANDLED" "30")
'("too-many-open-files" "G_IO_ERROR_TOO_MANY_OPEN_FILES" "31")
'("send-environment" "G_APPLICATION_SEND_ENVIRONMENT")
'("non-unique" "G_APPLICATION_NON_UNIQUE")
'("can-override-app-id" "G_APPLICATION_CAN_OVERRIDE_APP_ID")
+ '("allow-replacement" "G_APPLICATION_ALLOW_REPLACEMENT")
+ '("replace" "G_APPLICATION_REPLACE")
)
)
)
)
+(define-enum Return
+ (in-module "GPollable")
+ (c-name "GPollableReturn")
+ (gtype-id "G_TYPE_POLLABLE_RETURN")
+ (values
+ '("failed" "G_POLLABLE_RETURN_FAILED")
+ '("ok" "G_POLLABLE_RETURN_OK")
+ '("would-block" "G_POLLABLE_RETURN_WOULD_BLOCK")
+ )
+)
+
+(define-flags NameLookupFlags
+ (in-module "GResolver")
+ (c-name "GResolverNameLookupFlags")
+ (gtype-id "G_TYPE_RESOLVER_NAME_LOOKUP_FLAGS")
+ (values
+ '("default" "G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT")
+ '("ipv4-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY")
+ '("ipv6-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY")
+ )
+)
+
(define-flags BindFlags
(in-module "GSettings")
(c-name "GSettingsBindFlags")
)
)
+(define-method launch_uris_async
+ (of-object "GAppInfo")
+ (c-name "g_app_info_launch_uris_async")
+ (return-type "none")
+ (parameters
+ '("GList*" "uris")
+ '("GAppLaunchContext*" "context")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method launch_uris_finish
+ (of-object "GAppInfo")
+ (c-name "g_app_info_launch_uris_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("GError**" "error")
+ )
+)
+
(define-method should_show
(of-object "GAppInfo")
(c-name "g_app_info_should_show")
(return-type "GList*")
)
+(define-function g_content_type_get_mime_dirs
+ (c-name "g_content_type_get_mime_dirs")
+ (return-type "const-gchar*-const*")
+)
+
+(define-function g_content_type_set_mime_dirs
+ (c-name "g_content_type_set_mime_dirs")
+ (return-type "none")
+ (parameters
+ '("const-gchar*-const*" "dirs")
+ )
+)
+
;; From gcontextspecificgroup.h
(return-type "GDBusCapabilityFlags")
)
+(define-method get_flags
+ (of-object "GDBusConnection")
+ (c-name "g_dbus_connection_get_flags")
+ (return-type "GDBusConnectionFlags")
+)
+
(define-method close
(of-object "GDBusConnection")
(c-name "g_dbus_connection_close")
;; From gdocumentportal.h
-(define-function g_document_portal_add_document
- (c-name "g_document_portal_add_document")
- (return-type "char*")
- (parameters
- '("GFile*" "file")
- '("GError**" "error")
- )
-)
-
(define-function g_document_portal_add_documents
(c-name "g_document_portal_add_documents")
(return-type "GList*")
)
)
+(define-method set_advertised_protocols
+ (of-object "GDtlsConnection")
+ (c-name "g_dtls_connection_set_advertised_protocols")
+ (return-type "none")
+ (parameters
+ '("const-gchar*-const*" "protocols")
+ )
+)
+
+(define-method get_negotiated_protocol
+ (of-object "GDtlsConnection")
+ (c-name "g_dtls_connection_get_negotiated_protocol")
+ (return-type "const-gchar*")
+)
+
;; From gdtlsserverconnection.h
)
)
+(define-method query_default_handler_async
+ (of-object "GFile")
+ (c-name "g_file_query_default_handler_async")
+ (return-type "none")
+ (parameters
+ '("int" "io_priority")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method query_default_handler_finish
+ (of-object "GFile")
+ (c-name "g_file_query_default_handler_finish")
+ (return-type "GAppInfo*")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("GError**" "error")
+ )
+)
+
(define-method load_contents
(of-object "GFile")
(c-name "g_file_load_contents")
)
)
+(define-method writev
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev")
+ (return-type "gboolean")
+ (parameters
+ '("const-GOutputVector*" "vectors")
+ '("gsize" "n_vectors")
+ '("gsize*" "bytes_written")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method writev_all
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev_all")
+ (return-type "gboolean")
+ (parameters
+ '("GOutputVector*" "vectors")
+ '("gsize" "n_vectors")
+ '("gsize*" "bytes_written")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
(define-method printf
(of-object "GOutputStream")
(c-name "g_output_stream_printf")
)
)
+(define-method writev_async
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev_async")
+ (return-type "none")
+ (parameters
+ '("const-GOutputVector*" "vectors")
+ '("gsize" "n_vectors")
+ '("int" "io_priority")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method writev_finish
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("gsize*" "bytes_written")
+ '("GError**" "error")
+ )
+)
+
+(define-method writev_all_async
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev_all_async")
+ (return-type "none")
+ (parameters
+ '("GOutputVector*" "vectors")
+ '("gsize" "n_vectors")
+ '("int" "io_priority")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method writev_all_finish
+ (of-object "GOutputStream")
+ (c-name "g_output_stream_writev_all_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("gsize*" "bytes_written")
+ '("GError**" "error")
+ )
+)
+
(define-method write_bytes_async
(of-object "GOutputStream")
(c-name "g_output_stream_write_bytes_async")
)
)
+(define-method writev_nonblocking
+ (of-object "GPollableOutputStream")
+ (c-name "g_pollable_output_stream_writev_nonblocking")
+ (return-type "GPollableReturn")
+ (parameters
+ '("const-GOutputVector*" "vectors")
+ '("gsize" "n_vectors")
+ '("gsize*" "bytes_written")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
;; From gpollableutils.h
)
)
+(define-method lookup_by_name_with_flags_async
+ (of-object "GResolver")
+ (c-name "g_resolver_lookup_by_name_with_flags_async")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "hostname")
+ '("GResolverNameLookupFlags" "flags")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method lookup_by_name_with_flags_finish
+ (of-object "GResolver")
+ (c-name "g_resolver_lookup_by_name_with_flags_finish")
+ (return-type "GList*")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("GError**" "error")
+ )
+)
+
+(define-method lookup_by_name_with_flags
+ (of-object "GResolver")
+ (c-name "g_resolver_lookup_by_name_with_flags")
+ (return-type "GList*")
+ (parameters
+ '("const-gchar*" "hostname")
+ '("GResolverNameLookupFlags" "flags")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
(define-function g_resolver_free_addresses
(c-name "g_resolver_free_addresses")
(return-type "none")
(return-type "GType")
)
+(define-function g_keyfile_settings_backend_get_type
+ (c-name "g_keyfile_settings_backend_get_type")
+ (return-type "GType")
+)
+
(define-function g_nextstep_settings_backend_get_type
(c-name "g_nextstep_settings_backend_get_type")
(return-type "GType")
(return-type "gboolean")
(parameters
'("GIOCondition" "condition")
- '("gint64" "timeout")
+ '("gint64" "timeout_us")
'("GCancellable*" "cancellable")
'("GError**" "error")
)
)
)
+(define-method send_message_with_timeout
+ (of-object "GSocket")
+ (c-name "g_socket_send_message_with_timeout")
+ (return-type "GPollableReturn")
+ (parameters
+ '("GSocketAddress*" "address")
+ '("const-GOutputVector*" "vectors")
+ '("gint" "num_vectors")
+ '("GSocketControlMessage**" "messages")
+ '("gint" "num_messages")
+ '("gint" "flags")
+ '("gint64" "timeout_us")
+ '("gsize*" "bytes_written")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
(define-method get_option
(of-object "GSocket")
(c-name "g_socket_get_option")
)
)
+(define-method set_name
+ (of-object "GTask")
+ (c-name "g_task_set_name")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "name")
+ )
+)
+
(define-method get_source_object
(of-object "GTask")
(c-name "g_task_get_source_object")
(return-type "gpointer")
)
+(define-method get_name
+ (of-object "GTask")
+ (c-name "g_task_get_name")
+ (return-type "const-gchar*")
+)
+
(define-function g_task_is_valid
(c-name "g_task_is_valid")
(return-type "gboolean")
(return-type "GTlsRehandshakeMode")
)
+(define-method set_advertised_protocols
+ (of-object "GTlsConnection")
+ (c-name "g_tls_connection_set_advertised_protocols")
+ (return-type "none")
+ (parameters
+ '("const-gchar*-const*" "protocols")
+ )
+)
+
+(define-method get_negotiated_protocol
+ (of-object "GTlsConnection")
+ (c-name "g_tls_connection_get_negotiated_protocol")
+ (return-type "const-gchar*")
+)
+
(define-method handshake
(of-object "GTlsConnection")
(c-name "g_tls_connection_handshake")
+;; From gtrashportal.h
+
+(define-function g_trash_portal_trash_file
+ (c-name "g_trash_portal_trash_file")
+ (return-type "gboolean")
+ (parameters
+ '("GFile*" "file")
+ '("GError**" "error")
+ )
+)
+
+
+
;; From gunionvolumemonitor.h
)
+
+;; From gconstructor_as_data.h
+
+
+
+;; From gdbus-daemon-generated.h
+
+
+
+;; From gioenumtypes.h
+
+(define-function g_app_info_create_flags_get_type
+ (c-name "g_app_info_create_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_converter_flags_get_type
+ (c-name "g_converter_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_converter_result_get_type
+ (c-name "g_converter_result_get_type")
+ (return-type "GType")
+)
+
+(define-function g_data_stream_byte_order_get_type
+ (c-name "g_data_stream_byte_order_get_type")
+ (return-type "GType")
+)
+
+(define-function g_data_stream_newline_type_get_type
+ (c-name "g_data_stream_newline_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_attribute_type_get_type
+ (c-name "g_file_attribute_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_attribute_info_flags_get_type
+ (c-name "g_file_attribute_info_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_attribute_status_get_type
+ (c-name "g_file_attribute_status_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_query_info_flags_get_type
+ (c-name "g_file_query_info_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_create_flags_get_type
+ (c-name "g_file_create_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_measure_flags_get_type
+ (c-name "g_file_measure_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_mount_mount_flags_get_type
+ (c-name "g_mount_mount_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_mount_unmount_flags_get_type
+ (c-name "g_mount_unmount_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_drive_start_flags_get_type
+ (c-name "g_drive_start_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_drive_start_stop_type_get_type
+ (c-name "g_drive_start_stop_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_copy_flags_get_type
+ (c-name "g_file_copy_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_monitor_flags_get_type
+ (c-name "g_file_monitor_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_type_get_type
+ (c-name "g_file_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_filesystem_preview_type_get_type
+ (c-name "g_filesystem_preview_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_file_monitor_event_get_type
+ (c-name "g_file_monitor_event_get_type")
+ (return-type "GType")
+)
+
+(define-function g_io_error_enum_get_type
+ (c-name "g_io_error_enum_get_type")
+ (return-type "GType")
+)
+
+(define-function g_ask_password_flags_get_type
+ (c-name "g_ask_password_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_password_save_get_type
+ (c-name "g_password_save_get_type")
+ (return-type "GType")
+)
+
+(define-function g_mount_operation_result_get_type
+ (c-name "g_mount_operation_result_get_type")
+ (return-type "GType")
+)
+
+(define-function g_output_stream_splice_flags_get_type
+ (c-name "g_output_stream_splice_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_io_stream_splice_flags_get_type
+ (c-name "g_io_stream_splice_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_emblem_origin_get_type
+ (c-name "g_emblem_origin_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resolver_error_get_type
+ (c-name "g_resolver_error_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resolver_record_type_get_type
+ (c-name "g_resolver_record_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resource_error_get_type
+ (c-name "g_resource_error_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resource_flags_get_type
+ (c-name "g_resource_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resource_lookup_flags_get_type
+ (c-name "g_resource_lookup_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_family_get_type
+ (c-name "g_socket_family_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_type_get_type
+ (c-name "g_socket_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_msg_flags_get_type
+ (c-name "g_socket_msg_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_protocol_get_type
+ (c-name "g_socket_protocol_get_type")
+ (return-type "GType")
+)
+
+(define-function g_zlib_compressor_format_get_type
+ (c-name "g_zlib_compressor_format_get_type")
+ (return-type "GType")
+)
+
+(define-function g_unix_socket_address_type_get_type
+ (c-name "g_unix_socket_address_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_bus_type_get_type
+ (c-name "g_bus_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_bus_name_owner_flags_get_type
+ (c-name "g_bus_name_owner_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_bus_name_watcher_flags_get_type
+ (c-name "g_bus_name_watcher_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_proxy_flags_get_type
+ (c-name "g_dbus_proxy_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_error_get_type
+ (c-name "g_dbus_error_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_connection_flags_get_type
+ (c-name "g_dbus_connection_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_capability_flags_get_type
+ (c-name "g_dbus_capability_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_call_flags_get_type
+ (c-name "g_dbus_call_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_message_type_get_type
+ (c-name "g_dbus_message_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_message_flags_get_type
+ (c-name "g_dbus_message_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_message_header_field_get_type
+ (c-name "g_dbus_message_header_field_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_property_info_flags_get_type
+ (c-name "g_dbus_property_info_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_subtree_flags_get_type
+ (c-name "g_dbus_subtree_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_server_flags_get_type
+ (c-name "g_dbus_server_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_signal_flags_get_type
+ (c-name "g_dbus_signal_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_send_message_flags_get_type
+ (c-name "g_dbus_send_message_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_credentials_type_get_type
+ (c-name "g_credentials_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_message_byte_order_get_type
+ (c-name "g_dbus_message_byte_order_get_type")
+ (return-type "GType")
+)
+
+(define-function g_application_flags_get_type
+ (c-name "g_application_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_error_get_type
+ (c-name "g_tls_error_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_certificate_flags_get_type
+ (c-name "g_tls_certificate_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_authentication_mode_get_type
+ (c-name "g_tls_authentication_mode_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_rehandshake_mode_get_type
+ (c-name "g_tls_rehandshake_mode_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_password_flags_get_type
+ (c-name "g_tls_password_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_interaction_result_get_type
+ (c-name "g_tls_interaction_result_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_interface_skeleton_flags_get_type
+ (c-name "g_dbus_interface_skeleton_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_dbus_object_manager_client_flags_get_type
+ (c-name "g_dbus_object_manager_client_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_database_verify_flags_get_type
+ (c-name "g_tls_database_verify_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_database_lookup_flags_get_type
+ (c-name "g_tls_database_lookup_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_tls_certificate_request_flags_get_type
+ (c-name "g_tls_certificate_request_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_io_module_scope_flags_get_type
+ (c-name "g_io_module_scope_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_client_event_get_type
+ (c-name "g_socket_client_event_get_type")
+ (return-type "GType")
+)
+
+(define-function g_socket_listener_event_get_type
+ (c-name "g_socket_listener_event_get_type")
+ (return-type "GType")
+)
+
+(define-function g_test_dbus_flags_get_type
+ (c-name "g_test_dbus_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_subprocess_flags_get_type
+ (c-name "g_subprocess_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_notification_priority_get_type
+ (c-name "g_notification_priority_get_type")
+ (return-type "GType")
+)
+
+(define-function g_network_connectivity_get_type
+ (c-name "g_network_connectivity_get_type")
+ (return-type "GType")
+)
+
+(define-function g_pollable_return_get_type
+ (c-name "g_pollable_return_get_type")
+ (return-type "GType")
+)
+
+(define-function g_resolver_name_lookup_flags_get_type
+ (c-name "g_resolver_name_lookup_flags_get_type")
+ (return-type "GType")
+)
+
+(define-function g_settings_bind_flags_get_type
+ (c-name "g_settings_bind_flags_get_type")
+ (return-type "GType")
+)
+
+
+
+;; From gnetworking.h
+
+(define-function g_networking_init
+ (c-name "g_networking_init")
+ (return-type "none")
+)
+
+
)
)
+(define-signal name-lost
+ (of-object "GApplication")
+ (return-type "gboolean")
+ (flags "Run Last")
+)
+
(define-property application-id
(of-object "GApplication")
(prop-type "GParamString")
(readable #t)
(writable #t)
(construct-only #t)
+ (deprecated #t)
(default-value "FALSE")
)
(readable #t)
(writable #t)
(construct-only #f)
+ (deprecated #t)
(default-value "G_TLS_REHANDSHAKE_SAFELY")
)
(readable #t)
(writable #t)
(construct-only #f)
+ (deprecated #t)
(default-value "TRUE")
)
(default-value "0")
)
+(define-property advertised-protocols
+ (of-object "GTlsConnection")
+ (prop-type "GParamBoxed")
+ (docs "Application-layer protocols available on this connection")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property negotiated-protocol
+ (of-object "GTlsConnection")
+ (prop-type "GParamString")
+ (docs "Application-layer protocol negotiated for this connection")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+ (default-value "")
+)
+
;; From GTlsDatabase
;; From GTlsFileDatabase
(of-object "GDBusConnection")
(prop-type "GParamFlags")
(docs "Flags")
- (readable #f)
+ (readable #t)
(writable #t)
(construct-only #t)
(default-value "G_DBUS_CONNECTION_FLAGS_NONE")
---- ./../../gio/src/gio_signals.defs.orig 2017-09-11 09:52:55.272837455 +0200
-+++ ./../../gio/src/gio_signals.defs 2017-09-11 14:56:39.662521043 +0200
+--- ./../../gio/src/gio_signals.defs.orig 2017-09-12 17:06:06.023464567 +0200
++++ ./../../gio/src/gio_signals.defs 2017-09-13 08:41:32.428298292 +0200
@@ -87,11 +87,11 @@
(return-type "void")
(flags "Run Last, Must Collect")
;; From GApplication
-@@ -738,11 +738,11 @@
+@@ -591,10 +591,11 @@
+ (prop-type "GParamBoolean")
+ (docs "Whether or not this is an abstract address")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
++ (deprecated #t)
+ (default-value "FALSE")
+ )
+
+ (define-property address-type
+ (of-object "GUnixSocketAddress")
+@@ -738,11 +739,11 @@
(of-object "GMountOperation")
(return-type "void")
(flags "Run Last")
(define-signal reply
(of-object "GMountOperation")
-@@ -1106,11 +1106,11 @@
+@@ -1106,11 +1107,11 @@
(define-signal writable-change-event
(of-object "GSettings")
(return-type "gboolean")
(define-property settings-schema
(of-object "GSettings")
-@@ -1190,20 +1190,20 @@
+@@ -1190,20 +1191,20 @@
(define-signal activate
(of-object "GSimpleAction")
(return-type "void")
(define-property name
(of-object "GSimpleAction")
-@@ -1850,11 +1850,11 @@
+@@ -1850,11 +1851,11 @@
(define-signal writable-change-event
(of-object "GSettings")
(return-type "gboolean")
(define-property settings-schema
(of-object "GSettings")
-@@ -2723,23 +2723,23 @@
+@@ -2345,10 +2346,11 @@
+ (prop-type "GParamBoolean")
+ (docs "Whether to verify peer certificates against the system certificate database")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
++ (deprecated #t)
+ (default-value "TRUE")
+ )
+
+ (define-property database
+ (of-object "GTlsConnection")
+@@ -2723,23 +2725,23 @@
(define-signal g-properties-changed
(of-object "GDBusProxy")
(return-type "void")
(return-type "void")
)
-(define-vfunc dbus_register
- (of-object "GApplication")
- (return-type "gboolean")
- (parameters
- '("GDBusConnection*" "connection")
- '("const-gchar*" "object_path")
- '("GError**" "error")
- )
-)
-
-(define-vfunc dbus_unregister
+(define-vfunc shutdown
(of-object "GApplication")
(return-type "void")
- (parameters
- '("GDBusConnection*" "connection")
- '("const-gchar*" "object_path")
- )
)
; GAsyncInitable
(return-type "GObject*")
)
-(define-vfunc is_tagged
- (of-object "GAsyncResult")
- (return-type "gboolean")
- (parameters
- '("gpointer" "source_tag")
- )
-)
-
; GBufferedInputStream
(define-vfunc fill
)
)
-; GFileDescriptorBased
-
-(define-vfunc get_fd
- (of-object "GFileDescriptorBased")
- (return-type "int")
-)
-
; GFileInputStream
(define-vfunc tell
_WRAP_METHOD(guint32 get_flowinfo() const, g_inet_socket_address_get_flowinfo)
_WRAP_METHOD(guint32 get_scope_id() const, g_inet_socket_address_get_scope_id)
- _WRAP_PROPERTY("address", Glib::RefPtr<InetAddress>)
- // Don't use guint16 or guint32 in _WRAP_PROPERTY().
- // There are no Glib::Value<> specializations for those types.
- // Glib::Value<unsigned int> exists, and guint is a typedef of unsigned int.
- _WRAP_PROPERTY("port", guint)
- _WRAP_PROPERTY("flowinfo", guint)
- _WRAP_PROPERTY("scope-id", guint)
+ _WRAP_PROPERTY("address", Glib::RefPtr<InetAddress>)
+ _WRAP_PROPERTY("port", guint16)
+ _WRAP_PROPERTY("flowinfo", guint32)
+ _WRAP_PROPERTY("scope-id", guint32)
};
} // namespace Gio
_WRAP_METHOD(bool set_pending(), g_input_stream_set_pending, errthrow, newin "2,50")
_WRAP_METHOD(void clear_pending(), g_input_stream_clear_pending, newin "2,50")
+ //TODO: When we can break ABI, add vfuncs. See https://bugzilla.gnome.org/show_bug.cgi?id=572471
#m4 _CONVERSION(`GCancellable*', `const Glib::RefPtr<Cancellable>&', `Glib::wrap($3, true)')
- _WRAP_VFUNC(gssize read(void* buffer, gsize count, const Glib::RefPtr<Cancellable>& cancellable), read_fn, errthrow, err_return_value -1)
- _WRAP_VFUNC(gssize skip(gsize count, const Glib::RefPtr<Cancellable>& cancellable), skip, errthrow, err_return_value -1)
- _WRAP_VFUNC(bool close(const Glib::RefPtr<Cancellable>& cancellable), close_fn, errthrow)
+ //_WRAP_VFUNC(gssize read(void* buffer, gsize count, const Glib::RefPtr<Cancellable>& cancellable), read_fn, errthrow, err_return_value -1)
+ //_WRAP_VFUNC(gssize skip(gsize count, const Glib::RefPtr<Cancellable>& cancellable), skip, errthrow, err_return_value -1)
+ //_WRAP_VFUNC(bool close(const Glib::RefPtr<Cancellable>& cancellable), close_fn, errthrow)
};
} // namespace Gio
void
IOStream::splice_async(const Glib::RefPtr<IOStream>& stream2, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, SpliceFlags flags, int io_priority)
+ const Glib::RefPtr<Cancellable>& cancellable, IOStreamSpliceFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
IOStream::splice_async(const Glib::RefPtr<IOStream>& stream2, const SlotAsyncReady& slot,
- SpliceFlags flags, int io_priority)
+ IOStreamSpliceFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The giomm Development Team
*
* This library is free software; you can redistribute it and/or
namespace Gio
{
+_WRAP_ENUM(IOStreamSpliceFlags, GIOStreamSpliceFlags, NO_GTYPE)
+
/** IOStream - Base class for implementing read/write streams.
* IOStream represents an object that has both read and write streams.
* Generally the two streams acts as separate input and output streams, but
public:
- _WRAP_ENUM(SpliceFlags, GIOStreamSpliceFlags, NO_GTYPE)
-
/** Asyncronously splice the output stream to the input stream of @a
* stream2, and splice the output stream of @a stream2 to the input stream of
* this stream.
* @param stream2 The second IOStream.
* @param slot A SlotAsyncReady slot.
* @param cancellable A Cancellable object.
- * @param flags A set of SpliceFlags.
+ * @param flags A set of IOStreamSpliceFlags.
* @param io_priority The io priority of the request.
*
* @newin{2,34}
*/
void splice_async(const Glib::RefPtr<IOStream>& stream2,
const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable,
- SpliceFlags flags = SpliceFlags::NONE,
+ IOStreamSpliceFlags flags = Gio::IO_STREAM_SPLICE_NONE,
int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_io_stream_splice_async)
/// A non-cancellable version of splice_async().
void splice_async(const Glib::RefPtr<IOStream>& stream2,
const SlotAsyncReady& slot,
- SpliceFlags flags = SpliceFlags::NONE,
+ IOStreamSpliceFlags flags = Gio::IO_STREAM_SPLICE_NONE,
int io_priority = Glib::PRIORITY_DEFAULT);
_WRAP_METHOD(static bool splice_finish(const Glib::RefPtr<AsyncResult>& result), g_io_stream_splice_finish, errthrow)
*
* @newin{2,50}
*/
- using SlotCompare = sigc::slot<int(const Glib::RefPtr<const Glib::ObjectBase>&, const Glib::RefPtr<const Glib::ObjectBase>&)>;
+ using SlotCompare = sigc::slot<int, const Glib::RefPtr<const Glib::ObjectBase>&, const Glib::RefPtr<const Glib::ObjectBase>&>;
_WRAP_METHOD(guint insert_sorted(const Glib::RefPtr<Glib::ObjectBase>& item,
const SlotCompare& slot{compare_func}), g_list_store_insert_sorted,
*
* @newin{2,50}
*/
- using SlotCompare = sigc::slot<int(const Glib::RefPtr<const T_item>&, const Glib::RefPtr<const T_item>&)>;
+ using SlotCompare = sigc::slot<int, const Glib::RefPtr<const T_item>&, const Glib::RefPtr<const T_item>&>;
/** Inserts @a item at a position to be determined by the @a slot.
*
template <typename T_item>
Glib::RefPtr<ListStore<T_item>> ListStore<T_item>::create()
{
- return Glib::make_refptr_for_instance<ListStore<T_item>>(new ListStore<T_item>());
+ return Glib::RefPtr<ListStore<T_item>>(new ListStore<T_item>());
}
template <typename T_item>
Glib::RefPtr<T_item> ListStore<T_item>::get_item(guint position)
{
- return std::dynamic_pointer_cast<T_item>(ListModel::get_object(position));
+ return Glib::RefPtr<T_item>::cast_dynamic(ListModel::get_object(position));
}
template <typename T_item>
// cast_dynamic is necessary if T_item is a user-derived class, such as
// class MyObject : public Glib::Object
- const Glib::RefPtr<const T_item> item_a = std::dynamic_pointer_cast<T_item>(
+ const Glib::RefPtr<const T_item> item_a = Glib::RefPtr<T_item>::cast_dynamic(
Glib::wrap(static_cast<typename T_item::BaseObjectType*>(const_cast<gpointer>(a)), true));
- const Glib::RefPtr<const T_item> item_b = std::dynamic_pointer_cast<T_item>(
+ const Glib::RefPtr<const T_item> item_b = Glib::RefPtr<T_item>::cast_dynamic(
Glib::wrap(static_cast<typename T_item::BaseObjectType*>(const_cast<gpointer>(b)), true));
return (*slot)(item_a, item_b);
#include <gio/gio.h>
#include <glibmm/error.h>
+#include <giomm/private/icon_p.h>
#include "slot_async.h"
namespace Gio
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <glibmm/interface.h>
+#include <giomm/icon.h>
#include <giomm/inputstream.h>
+#include <giomm/icon.h>
_DEFS(giomm,gio)
-_PINCLUDE(glibmm/private/interface_p.h)
+_PINCLUDE(giomm/private/icon_p.h)
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GLoadableIconIface GLoadableIconIface;
*
* @newin{2,16}
*/
-class LoadableIcon : public Glib::Interface
+class LoadableIcon : public Icon
{
- _CLASS_INTERFACE(LoadableIcon, GLoadableIcon, G_LOADABLE_ICON, GLoadableIconIface)
+ _CLASS_INTERFACE(LoadableIcon, GLoadableIcon, G_LOADABLE_ICON, GLoadableIconIface, Icon, GIcon)
public:
/**
{
}
- SlotWithData(const SlotWithData& src) = delete;
- SlotWithData& operator=(const SlotWithData& src) = delete;
-
~SlotWithData() { delete m_slot; }
void operator()() { (*m_slot)(m_data); }
namespace Gio
{
+_DEPRECATE_IFDEF_START
+void
+MemoryInputStream::add_data(const std::string& data)
+{
+ char* data_copy = g_strdup(data.c_str());
+ g_memory_input_stream_add_data(gobj(), data_copy, -1, g_free);
+}
+
+void
+MemoryInputStream::add_data(const void* data, gssize len)
+{
+ char* data_copy = nullptr;
+
+ // copy the data so that the caller doesn't need to keep the data alive
+ if (len < 0)
+ data_copy = g_strdup(static_cast<const gchar*>(data));
+ else
+ data_copy = static_cast<gchar*>(g_memdup(data, len));
+
+ g_memory_input_stream_add_data(gobj(), data_copy, len, g_free);
+}
+_DEPRECATE_IFDEF_END
+
void
MemoryInputStream::add_data(const void* data, gssize len, const SlotDestroyData& destroy_slot)
{
#include <giomm/inputstream.h>
#include <giomm/seekable.h>
-#include <giomm/pollableinputstream.h>
_DEFS(giomm,gio)
_PINCLUDE(giomm/private/inputstream_p.h)
*/
class MemoryInputStream
: public Gio::InputStream,
- public Seekable,
- public PollableInputStream
+ public Seekable
{
_CLASS_GOBJECT(MemoryInputStream, GMemoryInputStream, G_MEMORY_INPUT_STREAM, Gio::InputStream, GInputStream)
_IMPLEMENTS_INTERFACE(Seekable)
- _IMPLEMENTS_INTERFACE(PollableInputStream)
protected:
_CTOR_DEFAULT
public:
_WRAP_CREATE()
+_DEPRECATE_IFDEF_START
+ /** Appends to data that can be read from the input stream.
+ *
+ * @param data Input data.
+ *
+ * @deprecated Use add_data() with SlotDestroyData or GDestroyNotify instead.
+ */
+ void add_data(const std::string& data);
+
+ /** Appends to data that can be read from the input stream.
+ *
+ * Note that the data will be copied internally and freed when no longer needed.
+ *
+ * @param data Input data.
+ * @param len Length of the data, may be -1 if data is a null-terminated string.
+ *
+ * @deprecated Use add_data() with SlotDestroyData or GDestroyNotify instead.
+ */
+ void add_data(const void* data, gssize len);
+_DEPRECATE_IFDEF_END
+
_WRAP_METHOD(void add_data(const void* data, gssize len, GDestroyNotify destroy), g_memory_input_stream_add_data)
/** For example,
*
* @newin{2,40}
*/
- using SlotDestroyData = sigc::slot<void(void*)>;
+ using SlotDestroyData = sigc::slot<void, void*>;
/** Appends to data that can be read from the input stream.
*
#include <giomm/outputstream.h>
#include <giomm/seekable.h>
-#include <giomm/pollableoutputstream.h>
#include <glibmm/object.h>
// TODO: remove this if possible -- it's here for the GReallocFunc definition
#include <gio/gio.h>
*/
class MemoryOutputStream :
public OutputStream,
- public Seekable,
- public PollableOutputStream
+ public Seekable
{
_CLASS_GOBJECT(MemoryOutputStream, GMemoryOutputStream, G_MEMORY_OUTPUT_STREAM, Gio::OutputStream, GOutputStream)
_IMPLEMENTS_INTERFACE(Seekable)
- _IMPLEMENTS_INTERFACE(PollableOutputStream)
protected:
// Hand-coded because it's equivalent to g_memory_output_stream_new_resizable(),
_WRAP_METHOD(void freeze(), g_menu_freeze)
- _WRAP_METHOD(void insert_item(int position, const Glib::RefPtr<const MenuItem>& item), g_menu_insert_item)
- _WRAP_METHOD(void prepend_item(const Glib::RefPtr<const MenuItem>& item), g_menu_prepend_item)
- _WRAP_METHOD(void append_item(const Glib::RefPtr<const MenuItem>& item), g_menu_append_item)
+ //TODO: Make the item "const Glib::RefPtr<const MenuItem>&" when we can break ABI? The function is documented as just copying its attributes.
+ _WRAP_METHOD(void insert_item(int position, const Glib::RefPtr<MenuItem>& item), g_menu_insert_item)
+ _WRAP_METHOD(void prepend_item(const Glib::RefPtr<MenuItem>& item), g_menu_prepend_item)
+ _WRAP_METHOD(void append_item(const Glib::RefPtr<MenuItem>& item), g_menu_append_item)
_WRAP_METHOD(void remove(int position), g_menu_remove)
_WRAP_METHOD(void remove_all(), g_menu_remove_all)
_WRAP_METHOD(void prepend(const Glib::ustring& label, const Glib::ustring& detailed_action{?}), g_menu_prepend)
_WRAP_METHOD(void append(const Glib::ustring& label, const Glib::ustring& detailed_action{?}), g_menu_append)
-// TODO: Should the MenuModel be const too?
_WRAP_METHOD(void insert_section(int position, const Glib::ustring& label{?}, const Glib::RefPtr<MenuModel>& section), g_menu_insert_section)
_WRAP_METHOD(void prepend_section(const Glib::ustring& label{?}, const Glib::RefPtr<MenuModel>& section), g_menu_prepend_section)
_WRAP_METHOD(void append_section(const Glib::ustring& label{?}, const Glib::RefPtr<MenuModel>& section), g_menu_append_section)
_WRAP_METHOD(Glib::ustring get_name() const, g_menu_attribute_iter_get_name)
- _WRAP_METHOD(Glib::VariantBase get_value() const, g_menu_attribute_iter_get_value)
+ //TODO: When we can break ABI, remove the method overload and just make it const.
+ //It makes no sense to return const by value.
+ _WRAP_METHOD(Glib::VariantBase get_value(), g_menu_attribute_iter_get_value)
+ _WRAP_METHOD(const Glib::VariantBase get_value() const, g_menu_attribute_iter_get_value, constversion)
_WRAP_METHOD(bool next(), g_menu_attribute_iter_next)
};
set_submenu(submenu);
}
+_DEPRECATE_IFDEF_START
+void
+MenuItem::set_action_and_target(const Glib::ustring& action)
+{
+ g_menu_item_set_action_and_target_value(gobj(), action.c_str(), nullptr);
+}
+_DEPRECATE_IFDEF_END
+
void
MenuItem::set_action(const Glib::ustring& action)
{
//void set_attribute(const Glib::ustring& attribute, const T_Value& value) const;
_WRAP_METHOD(void set_attribute_value(const Glib::ustring& attribute, const Glib::VariantBase& value), g_menu_item_set_attribute_value)
+ _WRAP_METHOD(void set_attribute(const Glib::ustring& attribute, const Glib::VariantBase& value), g_menu_item_set_attribute_value, deprecated "Use set_attribute() instead.")
_IGNORE(g_menu_item_set_attribute)
//These are documented as transfer-full, so we don't need to use refreturn.
//void get_attribute(const Glib::ustring& attribute, T_Value& value) const;
//_WRAP_METHOD(Glib::VariantBase get_attribute_value(const Glib::ustring& attribute, const Glib::VariantType& expected_type{?}) const, g_menu_item_get_attribute_value)
+ _WRAP_METHOD(Glib::VariantBase get_attribute(const Glib::ustring& attribute, const Glib::VariantType& expected_type{?}) const, g_menu_item_get_attribute_value, deprecated "Use get_attribute_value() instead.")
_WRAP_METHOD(Glib::VariantBase get_attribute_value(const Glib::ustring& attribute, const Glib::VariantType& expected_type{?}) const, g_menu_item_get_attribute_value)
// Ignore varargs function.
_IGNORE(g_menu_item_get_attribute)
+_DEPRECATE_IFDEF_START
+ /** Unsets the target for the specified @a action.
+ * @deprecated Use set_action() or unset_target() instead.
+ */
+ void set_action_and_target(const Glib::ustring& action);
+_DEPRECATE_IFDEF_END
+
/** Sets the action for the menu item.
* See set_action_and_target().
*
#m4begin
dnl See the .ccg implementation for how this conversion works.
+ //TODO: When we can break ABI, remove the method overload and just make it const.
+ //It makes no sense to return const by value.
_CONVERSION(`MenuAttribute',`const gchar*',`giomm_get_menu_attribute($3)')
#m4end
//TODO: Add a get_item_attribute() templated method to get values directly
//instead of returning a Glib::VariantBase?
- _WRAP_METHOD(Glib::VariantBase get_item_attribute(int item_index, MenuAttribute attribute, const Glib::VariantType& expected_type) const, g_menu_model_get_item_attribute_value)
+ _WRAP_METHOD(Glib::VariantBase get_item_attribute(int item_index, MenuAttribute attribute, const Glib::VariantType& expected_type), g_menu_model_get_item_attribute_value)
+ _WRAP_METHOD(const Glib::VariantBase get_item_attribute(int item_index, MenuAttribute attribute, const Glib::VariantType& expected_type) const, g_menu_model_get_item_attribute_value, constversion)
// Ignore varargs function
_IGNORE(g_menu_model_get_item_attribute)
void
Mount::unmount(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::unmount(const SlotAsyncReady& slot, UnmountFlags flags)
+Mount::unmount(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::unmount(UnmountFlags flags)
+Mount::unmount(MountUnmountFlags flags)
{
g_mount_unmount_with_operation(gobj(), GMountUnmountFlags(flags),
nullptr, // mount_operation
void
Mount::unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Mount::unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- UnmountFlags flags)
+ MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::unmount(const Glib::RefPtr<MountOperation>& mount_operation, UnmountFlags flags)
+Mount::unmount(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_mount_unmount_with_operation(gobj(), GMountUnmountFlags(flags), Glib::unwrap(mount_operation),
nullptr, // cancellable
void
Mount::remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, MountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Mount::remount(
- const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, MountFlags flags)
+ const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::remount(const Glib::RefPtr<MountOperation>& operation, MountFlags flags)
+Mount::remount(const Glib::RefPtr<MountOperation>& operation, MountMountFlags flags)
{
g_mount_remount(gobj(), static_cast<GMountMountFlags>(flags), Glib::unwrap(operation), nullptr,
nullptr, nullptr);
}
void
-Mount::remount(MountFlags flags)
+Mount::remount(MountMountFlags flags)
{
g_mount_remount(gobj(), static_cast<GMountMountFlags>(flags), nullptr, nullptr, nullptr, nullptr);
}
void
Mount::eject(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::eject(const SlotAsyncReady& slot, UnmountFlags flags)
+Mount::eject(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::eject(UnmountFlags flags)
+Mount::eject(MountUnmountFlags flags)
{
g_mount_eject_with_operation(gobj(), GMountUnmountFlags(flags),
nullptr, // mount_operation
void
Mount::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Mount::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- UnmountFlags flags)
+ MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Mount::eject(const Glib::RefPtr<MountOperation>& mount_operation, UnmountFlags flags)
+Mount::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_mount_eject_with_operation(gobj(), GMountUnmountFlags(flags), Glib::unwrap(mount_operation),
nullptr, // cancellable
namespace Gio
{
+_WRAP_ENUM(MountUnmountFlags, GMountUnmountFlags, NO_GTYPE)
+_WRAP_ENUM(MountMountFlags, GMountMountFlags, NO_GTYPE)
class File;
class Drive;
_CLASS_INTERFACE(Mount, GMount, G_MOUNT, GMountIface)
public:
- _WRAP_ENUM(UnmountFlags, GMountUnmountFlags, NO_GTYPE)
- _WRAP_ENUM(MountFlags, GMountMountFlags, NO_GTYPE)
_WRAP_METHOD(Glib::RefPtr<File> get_root(), g_mount_get_root, refreturn)
_WRAP_METHOD(Glib::RefPtr<const File> get_root() const, g_mount_get_root, refreturn, constversion)
_WRAP_METHOD(bool can_unmount() const, g_mount_can_unmount)
_WRAP_METHOD(bool can_eject() const, g_mount_can_eject)
- void unmount(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags = UnmountFlags::NONE);
- void unmount(const SlotAsyncReady& slot, UnmountFlags flags = UnmountFlags::NONE);
- void unmount(UnmountFlags flags = UnmountFlags::NONE);
- void unmount(const Glib::RefPtr<MountOperation>& mount_operation, UnmountFlags flags = UnmountFlags::NONE);
- void unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, UnmountFlags flags = UnmountFlags::NONE);
- void unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags = UnmountFlags::NONE);
+ void unmount(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void unmount(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void unmount(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void unmount(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void unmount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_mount_unmount)
_IGNORE(g_mount_unmount_with_operation)
* @param cancellable A cancellable object which can be used to cancel the operation.
* @param flags Flags affecting the operation.
*/
- void remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountFlags flags = MountFlags::NONE);
+ void remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Remounts a mount.
* This is an asynchronous operation, and is finished by calling mount_finish() with the AsyncResult data returned in the callback slot.
* @param slot A callback which will be called when the operation is completed or canceled.
* @param flags Flags affecting the operation.
*/
- void remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, MountFlags flags = MountFlags::NONE);
+ void remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Remounts a mount.
*
* @param operation A mount operation.
* @param flags Flags affecting the operation.
*/
- void remount(const Glib::RefPtr<MountOperation>& operation, MountFlags flags = MountFlags::NONE);
+ void remount(const Glib::RefPtr<MountOperation>& operation, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Remounts a mount, without user interaction.
*
*
* @param flags Flags affecting the operation.
*/
- void remount(MountFlags flags = MountFlags::NONE);
+ void remount(MountMountFlags flags = MOUNT_MOUNT_NONE);
_IGNORE(g_mount_remount)
_WRAP_METHOD(bool remount_finish(const Glib::RefPtr<AsyncResult>& result), g_mount_remount_finish, errthrow)
- void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags = UnmountFlags::NONE);
- void eject(const SlotAsyncReady& slot, UnmountFlags flags = UnmountFlags::NONE);
- void eject(UnmountFlags flags = UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, UnmountFlags flags = UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, UnmountFlags flags = UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, UnmountFlags flags = UnmountFlags::NONE);
+ void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_mount_eject)
_IGNORE(g_mount_eject_with_operation)
void guess_content_type_sync(bool force_rescan = true);
_IGNORE(g_mount_guess_content_type_sync)
- #m4 _CONVERSION(`gchar**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
+ #m4 _CONVERSION(`gchar**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
/** Finishes guessing content types of the Mount.
* If any errors occurred during the operation, an exception will be thrown.
* @return An array of content types.
* @throw Glib::Error
*/
- _WRAP_METHOD(
std::vector<Glib::ustring> guess_content_type_finish(const Glib::RefPtr<AsyncResult>& result), g_mount_guess_content_type_finish, errthrow)
+ _WRAP_METHOD(
Glib::StringArrayHandle guess_content_type_finish(const Glib::RefPtr<AsyncResult>& result), g_mount_guess_content_type_finish, errthrow)
_WRAP_METHOD(bool is_shadowed() const, g_mount_is_shadowed)
_WRAP_METHOD(void shadow(), g_mount_shadow)
_WRAP_SIGNAL(void changed(), changed)
_WRAP_SIGNAL(void unmounted(), unmounted)
- _WRAP_SIGNAL(void pre_unmount(), pre_unmount)
+ _WRAP_SIGNAL(void pre_unmount(), pre_unmount, no_default_handler)
//There are no properties.
};
*/
#include <glibmm/object.h>
+#include <glibmm/arrayhandle.h>
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
{
_WRAP_ENUM(AskPasswordFlags, GAskPasswordFlags, NO_GTYPE)
-_WRAP_ENUM(PasswordSave, GPasswordSave, NO_GTYPE)
+_WRAP_ENUM(PasswordSave, GPasswordSave)
_WRAP_ENUM(MountOperationResult, GMountOperationResult, NO_GTYPE)
/** Authentication methods for mountable locations.
#m4 _CONVERSION(`const char*',`const Glib::ustring&',__GCHARP_TO_USTRING)
_WRAP_SIGNAL(void ask_password(const Glib::ustring& message, const Glib::ustring& default_user, const Glib::ustring& default_domain, AskPasswordFlags flags), ask_password)
- //TODO: We really need some test to make sure that our use of ArrayHandler is correct. murrayc.
-#m4 _CONVERSION(`const std::vector<Glib::ustring>&',`const gchar**',`const_cast<const gchar**>(Glib::ArrayHandler<Glib::ustring>::vector_to_array($3).data())')
-#m4 _CONVERSION(`const gchar**',`const std::vector<Glib::ustring>&',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_SIGNAL(void ask_question(const Glib::ustring& message, const std::vector<Glib::ustring>& choices), ask_question)
+ //TODO: We really need some test to make sure that our use of StringArrayHandle is correct. murrayc.
+#m4 _CONVERSION(`const Glib::StringArrayHandle&',`const gchar**',`const_cast<const gchar**>(($3).data())')
+#m4 _CONVERSION(`const gchar**',`const Glib::StringArrayHandle&',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_SIGNAL(void ask_question(const Glib::ustring& message, const Glib::StringArrayHandle& choices), ask_question)
_WRAP_SIGNAL(void reply(MountOperationResult result), reply)
- _WRAP_SIGNAL(void aborted(), aborted)
+
+ //TODO: Remove no_default_handler when we can break ABI:
+ _WRAP_SIGNAL(void aborted(), aborted, no_default_handler)
//TODO: The array of char* is not very pleasant to wrap:
//_WRAP_SIGNAL( void show_processes(const Glib::ustring& message, GArray* processes, const gchar *choices[]);
- _WRAP_SIGNAL(void show_unmount_progress(const Glib::ustring& message, gint64 time_left, gint64 bytes_left), "show_unmount_progress")
+ _WRAP_SIGNAL(void show_unmount_progress(const Glib::ustring& message, gint64 time_left, gint64 bytes_left), "show_unmount_progress", no_default_handler)
_WRAP_PROPERTY("username", Glib::ustring)
_WRAP_PROPERTY("password", Glib::ustring)
namespace Gio
{
-_WRAP_ENUM(NetworkConnectivity, GNetworkConnectivity, NO_GTYPE)
-
+_WRAP_ENUM(NetworkConnectivity, GNetworkConnectivity)
/** Network status monitor.
*
- * %NetworkMonitor provides an easy-to-use cross-platform API
+ * %Gio::NetworkMonitor provides an easy-to-use cross-platform API
* for monitoring network connectivity. On Linux, the available
* implementations are based on the kernel's netlink interface and
* on NetworkManager.
*
* There is also an implementation for use inside Flatpak sandboxes.
-
+ *
* @newin{2,44}
*/
class NetworkMonitor : public Glib::Interface
{
class Icon;
+_WRAP_ENUM(NotificationPriority, GNotificationPriority, newin "2,44")
/** User Notifications (pop up messages).
*
_IGNORE(g_notification_new)
public:
- _WRAP_ENUM(Priority, GNotificationPriority, newin "2,44")
-
_WRAP_METHOD_DOCS_ONLY(g_notification_new)
_WRAP_CREATE(const Glib::ustring& title)
_WRAP_METHOD(void set_title(const Glib::ustring& title), g_notification_set_title)
_WRAP_METHOD(void set_body(const Glib::ustring& body), g_notification_set_body)
_WRAP_METHOD(void set_icon(const Glib::RefPtr<Icon>& icon), g_notification_set_icon)
- _IGNORE(g_notification_set_urgent)
- _WRAP_METHOD(void set_priority(Priority priority = Priority::NORMAL), g_notification_set_priority, newin "2,44")
+ _WRAP_METHOD(void set_urgent(bool urgent = true), g_notification_set_urgent, deprecated "Use set_priority() instead.")
+ _WRAP_METHOD(void set_priority(NotificationPriority priority = NOTIFICATION_PRIORITY_NORMAL), g_notification_set_priority, newin "2,44")
_WRAP_METHOD(void add_button(const Glib::ustring& label, const Glib::ustring& detailed_action), g_notification_add_button)
#include <glibmm/exceptionhandler.h>
#include "slot_async.h"
-using SpliceFlags = Gio::OutputStream::SpliceFlags;
-
namespace Gio
{
void
OutputStream::splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, SpliceFlags flags, int io_priority)
+ const Glib::RefPtr<Cancellable>& cancellable, OutputStreamSpliceFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
OutputStream::splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot,
- SpliceFlags flags, int io_priority)
+ OutputStreamSpliceFlags flags, int io_priority)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
gssize
OutputStream::splice(const Glib::RefPtr<InputStream>& source,
- const Glib::RefPtr<Cancellable>& cancellable, SpliceFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, OutputStreamSpliceFlags flags)
{
GError* gerror = nullptr;
gssize retvalue = g_output_stream_splice(gobj(), Glib::unwrap(source),
}
gssize
-OutputStream::splice(const Glib::RefPtr<InputStream>& source, SpliceFlags flags)
+OutputStream::splice(const Glib::RefPtr<InputStream>& source, OutputStreamSpliceFlags flags)
{
GError* gerror = nullptr;
gssize retvalue = g_output_stream_splice(
namespace Gio
{
+_WRAP_ENUM(OutputStreamSpliceFlags, GOutputStreamSpliceFlags, NO_GTYPE)
/** Base class for implementing streaming output.
*
_CTOR_DEFAULT
public:
- _WRAP_ENUM(SpliceFlags, GOutputStreamSpliceFlags, NO_GTYPE)
_WRAP_METHOD(gssize write(const void* buffer, gsize count, const Glib::RefPtr<Cancellable>& cancellable{?}),
g_output_stream_write,
/** Splices an input stream into an output stream.
*
* @param source An InputStream.
- * @param flags A set of SpliceFlags.
+ * @param flags A set of OutputStreamSpliceFlags.
* @param cancellable A Cancellable object.
* ignore.
* @return A #gssize containing the size of the data spliced.
*/
- gssize splice(const Glib::RefPtr<InputStream>& source, const Glib::RefPtr<Cancellable>& cancellable, SpliceFlags flags = SpliceFlags::NONE);
+ gssize splice(const Glib::RefPtr<InputStream>& source, const Glib::RefPtr<Cancellable>& cancellable, OutputStreamSpliceFlags flags = OUTPUT_STREAM_SPLICE_NONE);
/** Splices an input stream into an output stream.
*
* @param source An InputStream.
- * @param flags A set of SpliceFlags.
+ * @param flags A set of OutputStreamSpliceFlags.
* ignore.
* @return A #gssize containing the size of the data spliced.
*/
- gssize splice(const Glib::RefPtr<InputStream>& source, SpliceFlags flags = SpliceFlags::NONE);
+ gssize splice(const Glib::RefPtr<InputStream>& source, OutputStreamSpliceFlags flags = OUTPUT_STREAM_SPLICE_NONE);
_IGNORE(g_output_stream_splice)
_WRAP_METHOD(bool flush(const Glib::RefPtr<Cancellable>& cancellable{?}),
* @param source An InputStream.
* @param slot Callback slot to call when the request is satisfied.
* @param cancellable Cancellable object.
- * @param flags A set of SpliceFlags.
+ * @param flags A set of OutputStreamSpliceFlags.
* @param io_priority The io priority of the request.
*/
- void splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, SpliceFlags flags = SpliceFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, OutputStreamSpliceFlags flags = OUTPUT_STREAM_SPLICE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
/** Splices a stream asynchronously.
* When the operation is finished @a slot will be called.
*
* @param source An InputStream.
* @param slot Callback slot to call when the request is satisfied.
- * @param flags A set of SpliceFlags.
+ * @param flags A set of OutputStreamSpliceFlags.
* @param io_priority The io priority of the request.
*/
- void splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot, SpliceFlags flags = SpliceFlags::NONE, int io_priority = Glib::PRIORITY_DEFAULT);
+ void splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot, OutputStreamSpliceFlags flags = OUTPUT_STREAM_SPLICE_NONE, int io_priority = Glib::PRIORITY_DEFAULT);
_IGNORE(g_output_stream_splice_async)
_WRAP_METHOD(bool set_pending(), g_output_stream_set_pending, errthrow, newin "2,50")
_WRAP_METHOD(void clear_pending(), g_output_stream_clear_pending, newin "2,50")
+ //TODO: When we can break ABI, add vfuncs. See https://bugzilla.gnome.org/show_bug.cgi?id=572471
#m4 _CONVERSION(`GCancellable*', `const Glib::RefPtr<Cancellable>&', `Glib::wrap($3, true)')
#m4 _CONVERSION(`GInputStream*', `const Glib::RefPtr<InputStream>&', `Glib::wrap($3, true)')
- _WRAP_VFUNC(gssize write(const void* buffer, gsize count, const Glib::RefPtr<Cancellable>& cancellable), write_fn, errthrow, err_return_value -1)
- _WRAP_VFUNC(gssize splice(const Glib::RefPtr<InputStream>& source, const Glib::RefPtr<Cancellable>& cancellable{.}, SpliceFlags flags{.}), splice, errthrow, err_return_value -1)
- _WRAP_VFUNC(bool flush(const Glib::RefPtr<Cancellable>& cancellable), flush, errthrow)
- _WRAP_VFUNC(bool close(const Glib::RefPtr<Cancellable>& cancellable), close_fn, errthrow)
+ //_WRAP_VFUNC(gssize write(const void* buffer, gsize count, const Glib::RefPtr<Cancellable>& cancellable), write_fn, errthrow, err_return_value -1)
+ //_WRAP_VFUNC(gssize splice(const Glib::RefPtr<InputStream>& source, const Glib::RefPtr<Cancellable>& cancellable{.}, OutputStreamSpliceFlags flags{.}), splice, errthrow, err_return_value -1)
+ //_WRAP_VFUNC(bool flush(const Glib::RefPtr<Cancellable>& cancellable), flush, errthrow)
+ //_WRAP_VFUNC(bool close(const Glib::RefPtr<Cancellable>& cancellable), close_fn, errthrow)
};
} // namespace Gio
class Cancellable;
-// GPollableInputStream requires GInputStream (a GObject), but Gio::PollableInputStream
-// shall not be derived from Gio::InputStream, like the Gio::Tls[Client|Server]Connection
-// interfaces are derived from Gio::TlsConnection. The unusual Gio::TlsConnection class
-// hierarchy is possible only because no subclass of Glib::Object implements
-// Gio::Tls[Client|Server]Connection.
-// See https://bugzilla.gnome.org/show_bug.cgi?id=776537
+//TODO: Instead derive from InputStream, when we can break ABI,
+//because the GPollableInputStream interface requires the GInputStream interface.
+//LoadableIcon does a similar thing correctly, for instance.
/** PollableInputStream - Interface for pollable input streams.
* PollableInputStream is implemented by InputStreams that can be polled for
class Cancellable;
-// GPollableOutputStream requires GOutputStream (a GObject), but Gio::PollableOutputStream
-// shall not be derived from Gio::OutputStream, like the Gio::Tls[Client|Server]Connection
-// interfaces are derived from Gio::TlsConnection. The unusual Gio::TlsConnection class
-// hierarchy is possible only because no subclass of Glib::Object implements
-// Gio::Tls[Client|Server]Connection.
-// See https://bugzilla.gnome.org/show_bug.cgi?id=776537
+//TODO: Instead derive from OutputStream, when we can break ABI,
+//because the GPollableOutputStream interface requires the GOutputStream interface.
+//LoadableIcon does a similar thing correctly, for instance.
/** PollableOutputStream - Interface for pollable output streams.
* PollableOutputStream is implemented by OutputStreams that can be polled for
+++ /dev/null
-/* Copyright (C) 2017 The giomm Development Team
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include <glibmm/object.h>
-#include <glibmm/refptr.h>
-#include <giomm/action.h>
-
-_DEFS(giomm,gio)
-_PINCLUDE(glibmm/private/object_p.h)
-
-namespace Gio
-{
-/** An Action reflecting a Glib::Object property.
- *
- * A %PropertyAction is a way to get an Action with a state value
- * reflecting and controlling the value of a Glib::Object property.
- *
- * The state of the action will correspond to the value of the property.
- * Changing it will change the property (assuming the requested value
- * matches the requirements as specified in the GParamSpec, used when the
- * property was installed).
- *
- * Only the most common types are presently supported. Booleans are
- * mapped to booleans, strings to strings, signed/unsigned integers to
- * int32/uint32 and floats and doubles to doubles.
- *
- * If the property is an enum then the state will be string-typed and
- * conversion will automatically be performed between the enum value and
- * "nick" string as per the GEnumValue table.
- *
- * Flags types are not currently supported.
- *
- * Properties of object types, boxed types and pointer types are not
- * supported and probably never will be.
- *
- * Properties of Glib::Variant types are not currently supported.
- *
- * If the property is boolean-valued then the action will have a nullptr
- * parameter type, and activating the action (with no parameter) will
- * toggle the value of the property.
- *
- * In all other cases, the parameter type will correspond to the type of
- * the property.
- *
- * The general idea here is to reduce the number of locations where a
- * particular piece of state is kept (and therefore has to be synchronised
- * between). %PropertyAction does not have a separate state that is kept
- * in sync with the property value -- its state is the property value.
- *
- * For example, it might be useful to create an Action corresponding to
- * property_visible_child_name() of a Gtk::Stack so that the current
- * page can be switched from a menu. The active radio indication in the
- * menu is then directly determined from the active page of the Gtk::Stack.
- *
- * An anti-example would be binding property_active_id() on a Gtk::ComboBox.
- * This is because the state of the combobox itself is probably uninteresting
- * and is actually being used to control something else.
- *
- * Another anti-example would be to bind to property_visible_child_name()
- * of a Gtk::Stack if this value is actually stored in Gio::Settings.
- * In that case, the real source of the value is
- * Gio::Settings. If you want an Action to control a setting stored in
- * Gio::Settings, see Gio::Settings::create_action() instead, and possibly
- * combine its use with Gio::Settings::bind().
- *
- * @newin{2,58}
- */
-class PropertyAction : public Glib::Object, public Action
-{
- _CLASS_GOBJECT(PropertyAction, GPropertyAction, G_PROPERTY_ACTION, Glib::Object, GObject)
- _IMPLEMENTS_INTERFACE(Action)
-
-protected:
- PropertyAction(const Glib::ustring& name, const Glib::PropertyProxy_Base& property_proxy,
- bool invert_boolean = false);
-
-public:
- /** Creates an Action corresponding to the value of property @a property_proxy.
- *
- * The property must be existent and readable and writable (and not construct-only).
- *
- * This function takes a reference on the property's object and doesn't
- * release it until the action is destroyed.
- *
- * @param name The name of the action to create.
- * @param property_proxy The property to bind.
- * @param invert_boolean If <tt>true</tt>, the state of the action will be
- * the negation of the property value, provided the property is boolean.
- * @return A new %PropertyAction.
- *
- * @newin{2,58}
- */
- _WRAP_CREATE(const Glib::ustring& name, const Glib::PropertyProxy_Base& property_proxy,
- bool invert_boolean = false)
-
- _WRAP_PROPERTY("name", Glib::ustring, newin "2,58")
- _WRAP_PROPERTY("parameter-type", Glib::VariantType, newin "2,58")
- _WRAP_PROPERTY("enabled", bool, newin "2,58")
- _WRAP_PROPERTY("state-type", Glib::VariantType, newin "2,58")
- _WRAP_PROPERTY("state", Glib::VariantBase, newin "2,58")
- //_WRAP_PROPERTY("object", Glib::ObjectBase) // write-only, construct-only
- //_WRAP_PROPERTY("property-name", Glib::ustring) // write-only, construct-only
- _WRAP_PROPERTY("invert-boolean", bool, newin "2,58")
-
- // There are no methods (apart from ctor and create), signals or vfuncs.
-};
-
-} // namespace Gio
_WRAP_PROPERTY("protocol", Glib::ustring)
_WRAP_PROPERTY("destination_protocol", Glib::ustring)
_WRAP_PROPERTY("destination_hostname", Glib::ustring)
- // Don't use guint16 in _WRAP_PROPERTY().
- // There is no Glib::Value<> specialization for guint16.
- // Glib::Value<unsigned int> exists, and guint is a typedef of unsigned int.
- _WRAP_PROPERTY("destination_port", guint)
+
+//TODO: This should really be a guint16:
+ _WRAP_PROPERTY("destination_port", Glib::ustring)
+
_WRAP_PROPERTY("username", Glib::ustring)
_WRAP_PROPERTY("password", Glib::ustring)
_WRAP_PROPERTY("uri", Glib::ustring)
_WRAP_METHOD(bool is_supported() const, g_proxy_resolver_is_supported)
- //TODO: Use std::string instead of ustring?:
+ //TODO: Use std::string instead of ustring (StringArrayHandle uses ustring)?:
#m4 _CONVERSION(`gchar**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
_WRAP_METHOD(std::vector<Glib::ustring> lookup(const Glib::ustring& uri,
const Glib::RefPtr<Cancellable>& cancellable), g_proxy_resolver_lookup, errthrow)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2012 The giomm Development Team
*
* This library is free software; you can redistribute it and/or
namespace Gio
{
+
+//TODO: Instead derive from ActionGroup, when we can break ABI,
+//because the GRemoteActionGroup interface requires the GActionGroup interface.
+//LoadableIcon does a similar thing correctly, for instance.
+
+
/** RemoteActionGroup - a ActionGroup that interacts with other processes.
* The RemoteActionGroup interface is implemented by ActionGroup instances that
* either transmit action invocations to other processes or receive action
#m4 _CONVERSION(`GVariant*',`const Glib::VariantBase&',`Glib::wrap($3, true)')
- _WRAP_VFUNC(void activate_action_full(const Glib::ustring& action_name, const Glib::VariantBase& parameter, const Glib::VariantBase& platform_data), "activate_action_full")
- _WRAP_VFUNC(void change_action_state_full(const Glib::ustring& action_name, const Glib::VariantBase& value, const Glib::VariantBase& platform_data), "change_action_state_full")
+ _WRAP_VFUNC(void activate_action(const Glib::ustring& action_name, const Glib::VariantBase& parameter, const Glib::VariantBase& platform_data), "activate_action_full")
+ _WRAP_VFUNC(void change_action_state(const Glib::ustring& action_name, const Glib::VariantBase& value, const Glib::VariantBase& platform_data), "change_action_state_full")
};
} // namespace Gio
#include <glibmm/error.h>
#include "slot_async.h"
-namespace {
-
-struct SrvTargetListTraits
-{
- using CppType = Gio::SrvTarget;
- using CType = const GSrvTarget*;
- using CTypeNonConst = GSrvTarget*;
-
- static CType to_c_type(const CppType& item) { return item.gobj(); }
- static CType to_c_type(CType ptr) { return ptr; }
- static CppType to_cpp_type(CType item) { return CppType(const_cast<CTypeNonConst>(item), true /* take_copy */); }
- static void release_c_type(CType item) { g_srv_target_free(const_cast<CTypeNonConst>(item)); }
-};
-
-} // anonymous namespace
-
namespace Gio
{
}
void
-Resolver::lookup_records_async(const Glib::ustring& rrname, RecordType record_type,
+Resolver::lookup_records_async(const Glib::ustring& rrname, ResolverRecordType record_type,
const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable)
{
auto slot_copy = new SlotAsyncReady(slot);
void
Resolver::lookup_records_async(
- const Glib::ustring& rrname, RecordType record_type, const SlotAsyncReady& slot)
+ const Glib::ustring& rrname, ResolverRecordType record_type, const SlotAsyncReady& slot)
{
auto slot_copy = new SlotAsyncReady(slot);
namespace Gio
{
+_WRAP_ENUM(ResolverRecordType, GResolverRecordType)
+
/** Asynchronous and cancellable DNS resolver
*
* Resolver provides cancellable synchronous and asynchronous DNS resolution,
protected:
public:
- _WRAP_ENUM(RecordType, GResolverRecordType)
-
static Glib::RefPtr<Resolver> get_default();
_IGNORE(g_resolver_get_default)
static void set_default(const Glib::RefPtr<Resolver>& resolver);
// g_resolver_free_addresses is just a C convenience function
_IGNORE(g_resolver_free_addresses)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<InetAddress>>',`Glib::ListHandler<Glib::RefPtr<InetAddress>>::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<InetAddress>> lookup_by_name(const Glib::ustring& hostname, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_by_name, errthrow)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<InetAddress> >',`$2($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<InetAddress> > lookup_by_name(const Glib::ustring& hostname, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_by_name, errthrow)
/** Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls @a slot, which must call
* lookup_by_name_finish() to get the result. See lookup_by_name() for more details.
void lookup_by_name_async(const Glib::ustring& hostname, const SlotAsyncReady& slot);
_IGNORE(g_resolver_lookup_by_name_async)
- _WRAP_METHOD(
std::vector<Glib::RefPtr<InetAddress>> lookup_by_name_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_by_name_finish, errthrow)
+ _WRAP_METHOD(
Glib::ListHandle< Glib::RefPtr<InetAddress> > lookup_by_name_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_by_name_finish, errthrow)
_WRAP_METHOD(Glib::ustring lookup_by_address(const Glib::RefPtr<InetAddress>& address, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_by_address, errthrow)
_WRAP_METHOD(Glib::ustring lookup_by_address_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_by_address_finish, errthrow)
-#m4 _CONVERSION(`GList*',`std::vector<SrvTarget>',`Glib::ListHandler<SrvTarget, SrvTargetListTraits>::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<SrvTarget> lookup_service(const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_service, errthrow)
+#m4 _CONVERSION(`GList*',`ListHandle_SrvTarget',`$2($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(ListHandle_SrvTarget lookup_service(const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_service, errthrow)
/** Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback,
* which must call lookup_service_finish() to get the final result. See glookup_service() for more details.
void lookup_service_async(const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain, const SlotAsyncReady& slot);
_IGNORE(g_resolver_lookup_service_async)
- _WRAP_METHOD(
std::vector<SrvTarget> lookup_service_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_service_finish, errthrow)
+ _WRAP_METHOD(
ListHandle_SrvTarget lookup_service_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_service_finish, errthrow)
#m4 _CONVERSION(`GList*',`std::vector<Glib::VariantContainerBase>',`Glib::ListHandler<Glib::VariantContainerBase>::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::VariantContainerBase> lookup_records(const Glib::ustring& rrname, RecordType record_type, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_records, errthrow)
+ _WRAP_METHOD(std::vector<Glib::VariantContainerBase> lookup_records(const Glib::ustring& rrname, ResolverRecordType record_type, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_records, errthrow)
/** Begins asynchronously performing a DNS lookup for the given @a rrname,
* and eventually calls @a slot, which must call lookup_records_finish() to
* @newin{2,36}
*/
void lookup_records_async(const Glib::ustring& rrname,
- RecordType record_type, const SlotAsyncReady& slot,
+ ResolverRecordType record_type, const SlotAsyncReady& slot,
const Glib::RefPtr<Cancellable>& cancellable);
_IGNORE(g_resolver_lookup_records_async)
/// A non-cancellable version of lookup_records_async().
void lookup_records_async(const Glib::ustring& rrname,
- RecordType record_type, const SlotAsyncReady& slot);
+ ResolverRecordType record_type, const SlotAsyncReady& slot);
_WRAP_METHOD(std::vector<Glib::VariantContainerBase> lookup_records_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_records_finish, errthrow)
- _WRAP_SIGNAL(void reload(), reload)
+ //TODO: Remove no_default_handler when we can break ABI:
+ _WRAP_SIGNAL(void reload(), reload, no_default_handler)
};
std::string hostname_to_ascii (const Glib::ustring& hostname);
namespace Gio
{
-// Hand-coded because we want Flags& instead of guint32&.
+// Hand-coded because we want ResourceFlags& instead of guint32&.
void
-Resource::get_info(const std::string& path, gsize& size, Flags& flags,
- LookupFlags lookup_flags) const
+Resource::get_info(const std::string& path, gsize& size, ResourceFlags& flags,
+ ResourceLookupFlags lookup_flags) const
{
guint32 file_flags = 0;
GError* gerror = nullptr;
(GResourceLookupFlags)lookup_flags, &size, &file_flags, &gerror);
if (gerror)
::Glib::Error::throw_exception(gerror);
- flags = static_cast<Flags>(file_flags);
+ flags = static_cast<ResourceFlags>(file_flags);
}
void
-Resource::get_file_exists(const std::string& path, LookupFlags lookup_flags) const
+Resource::get_file_exists(const std::string& path, ResourceLookupFlags lookup_flags) const
{
GError* gerror = nullptr;
g_resource_get_info(const_cast<GResource*>(gobj()), path.c_str(),
}
bool
-Resource::get_file_exists_nothrow(const std::string& path, LookupFlags lookup_flags) const
+Resource::get_file_exists_nothrow(const std::string& path, ResourceLookupFlags lookup_flags) const
{
return g_resource_get_info(const_cast<GResource*>(gobj()), path.c_str(),
(GResourceLookupFlags)lookup_flags, nullptr, nullptr, nullptr);
}
-// Hand-coded because we want Flags& instead of guint32&.
+// Hand-coded because we want ResourceFlags& instead of guint32&.
// static
void
Resource::get_info_global(
- const std::string& path, gsize& size, Flags& flags, LookupFlags lookup_flags)
+ const std::string& path, gsize& size, ResourceFlags& flags, ResourceLookupFlags lookup_flags)
{
guint32 file_flags = 0;
GError* gerror = nullptr;
path.c_str(), (GResourceLookupFlags)lookup_flags, &size, &file_flags, &gerror);
if (gerror)
::Glib::Error::throw_exception(gerror);
- flags = static_cast<Flags>(file_flags);
+ flags = static_cast<ResourceFlags>(file_flags);
}
// static
void
-Resource::get_file_exists_global(const std::string& path, LookupFlags lookup_flags)
+Resource::get_file_exists_global(const std::string& path, ResourceLookupFlags lookup_flags)
{
GError* gerror = nullptr;
g_resources_get_info(path.c_str(), (GResourceLookupFlags)lookup_flags, nullptr, nullptr, &gerror);
// static
bool
-Resource::get_file_exists_global_nothrow(const std::string& path, LookupFlags lookup_flags)
+Resource::get_file_exists_global_nothrow(const std::string& path, ResourceLookupFlags lookup_flags)
{
return g_resources_get_info(
path.c_str(), (GResourceLookupFlags)lookup_flags, nullptr, nullptr, nullptr);
*/
_WRAP_GERROR(ResourceError, GResourceError, G_RESOURCE_ERROR, NO_GTYPE, newin "2,34")
+_WRAP_ENUM(ResourceFlags, GResourceFlags, newin "2,44")
+_WRAP_ENUM(ResourceLookupFlags, GResourceLookupFlags, newin "2,44")
+
/** %Resource framework.
*
* Applications and libraries often contain binary or textual data that is
_IGNORE(g_resource_ref, g_resource_unref)
public:
- _WRAP_ENUM(Flags, GResourceFlags, newin "2,44")
- _WRAP_ENUM(LookupFlags, GResourceLookupFlags, newin "2,44")
-
- _WRAP_METHOD(static Glib::RefPtr<Resource> create_from_data(const Glib::RefPtr<const Glib::Bytes>& data), g_resource_new_from_data, errthrow "Glib::FileError", newin "2,44")
- _WRAP_METHOD(static Glib::RefPtr<Resource> create_from_file(const std::string& filename), g_resource_load, errthrow "Glib::FileError", newin "2,44")
- _WRAP_METHOD(Glib::RefPtr<InputStream> open_stream(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE) const, g_resource_open_stream, errthrow "Gio::ResourceError", newin "2,44")
- _WRAP_METHOD(Glib::RefPtr<const Glib::Bytes> lookup_data(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE) const, g_resource_lookup_data, errthrow "Gio::ResourceError", newin "2,44")
+ _WRAP_METHOD(static Glib::RefPtr<Resource> create_from_data(const Glib::RefPtr<const Glib::Bytes>& data), g_resource_new_from_data, errthrow, newin "2,44")
+ _WRAP_METHOD(static Glib::RefPtr<Resource> create_from_file(const std::string& filename), g_resource_load, errthrow, newin "2,44")
+ _WRAP_METHOD(Glib::RefPtr<InputStream> open_stream(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const, g_resource_open_stream, errthrow, newin "2,44")
+ _WRAP_METHOD(Glib::RefPtr<const Glib::Bytes> lookup_data(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const, g_resource_lookup_data, errthrow, newin "2,44")
#m4 _CONVERSION(`char**',`std::vector<std::string>',`Glib::ArrayHandler<std::string>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<std::string> enumerate_children(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE) const, g_resource_enumerate_children, errthrow "Gio::ResourceError", newin "2,44")
+ _WRAP_METHOD(std::vector<std::string> enumerate_children(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const, g_resource_enumerate_children, errthrow, newin "2,44")
/** Looks for a file at the specified @a path in the resource and
* if found returns information about it.
* @param path A pathname inside the resource.
* @param[out] size A location to place the length of the contents of the file.
* @param[out] flags A location to place the flags about the file.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @throw Gio::ResourceError if the file was not found.
*/
- void get_info(const std::string& path, gsize& size, Flags& flags, LookupFlags lookup_flags = LookupFlags::NONE) const;
+ void get_info(const std::string& path, gsize& size, ResourceFlags& flags, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const;
_IGNORE(g_resource_get_info)
/** Looks for a file at the specified @a path in the resource.
* @newin{2,44}
*
* @param path A pathname inside the resource.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @throw Gio::ResourceError if the file was not found.
*/
- void get_file_exists(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE) const;
+ void get_file_exists(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const;
/** Looks for a file at the specified @a path in the resource.
*
* @newin{2,44}
*
* @param path A pathname inside the resource.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @return <tt>true</tt> if the file was found, <tt>false</tt> if there were errors.
*/
- bool get_file_exists_nothrow(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE) const;
+ bool get_file_exists_nothrow(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE) const;
// 'register' is a keyword. Can't be the name of a method.
_WRAP_METHOD(void register_global(), g_resources_register, newin "2,44")
_WRAP_METHOD(void unregister_global(), g_resources_unregister, newin "2,44")
- _WRAP_METHOD(static Glib::RefPtr<InputStream> open_stream_global(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE), g_resources_open_stream, errthrow "Gio::ResourceError", newin "2,44")
- _WRAP_METHOD(static Glib::RefPtr<const Glib::Bytes> lookup_data_global(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE), g_resources_lookup_data, errthrow "Gio::ResourceError", newin "2,44")
- _WRAP_METHOD(static std::vector<std::string> enumerate_children_global(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE), g_resources_enumerate_children, errthrow "Gio::ResourceError", newin "2,44")
+ _WRAP_METHOD(static Glib::RefPtr<InputStream> open_stream_global(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE), g_resources_open_stream, errthrow, newin "2,44")
+ _WRAP_METHOD(static Glib::RefPtr<const Glib::Bytes> lookup_data_global(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE), g_resources_lookup_data, errthrow, newin "2,44")
+ _WRAP_METHOD(static std::vector<std::string> enumerate_children_global(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE), g_resources_enumerate_children, errthrow, newin "2,44")
/** Looks for a file at the specified @a path in the set of
* globally registered resources and if found returns information about it.
* @param path A pathname inside the resource.
* @param[out] size A location to place the length of the contents of the file.
* @param[out] flags A location to place the flags about the file.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @throw Gio::ResourceError if the file was not found.
*/
- static void get_info_global(const std::string& path, gsize& size, Flags& flags, LookupFlags lookup_flags = LookupFlags::NONE);
+ static void get_info_global(const std::string& path, gsize& size, ResourceFlags& flags, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE);
_IGNORE(g_resources_get_info)
/** Looks for a file at the specified @a path in the set of
* @newin{2,44}
*
* @param path A pathname inside the resource.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @throw Gio::ResourceError if the file was not found.
*/
- static void get_file_exists_global(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE);
+ static void get_file_exists_global(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE);
/** Looks for a file at the specified @a path in the set of
* globally registered resources.
* @newin{2,44}
*
* @param path A pathname inside the resource.
- * @param lookup_flags A LookupFlags.
+ * @param lookup_flags A ResourceLookupFlags.
* @return <tt>true</tt> if the file was found, <tt>false</tt> if there were errors.
*/
- static bool get_file_exists_global_nothrow(const std::string& path, LookupFlags lookup_flags = LookupFlags::NONE);
+ static bool get_file_exists_global_nothrow(const std::string& path, ResourceLookupFlags lookup_flags = RESOURCE_LOOKUP_FLAGS_NONE);
_IGNORE(g_static_resource_init, g_static_resource_fini, g_static_resource_get_resource)dnl//Used only by the glib-compile-resources command
};
}
void
Settings::bind(
- const Glib::ustring& key, const Glib::PropertyProxy_Base& property_proxy, BindFlags flags)
+ const Glib::ustring& key, const Glib::PropertyProxy_Base& property_proxy, SettingsBindFlags flags)
{
bind(key, property_proxy.get_object(), property_proxy.get_name(), flags);
}
bind_writable(key, property_proxy.get_object(), property_proxy.get_name(), inverted);
}
+_DEPRECATE_IFDEF_START
+G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+std::vector<Glib::ustring>
+Settings::list_schemas()
+{
+ return Glib::ArrayHandler<Glib::ustring>::array_to_vector(
+ g_settings_list_schemas(), Glib::OWNERSHIP_NONE);
+}
+G_GNUC_END_IGNORE_DEPRECATIONS
+_DEPRECATE_IFDEF_END
}
_CONFIGINCLUDE(giommconfig.h)
+#include <glibmm/arrayhandle.h>
#include <glibmm/object.h>
#include <glibmm/variant.h>
#include <giomm/action.h>
{
class SettingsSchema;
+ _WRAP_ENUM(SettingsBindFlags, GSettingsBindFlags)
+
/** A high-level API for application settings
*
* The Settings class provides a convenient API for storing and retrieving
{
_CLASS_GOBJECT(Settings, GSettings, G_SETTINGS, Glib::Object, GObject)
-public:
- _WRAP_ENUM(BindFlags, GSettingsBindFlags)
-
protected:
_WRAP_CTOR(Settings(const Glib::ustring& schema_id), g_settings_new)
_WRAP_CTOR(Settings(const Glib::ustring& schema_id, const Glib::ustring& path), g_settings_new_with_path)
//TODO: Requires SettingsBackend: _WRAP_CTOR(Settings(const Glib::ustring& schema_id, const Glib::RefPtr<SettingsBackend>& backend), g_settings_new_with_backend)
//TODO: Requires SettingsBackend: _WRAP_CTOR(Settings(const Glib::ustring& schema_id, const Glib::RefPtr<SettingsBackend>& backend, const Glib::ustring& path), g_settings_new_with_backend_and_path)
- //TODO: Requires SettingsBackend: _WRAP_CTOR(Settings(const Glib::RefPtr<SettingsSchema>& settings_schema, const Glib::RefPtr<SettingsBackend>& backend, const Glib::ustring& path), g_settings_new_full)
public:
_WRAP_CREATE(const Glib::ustring& schema_id)
_WRAP_CREATE(const Glib::ustring& schema_id, const Glib::ustring& path)
//TODO: Requires SettingsBackend: _WRAP_CREATE(const Glib::ustring& schema_id, const Glib::RefPtr<SettingsBackend>& backend)
//TODO: Requires SettingsBackend: _WRAP_CREATE(const Glib::ustring& schema_id, const Glib::RefPtr<SettingsBackend>& backend, const Glib::ustring& path)
- //TODO: Requires SettingsBackend: _WRAP_CREATE(const Glib::RefPtr<SettingsSchema>& settings_schema, const Glib::RefPtr<SettingsBackend>& backend, const Glib::ustring& path)
//TODO: Rename these to get/set_*_value_variant() and add templated get/set_*_value() methods as elsewhere?
_WRAP_METHOD(bool set_value(const Glib::ustring& key, const Glib::VariantBase& value), g_settings_set_value)
_IGNORE(g_settings_get_default_value)
_WRAP_METHOD(int get_int(const Glib::ustring& key) const, g_settings_get_int)
- _WRAP_METHOD(bool set_int(const Glib::ustring& key, int value), g_settings_set_int)
+ _WRAP_METHOD(void set_int(const Glib::ustring& key, int value), g_settings_set_int)
_WRAP_METHOD(gint64 get_int64(const Glib::ustring& key) const, g_settings_get_int64)
- _WRAP_METHOD(bool set_int64(const Glib::ustring& key, gint64 value), g_settings_set_int64)
+ _WRAP_METHOD(void set_int64(const Glib::ustring& key, gint64 value), g_settings_set_int64)
_WRAP_METHOD(guint get_uint(const Glib::ustring& key) const, g_settings_get_uint)
- _WRAP_METHOD(bool set_uint(const Glib::ustring& key, guint value), g_settings_set_uint)
+ _WRAP_METHOD(void set_uiint(const Glib::ustring& key, guint value), g_settings_set_uint, deprecated "Use set_uint() instead.")
+ _WRAP_METHOD(void set_uint(const Glib::ustring& key, guint value), g_settings_set_uint)
_WRAP_METHOD(guint64 get_uint64(const Glib::ustring& key) const, g_settings_get_uint64)
- _WRAP_METHOD(bool set_uint64(const Glib::ustring& key, guint64 value), g_settings_set_uint64)
+ _WRAP_METHOD(void set_uint64(const Glib::ustring& key, guint64 value), g_settings_set_uint64)
_WRAP_METHOD(bool get_boolean(const Glib::ustring& key) const, g_settings_get_boolean)
- _WRAP_METHOD(bool set_boolean(const Glib::ustring& key, bool value), g_settings_set_boolean)
+ _WRAP_METHOD(void set_boolean(const Glib::ustring& key, bool value), g_settings_set_boolean)
_WRAP_METHOD(Glib::ustring get_string(const Glib::ustring& key) const, g_settings_get_string)
- _WRAP_METHOD(bool set_string(const Glib::ustring& key, const Glib::ustring& value), g_settings_set_string)
+ _WRAP_METHOD(void set_string(const Glib::ustring& key, const Glib::ustring& value), g_settings_set_string)
_WRAP_METHOD(double get_double(const Glib::ustring& key) const, g_settings_get_double)
- _WRAP_METHOD(bool set_double(const Glib::ustring& key, double value), g_settings_set_double)
+ _WRAP_METHOD(void set_double(const Glib::ustring& key, double value), g_settings_set_double)
- #m4 _CONVERSION(`gchar**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> get_string_array(const Glib::ustring& key) const, g_settings_get_strv)
+ #m4 _CONVERSION(`gchar**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle get_string_array(const Glib::ustring& key) const, g_settings_get_strv)
- _WRAP_METHOD(bool set_string_array(const Glib::ustring& key, const std::vector<Glib::ustring>& value), g_settings_set_strv)
+ _WRAP_METHOD(bool set_string_array(const Glib::ustring& key, const Glib::StringArrayHandle& value), g_settings_set_strv)
_WRAP_METHOD(int get_enum(const Glib::ustring& key) const, g_settings_get_enum)
+ _WRAP_METHOD(bool get_enum(const Glib::ustring& key, int value), g_settings_set_enum,
+ deprecated "This method is misnamed. Use set_enum() instead.")
_WRAP_METHOD(bool set_enum(const Glib::ustring& key, int value), g_settings_set_enum)
_WRAP_METHOD(guint get_flags(const Glib::ustring& key) const, g_settings_get_flags)
+ _WRAP_METHOD(bool get_flags(const Glib::ustring& key, guint value), g_settings_set_flags,
+ deprecated "This method is misnamed. Use set_flags() instead.")
_WRAP_METHOD(bool set_flags(const Glib::ustring& key, guint value), g_settings_set_flags)
// Ignore varargs functions.
_WRAP_METHOD(void reset(const Glib::ustring& key), g_settings_reset)
+_DEPRECATE_IFDEF_START
+//We must hand-code this because gmmproc is confused by the static keyword with the vector.
+//#m4 _CONVERSION(`const gchar*const*',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_NONE)')
+ _WRAP_METHOD_DOCS_ONLY(g_settings_list_schemas)
+ static std::vector<Glib::ustring> list_schemas();
+ _IGNORE(g_settings_list_schemas)
+_DEPRECATE_IFDEF_END
+
#m4 _CONVERSION(`gchar**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
_WRAP_METHOD(std::vector<Glib::ustring> list_children() const, g_settings_list_children)
- _IGNORE(g_settings_list_keys)
+ _WRAP_METHOD(std::vector<Glib::ustring> list_keys() const, g_settings_list_keys, deprecated "Use SettingsSchema::list_keys().")
_IGNORE(g_settings_get_range, g_settings_list_relocatable_schemas) // deprecated
- _IGNORE(g_settings_range_check)
+ _WRAP_METHOD(bool range_check(const Glib::ustring& key, const Glib::VariantBase& value) const, g_settings_range_check,
+ deprecated "Use g_settings_schema_key_range_check() instead.")
+ //TODO: Wrap GSettingsSchema
#m4 _CONVERSION(`Glib::ObjectBase*',`gpointer',(gpointer)$3->gobj())
- _WRAP_METHOD(void bind(const Glib::ustring& key, Glib::ObjectBase* object, const Glib::ustring& property, BindFlags flags = BindFlags::DEFAULT), g_settings_bind)
- void bind(const Glib::ustring& key, const Glib::PropertyProxy_Base& property_proxy, BindFlags flags = BindFlags::DEFAULT);
+ _WRAP_METHOD(void bind(const Glib::ustring& key, Glib::ObjectBase* object, const Glib::ustring& property, SettingsBindFlags flags=SETTINGS_BIND_DEFAULT), g_settings_bind)
+ void bind(const Glib::ustring& key, const Glib::PropertyProxy_Base& property_proxy, SettingsBindFlags flags=SETTINGS_BIND_DEFAULT);
// TODO: implement bind_with_mapping
_WRAP_METHOD(void bind_writable(const Glib::ustring& key, Glib::ObjectBase* object, const Glib::ustring& property, bool inverted=false), g_settings_bind_writable)
void bind_writable(const Glib::ustring& key, const Glib::PropertyProxy_Base& property_proxy, bool inverted=false);
_WRAP_PROPERTY("delay-apply", bool)
_WRAP_PROPERTY("has-unapplied", bool)
_WRAP_PROPERTY("path", std::string)
- _IGNORE_PROPERTY("schema")
+ _WRAP_PROPERTY("schema", Glib::ustring, deprecated "Use the 'schema-id' property instead. In a future version, this property may instead refer to a SettingsSchema.")
_WRAP_PROPERTY("schema-id", Glib::ustring)
- _WRAP_PROPERTY("settings-schema", Glib::RefPtr<SettingsSchema>, newin "2,58")
+ _WRAP_PROPERTY("settings-schema", Glib::RefPtr<SettingsSchema>, newin "2,60")
- //TODO?: _WRAP_SIGNAL(bool change_event(const std::vector<Glib::QueryQuark>& keys, int n_keys), "change-event")
+ //TODO?: _WRAP_SIGNAL(bool change_event(const Glib::ArrayHandle<Glib::QueryQuark>& keys, int n_keys), "change-event")
+ //TODO: Remove two_signal_methods when we can break ABI.
#m4 _CONVERSION(`const char*',`const Glib::ustring&',__GCHARP_TO_USTRING)
- _WRAP_SIGNAL(void changed(const Glib::ustring& key), "changed", detail_name key)
+ _WRAP_SIGNAL(void changed(const Glib::ustring& key), "changed", detail_name key, two_signal_methods)
_WRAP_SIGNAL(bool writable_change_event(GQuark key), "writable-change-event")
- _WRAP_SIGNAL(void writable_changed(const Glib::ustring& key), writable_changed, detail_name key)
+ _WRAP_SIGNAL(void writable_changed(const Glib::ustring& key), writable_changed, detail_name key, two_signal_methods)
};
} // namespace Gio
_CONFIGINCLUDE(giommconfig.h)
#include <giomm/settingsschemakey.h>
+#include <glibmm/arrayhandle.h>
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
class SettingsSchema final
{
_CLASS_OPAQUE_REFCOUNTED(SettingsSchema, GSettingsSchema, NONE, g_settings_schema_ref, g_settings_schema_unref)
+ _IS_REFCOUNTED_BOXEDTYPE
protected:
_IGNORE(g_settings_schema_ref, g_settings_schema_unref)
_WRAP_METHOD_DOCS_ONLY(g_simple_action_group_new)
_WRAP_CREATE()
- _IGNORE(g_simple_action_group_lookup, g_simple_action_group_insert, g_simple_action_group_remove)
+ _WRAP_METHOD(Glib::RefPtr<Action> lookup(const Glib::ustring& action_name), g_simple_action_group_lookup, refreturn, deprecated "Use ActionMap::lookup_action() instead")
+ _WRAP_METHOD(Glib::RefPtr<const Action> lookup(const Glib::ustring& action_name) const, g_simple_action_group_lookup, refreturn, constversion, deprecated "Use ActionMap::lookup_action() instead")
+
+ _WRAP_METHOD(void insert(const Glib::RefPtr<Action>& action), g_simple_action_group_insert, deprecated "Use ActionMap::add_action() instead")
+ _WRAP_METHOD(void remove(const Glib::ustring& action_name), g_simple_action_group_remove, deprecated "Use ActionMap::remove_action() instead")
_IGNORE(g_simple_action_group_add_entries) // deprecated
};
#include <giomm/socketsource.h>
#include "slot_async.h"
-using Type = Gio::Socket::Type;
-using Protocol = Gio::Socket::Protocol;
-
namespace Gio
{
-Socket::Socket(SocketFamily family, Type type, Protocol protocol,
+Socket::Socket(SocketFamily family, SocketType type, SocketProtocol protocol,
const Glib::RefPtr<Cancellable>& cancellable)
: _CONSTRUCT("family", int(family), "type", int(type), "protocol", int(protocol))
{
// static
Glib::RefPtr<Socket>
-Socket::create(SocketFamily family, Type type, Protocol protocol,
+Socket::create(SocketFamily family, SocketType type, SocketProtocol protocol,
const Glib::RefPtr<Cancellable>& cancellable)
{
- return Glib::make_refptr_for_instance<Socket>(new Socket(family, type, protocol, cancellable));
+ return Glib::RefPtr<Socket>(new Socket(family, type, protocol, cancellable));
}
// static
Glib::RefPtr<Socket>
Socket::create_from_fd(int fd, const Glib::RefPtr<Cancellable>& cancellable)
{
- return Glib::make_refptr_for_instance<Socket>(new Socket(fd, cancellable));
+ return Glib::RefPtr<Socket>(new Socket(fd, cancellable));
}
gssize
Glib::RefPtr<SocketSource>
Socket::create_source(Glib::IOCondition condition, const Glib::RefPtr<Cancellable>& cancellable)
{
- return SocketSource::create(gobj(), condition, cancellable);
+ // The corresponding unreference() takes place in the dtor
+ // of the Glib::RefPtr<Socket> object below.
+ reference();
+ return SocketSource::create(Glib::RefPtr<Socket>(this), condition, cancellable);
}
} // namespace Gio
{
class SocketSource;
+_WRAP_ENUM(SocketType, GSocketType)
+_WRAP_ENUM(SocketProtocol, GSocketProtocol)
+_WRAP_ENUM(SocketMsgFlags, GSocketMsgFlags)
/** @defgroup NetworkIO Portable Network I/O Functionality
*/
_CLASS_GOBJECT(Socket, GSocket, G_SOCKET, Glib::Object, GObject)
_IMPLEMENTS_INTERFACE(Initable)
-public:
- _WRAP_ENUM(Type, GSocketType)
- _WRAP_ENUM(Protocol, GSocketProtocol)
- _WRAP_ENUM(MsgFlags, GSocketMsgFlags)
-
protected:
- Socket(SocketFamily family, Type type, Protocol protocol,
+ Socket(SocketFamily family, SocketType type, SocketProtocol protocol,
const Glib::RefPtr<Cancellable>& cancellable);
Socket(int fd, const Glib::RefPtr<Cancellable>& cancellable);
* @throw Glib::Error
*/
static Glib::RefPtr<Socket>
- create(SocketFamily family, Type type, Protocol protocol,
+ create(SocketFamily family, SocketType type, SocketProtocol protocol,
const Glib::RefPtr<Cancellable>& cancellable = Glib::RefPtr<Cancellable>());
// gmmproc thinks that this function should be wrapped in this class because
_WRAP_METHOD(int get_fd() const, g_socket_get_fd)
_WRAP_METHOD(Glib::RefPtr<SocketAddress> get_local_address() const, g_socket_get_local_address, errthrow)
_WRAP_METHOD(Glib::RefPtr<SocketAddress> get_remote_address() const, g_socket_get_remote_address, errthrow)
- _WRAP_METHOD(Protocol get_protocol() const, g_socket_get_protocol)
- _WRAP_METHOD(Type get_socket_type() const, g_socket_get_socket_type)
+ _WRAP_METHOD(SocketProtocol get_protocol() const, g_socket_get_protocol)
+ _WRAP_METHOD(SocketType get_socket_type() const, g_socket_get_socket_type)
_WRAP_METHOD(bool speaks_ipv4() const, g_socket_speaks_ipv4)
_WRAP_METHOD(Glib::RefPtr<Credentials> get_credentials(), g_socket_get_credentials, errthrow)
_WRAP_PROPERTY("local-address", Glib::RefPtr<SocketAddress>)
_WRAP_PROPERTY("remote-address", Glib::RefPtr<SocketAddress>)
_WRAP_PROPERTY("timeout", guint)
- _WRAP_PROPERTY("protocol", Protocol)
+ _WRAP_PROPERTY("protocol", SocketProtocol)
_WRAP_PROPERTY("broadcast", bool)
- _WRAP_PROPERTY("type", Type)
+ _WRAP_PROPERTY("type", SocketType)
_WRAP_PROPERTY("ttl", guint)
_WRAP_PROPERTY("multicast-loopback", bool)
_WRAP_PROPERTY("multicast-ttl", guint)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2010 Jonathon Jongsma
*
* This library is free software; you can redistribute it and/or
_WRAP_CREATE()
_WRAP_METHOD(SocketFamily get_family() const, g_socket_client_get_family)
_WRAP_METHOD(void set_family(SocketFamily family), g_socket_client_set_family)
- _WRAP_METHOD(Socket::Type get_socket_type() const, g_socket_client_get_socket_type)
- _WRAP_METHOD(void set_socket_type(Socket::Type type), g_socket_client_set_socket_type)
- _WRAP_METHOD(Socket::Protocol get_protocol() const, g_socket_client_get_protocol)
- _WRAP_METHOD(void set_protocol(Socket::Protocol protocol), g_socket_client_set_protocol)
+ _WRAP_METHOD(SocketType get_socket_type() const, g_socket_client_get_socket_type)
+ _WRAP_METHOD(void set_socket_type(SocketType type), g_socket_client_set_socket_type)
+ _WRAP_METHOD(SocketProtocol get_protocol() const, g_socket_client_get_protocol)
+ _WRAP_METHOD(void set_protocol(SocketProtocol protocol), g_socket_client_set_protocol)
_WRAP_METHOD(Glib::RefPtr<SocketAddress> get_local_address(), g_socket_client_get_local_address)
_WRAP_METHOD(Glib::RefPtr<const SocketAddress> get_local_address() const, g_socket_client_get_local_address, constversion)
_WRAP_METHOD(void set_local_address(const Glib::RefPtr<SocketAddress>& address), g_socket_client_set_local_address)
_WRAP_PROPERTY("family", SocketFamily)
_WRAP_PROPERTY("local-address", Glib::RefPtr<SocketAddress>)
- _WRAP_PROPERTY("protocol", Socket::Protocol)
- _WRAP_PROPERTY("type", Socket::Type)
+ _WRAP_PROPERTY("protocol", SocketProtocol)
+ _WRAP_PROPERTY("type", SocketType)
_WRAP_PROPERTY("timeout", guint)
_WRAP_PROPERTY("enable-proxy", bool)
_WRAP_PROPERTY("tls", bool)
#m4 _CONVERSION(`GSocketConnectable*',`const Glib::RefPtr<SocketConnectable>&',`Glib::wrap($3, true)')
#m4 _CONVERSION(`GIOStream*',`const Glib::RefPtr<IOStream>&',`Glib::wrap($3, true)')
- _WRAP_SIGNAL(void event(SocketClientEvent event, const Glib::RefPtr<SocketConnectable>& connectable, const Glib::RefPtr<IOStream>& connection), event)
+ _WRAP_SIGNAL(void event(SocketClientEvent event, const Glib::RefPtr<SocketConnectable>& connectable, const Glib::RefPtr<IOStream>& connection), event, no_default_handler)
};
} // namespace Gio
}
bool
-SocketListener::add_address(const Glib::RefPtr<SocketAddress>& address, Socket::Type type,
- Socket::Protocol protocol, const Glib::RefPtr<Glib::Object>& source_object,
+SocketListener::add_address(const Glib::RefPtr<SocketAddress>& address, SocketType type,
+ SocketProtocol protocol, const Glib::RefPtr<Glib::Object>& source_object,
Glib::RefPtr<SocketAddress>& effective_address)
{
GError* gerror = nullptr;
}
bool
-SocketListener::add_address(const Glib::RefPtr<SocketAddress>& address, Socket::Type type,
- Socket::Protocol protocol, Glib::RefPtr<SocketAddress>& effective_address)
+SocketListener::add_address(const Glib::RefPtr<SocketAddress>& address, SocketType type,
+ SocketProtocol protocol, Glib::RefPtr<SocketAddress>& effective_address)
{
GError* gerror = nullptr;
GSocketAddress* retaddr = nullptr;
bool add_socket(const Glib::RefPtr<Socket>& socket);
_WRAP_METHOD_DOCS_ONLY(g_socket_listener_add_address)
-bool add_address(const Glib::RefPtr<SocketAddress>& address, Socket::Type type, Socket::Protocol protocol, const Glib::RefPtr<Glib::Object>& source_object, Glib::RefPtr<SocketAddress>& effective_address);
+bool add_address(const Glib::RefPtr<SocketAddress>& address, SocketType type, SocketProtocol protocol, const Glib::RefPtr<Glib::Object>& source_object, Glib::RefPtr<SocketAddress>& effective_address);
_IGNORE(g_socket_listener_add_address)
_WRAP_METHOD_DOCS_ONLY(g_socket_listener_add_address)
- bool add_address(const Glib::RefPtr<SocketAddress>& address, Socket::Type type, Socket::Protocol protocol, Glib::RefPtr<SocketAddress>& effective_address);
+ bool add_address(const Glib::RefPtr<SocketAddress>& address, SocketType type, SocketProtocol protocol, Glib::RefPtr<SocketAddress>& effective_address);
_WRAP_METHOD(bool add_inet_port(guint16 port, const Glib::RefPtr<Glib::Object>& source_object), g_socket_listener_add_inet_port, errthrow)
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <glibmm/value.h>
+#include <glibmm/listhandle.h>
+
+// unfortunately we need to include the C header for the type traits
+// implementation
+#include <gio/gio.h>
_DEFS(giomm,gio)
};
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+struct SrvTargetListTraits
+{
+ using CppType = Gio::SrvTarget;
+ using CType = const GSrvTarget*;
+ using CTypeNonConst = GSrvTarget*;
+
+ static CType to_c_type(const CppType& item) { return item.gobj(); }
+ static CType to_c_type(CType ptr) { return ptr; }
+ static CppType to_cpp_type(CType item) { return CppType(const_cast<CTypeNonConst>(item), true /* take_copy */); }
+ static void release_c_type(CType item) { g_srv_target_free(const_cast<CTypeNonConst>(item)); }
+};
+
+#endif // DOXYGEN_SHOULD_SKIP_THIS
+
+using ListHandle_SrvTarget = Glib::ListHandle<Gio::SrvTarget, SrvTargetListTraits>;
} // namespace Gio
{
}
+ThemedIcon::ThemedIcon(const std::vector<Glib::ustring>& iconnames)
+: _CONSTRUCT("names", Glib::ArrayHandler<Glib::ustring>::vector_to_array(iconnames).data())
+{
+}
+
} // namespace Gio
_IMPLEMENTS_INTERFACE(Icon)
protected:
+ //TODO: When we can break ABI, change the type of icon names to Glib::ustring
+ // in methods where it is std::string. Gtkmm consistently uses Glib::ustring
+ // for icon names, but Gio::ThemedIcon is inconsistent.
+
/** Creates a new themed icon for @a iconname, and optionally all the names that can be created by shortening @a iconname at '-' characters.
*
* @param iconname A string containing an icon name.
explicit ThemedIcon(const std::string& iconname, bool use_default_fallbacks = false);
_IGNORE(g_themed_icon_new, g_themed_icon_new_with_default_fallbacks)
+ /** Creates a new themed icon for @a iconnames.
+ *
+ * @param iconnames A vector of strings containing icon names.
+ *
+ * @newin{2,60}
+ */
+ explicit ThemedIcon(const std::vector<Glib::ustring>& iconnames);
+ _IGNORE(g_themed_icon_new_from_names)
+
public:
/** Creates a new themed icon for @a iconname, and optionally all the names that can be created by shortening @a iconname at '-' characters.
*
*/
_WRAP_CREATE(const std::string& iconname, bool use_default_fallbacks = false)
- //TODO: GIcon *g_themed_icon_new_from_names (char **iconnames, int len);
+ /** Creates a new themed icon for @a iconnames.
+ *
+ * @param iconnames A vector of strings containing icon names.
+ *
+ * @newin{2,60}
+ */
+ _WRAP_CREATE(const std::vector<Glib::ustring>& iconnames)
_WRAP_METHOD(void prepend_name(const std::string& iconname), g_themed_icon_prepend_name)
_WRAP_METHOD(void append_name(const std::string& iconname), g_themed_icon_append_name)
- #m4 _CONVERSION(`const gchar* const*',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> get_names() const, g_themed_icon_get_names)
+ #m4 _CONVERSION(`const gchar* const*',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle get_names() const, g_themed_icon_get_names)
//There are no signals.
Glib::RefPtr<TlsCertificate>
TlsCertificate::create_from_pem(const std::string& data, gssize length)
{
- return Glib::make_refptr_for_instance<TlsCertificate>(new TlsCertificate(data, length));
+ return Glib::RefPtr<TlsCertificate>(new TlsCertificate(data, length));
}
} // namesapce Gio
class SocketConnectable;
-// It's unusual that a subclass of Glib::Object is a base class of an interface.
-// For a discussion, see https://bugzilla.gnome.org/show_bug.cgi?id=776537
-// especially the last paragraph of comment 6.
-
/** TlsClientConnection - TLS client-side connection.
* TlsClientConnection is the client-side subclass of TlsConnection,
* representing a client-side TLS connection.
_CUSTOM_CTOR_CAST
public:
- // It's not possible to use _WRAP_CTOR/_WRAP_CREATE to wrap the new
- // function because this is an interface.
+ //TODO: It's not possible to use _WRAP_CTOR/_WRAP_CREATE to wrap the new
+ //function because this is an interface.
#m4 _CONVERSION(`GIOStream*',`Glib::RefPtr<TlsClientConnection>',`Glib::wrap(G_TLS_CLIENT_CONNECTION($3))')
_WRAP_METHOD(static Glib::RefPtr<TlsClientConnection> create(const Glib::RefPtr<IOStream>& base_io_stream, const Glib::RefPtr<const SocketConnectable>& server_identity{?}), g_tls_client_connection_new, errthrow)
_WRAP_METHOD(void set_validation_flags(TlsCertificateFlags flags), g_tls_client_connection_set_validation_flags)
_WRAP_METHOD(TlsCertificateFlags get_validation_flags() const, g_tls_client_connection_get_validation_flags)
- _IGNORE(g_tls_client_connection_set_use_ssl3, g_tls_client_connection_get_use_ssl3) dnl// deprecated
+ _WRAP_METHOD(void set_use_ssl3(bool use_ssl3 = true), g_tls_client_connection_set_use_ssl3,
+ deprecated "SSL 3.0 is insecure, and this function does not generally enable or disable it, despite its name.")
+ _WRAP_METHOD(bool get_use_ssl3() const, g_tls_client_connection_get_use_ssl3,
+ deprecated "SSL 3.0 is insecure, and this function does not actually indicate whether it is enabled.")
#m4 _CONVERSION(`GList*',`std::vector< Glib::RefPtr<Glib::ByteArray> >',`Glib::ListHandler< Glib::RefPtr<Glib::ByteArray> >::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
_WRAP_METHOD(std::vector< Glib::RefPtr<Glib::ByteArray> > get_accepted_cas(), g_tls_client_connection_get_accepted_cas)
_WRAP_METHOD(void copy_session_state(const Glib::RefPtr<TlsClientConnection>& source), g_tls_client_connection_copy_session_state)
- _WRAP_PROPERTY("accepted-cas", std::vector< Glib::RefPtr<Glib::ByteArray> >)
+ // property_accepted_cas() won't work unless a Glib::Value<std::vector<Glib::RefPtr<Glib::ByteArray>>>
+ // specialization is added. Workaround: Use get_accepted_cas().
+ _WRAP_PROPERTY("accepted-cas", std::vector< Glib::RefPtr<Glib::ByteArray> >,
+ deprecated "property_accepted_cas() does not work. Use get_accepted_cas() instead.")
_WRAP_PROPERTY("server-identity", Glib::RefPtr<SocketConnectable>)
+ _WRAP_PROPERTY("use-ssl3", bool, deprecated "SSL 3.0 is insecure, and this property does not generally enable or disable it, despite its name.")
_WRAP_PROPERTY("validation-flags", TlsCertificateFlags)
- _IGNORE_PROPERTY(use-ssl3) dnl// deprecated
};
} // namespace Gio
_WRAP_METHOD(void set_require_close_notify(bool require_close_notify = true), g_tls_connection_set_require_close_notify)
_WRAP_METHOD(bool get_require_close_notify() const, g_tls_connection_get_require_close_notify)
- _WRAP_METHOD(void set_rehandshake_mode(TlsRehandshakeMode mode), g_tls_connection_set_rehandshake_mode)
- _WRAP_METHOD(TlsRehandshakeMode get_rehandshake_mode() const, g_tls_connection_get_rehandshake_mode)
+ _WRAP_METHOD(void set_rehandshake_mode(TlsRehandshakeMode mode), g_tls_connection_set_rehandshake_mode,
+ deprecated "Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3.")
+ _WRAP_METHOD(TlsRehandshakeMode get_rehandshake_mode() const, g_tls_connection_get_rehandshake_mode,
+ deprecated "Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3.")
- _IGNORE(g_tls_connection_set_use_system_certdb, g_tls_connection_get_use_system_certdb)
+ _WRAP_METHOD(void set_use_system_certdb(bool use_system_certdb = true), g_tls_connection_set_use_system_certdb,
+ deprecated "Use set_database() instead.")
+ _WRAP_METHOD(bool get_use_system_certdb() const, g_tls_connection_get_use_system_certdb,
+ deprecated "Use get_database() instead.")
_WRAP_METHOD(Glib::RefPtr<TlsDatabase> get_database(), g_tls_connection_get_database)
_WRAP_METHOD(Glib::RefPtr<const TlsDatabase> get_database() const, g_tls_connection_get_database, constversion)
_WRAP_PROPERTY("interaction", Glib::RefPtr<TlsInteraction>)
_WRAP_PROPERTY("peer-certificate", Glib::RefPtr<TlsCertificate>)
_WRAP_PROPERTY("peer-certificate-errors", TlsCertificateFlags)
- _WRAP_PROPERTY("rehandshake-mode", TlsRehandshakeMode)
+ _WRAP_PROPERTY("rehandshake-mode", TlsRehandshakeMode,
+ deprecated "Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3.")
_WRAP_PROPERTY("require-close-notify", bool)
- _IGNORE_PROPERTY("use-system-certdb")
+ _WRAP_PROPERTY("use-system-certdb", bool, deprecated "Use property_database() instead.")
#m4 _CONVERSION(`GTlsCertificate*',`const Glib::RefPtr<const TlsCertificate>&',`Glib::wrap($3, true)')
_WRAP_SIGNAL(bool accept_certificate(const Glib::RefPtr<const TlsCertificate>& peer_cert, TlsCertificateFlags errors), "accept_certificate")
#include <giomm/tlscertificate.h>
#include <giomm/tlsinteraction.h>
#include "slot_async.h"
-
-
-using VerifyFlags = Gio::TlsDatabase::VerifyFlags;
-using LookupFlags = Gio::TlsDatabase::LookupFlags;
namespace Gio
{
+_WRAP_ENUM(TlsDatabaseVerifyFlags, GTlsDatabaseVerifyFlags)
+_WRAP_ENUM(TlsDatabaseLookupFlags, GTlsDatabaseLookupFlags)
+
class Cancellable;
class SocketConnectable;
class TlsCertificate;
//TODO?: Have a constant for the C macro G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER (which is a string)?
//TODO?: Have a constant for the C macro G_TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT (which is a string)?
- _WRAP_ENUM(VerifyFlags, GTlsDatabaseVerifyFlags)
- _WRAP_ENUM(LookupFlags, GTlsDatabaseLookupFlags)
-
- _WRAP_METHOD(TlsCertificateFlags verify_chain(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity{?}, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, VerifyFlags flags{.} = VerifyFlags::NONE) const, g_tls_database_verify_chain, errthrow)
- _WRAP_METHOD(void verify_chain_async(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity{?}, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, VerifyFlags flags{.} = VerifyFlags::NONE) const, g_tls_database_verify_chain_async, slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_METHOD(TlsCertificateFlags verify_chain(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity{?}, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseVerifyFlags flags{.} = TLS_DATABASE_VERIFY_NONE) const, g_tls_database_verify_chain, errthrow)
+ _WRAP_METHOD(void verify_chain_async(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity{?}, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseVerifyFlags flags{.} = TLS_DATABASE_VERIFY_NONE) const, g_tls_database_verify_chain_async, slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_METHOD(TlsCertificateFlags verify_chain_finish(const Glib::RefPtr<AsyncResult>& result), g_tls_database_verify_chain_finish, errthrow)
- _WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificate_issuer, errthrow)
- _WRAP_METHOD(Glib::RefPtr<const TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE) const, g_tls_database_lookup_certificate_issuer, errthrow, constversion)
+ _WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificate_issuer, errthrow)
+ _WRAP_METHOD(Glib::RefPtr<const TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE) const, g_tls_database_lookup_certificate_issuer, errthrow, constversion)
- _WRAP_METHOD(void lookup_certificate_issuer_async(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificate_issuer_async, slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_METHOD(void lookup_certificate_issuer_async(const Glib::RefPtr<const TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificate_issuer_async, slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer_finish(const Glib::RefPtr<AsyncResult>& result), g_tls_database_lookup_certificate_issuer_finish, errthrow)
#m4 _CONVERSION(`GList*',`std::vector< Glib::RefPtr<TlsCertificate> >',`Glib::ListHandler< Glib::RefPtr<TlsCertificate> >::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificates_issued_by, errthrow)
+ _WRAP_METHOD(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = Gio::TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificates_issued_by, errthrow)
#m4 _CONVERSION(`GList*',`std::vector< Glib::RefPtr<const TlsCertificate> >',`Glib::ListHandler< Glib::RefPtr<const TlsCertificate> >::list_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector< Glib::RefPtr<const TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE) const, g_tls_database_lookup_certificates_issued_by, errthrow)
+ _WRAP_METHOD(std::vector< Glib::RefPtr<const TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = Gio::TLS_DATABASE_LOOKUP_NONE) const, g_tls_database_lookup_certificates_issued_by, errthrow)
- _WRAP_METHOD(void lookup_certificates_issued_by_async(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificates_issued_by_async, slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_METHOD(void lookup_certificates_issued_by_async(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = Gio::TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificates_issued_by_async, slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_METHOD(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by_finish(const Glib::RefPtr<AsyncResult>& result), g_tls_database_lookup_certificates_issued_by_finish, errthrow)
_WRAP_METHOD(Glib::ustring create_certificate_handle(const Glib::RefPtr<const TlsCertificate>& certificate) const, g_tls_database_create_certificate_handle)
- _WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificate_for_handle, errthrow)
- _WRAP_METHOD(Glib::RefPtr<const TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE) const, g_tls_database_lookup_certificate_for_handle, errthrow, constversion)
+ _WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificate_for_handle, errthrow)
+ _WRAP_METHOD(Glib::RefPtr<const TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE) const, g_tls_database_lookup_certificate_for_handle, errthrow, constversion)
- _WRAP_METHOD(void lookup_certificate_for_handle_async(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.} = LookupFlags::NONE), g_tls_database_lookup_certificate_for_handle_async, slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_METHOD(void lookup_certificate_for_handle_async(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction{?}, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.} = TLS_DATABASE_LOOKUP_NONE), g_tls_database_lookup_certificate_for_handle_async, slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_METHOD(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle_finish(const Glib::RefPtr<AsyncResult>& result), g_tls_database_lookup_certificate_for_handle_finish, errthrow)
#m4 _CONVERSION(`GTlsCertificate*',`const Glib::RefPtr<TlsCertificate>&',`Glib::wrap($3, true)')
#m4 _CONVERSION(`GSocketConnectable*',`const Glib::RefPtr<const SocketConnectable>&',`Glib::wrap($3, true)')
#m4 _CONVERSION(`GTlsInteraction*',`const Glib::RefPtr<TlsInteraction>&',`Glib::wrap($3, true)')
- _WRAP_VFUNC(TlsCertificateFlags verify_chain(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, VerifyFlags flags{.}) const, "verify_chain", errthrow)
- _WRAP_VFUNC(void verify_chain_async(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, VerifyFlags flags{.}) const, "verify_chain_async", slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_VFUNC(TlsCertificateFlags verify_chain(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseVerifyFlags flags{.}) const, "verify_chain", errthrow)
+ _WRAP_VFUNC(void verify_chain_async(const Glib::RefPtr<TlsCertificate>& chain, const Glib::ustring& purpose, const Glib::RefPtr<const SocketConnectable>& identity, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseVerifyFlags flags{.}) const, "verify_chain_async", slot_name slot, slot_callback SignalProxy_async_callback)
#m4 _CONVERSION(`GAsyncResult*',`const Glib::RefPtr<AsyncResult>&',`Glib::wrap($3, true)')
_WRAP_VFUNC(TlsCertificateFlags verify_chain_finish(const Glib::RefPtr<AsyncResult>& result), "verify_chain_finish", errthrow)
dnl// create_certificate_handle_vfunc() shall return a newly allocated string.
-dnl// Also, ensure that create_certificate_handle_vfunc() never returns an empty char[],
-dnl// because that could be caused by an intermediate empty ustring from an initial null char*.
#m4 _CONVERSION(`GTlsCertificate*',`const Glib::RefPtr<const TlsCertificate>&',`Glib::wrap($3, true)')
-#m4 _CONVERSION(`Glib::ustring',`gchar*',`g_strdup(Glib::c_str_or_nullptr($3))')
#m4 _CONVERSION(`gchar*',`Glib::ustring',`Glib::convert_return_gchar_ptr_to_ustring($3)')
_WRAP_VFUNC(Glib::ustring create_certificate_handle(const Glib::RefPtr<const TlsCertificate>& certificate) const, "create_certificate_handle")
#m4 _CONVERSION(`Glib::RefPtr<TlsCertificate>',`GTlsCertificate*',`G_TLS_CERTIFICATE(g_object_ref(Glib::unwrap($3)))')
- _WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificate_for_handle", errthrow)
- _WRAP_VFUNC(void lookup_certificate_for_handle_async(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificate_for_handle_async", slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificate_for_handle", errthrow)
+ _WRAP_VFUNC(void lookup_certificate_for_handle_async(const Glib::ustring& handle, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificate_for_handle_async", slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_for_handle_finish(const Glib::RefPtr<AsyncResult>& result), "lookup_certificate_for_handle_finish", errthrow)
- _WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificate_issuer", errthrow)
- _WRAP_VFUNC(void lookup_certificate_issuer_async(const Glib::RefPtr<TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificate_issuer_async", slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer(const Glib::RefPtr<TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificate_issuer", errthrow)
+ _WRAP_VFUNC(void lookup_certificate_issuer_async(const Glib::RefPtr<TlsCertificate>& certificate, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificate_issuer_async", slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_VFUNC(Glib::RefPtr<TlsCertificate> lookup_certificate_issuer_finish(const Glib::RefPtr<AsyncResult>& result), "lookup_certificate_issuer_finish", errthrow)
#m4 _CONVERSION(`std::vector< Glib::RefPtr<TlsCertificate> >',`GList*',`g_list_copy(Glib::ListHandler< Glib::RefPtr<TlsCertificate> >::vector_to_list($3).data())')
#m4 _CONVERSION(`GByteArray*',`const Glib::RefPtr<Glib::ByteArray>&',`Glib::wrap($3, true)')
- _WRAP_VFUNC(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificates_issued_by", errthrow)
- _WRAP_VFUNC(void lookup_certificates_issued_by_async(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, LookupFlags flags{.}), "lookup_certificates_issued_by_async", slot_name slot, slot_callback SignalProxy_async_callback)
+ _WRAP_VFUNC(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificates_issued_by", errthrow)
+ _WRAP_VFUNC(void lookup_certificates_issued_by_async(const Glib::RefPtr<Glib::ByteArray>& issuer_raw_dn, const Glib::RefPtr<TlsInteraction>& interaction, const SlotAsyncReady& slot{callback}, const Glib::RefPtr<Cancellable>& cancellable{.?}, TlsDatabaseLookupFlags flags{.}), "lookup_certificates_issued_by_async", slot_name slot, slot_callback SignalProxy_async_callback)
_WRAP_VFUNC(std::vector< Glib::RefPtr<TlsCertificate> > lookup_certificates_issued_by_finish(const Glib::RefPtr<AsyncResult>& result), "lookup_certificates_issued_by_finish", errthrow)
};
namespace Gio
{
-// It's unusual that a subclass of Glib::Object is a base class of an interface.
-// For a discussion, see https://bugzilla.gnome.org/show_bug.cgi?id=776537
-// especially the last paragraph of comment 6.
/** TlsFileDatabase - TLS file based database type.
* TlsFileDatabase is implemented by TlsDatabase objects which load their
_CLASS_INTERFACE(TlsFileDatabase, GTlsFileDatabase, G_TLS_FILE_DATABASE, GTlsFileDatabaseInterface)
public:
- // It's not possible to use _WRAP_CTOR/_WRAP_CREATE to wrap the new
- // function because this is an interface.
+ //TODO: It is not possible to use _WRAP_CTOR()/WRAP_CREATE() here because this
+ //class is an interface.
+ // So, should we make it possible to use them? murrayc.
#m4 _CONVERSION(`GTlsDatabase*',`Glib::RefPtr<TlsFileDatabase>',`Glib::wrap(G_TLS_FILE_DATABASE($3))')
_WRAP_METHOD(static Glib::RefPtr<TlsFileDatabase> create(const std::string& anchors), g_tls_file_database_new, errthrow)
*/
#include <gio/gio.h>
-
-using Flags = Gio::TlsPassword::Flags;
namespace Gio
{
+_WRAP_ENUM(TlsPasswordFlags, GTlsPasswordFlags)
/** TlsPassword - TLS Passwords for prompting.
* Holds a password used in TLS.
{
_CLASS_GOBJECT(TlsPassword, GTlsPassword, G_TLS_PASSWORD, Glib::Object, GObject)
-public:
- _WRAP_ENUM(Flags, GTlsPasswordFlags)
-
protected:
- _WRAP_CTOR(TlsPassword(const Glib::ustring& description{.}, Flags flags{.} = Flags::NONE), g_tls_password_new)
+ _WRAP_CTOR(TlsPassword(const Glib::ustring& description{.}, TlsPasswordFlags flags{.} = Gio::TLS_PASSWORD_NONE), g_tls_password_new)
public:
_WRAP_METHOD_DOCS_ONLY(g_tls_password_new)
- _WRAP_CREATE(const Glib::ustring& description{.}, Flags flags{.} = Flags::NONE)
+ _WRAP_CREATE(const Glib::ustring& description{.}, TlsPasswordFlags flags{.} = Gio::TLS_PASSWORD_NONE)
_WRAP_METHOD(const guchar* get_value(gsize& length{?}) const, g_tls_password_get_value)
_WRAP_METHOD(Glib::ustring get_description() const, g_tls_password_get_description)
_WRAP_METHOD(void set_description(const Glib::ustring& description), g_tls_password_set_description)
- _WRAP_METHOD(Flags get_flags() const, g_tls_password_get_flags)
- _WRAP_METHOD(void set_flags(Flags flags), g_tls_password_set_flags)
+ _WRAP_METHOD(TlsPasswordFlags get_flags() const, g_tls_password_get_flags)
+ _WRAP_METHOD(void set_flags(TlsPasswordFlags flags), g_tls_password_set_flags)
_WRAP_METHOD(Glib::ustring get_warning() const, g_tls_password_get_warning)
_WRAP_METHOD(void set_warning(const Glib::ustring& warning), g_tls_password_set_warning)
_WRAP_PROPERTY("description", Glib::ustring)
- _WRAP_PROPERTY("flags", Flags)
+ _WRAP_PROPERTY("flags", TlsPasswordFlags)
_WRAP_PROPERTY("warning", Glib::ustring)
#m4 _CONVERSION(`gsize*', `gsize&', `*($3)')
namespace Gio
{
-// It's unusual that a subclass of Glib::Object is a base class of an interface.
-// For a discussion, see https://bugzilla.gnome.org/show_bug.cgi?id=776537
-// especially the last paragraph of comment 6.
/** TlsServerConnection - TLS server-side connection.
* TlsServerConnection is the server-side subclass of TlsConnection,
_CUSTOM_CTOR_CAST
public:
- // It's not possible to use _WRAP_CTOR/_WRAP_CREATE to wrap the new
- // function because this is an interface.
+ //TODO: It's not possible to use _WRAP_CTOR/_WRAP_CREATE to wrap the new
+ //function because this is an interface.
#m4 _CONVERSION(`GIOStream*',`Glib::RefPtr<TlsServerConnection>',`Glib::wrap(G_TLS_SERVER_CONNECTION($3))')
_WRAP_METHOD(static Glib::RefPtr<IOStream> create(const Glib::RefPtr<IOStream>& base_io_stream, const Glib::RefPtr<TlsCertificate>& certificate), g_tls_server_connection_new, errthrow)
namespace Gio
{
-UnixFDList::UnixFDList(const std::vector<int>& fds)
+UnixFDList::UnixFDList(const Glib::ArrayHandle<int>& fds)
: // Mark this class as non-derived to allow C++ vfuncs to be skipped.
Glib::ObjectBase(nullptr),
// g_unix_fd_list_new_from_array() must be called.
// _CONSTRUCT() + g_unit_fd_list_append() is not an alternative.
// g_unit_fd_list_append() duplicates the file descriptor,
// but g_unix_fd_list_new_from_array() does not.
- Glib::Object((GObject*)g_unix_fd_list_new_from_array(Glib::ArrayHandler<int>::vector_to_array(fds).data(), fds.size()))
+ Glib::Object((GObject*)g_unix_fd_list_new_from_array(fds.data(), fds.size()))
{
}
-UnixFDList::UnixFDList(const std::vector<int>& fds, int n_fds)
+UnixFDList::UnixFDList(const Glib::ArrayHandle<int>& fds, int n_fds)
: // Mark this class as non-derived to allow C++ vfuncs to be skipped.
Glib::ObjectBase(nullptr),
// g_unix_fd_list_new_from_array() must be called.
// _CONSTRUCT() + g_unit_fd_list_append() is not an alternative.
// g_unit_fd_list_append() duplicates the file descriptor,
// but g_unix_fd_list_new_from_array() does not.
- Glib::Object((GObject*)g_unix_fd_list_new_from_array(Glib::ArrayHandler<int>::vector_to_array(fds).data(), n_fds))
+ Glib::Object((GObject*)g_unix_fd_list_new_from_array(fds.data(), n_fds))
{
}
-const std::vector<int>
+const Glib::ArrayHandle<int>
UnixFDList::peek_fds() const
{
int length = 0;
const auto fds = g_unix_fd_list_peek_fds(const_cast<GUnixFDList*>(gobj()), &length);
// The array is terminated with a -1, but that terminating element is
// not included in the length that g_unix_fd_list_peek_fds() returns.
- return Glib::ArrayHandler<int>::array_to_vector(fds, length, Glib::OWNERSHIP_NONE);
+ return Glib::ArrayHandle<int>(fds, length, Glib::OWNERSHIP_NONE);
}
-std::vector<int>
+Glib::ArrayHandle<int>
UnixFDList::steal_fds()
{
int length = 0;
const auto fds = g_unix_fd_list_steal_fds(gobj(), &length);
// The array is terminated with a -1, but that terminating element is
// not included in the length that g_unix_fd_list_steal_fds() returns.
- return Glib::ArrayHandler<int>::array_to_vector(fds, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<int>(fds, length, Glib::OWNERSHIP_DEEP);
}
} // namespace Gio
*/
#include <glibmm/object.h>
+#include <glibmm/arrayhandle.h>
_DEFS(giomm,gio)
_PINCLUDE(glibmm/private/object_p.h)
_CTOR_DEFAULT
_IGNORE(g_unix_fd_list_new)
- explicit UnixFDList(const std::vector<int>& fds);
+ explicit UnixFDList(const Glib::ArrayHandle<int>& fds);
- explicit UnixFDList(const std::vector<int>& fds, int n_fds);
+ explicit UnixFDList(const Glib::ArrayHandle<int>& fds, int n_fds);
_IGNORE(g_unix_fd_list_new_from_array)
public:
* @param fds The list of file descriptors to use for creation.
* @return A new UnixFDList.
*/
- _WRAP_CREATE(const std::vector<int>& fds)
+ _WRAP_CREATE(const Glib::ArrayHandle<int>& fds)
_WRAP_METHOD_DOCS_ONLY(g_unix_fd_list_new_from_array)
- _WRAP_CREATE(const std::vector<int>& fds, int n_fds)
+ _WRAP_CREATE(const Glib::ArrayHandle<int>& fds, int n_fds)
_WRAP_METHOD(int get_length() const, g_unix_fd_list_get_length)
- _WRAP_METHOD(int get(int index) const, g_unix_fd_list_get, errthrow "Gio::Error")
+ _WRAP_METHOD(int get(int index) const, g_unix_fd_list_get, errthrow)
/** Returns the array of file descriptors that is contained in this object.
*
*
* @newin{2,28}
*/
- const std::vector<int> peek_fds() const;
+ const Glib::ArrayHandle<int> peek_fds() const;
_IGNORE(g_unix_fd_list_peek_fds)
/** Returns the array of file descriptors that is contained in this object.
*
* @newin{2,28}
*/
- std::vector<int> steal_fds();
+ Glib::ArrayHandle<int> steal_fds();
_IGNORE(g_unix_fd_list_steal_fds)
_WRAP_METHOD_DOCS_ONLY(g_unix_fd_list_append)
///@throw Glib::Error.
- _WRAP_METHOD(int append(int fd), g_unix_fd_list_append, errthrow "Gio::Error")
+ _WRAP_METHOD(int append(int fd), g_unix_fd_list_append, errthrow)
};
} // namespace Gio
namespace Gio
{
-std::vector<int>
+Glib::ArrayHandle<int>
UnixFDMessage::steal_fds()
{
int length = 0;
const auto fds = g_unix_fd_message_steal_fds(gobj(), &length);
// The array is terminated with a -1, but that terminating element is
// not included in the length that g_unix_fd_message_steal_fds() returns.
- return Glib::ArrayHandler<int>::array_to_vector(fds, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<int>(fds, length, Glib::OWNERSHIP_DEEP);
}
} // namespace Gio
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmm/arrayhandle.h>
#include <giomm/socketcontrolmessage.h>
_DEFS(giomm,gio)
_WRAP_METHOD(Glib::RefPtr<UnixFDList> get_fd_list(), g_unix_fd_message_get_fd_list, refreturn)
_WRAP_METHOD(Glib::RefPtr<const UnixFDList> get_fd_list() const, g_unix_fd_message_get_fd_list, refreturn, constversion)
- _WRAP_METHOD(bool append_fd(int fd), g_unix_fd_message_append_fd, errthrow "Gio::Error")
+ _WRAP_METHOD(bool append_fd(int fd), g_unix_fd_message_append_fd, errthrow)
/** Returns the array of file descriptors that is contained in this object.
*
*
* @newin{2,28}
*/
- std::vector<int> steal_fds();
+ Glib::ArrayHandle<int> steal_fds();
_IGNORE(g_unix_fd_message_steal_fds)
_WRAP_PROPERTY("fd-list", Glib::RefPtr<UnixFDList>)
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
*/
#include <giomm/inputstream.h>
-#include <giomm/pollableinputstream.h>
-#include <giomm/filedescriptorbased.h>
_DEFS(giomm,gio)
_PINCLUDE(giomm/private/inputstream_p.h)
*
* @newin{2,16}
*/
-class UnixInputStream
-: public Gio::InputStream, public PollableInputStream, public FileDescriptorBased
+class UnixInputStream : public Gio::InputStream
{
_CLASS_GOBJECT(UnixInputStream, GUnixInputStream, G_UNIX_INPUT_STREAM, Gio::InputStream, GInputStream)
- _IMPLEMENTS_INTERFACE(PollableInputStream)
- _IMPLEMENTS_INTERFACE(FileDescriptorBased)
_GTKMMPROC_WIN32_NO_WRAP
protected:
+// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+
/* Copyright (C) 2007 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
*/
#include <giomm/outputstream.h>
-#include <giomm/pollableoutputstream.h>
-#include <giomm/filedescriptorbased.h>
_DEFS(giomm,gio)
_PINCLUDE(giomm/private/outputstream_p.h)
*
* @newin{2,16}
*/
-class UnixOutputStream
-: public Gio::OutputStream, public PollableOutputStream, public FileDescriptorBased
+class UnixOutputStream : public Gio::OutputStream
{
_CLASS_GOBJECT(UnixOutputStream, GUnixOutputStream, G_UNIX_OUTPUT_STREAM, Gio::OutputStream, GOutputStream)
- _IMPLEMENTS_INTERFACE(PollableOutputStream)
- _IMPLEMENTS_INTERFACE(FileDescriptorBased)
_GTKMMPROC_WIN32_NO_WRAP
protected:
#include <gio/gunixsocketaddress.h>
-using Type = Gio::UnixSocketAddress::Type;
-
namespace Gio
{
Glib::RefPtr<UnixSocketAddress>
-UnixSocketAddress::create(const std::string& path, Type type, int path_len)
+UnixSocketAddress::create(const std::string& path, UnixSocketAddressType type, int path_len)
{
return Glib::wrap(reinterpret_cast<GUnixSocketAddress*>(g_unix_socket_address_new_with_type(
path.c_str(), path_len, static_cast<GUnixSocketAddressType>(type))));
namespace Gio
{
+_WRAP_ENUM(UnixSocketAddressType, GUnixSocketAddressType)
+
class ByteArray;
/** UnixSocketAddress - UNIX SocketAddress.
_CLASS_GOBJECT(UnixSocketAddress, GUnixSocketAddress, G_UNIX_SOCKET_ADDRESS, SocketAddress, GSocketAddress)
_GTKMMPROC_WIN32_NO_WRAP
-public:
- _WRAP_ENUM(Type, GUnixSocketAddressType)
-
protected:
_WRAP_CTOR(UnixSocketAddress(const std::string& path), g_unix_socket_address_new)
//TODO: Possibly add when g_unix_socket_address_new_with_type() does not do
//more than call g_object_new() (maybe file a bug).
- //_WRAP_CTOR(UnixSocketAddress(const std::string& path, int path_len = -1, Type type = Type::PATH), g_unix_socket_address_new_with_type)
+ //_WRAP_CTOR(UnixSocketAddress(const std::string& path, int path_len = -1, UnixSocketAddressType type = Gio::UNIX_SOCKET_ADDRESS_PATH), g_unix_socket_address_new_with_type)
public:
_WRAP_METHOD_DOCS_ONLY(g_unix_socket_address_new)
//TODO: Add when the above constructor is included, removing the handwritten
//create() method for it below.
//_WRAP_METHOD_DOCS_ONLY(g_unix_socket_address_new_with_type)
- //_WRAP_CREATE(const std::string& path, int path_len = -1, Type type = Type::PATH)
+ //_WRAP_CREATE(const std::string& path, int path_len = -1, UnixSocketAddressType type = Gio::UNIX_SOCKET_ADDRESS_PATH)
_WRAP_METHOD_DOCS_ONLY(g_unix_socket_address_new_with_type)
static Glib::RefPtr<UnixSocketAddress> create(const std::string& path,
- Type type, int path_len = -1);
+ UnixSocketAddressType type, int path_len = -1);
// Deprecated.
_IGNORE(g_unix_socket_address_get_is_abstract)
- _WRAP_METHOD(Type get_address_type() const, g_unix_socket_address_get_address_type)
+ _WRAP_METHOD(UnixSocketAddressType get_address_type() const, g_unix_socket_address_get_address_type)
_WRAP_METHOD(std::string get_path() const, g_unix_socket_address_get_path)
_IGNORE(g_unix_socket_address_get_path_len)
_WRAP_METHOD(static bool abstract_names_supported(), g_unix_socket_address_abstract_names_supported)
- _IGNORE_PROPERTY("abstract")
- _WRAP_PROPERTY("address-type", Type)
+ _WRAP_PROPERTY("abstract", bool, deprecated "Use property_address_type() instead, which distinguishes between zero-padded and non-zero-padded abstract addresses.")
+ _WRAP_PROPERTY("address-type", UnixSocketAddressType)
_WRAP_PROPERTY("path", std::string)
_WRAP_PROPERTY("path-as-array", Glib::RefPtr<ByteArray>)
};
void
Volume::mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Volume::mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- Mount::MountFlags flags)
+ MountMountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Volume::mount(const Glib::RefPtr<MountOperation>& mount_operation, Mount::MountFlags flags)
+Volume::mount(const Glib::RefPtr<MountOperation>& mount_operation, MountMountFlags flags)
{
g_volume_mount(gobj(), static_cast<GMountMountFlags>(flags), Glib::unwrap(mount_operation),
nullptr, // cancellable
}
void
-Volume::mount(Mount::MountFlags flags)
+Volume::mount(MountMountFlags flags)
{
g_volume_mount(gobj(), static_cast<GMountMountFlags>(flags), nullptr,
nullptr, // cancellable
void
Volume::eject(
- const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Volume::eject(const SlotAsyncReady& slot, Mount::UnmountFlags flags)
+Volume::eject(const SlotAsyncReady& slot, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Volume::eject(Mount::UnmountFlags flags)
+Volume::eject(MountUnmountFlags flags)
{
g_volume_eject_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
nullptr, // mount_operation
void
Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags)
+ const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
void
Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot,
- Mount::UnmountFlags flags)
+ MountUnmountFlags flags)
{
// Create a copy of the slot.
// A pointer to it will be passed through the callback's data parameter
}
void
-Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags)
+Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags)
{
g_volume_eject_with_operation(gobj(), static_cast<GMountUnmountFlags>(flags),
Glib::unwrap(mount_operation),
* @param cancellable A cancellable object which can be used to cancel the operation.
* @param flags Flags affecting the operation.
*/
- void mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a volume.
* This is an asynchronous operation, and is finished by calling mount_finish() with the AsyncResult data returned in the callback slot.
* @param slot A callback which will be called when the operation is completed or canceled.
* @param flags Flags affecting the operation.
*/
- void mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a volume.
*
* @param mount_operation A mount operation.
* @param flags Flags affecting the operation.
*/
- void mount(const Glib::RefPtr<MountOperation>& mount_operation, Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount(const Glib::RefPtr<MountOperation>& mount_operation, MountMountFlags flags = MOUNT_MOUNT_NONE);
/** Mounts a volume.
*
* @param flags Flags affecting the operation.
*/
- void mount(Mount::MountFlags flags = Mount::MountFlags::NONE);
+ void mount(MountMountFlags flags = MOUNT_MOUNT_NONE);
_IGNORE(g_volume_mount)
g_volume_mount_finish,
errthrow)
- void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
- void eject(const Glib::RefPtr<MountOperation>& mount_operation, Mount::UnmountFlags flags = Mount::UnmountFlags::NONE);
+ void eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
+ void eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags = MOUNT_UNMOUNT_NONE);
_IGNORE(g_volume_eject)
_IGNORE(g_volume_eject_with_operation)
_WRAP_METHOD(std::string get_identifier(const std::string& kind) const,
g_volume_get_identifier)
- #m4 _CONVERSION(`char**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(std::vector<Glib::ustring> enumerate_identifiers() const,
+ #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
+ _WRAP_METHOD(Glib::StringArrayHandle enumerate_identifiers() const,
g_volume_enumerate_identifiers)
_WRAP_METHOD(Glib::RefPtr<File> get_activation_root(), g_volume_get_activation_root)
_WRAP_METHOD(static Glib::RefPtr<VolumeMonitor> get(), g_volume_monitor_get)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<Drive>>',`Glib::ListHandler<Glib::RefPtr<Drive>>::list_to_vector($3, Glib::OWNERSHIP_SHALLOW)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<Drive>> get_connected_drives(), g_volume_monitor_get_connected_drives)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<Drive> >',`$2($3, Glib::OWNERSHIP_SHALLOW)')
+ _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<Drive> > get_connected_drives(), g_volume_monitor_get_connected_drives)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<Volume>>',`Glib::ListHandler<Glib::RefPtr<Volume>>::list_to_vector($3, Glib::OWNERSHIP_SHALLOW)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<Volume>> get_volumes(), g_volume_monitor_get_volumes)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<Volume> >',`$2($3, Glib::OWNERSHIP_SHALLOW)')
+ _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<Volume> > get_volumes(), g_volume_monitor_get_volumes)
-#m4 _CONVERSION(`GList*',`std::vector<Glib::RefPtr<Mount>>',`Glib::ListHandler<Glib::RefPtr<Mount>>::list_to_vector($3, Glib::OWNERSHIP_SHALLOW)')
- _WRAP_METHOD(std::vector<Glib::RefPtr<Mount>> get_mounts(), g_volume_monitor_get_mounts)
+#m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<Mount> >',`$2($3, Glib::OWNERSHIP_SHALLOW)')
+ _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<Mount> > get_mounts(), g_volume_monitor_get_mounts)
_WRAP_METHOD(Glib::RefPtr<Volume> get_volume_for_uuid(const std::string& uuid), g_volume_monitor_get_volume_for_uuid, refreturn)
_WRAP_METHOD(Glib::RefPtr<Mount> get_mount_for_uuid(const std::string& uuid), g_volume_monitor_get_mount_for_uuid, refreturn)
- _IGNORE(g_volume_monitor_adopt_orphan_mount)
+ _WRAP_METHOD(static Glib::RefPtr<Volume> adopt_orphan_mount(const Glib::RefPtr<Mount>& mount), g_volume_monitor_adopt_orphan_mount,
+ deprecated "Instead of using this function, create shadow mounts with the URI of the mount you intend to adopt.")
#m4 _CONVERSION(`GVolume*',`const Glib::RefPtr<Volume>&',`Glib::wrap($3, true)')
_WRAP_SIGNAL(void volume_added(const Glib::RefPtr<Volume>& volume), volume_added)
_WRAP_SIGNAL(void drive_disconnected(const Glib::RefPtr<Drive>& drive), drive_disconnected)
_WRAP_SIGNAL(void drive_changed(const Glib::RefPtr<Drive>& drive), drive_changed)
- _WRAP_SIGNAL(void drive_eject_button(const Glib::RefPtr<Drive>& drive), drive_eject_button)
- _WRAP_SIGNAL(void drive_stop_button(const Glib::RefPtr<Drive>& drive), drive_stop_button)
+ //TODO: Remove no_default_handler when we can break ABI:
+ _WRAP_SIGNAL(void drive_eject_button(const Glib::RefPtr<Drive>& drive), drive_eject_button, no_default_handler)
+ _WRAP_SIGNAL(void drive_stop_button(const Glib::RefPtr<Drive>& drive), drive_stop_button, no_default_handler)
//TODO: Use ListHandle?
//_WRAP_VFUNC(GList* get_volumes(), get_volumes)
*
* If your source file is @c program.cc, you can compile it with:
* @code
- * g++ program.cc -o program `pkg-config --cflags --libs glibmm-2.60 giomm-2.60`
+ * g++ program.cc -o program `pkg-config --cflags --libs glibmm-2.4 giomm-2.4`
* @endcode
*
* Alternatively, if using autoconf, use the following in @c configure.ac:
* @code
- * PKG_CHECK_MODULES([GLIBMM], [glibmm-2.60 giomm-2.60])
+ * PKG_CHECK_MODULES([GLIBMM], [glibmm-2.4 giomm-2.4])
* @endcode
* Then use the generated @c GLIBMM_CFLAGS and @c GLIBMM_LIBS variables in the
* project Makefile.am files. For example:
//#include <glibmm/i18n.h> //This must be included by the application, after system headers such as
//<iostream>.
+// Include this first because we need it to be the first thing to include <glib.h>,
+// so we can do an undef trick to still use deprecated API in the header:
+#include <glibmm/thread.h>
+
+#include <glibmm/threads.h>
+
+#include <glibmm/arrayhandle.h>
#include <glibmm/balancedtree.h>
#include <glibmm/base64.h>
#ifndef GLIBMM_INCLUDED_FROM_WRAP_INIT_CC
#include <glibmm/exception.h>
#include <glibmm/exceptionhandler.h>
#include <glibmm/fileutils.h>
+#include <glibmm/helperlist.h>
#include <glibmm/interface.h>
#include <glibmm/iochannel.h>
#include <glibmm/init.h>
#include <glibmm/keyfile.h>
+#include <glibmm/streamiochannel.h>
+#include <glibmm/listhandle.h>
#include <glibmm/main.h>
#include <glibmm/markup.h>
#include <glibmm/miscutils.h>
#include <glibmm/shell.h>
#include <glibmm/signalproxy_connectionnode.h>
#include <glibmm/signalproxy.h>
+#include <glibmm/slisthandle.h>
#include <glibmm/spawn.h>
#include <glibmm/stringutils.h>
+#include <glibmm/threadpool.h>
#include <glibmm/timer.h>
#include <glibmm/timeval.h>
#include <glibmm/timezone.h>
#include <glibmm/uriutils.h>
#include <glibmm/ustring.h>
#include <glibmm/value.h>
+#include <glibmm/valuearray.h>
#include <glibmm/variant.h>
#include <glibmm/variantdict.h>
#include <glibmm/variantiter.h>
#include <glibmm/varianttype.h>
#include <glibmm/vectorutils.h>
+#include <glibmm/weakref.h>
#include <glibmm/wrap.h>
#endif /* _GLIBMM_H */
Description: C++ wrapper for GLib
Version: @PACKAGE_VERSION@
URL: http://www.gtkmm.org/
-Requires: gobject-2.0 sigc++-3.0
+Requires: gobject-2.0 sigc++-2.0
Libs: -L${libdir} -lglibmm-@GLIBMM_API_VERSION@
Cflags: -I${includedir}/@GLIBMM_MODULE_NAME@ -I${libdir}/@GLIBMM_MODULE_NAME@/include
--- /dev/null
+/* Copyright (C) 2011 The glibmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/arrayhandle.h>
+
+namespace Glib
+{
+
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::~ArrayHandle() noexcept
+{
+ if (parray_ && ownership_ != Glib::OWNERSHIP_NONE)
+ {
+ if (ownership_ != Glib::OWNERSHIP_SHALLOW)
+ {
+ // Deep ownership: release each container element.
+ const CType* const pend = parray_ + size_;
+ for (const CType* p = parray_; p != pend; ++p)
+ Tr::release_c_type(*p);
+ }
+ g_free(const_cast<CType*>(parray_));
+ }
+}
+
+} // namespace Glib
--- /dev/null
+#ifndef _GLIBMM_ARRAYHANDLE_H
+#define _GLIBMM_ARRAYHANDLE_H
+
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+#include <glibmm/containerhandle_shared.h>
+
+namespace Glib
+{
+
+namespace Container_Helpers
+{
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/* Count the number of elements in a 0-terminated sequence.
+ */
+template <class T>
+inline std::size_t
+compute_array_size(const T* array)
+{
+ const T* pend = array;
+
+ while (*pend)
+ ++pend;
+
+ return (pend - array);
+}
+
+/* Allocate and fill a 0-terminated array. The size argument
+ * specifies the number of elements in the input sequence.
+ */
+template <class For, class Tr>
+typename Tr::CType*
+create_array(For pbegin, std::size_t size, Tr)
+{
+ using CType = typename Tr::CType;
+
+ CType* const array = static_cast<CType*>(g_malloc((size + 1) * sizeof(CType)));
+ CType* const array_end = array + size;
+
+ for (CType* pdest = array; pdest != array_end; ++pdest)
+ {
+ // Use & to force a warning if the iterator returns a temporary object.
+ *pdest = Tr::to_c_type(*&*pbegin);
+ ++pbegin;
+ }
+
+ *array_end = CType();
+ return array;
+}
+
+template <class For>
+gboolean*
+create_bool_array(For pbegin, std::size_t size)
+{
+ gboolean* const array(static_cast<gboolean*>(g_malloc((size + 1) * sizeof(gboolean))));
+ gboolean* const array_end(array + size);
+
+ for (gboolean* pdest(array); pdest != array_end; ++pdest)
+ {
+ *pdest = *pbegin;
+ ++pbegin;
+ }
+
+ *array_end = false;
+ return array;
+}
+
+/* Convert from any container that supports forward
+ * iterators and has a size() method.
+ */
+template <class Tr, class Cont>
+struct ArraySourceTraits
+{
+ using CType = typename Tr::CType;
+
+ static std::size_t get_size(const Cont& cont) { return cont.size(); }
+
+ static const CType* get_data(const Cont& cont, std::size_t size)
+ {
+ return Glib::Container_Helpers::create_array(cont.begin(), size, Tr());
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+// source traits for bools.
+template <class Cont>
+struct BoolArraySourceTraits
+{
+ using CType = gboolean;
+
+ static std::size_t get_size(const Cont& cont) { return cont.size(); }
+
+ static const CType* get_data(const Cont& cont, std::size_t size)
+ {
+ return Glib::Container_Helpers::create_bool_array(cont.begin(), size);
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+/* Convert from a 0-terminated array. The Cont argument must be a pointer
+ * to the first element. Note that only arrays of the C type are supported.
+ */
+template <class Tr, class Cont>
+struct ArraySourceTraits<Tr, Cont*>
+{
+ using CType = typename Tr::CType;
+
+ static std::size_t get_size(const CType* array)
+ {
+ return (array) ? Glib::Container_Helpers::compute_array_size(array) : 0;
+ }
+
+ static const CType* get_data(const CType* array, std::size_t) { return array; }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_NONE;
+};
+
+template <class Tr, class Cont>
+struct ArraySourceTraits<Tr, const Cont*> : ArraySourceTraits<Tr, Cont*>
+{
+};
+
+/* Convert from a 0-terminated array. The Cont argument must be a pointer
+ * to the first element. Note that only arrays of the C type are supported.
+ * For consistency, the array must be 0-terminated, even though the array
+ * size is known at compile time.
+ */
+template <class Tr, class Cont, std::size_t N>
+struct ArraySourceTraits<Tr, Cont[N]>
+{
+ using CType = typename Tr::CType;
+
+ static std::size_t get_size(const CType*) { return (N - 1); }
+
+ static const CType* get_data(const CType* array, std::size_t) { return array; }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_NONE;
+};
+
+template <class Tr, class Cont, std::size_t N>
+struct ArraySourceTraits<Tr, const Cont[N]> : ArraySourceTraits<Tr, Cont[N]>
+{
+};
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+/**
+ * @ingroup ContHelpers
+ */
+template <class Tr>
+class ArrayHandleIterator
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using iterator_category = std::random_access_iterator_tag;
+ using value_type = CppType;
+ using difference_type = std::ptrdiff_t;
+ using reference = value_type;
+ using pointer = void;
+
+ explicit inline ArrayHandleIterator(const CType* pos);
+
+ inline value_type operator*() const;
+ inline value_type operator[](difference_type offset) const;
+
+ inline ArrayHandleIterator<Tr>& operator++();
+ inline const ArrayHandleIterator<Tr> operator++(int);
+ // these are needed by msvc 2005 when using deque.
+ inline ArrayHandleIterator<Tr>& operator--();
+ inline const ArrayHandleIterator<Tr> operator--(int);
+
+ // All this random access stuff is only there because STL algorithms
+ // usually have optimized specializations for random access iterators,
+ // and we don't want to give away efficiency for nothing.
+ //
+ inline ArrayHandleIterator<Tr>& operator+=(difference_type rhs);
+ inline ArrayHandleIterator<Tr>& operator-=(difference_type rhs);
+ inline const ArrayHandleIterator<Tr> operator+(difference_type rhs) const;
+ inline const ArrayHandleIterator<Tr> operator-(difference_type rhs) const;
+ inline difference_type operator-(const ArrayHandleIterator<Tr>& rhs) const;
+
+ inline bool operator==(const ArrayHandleIterator<Tr>& rhs) const;
+ inline bool operator!=(const ArrayHandleIterator<Tr>& rhs) const;
+ inline bool operator<(const ArrayHandleIterator<Tr>& rhs) const;
+ inline bool operator>(const ArrayHandleIterator<Tr>& rhs) const;
+ inline bool operator<=(const ArrayHandleIterator<Tr>& rhs) const;
+ inline bool operator>=(const ArrayHandleIterator<Tr>& rhs) const;
+
+private:
+ const CType* pos_;
+};
+
+} // namespace Container_Helpers
+
+// TODO: When we can break ABI, remove this and replace uses of it with std::vector.
+// We cannot deprecate it yet, because we cannot easily deprecate methods that use it
+//- for instance, we cannot just override methods that use it as a return type.
+
+/** This is an intermediate type. When a method takes this, or returns this, you
+ * should use a standard C++ container of your choice, such as std::list or
+ * std::vector.
+ *
+ * However, this is not used in new API. We now prefer to just use std::vector,
+ * which is less flexibile, but makes the API clearer.
+ *
+ * @ingroup ContHandles
+ */
+template <class T, class Tr = Glib::Container_Helpers::TypeTraits<T>>
+class ArrayHandle
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using value_type = CppType;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using const_iterator = Glib::Container_Helpers::ArrayHandleIterator<Tr>;
+ using iterator = Glib::Container_Helpers::ArrayHandleIterator<Tr>;
+
+ template <class Cont>
+ inline ArrayHandle(const Cont& container);
+
+ // Take over ownership of an array created by GTK+ functions.
+ inline ArrayHandle(const CType* array, std::size_t array_size, Glib::OwnershipType ownership);
+ inline ArrayHandle(const CType* array, Glib::OwnershipType ownership);
+
+ // Copying clears the ownership flag of the source handle.
+ inline ArrayHandle(const ArrayHandle<T, Tr>& other);
+
+ ~ArrayHandle() noexcept;
+
+ inline const_iterator begin() const;
+ inline const_iterator end() const;
+
+ template <class U>
+ inline operator std::vector<U>() const;
+ template <class U>
+ inline operator std::deque<U>() const;
+ template <class U>
+ inline operator std::list<U>() const;
+
+ template <class Cont>
+ inline void assign_to(Cont& container) const;
+
+ template <class Out>
+ inline void copy(Out pdest) const;
+
+ inline const CType* data() const;
+ inline std::size_t size() const;
+ inline bool empty() const;
+
+private:
+ std::size_t size_;
+ const CType* parray_;
+ mutable Glib::OwnershipType ownership_;
+
+ // No copy assignment.
+ ArrayHandle<T, Tr>& operator=(const ArrayHandle<T, Tr>&);
+};
+
+template <>
+class ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>
+{
+public:
+ using Me = ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>;
+ using Tr = Container_Helpers::TypeTraits<bool>;
+
+ using CppType = Tr::CppType;
+ using CType = Tr::CType;
+
+ using value_type = CppType;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using const_iterator = Glib::Container_Helpers::ArrayHandleIterator<Tr>;
+ using iterator = Glib::Container_Helpers::ArrayHandleIterator<Tr>;
+
+ template <class Cont>
+ inline ArrayHandle(const Cont& container);
+
+ // Take over ownership of an array created by GTK+ functions.
+ inline ArrayHandle(const CType* array, std::size_t array_size, Glib::OwnershipType ownership);
+ inline ArrayHandle(const CType* array, Glib::OwnershipType ownership);
+
+ // Copying clears the ownership flag of the source handle.
+ inline ArrayHandle(const Me& other);
+
+ ~ArrayHandle() noexcept;
+
+ inline const_iterator begin() const;
+ inline const_iterator end() const;
+
+ // this is inside class definition, so msvc 2005, 2008 and 2010 can compile this code.
+ template <class U>
+ inline operator std::vector<U>() const
+ {
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::vector<U>(this->begin(), this->end());
+#else
+ std::vector<U> temp;
+ temp.reserve(this->size());
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+ }
+
+ // this is inside class definition, so msvc 2005, 2008 and 2010 can compile this code.
+ template <class U>
+ inline operator std::deque<U>() const
+ {
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::deque<U>(this->begin(), this->end());
+#else
+ std::deque<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+ }
+
+ // this is inside class definition, so msvc 2005, 2008 and 2010 can compile this code.
+ template <class U>
+ inline operator std::list<U>() const
+ {
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::list<U>(this->begin(), this->end());
+#else
+ std::list<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+ }
+
+ template <class Cont>
+ inline void assign_to(Cont& container) const;
+
+ template <class Out>
+ inline void copy(Out pdest) const;
+
+ inline const CType* data() const;
+ inline std::size_t size() const;
+ inline bool empty() const;
+
+private:
+ std::size_t size_;
+ const CType* parray_;
+ mutable Glib::OwnershipType ownership_;
+
+ // No copy assignment.
+ Me& operator=(const Me&);
+};
+
+// TODO: Remove this when we can break glibmm API.
+/** If a method takes this as an argument, or has this as a return type, then you can use a standard
+ * container such as std::list<Glib::ustring> or std::vector<Glib::ustring>.
+ *
+ *
+ * However, this is not used in new API. We now prefer to just use std::vector,
+ * which is less flexibile, but makes the API clearer.
+ *
+ * @ingroup ContHandles
+ */
+using StringArrayHandle = ArrayHandle<Glib::ustring>;
+
+/***************************************************************************/
+/* Inline implementation */
+/***************************************************************************/
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+namespace Container_Helpers
+{
+
+/**** Glib::Container_Helpers::ArrayHandleIterator<> ***********************/
+
+template <class Tr>
+inline ArrayHandleIterator<Tr>::ArrayHandleIterator(const CType* pos) : pos_(pos)
+{
+}
+
+template <class Tr>
+inline typename ArrayHandleIterator<Tr>::value_type ArrayHandleIterator<Tr>::operator*() const
+{
+ return Tr::to_cpp_type(*pos_);
+}
+
+template <class Tr>
+inline typename ArrayHandleIterator<Tr>::value_type ArrayHandleIterator<Tr>::operator[](
+ difference_type offset) const
+{
+ return Tr::to_cpp_type(pos_[offset]);
+}
+
+template <class Tr>
+inline ArrayHandleIterator<Tr>& ArrayHandleIterator<Tr>::operator++()
+{
+ ++pos_;
+ return *this;
+}
+
+template <class Tr>
+inline const ArrayHandleIterator<Tr> ArrayHandleIterator<Tr>::operator++(int)
+{
+ return ArrayHandleIterator<Tr>(pos_++);
+}
+
+template <class Tr>
+inline ArrayHandleIterator<Tr>& ArrayHandleIterator<Tr>::operator--()
+{
+ --pos_;
+ return *this;
+}
+
+template <class Tr>
+inline const ArrayHandleIterator<Tr> ArrayHandleIterator<Tr>::operator--(int)
+{
+ return ArrayHandleIterator<Tr>(pos_--);
+}
+
+template <class Tr>
+inline ArrayHandleIterator<Tr>&
+ArrayHandleIterator<Tr>::operator+=(typename ArrayHandleIterator<Tr>::difference_type rhs)
+{
+ pos_ += rhs;
+ return *this;
+}
+
+template <class Tr>
+inline ArrayHandleIterator<Tr>&
+ArrayHandleIterator<Tr>::operator-=(typename ArrayHandleIterator<Tr>::difference_type rhs)
+{
+ pos_ -= rhs;
+ return *this;
+}
+
+template <class Tr>
+inline const ArrayHandleIterator<Tr>
+ArrayHandleIterator<Tr>::operator+(typename ArrayHandleIterator<Tr>::difference_type rhs) const
+{
+ return ArrayHandleIterator<Tr>(pos_ + rhs);
+}
+
+template <class Tr>
+inline const ArrayHandleIterator<Tr>
+ArrayHandleIterator<Tr>::operator-(typename ArrayHandleIterator<Tr>::difference_type rhs) const
+{
+ return ArrayHandleIterator<Tr>(pos_ - rhs);
+}
+
+template <class Tr>
+inline typename ArrayHandleIterator<Tr>::difference_type
+ArrayHandleIterator<Tr>::operator-(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ - rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator==(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ == rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator!=(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ != rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator<(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ < rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator>(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ > rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator<=(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ <= rhs.pos_);
+}
+
+template <class Tr>
+inline bool
+ArrayHandleIterator<Tr>::operator>=(const ArrayHandleIterator<Tr>& rhs) const
+{
+ return (pos_ >= rhs.pos_);
+}
+
+} // namespace Container_Helpers
+
+/**** Glib::ArrayHandle<> **************************************************/
+
+template <class T, class Tr>
+template <class Cont>
+inline ArrayHandle<T, Tr>::ArrayHandle(const Cont& container)
+: size_(Glib::Container_Helpers::ArraySourceTraits<Tr, Cont>::get_size(container)),
+ parray_(Glib::Container_Helpers::ArraySourceTraits<Tr, Cont>::get_data(container, size_)),
+ ownership_(Glib::Container_Helpers::ArraySourceTraits<Tr, Cont>::initial_ownership)
+{
+}
+
+template <class T, class Tr>
+inline ArrayHandle<T, Tr>::ArrayHandle(const typename ArrayHandle<T, Tr>::CType* array,
+ std::size_t array_size, Glib::OwnershipType ownership)
+: size_((array) ? array_size : 0), parray_(array), ownership_(ownership)
+{
+}
+
+template <class T, class Tr>
+inline ArrayHandle<T, Tr>::ArrayHandle(
+ const typename ArrayHandle<T, Tr>::CType* array, Glib::OwnershipType ownership)
+: size_((array) ? Glib::Container_Helpers::compute_array_size(array) : 0),
+ parray_(array),
+ ownership_(ownership)
+{
+}
+
+template <class T, class Tr>
+inline ArrayHandle<T, Tr>::ArrayHandle(const ArrayHandle<T, Tr>& other)
+: size_(other.size_), parray_(other.parray_), ownership_(other.ownership_)
+{
+ other.ownership_ = Glib::OWNERSHIP_NONE;
+}
+
+template <class T, class Tr>
+ArrayHandle<T, Tr>::~ArrayHandle() noexcept
+{
+ if (parray_ && ownership_ != Glib::OWNERSHIP_NONE)
+ {
+ if (ownership_ != Glib::OWNERSHIP_SHALLOW)
+ {
+ // Deep ownership: release each container element.
+ const CType* const pend = parray_ + size_;
+ for (const CType* p = parray_; p != pend; ++p)
+ Tr::release_c_type(*p);
+ }
+ g_free(const_cast<CType*>(parray_));
+ }
+}
+
+template <class T, class Tr>
+inline typename ArrayHandle<T, Tr>::const_iterator
+ArrayHandle<T, Tr>::begin() const
+{
+ return Glib::Container_Helpers::ArrayHandleIterator<Tr>(parray_);
+}
+
+template <class T, class Tr>
+inline typename ArrayHandle<T, Tr>::const_iterator
+ArrayHandle<T, Tr>::end() const
+{
+ return Glib::Container_Helpers::ArrayHandleIterator<Tr>(parray_ + size_);
+}
+
+template <class T, class Tr>
+template <class U>
+inline ArrayHandle<T, Tr>::operator std::vector<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::vector<U>(this->begin(), this->end());
+#else
+ std::vector<U> temp;
+ temp.reserve(this->size());
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline ArrayHandle<T, Tr>::operator std::deque<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::deque<U>(this->begin(), this->end());
+#else
+ std::deque<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline ArrayHandle<T, Tr>::operator std::list<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::list<U>(this->begin(), this->end());
+#else
+ std::list<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class Cont>
+inline void
+ArrayHandle<T, Tr>::assign_to(Cont& container) const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ container.assign(this->begin(), this->end());
+#else
+ Cont temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ container.swap(temp);
+#endif
+}
+
+template <class T, class Tr>
+template <class Out>
+inline void
+ArrayHandle<T, Tr>::copy(Out pdest) const
+{
+ std::copy(this->begin(), this->end(), pdest);
+}
+
+template <class T, class Tr>
+inline const typename ArrayHandle<T, Tr>::CType*
+ArrayHandle<T, Tr>::data() const
+{
+ return parray_;
+}
+
+template <class T, class Tr>
+inline std::size_t
+ArrayHandle<T, Tr>::size() const
+{
+ return size_;
+}
+
+template <class T, class Tr>
+inline bool
+ArrayHandle<T, Tr>::empty() const
+{
+ return (size_ == 0);
+}
+
+/**** Glib::ArrayHandle<bool> **********************************************/
+
+template <class Cont>
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::ArrayHandle(const Cont& container)
+: size_(Glib::Container_Helpers::BoolArraySourceTraits<Cont>::get_size(container)),
+ parray_(Glib::Container_Helpers::BoolArraySourceTraits<Cont>::get_data(container, size_)),
+ ownership_(Glib::Container_Helpers::BoolArraySourceTraits<Cont>::initial_ownership)
+{
+}
+
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::ArrayHandle(
+ const gboolean* array, std::size_t array_size, Glib::OwnershipType ownership)
+: size_((array) ? array_size : 0), parray_(array), ownership_(ownership)
+{
+}
+
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::ArrayHandle(
+ const gboolean* array, Glib::OwnershipType ownership)
+: size_((array) ? Glib::Container_Helpers::compute_array_size(array) : 0),
+ parray_(array),
+ ownership_(ownership)
+{
+}
+
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::ArrayHandle(
+ const ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>& other)
+: size_(other.size_), parray_(other.parray_), ownership_(other.ownership_)
+{
+ other.ownership_ = Glib::OWNERSHIP_NONE;
+}
+
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::const_iterator
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::begin() const
+{
+ return Glib::Container_Helpers::ArrayHandleIterator<Tr>(parray_);
+}
+
+inline ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::const_iterator
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::end() const
+{
+ return Glib::Container_Helpers::ArrayHandleIterator<Tr>(parray_ + size_);
+}
+
+template <class Cont>
+inline void
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::assign_to(Cont& container) const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ container.assign(this->begin(), this->end());
+#else
+ Cont temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ container.swap(temp);
+#endif
+}
+
+template <class Out>
+inline void
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::copy(Out pdest) const
+{
+ std::copy(this->begin(), this->end(), pdest);
+}
+
+inline const gboolean*
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::data() const
+{
+ return parray_;
+}
+
+inline std::size_t
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::size() const
+{
+ return size_;
+}
+
+inline bool
+ArrayHandle<bool, Container_Helpers::TypeTraits<bool>>::empty() const
+{
+ return (size_ == 0);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} // namespace Glib
+
+#endif /* _GLIBMM_ARRAYHANDLE_H */
}
GType
+Class::clone_custom_type(const char* custom_type_name) const
+{
+ return clone_custom_type(custom_type_name, nullptr, nullptr, nullptr);
+}
+
+GType
+Class::clone_custom_type(
+ const char* custom_type_name, const interface_class_vector_type& interface_classes) const
+{
+ return clone_custom_type(custom_type_name, &interface_classes, nullptr, nullptr);
+}
+
+GType
Class::clone_custom_type(
- const char* custom_type_name, const interface_classes_type* interface_classes,
+ const char* custom_type_name, const interface_class_vector_type* interface_classes,
const class_init_funcs_type* class_init_funcs, GInstanceInitFunc instance_init_func) const
{
std::string full_name("gtkmm__CustomObject_");
const class_init_funcs_type& class_init_funcs =
*static_cast<class_init_funcs_type*>(class_data);
- g_return_if_fail(!class_init_funcs.empty() && std::get<GClassInitFunc>(class_init_funcs[0]) != nullptr);
+ g_return_if_fail(!class_init_funcs.empty() && std::get<0>(class_init_funcs[0]) != nullptr);
// Call the wrapper's class_init_function() to redirect
// the vfunc and default signal handler callbacks.
- auto init_func = std::get<GClassInitFunc>(class_init_funcs[0]);
+ GClassInitFunc init_func = std::get<0>(class_init_funcs[0]);
(*init_func)(g_class, nullptr);
GObjectClass* const gobject_class = static_cast<GObjectClass*>(g_class);
// Call extra class init functions, if any.
for (std::size_t i = 1; i < class_init_funcs.size(); ++i)
{
- if (auto extra_init_func = std::get<GClassInitFunc>(class_init_funcs[i]))
+ if (GClassInitFunc extra_init_func = std::get<0>(class_init_funcs[i]))
{
- auto extra_class_data = std::get<void*>(class_init_funcs[i]);
+ void* extra_class_data = std::get<1>(class_init_funcs[i]);
(*extra_init_func)(g_class, extra_class_data);
}
}
+// -*- c++ -*-
#ifndef _GLIBMM_CLASS_H
#define _GLIBMM_CLASS_H
+/* $Id$ */
+
/* Copyright 2001 Free Software Foundation
* Copyright (C) 1998-2002 The gtkmm Development Team
*
inline GType get_type() const;
+ // TODO: Remove this method at the next ABI/API break.
+ /** Register a static custom GType, derived from the parent of this class's type.
+ * The parent type of the registered custom type is the same C class as the parent
+ * of the get_type() type. If a type with the specified name is already registered,
+ * nothing is done. register_derived_type() must have been called.
+ * @param custom_type_name The name of the registered type is
+ * "gtkmm__CustomObject_" + canonic(custom_type_name), where canonic()
+ * replaces special characters with '+'.
+ * @return The registered type.
+ */
+ GType clone_custom_type(const char* custom_type_name) const;
+
/// The type that holds pointers to the interfaces of custom types.
- using interface_classes_type = std::vector<const Interface_Class*>;
+ using interface_class_vector_type = std::vector<const Interface_Class*>;
+
/** The type that holds pointers to extra class init functions of custom types.
* The std::tuple contains a function pointer and a pointer to class data.
* The class data pointer can be nullptr, if the function does not need it.
*/
using class_init_funcs_type = std::vector<std::tuple<GClassInitFunc, void*>>;
+ // TODO: Remove this method at the next ABI/API break.
+ /** Register a static custom GType, derived from the parent of this class's type.
+ * The parent type of the registered custom type is the same C class as the parent
+ * of the get_type() type. If a type with the specified name is already registered,
+ * nothing is done. register_derived_type() must have been called.
+ * @param custom_type_name The name of the registered type is
+ * "gtkmm__CustomObject_" + canonic(custom_type_name), where canonic()
+ * replaces special characters with '+'.
+ * @param interface_classes Interfaces that the custom type implements.
+ * @return The registered type.
+ */
+ GType clone_custom_type(
+ const char* custom_type_name, const interface_class_vector_type& interface_classes) const;
+
/** Register a static custom GType, derived from the parent of this class's type.
* The parent type of the registered custom type is the same C class as the parent
* of the get_type() type. If a type with the specified name is already registered,
* @return The registered type.
*/
GType clone_custom_type(
- const char* custom_type_name, const interface_classes_type* interface_classes,
+ const char* custom_type_name, const interface_class_vector_type* interface_classes,
const class_init_funcs_type* class_init_funcs, GInstanceInitFunc instance_init_func) const;
protected:
OWNERSHIP_DEEP /*!< Release the list, and its elements, when the container is deleted. */
};
+/** Utility class holding an iterator sequence.
+ * @ingroup ContHandles
+ * This can be used to initialize a Glib container handle (such as
+ * Glib::ArrayHandle) with an iterator sequence. Use the helper
+ * function Glib::sequence() to create a Sequence<> object.
+ */
+template <class Iterator>
+class Sequence
+{
+private:
+ Iterator pbegin_;
+ Iterator pend_;
+
+public:
+ Sequence(Iterator pbegin, Iterator pend) : pbegin_(pbegin), pend_(pend) {}
+
+ Iterator begin() const { return pbegin_; }
+ Iterator end() const { return pend_; }
+ std::size_t size() const { return std::distance(pbegin_, pend_); }
+};
+
+/** Helper function to create a Glib::Sequence<> object, which
+ * in turn can be used to initialize a container handle.
+ * @ingroup ContHandles
+ *
+ * @par Usage example:
+ * @code
+ * combo.set_popdown_strings(Glib::sequence(foo_begin, foo_end));
+ * @endcode
+ */
+template <class Iterator>
+inline Sequence<Iterator>
+sequence(Iterator pbegin, Iterator pend)
+{
+ return Sequence<Iterator>(pbegin, pend);
+}
+
namespace Container_Helpers
{
// be next to the objects that they use.
#ifdef GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
-/** Partial specialization for pointers to GObject instances.
- * The C++ type is not a Glib::RefPtr<>. It can be a gtkmm widget.
+/** Partial specialization for pointers to GtkObject instances.
* @ingroup ContHelpers
*/
template <class T>
// This confuse the SUN Forte compiler, so we ifdef it out:
#ifdef GLIBMM_HAVE_DISAMBIGUOUS_CONST_TEMPLATE_SPECIALIZATIONS
-/** Partial specialization for pointers to const GObject instances.
- * The C++ type is not a Glib::RefPtr<>. It can be a gtkmm widget.
+/** Partial specialization for pointers to const GtkObject instances.
* @ingroup ContHelpers
*/
template <class T>
// because that would be "dependent", and g++ 3.4 does not allow that.
// The specific Glib::wrap() overloads don't do anything special anyway.
GObject* cobj = (GObject*)(ptr);
- return Glib::make_refptr_for_instance<T>(dynamic_cast<T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
+ return Glib::RefPtr<T>(dynamic_cast<T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
// We use dynamic_cast<> in case of multiple inheritance.
}
// because that would be "dependent", and g++ 3.4 does not allow that.
// The specific Glib::wrap() overloads don't do anything special anyway.
GObject* cobj = (GObject*)const_cast<CTypeNonConst>(ptr);
- return Glib::make_refptr_for_instance<const T>(
+ return Glib::RefPtr<const T>(
dynamic_cast<const T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
// We use dynamic_cast<> in case of multiple inheritance.
}
--- /dev/null
+/* containers.h
+ *
+ * Copyright (C) 1998-2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/containers.h>
+
+namespace Glib
+{
+
+gpointer glibmm_null_pointer = nullptr;
+
+} // namespace Glib
--- /dev/null
+#ifndef _GLIBMM_CONTAINERS_H
+#define _GLIBMM_CONTAINERS_H
+
+/* containers.h
+ *
+ * Copyright (C) 1998-2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+#include <glibmm/sarray.h> /* for backward compatibility */
+#include <glibmm/wrap.h>
+#include <glib.h>
+#include <iterator>
+#include <cstddef>
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+namespace Glib
+{
+
+template <class T>
+class List_Iterator;
+template <class T>
+class List_ConstIterator;
+template <class T>
+class List_ReverseIterator;
+
+// Most of these methods in the non-template classes needs to be moved
+// to implementation.
+
+// Daniel Elstner has ideas about generating these per-widget with m4. murrayc.
+
+extern GLIBMM_API gpointer glibmm_null_pointer;
+
+template <class T>
+class List_Iterator_Base
+{
+public:
+ using value_type = T;
+ using pointer = T*;
+ using reference = T&;
+};
+
+/// For instance, List_Iterator< Gtk::Widget >
+template <class T>
+class List_Iterator : public List_Iterator_Base<T>
+{
+public:
+ using iterator_category = std::bidirectional_iterator_tag;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using pointer = typename List_Iterator_Base<T>::pointer;
+ using reference = typename List_Iterator_Base<T>::reference;
+
+ GList* const* head_;
+ GList* node_;
+
+ using Self = List_Iterator<T>;
+
+ List_Iterator(GList* const& head, GList* node) : head_(&head), node_(node) {}
+
+ List_Iterator() : head_(nullptr), node_(nullptr) {}
+
+ List_Iterator(const Self& src) : head_(src.head_), node_(src.node_) {}
+
+ bool operator==(const Self& src) const { return node_ == src.node_; }
+ bool operator!=(const Self& src) const { return node_ != src.node_; }
+
+ Self& operator++()
+ {
+ if (!node_)
+ node_ = g_list_first(*head_);
+ else
+ node_ = (GList*)g_list_next(node_);
+ return *this;
+ }
+
+ Self operator++(int)
+ {
+ Self tmp = *this;
+ ++*this;
+ return tmp;
+ }
+
+ Self& operator--()
+ {
+ if (!node_)
+ node_ = g_list_last(*head_);
+ else
+ node_ = (GList*)g_list_previous(node_);
+
+ return *this;
+ }
+
+ Self operator--(int)
+ {
+ Self tmp = *this;
+ --*this;
+ return tmp;
+ }
+
+ reference operator*() const { return *(pointer)(node_ ? node_->data : glibmm_null_pointer); }
+
+ pointer operator->() const { return &**this; }
+};
+
+/// For instance, SList_Iterator< Gtk::Widget >
+template <class T>
+class SList_Iterator : public List_Iterator_Base<T>
+{
+public:
+ using iterator_category = std::forward_iterator_tag;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using pointer = typename List_Iterator_Base<T>::pointer;
+ using reference = typename List_Iterator_Base<T>::reference;
+
+ GSList* node_;
+ using Self = SList_Iterator<T>;
+
+ SList_Iterator(GSList* node) : node_(node) {}
+
+ SList_Iterator() : node_(nullptr) {}
+
+ SList_Iterator(const Self& src) : node_(src.node_) {}
+
+ bool operator==(const Self& src) const { return node_ == src.node_; }
+ bool operator!=(const Self& src) const { return node_ != src.node_; }
+
+ Self& operator++()
+ {
+ node_ = g_slist_next(node_);
+ return *this;
+ }
+
+ Self operator++(int)
+ {
+ Self tmp = *this;
+ ++*this;
+ return tmp;
+ }
+
+ reference operator*() const
+ {
+ return reinterpret_cast<T&>(node_ ? node_->data : glibmm_null_pointer);
+ }
+
+ pointer operator->() const { return &**this; }
+};
+
+// This iterator variation returns T_IFace (wrapped from T_Impl)
+// For instance, List_Cpp_Iterator<GtkWidget, Gtk::Widget> is
+// a little like std::list<Gtk::Widget>::iterator
+template <class T_Impl, class T_IFace>
+class List_Cpp_Iterator : public List_Iterator_Base<T_IFace>
+{
+public:
+ using iterator_category = std::bidirectional_iterator_tag;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using pointer = typename List_Iterator_Base<T_IFace>::pointer;
+ using reference = typename List_Iterator_Base<T_IFace>::reference;
+
+ using Self = List_Cpp_Iterator<T_Impl, T_IFace>;
+
+ GList** head_;
+ GList* node_;
+
+ bool operator==(const Self& src) const { return node_ == src.node_; }
+ bool operator!=(const Self& src) const { return node_ != src.node_; }
+
+ List_Cpp_Iterator(GList*& head, GList* node) : head_(&head), node_(node) {}
+
+ List_Cpp_Iterator() : head_(nullptr), node_(nullptr) {}
+
+ List_Cpp_Iterator(const Self& src) : head_(src.head_), node_(src.node_) {}
+
+ reference operator*() const
+ {
+ if (node_ && node_->data)
+ {
+ // We copy/paste the widget wrap() implementation here,
+ // because we can not use a specific Glib::wrap(T_Impl) overload here,
+ // because that would be "dependent", and g++ 3.4 does not allow that.
+ // The specific Glib::wrap() overloads don't do anything special anyway.
+ GObject* cobj = static_cast<GObject*>(node_->data);
+
+#ifdef GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
+ return *dynamic_cast<pointer>(Glib::wrap_auto(cobj, false));
+#else
+ // We really do need to use dynamic_cast<>, so I expect problems if this code is used.
+ // murrayc.
+ return *static_cast<pointer>(Glib::wrap_auto(cobj, false));
+#endif
+ }
+ return *static_cast<pointer>(nullptr); // boom!
+ }
+
+ pointer operator->() const { return &**this; }
+
+ Self& operator++()
+ {
+ if (!node_)
+ node_ = g_list_first(*head_);
+ else
+ node_ = (GList*)g_list_next(node_);
+
+ return *this;
+ }
+
+ Self operator++(int)
+ {
+ Self tmp = *this;
+ ++*this;
+ return tmp;
+ }
+
+ Self& operator--()
+ {
+ if (!node_)
+ node_ = g_list_last(*head_);
+ else
+ node_ = (GList*)g_list_previous(node_);
+
+ return *this;
+ }
+
+ Self operator--(int)
+ {
+ Self tmp = *this;
+ --*this;
+ return tmp;
+ }
+};
+
+template <class T_Base>
+class List_ReverseIterator : private T_Base
+{
+public:
+ using iterator_category = typename T_Base::iterator_category;
+ using size_type = typename T_Base::size_type;
+ using difference_type = typename T_Base::difference_type;
+
+ using value_type = typename T_Base::value_type;
+ using pointer = typename T_Base::pointer;
+ using reference = typename T_Base::reference;
+
+ using Self = List_ReverseIterator<T_Base>;
+
+ bool operator==(const Self& src) const { return T_Base::operator==(src); }
+ bool operator!=(const Self& src) const { return T_Base::operator!=(src); }
+
+ List_ReverseIterator(GList* const& head, GList* node) : T_Base(head, node) {}
+
+ List_ReverseIterator() : T_Base() {}
+
+ List_ReverseIterator(const Self& src) : T_Base(src) {}
+
+ List_ReverseIterator(const T_Base& src) : T_Base(src) { ++(*this); }
+
+ Self& operator++()
+ {
+ T_Base::operator--();
+ return *this;
+ }
+ Self& operator--()
+ {
+ T_Base::operator++();
+ return *this;
+ }
+ Self operator++(int)
+ {
+ Self src = *this;
+ T_Base::operator--();
+ return src;
+ }
+ Self operator--(int)
+ {
+ Self src = *this;
+ T_Base::operator++();
+ return src;
+ }
+
+ reference operator*() const { return T_Base::operator*(); }
+ pointer operator->() const { return T_Base::operator->(); }
+};
+
+template <class T_Base>
+class List_ConstIterator : public T_Base
+{
+public:
+ using iterator_category = typename T_Base::iterator_category;
+ using size_type = typename T_Base::size_type;
+ using difference_type = typename T_Base::difference_type;
+
+ using value_type = const typename T_Base::value_type;
+ using pointer = const typename T_Base::pointer;
+ using reference = const typename T_Base::reference;
+
+ using Self = List_ConstIterator<T_Base>;
+
+ bool operator==(const Self& src) const { return T_Base::operator==(src); }
+ bool operator!=(const Self& src) const { return T_Base::operator!=(src); }
+
+ List_ConstIterator(GList* const& head, GList* node) : T_Base(head, node) {}
+
+ List_ConstIterator() : T_Base() {}
+
+ List_ConstIterator(const Self& src) : T_Base(src) {}
+
+ List_ConstIterator(const T_Base& src) : T_Base(src) {}
+
+ Self& operator++()
+ {
+ T_Base::operator++();
+ return *this;
+ }
+ Self& operator--()
+ {
+ T_Base::operator--();
+ return *this;
+ }
+ Self operator++(int)
+ {
+ Self src = *this;
+ T_Base::operator++();
+ return src;
+ }
+ Self operator--(int)
+ {
+ Self src = *this;
+ T_Base::operator--();
+ return src;
+ }
+
+ reference operator*() const { return T_Base::operator*(); }
+ pointer operator->() const { return T_Base::operator->(); }
+};
+
+} // namespace Glib
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+#endif /* _GLIBMM_CONTAINERS_H */
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#ifndef GLIBMM_CAN_USE_THREAD_LOCAL
+#include <glibmm/threads.h>
+#endif
+
#include <glibmm/dispatcher.h>
#include <glibmm/exceptionhandler.h>
#include <glibmm/fileutils.h>
#include <cerrno>
#include <fcntl.h>
#include <glib.h>
-#include <forward_list>
-#include <memory>
+#include <set>
#include <utility> // For std::move()
#ifdef G_OS_WIN32
#define EINTR 0 /* TODO: should use the real define */
#endif
-namespace Glib
-{
-class DispatchNotifier;
-}
-
namespace
{
struct DispatchNotifyData
{
- Glib::Dispatcher::Impl* dispatcher_impl;
+ Glib::Dispatcher* dispatcher;
Glib::DispatchNotifier* notifier;
- DispatchNotifyData()
- : dispatcher_impl(nullptr), notifier(nullptr)
- {}
+ DispatchNotifyData() : dispatcher(nullptr), notifier(nullptr) {}
- DispatchNotifyData(Glib::Dispatcher::Impl* d, Glib::DispatchNotifier* n)
- : dispatcher_impl(d), notifier(n)
- {}
+ DispatchNotifyData(Glib::Dispatcher* d, Glib::DispatchNotifier* n) : dispatcher(d), notifier(n) {}
};
static void
}
#endif /* !G_OS_WIN32 */
-void warn_dropped_dispatcher_message()
-{
- g_warning("Dropped dispatcher message as the dispatcher no longer exists.");
-}
-
} // anonymous namespace
namespace Glib
{
-// The most important reason for having the dispatcher implementation in a separate
-// class is that its deletion can be delayed until it's safe to delete it.
-// Deletion is safe when the pipe does not contain any message to the dispatcher
-// to delete. When the pipe is empty, it's surely safe.
-struct Dispatcher::Impl
-{
-public:
- sigc::signal<void()> signal_;
- DispatchNotifier* notifier_;
-
- explicit Impl(const Glib::RefPtr<MainContext>& context);
-
- // noncopyable
- Impl(const Impl&) = delete;
- Impl& operator=(const Impl&) = delete;
-};
-
class DispatchNotifier : public sigc::trackable
{
public:
DispatchNotifier(const DispatchNotifier&) = delete;
DispatchNotifier& operator=(const DispatchNotifier&) = delete;
- static DispatchNotifier* reference_instance(const Glib::RefPtr<MainContext>& context);
- static void unreference_instance(DispatchNotifier* notifier, Dispatcher::Impl* dispatcher_impl);
+ static DispatchNotifier* reference_instance(
+ const Glib::RefPtr<MainContext>& context, const Dispatcher* dispatcher);
+ static void unreference_instance(DispatchNotifier* notifier, const Dispatcher* dispatcher);
- void send_notification(Dispatcher::Impl* dispatcher_impl);
+ void send_notification(Dispatcher* dispatcher);
protected:
// Only used by reference_instance(). Should be private, but that triggers
explicit DispatchNotifier(const Glib::RefPtr<MainContext>& context);
private:
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
static thread_local DispatchNotifier* thread_specific_instance_;
+#else
+ static Glib::Threads::Private<DispatchNotifier> thread_specific_instance_;
+#endif
+
+ std::set<const Dispatcher*> deleted_dispatchers_;
- using UniqueImplPtr = std::unique_ptr<Dispatcher::Impl>;
- std::forward_list<UniqueImplPtr> orphaned_dispatcher_impl_;
long ref_count_;
Glib::RefPtr<MainContext> context_;
#ifdef G_OS_WIN32
/**** Glib::DispatchNotifier ***********************************************/
+// static
+
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
thread_local DispatchNotifier* DispatchNotifier::thread_specific_instance_ = nullptr;
+#else
+Glib::Threads::Private<DispatchNotifier> DispatchNotifier::thread_specific_instance_;
+#endif
DispatchNotifier::DispatchNotifier(const Glib::RefPtr<MainContext>& context)
-: orphaned_dispatcher_impl_(),
+: deleted_dispatchers_(),
ref_count_(0),
context_(context),
#ifdef G_OS_WIN32
// The following code is equivalent to
// context_->signal_io().connect(
- // sigc::mem_fun(*this, &DispatchNotifier::pipe_io_handler), fd, Glib::IOCondition::IO_IN);
+ // sigc::mem_fun(*this, &DispatchNotifier::pipe_io_handler), fd, Glib::IO_IN);
// except for source->set_can_recurse(true).
- const auto source = IOSource::create(fd, Glib::IOCondition::IO_IN);
+ const auto source = IOSource::create(fd, Glib::IO_IN);
// If the signal emission in pipe_io_handler() starts a new main loop,
// the event source shall not be blocked while that loop runs. (E.g. while
}
// static
-DispatchNotifier* DispatchNotifier::reference_instance(
- const Glib::RefPtr<MainContext>& context)
+DispatchNotifier*
+DispatchNotifier::reference_instance(
+ const Glib::RefPtr<MainContext>& context, const Dispatcher* dispatcher)
{
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
DispatchNotifier* instance = thread_specific_instance_;
+#else
+ DispatchNotifier* instance = thread_specific_instance_.get();
+#endif
if (!instance)
{
instance = new DispatchNotifier(context);
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
thread_specific_instance_ = instance;
+#else
+ thread_specific_instance_.replace(instance);
+#endif
}
else
{
// Prevent massive mess-up.
g_return_val_if_fail(instance->context_ == context, nullptr);
+
+ // In the possible but unlikely case that a new dispatcher gets the same
+ // address as a newly deleted one, if the pipe still contains messages to
+ // the deleted dispatcher, those messages will be delivered to the new one.
+ // Not ideal, but perhaps the best that can be done without breaking ABI.
+ // The alternative would be to remove the following erase(), and risk not
+ // delivering messages sent to the new dispatcher.
+ // TODO: When we can break ABI, a better solution without this drawback can
+ // be implemented. See https://bugzilla.gnome.org/show_bug.cgi?id=651942
+ // especially comment 16.
+ instance->deleted_dispatchers_.erase(dispatcher);
}
++instance->ref_count_; // initially 0
}
// static
-void DispatchNotifier::unreference_instance(
- DispatchNotifier* notifier, Dispatcher::Impl* dispatcher_impl)
+void
+DispatchNotifier::unreference_instance(DispatchNotifier* notifier, const Dispatcher* dispatcher)
{
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
DispatchNotifier* const instance = thread_specific_instance_;
+#else
+ DispatchNotifier* const instance = thread_specific_instance_.get();
+#endif
// Yes, the notifier argument is only used to check for sanity.
g_return_if_fail(instance == notifier);
if (instance->pipe_is_empty())
- {
- // No messages in the pipe. Delete the Dispatcher::Impl immediately.
- delete dispatcher_impl;
- instance->orphaned_dispatcher_impl_.clear();
- }
+ // No messages in the pipe. No need to keep track of deleted dispatchers.
+ instance->deleted_dispatchers_.clear();
else
- {
- // There are messages in the pipe, possibly to the orphaned Dispatcher::Impl.
- // Keep it around until it can safely be deleted.
- // Delete all slots connected to the Dispatcher. Then the signal emission
- // in pipe_io_handler() will do nothing.
- dispatcher_impl->signal_.clear();
- // Add a slot that will warn that a message has been dropped.
- dispatcher_impl->signal_.connect(sigc::ptr_fun(warn_dropped_dispatcher_message));
- instance->orphaned_dispatcher_impl_.push_front(UniqueImplPtr(dispatcher_impl));
- }
+ // There are messages in the pipe, possibly to the deleted dispatcher.
+ // Keep its address, so pipe_io_handler() can avoid delivering messages to it.
+ instance->deleted_dispatchers_.insert(dispatcher);
if (--instance->ref_count_ <= 0)
{
g_return_if_fail(instance->ref_count_ == 0); // could be < 0 if messed up
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
delete thread_specific_instance_;
thread_specific_instance_ = nullptr;
+#else
+ thread_specific_instance_.replace(nullptr);
+#endif
}
}
-void DispatchNotifier::send_notification(Dispatcher::Impl* dispatcher_impl)
+void
+DispatchNotifier::send_notification(Dispatcher* dispatcher)
{
#ifdef G_OS_WIN32
{
const std::lock_guard<std::mutex> lock(mutex_);
const bool was_empty = notify_queue_.empty();
- notify_queue_.emplace_back(DispatchNotifyData(dispatcher_impl, this));
+ notify_queue_.emplace_back(DispatchNotifyData(dispatcher, this));
if (was_empty)
{
}
#else /* !G_OS_WIN32 */
- DispatchNotifyData data(dispatcher_impl, this);
+ DispatchNotifyData data(dispatcher, this);
gssize n_written;
do
#ifdef G_OS_WIN32
return notify_queue_.empty();
#else
- PollFD poll_fd(fd_receiver_, Glib::IOCondition::IO_IN);
+ PollFD poll_fd(fd_receiver_, Glib::IO_IN);
// GPollFD*, number of file descriptors to poll, timeout (ms)
g_poll(poll_fd.gobj(), 1, 0);
- return static_cast<int>(poll_fd.get_revents() & Glib::IOCondition::IO_IN) == 0;
+ return (poll_fd.get_revents() & Glib::IO_IN) == 0;
#endif
}
g_return_val_if_fail(data.notifier == this, true);
+ // Drop the received message, if it is addressed to a deleted dispatcher.
+ const bool drop_message =
+ (deleted_dispatchers_.find(data.dispatcher) != deleted_dispatchers_.end());
+
+ // If the pipe is empty, there can be no messages to deleted dispatchers.
+ // No reason to keep track of them any more.
+ if (!deleted_dispatchers_.empty() && pipe_is_empty())
+ deleted_dispatchers_.clear();
+
+ if (drop_message)
+ {
+ g_warning("Dropped dispatcher message as the dispatcher no longer exists");
+ return true;
+ }
+
// Actually, we wouldn't need the try/catch block because the Glib::Source
// C callback already does it for us. However, we do it anyway because the
// default return value is 'false', which is not what we want.
try
{
- data.dispatcher_impl->signal_(); // emit
+ data.dispatcher->signal_(); // emit
}
catch (...)
{
Glib::exception_handlers_invoke();
}
- if (!orphaned_dispatcher_impl_.empty() && pipe_is_empty())
- orphaned_dispatcher_impl_.clear();
-
return true;
}
-/**** Glib::Dispatcher and Glib::Dispatcher::Impl **************************/
+/**** Glib::Dispatcher *****************************************************/
-Dispatcher::Impl::Impl(const Glib::RefPtr<MainContext>& context)
-: signal_(),
- notifier_(DispatchNotifier::reference_instance(context))
+Dispatcher::Dispatcher()
+: signal_(), notifier_(DispatchNotifier::reference_instance(MainContext::get_default(), this))
{
}
-Dispatcher::Dispatcher()
-: impl_(new Dispatcher::Impl(MainContext::get_default()))
-{}
-
-
Dispatcher::Dispatcher(const Glib::RefPtr<MainContext>& context)
-: impl_(new Dispatcher::Impl(context))
+: signal_(), notifier_(DispatchNotifier::reference_instance(context, this))
{
}
Dispatcher::~Dispatcher() noexcept
{
- DispatchNotifier::unreference_instance(impl_->notifier_, impl_);
+ DispatchNotifier::unreference_instance(notifier_, this);
}
void
Dispatcher::emit()
{
- impl_->notifier_->send_notification(impl_);
+ notifier_->send_notification(this);
}
void
Dispatcher::operator()()
{
- impl_->notifier_->send_notification(impl_);
+ notifier_->send_notification(this);
}
sigc::connection
-Dispatcher::connect(const sigc::slot<void()>& slot)
+Dispatcher::connect(const sigc::slot<void>& slot)
{
- return impl_->signal_.connect(slot);
+ return signal_.connect(slot);
}
sigc::connection
-Dispatcher::connect(sigc::slot<void()>&& slot)
+Dispatcher::connect(sigc::slot<void>&& slot)
{
- return impl_->signal_.connect(std::move(slot));
+ return signal_.connect(std::move(slot));
}
} // namespace Glib
namespace Glib
{
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+class DispatchNotifier;
+#endif
+
/** Signal class for inter-thread communication.
* @ingroup Threads
- * Glib::Dispatcher works similar to sigc::signal<void()>. But unlike normal
+ * Glib::Dispatcher works similar to sigc::signal<void>. But unlike normal
* signals, the notification happens asynchronously through a pipe. This is
* a simple and efficient way of communicating between threads, and especially
* useful in a thread model with a single GUI thread.
void emit();
void operator()();
- sigc::connection connect(const sigc::slot<void()>& slot);
+ sigc::connection connect(const sigc::slot<void>& slot);
/** @newin{2,48}
*/
- sigc::connection connect(sigc::slot<void()>&& slot);
-
- #ifndef DOXYGEN_SHOULD_SKIP_THIS
- struct Impl;
- #endif
+ sigc::connection connect(sigc::slot<void>&& slot);
private:
- Impl* impl_; // hidden implementation
+ sigc::signal<void> signal_;
+ DispatchNotifier* notifier_;
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ friend class Glib::DispatchNotifier;
+#endif
};
/*! A Glib::Dispatcher example.
g_error_free(gobject_);
}
+Error::operator bool() const
+{
+ return gobject_ != nullptr;
+}
+
GQuark
Error::domain() const
{
throw Glib::Error(gobject);
}
+// Glib::Value<Glib::Error>
+GType Value<Error>::value_type()
+{
+ return g_error_get_type();
+}
+
+void Value<Error>::set(const CppType& data)
+{
+ set_boxed(data.gobj());
+}
+
+Value<Error>::CppType Value<Error>::get() const
+{
+ return Glib::Error(static_cast<CType>(get_boxed()), true);
+}
+
} // namespace Glib
-// -*- c++ -*-
#ifndef _GLIBMM_ERROR_H
#define _GLIBMM_ERROR_H
#include <glibmmconfig.h>
#include <glibmm/exception.h>
+#include <glibmm/value.h>
#include <glib.h>
namespace Glib
~Error() noexcept override;
+ /** Test whether the %Error has an underlying instance.
+ *
+ * @newin{2,60}
+ */
+ explicit operator bool() const;
+
GQuark domain() const;
int code() const;
Glib::ustring what() const override;
GError* gobject_;
};
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+// This is needed so Glib::Error can be used with
+// Glib::Value and _WRAP_PROPERTY.
+template <>
+class Value<Glib::Error> : public ValueBase_Boxed
+{
+public:
+ using CppType = Glib::Error;
+ using CType = GError*;
+
+ static GType value_type();
+
+ void set(const CppType& data);
+ CppType get() const;
+};
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
} // namespace Glib
#endif /* _GLIBMM_ERROR_H */
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#ifndef GLIBMM_CAN_USE_THREAD_LOCAL
+#include <glibmm/threads.h>
+#endif
#include <glibmmconfig.h>
#include <glibmm/error.h>
#include <glibmm/exceptionhandler.h>
// Each thread has its own list of exception handlers
// to avoid thread synchronization problems.
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
static thread_local HandlerList* thread_specific_handler_list = nullptr;
+#else
+static Glib::Threads::Private<HandlerList> thread_specific_handler_list;
+#endif
static void
glibmm_exception_warning(const GError* error)
{
sigc::connection
-add_exception_handler(const sigc::slot<void()>& slot)
+add_exception_handler(const sigc::slot<void>& slot)
{
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
HandlerList* handler_list = thread_specific_handler_list;
+#else
+ HandlerList* handler_list = thread_specific_handler_list.get();
+#endif
if (!handler_list)
{
handler_list = new HandlerList();
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
thread_specific_handler_list = handler_list;
+#else
+ thread_specific_handler_list.set(handler_list);
+#endif
}
handler_list->emplace_back(slot);
// handled. If there are no more handlers in the list and the exception
// is still unhandled, call glibmm_unexpected_exception().
+#ifdef GLIBMM_CAN_USE_THREAD_LOCAL
if (HandlerList* const handler_list = thread_specific_handler_list)
+#else
+ if(HandlerList *const handler_list = thread_specific_handler_list.get())
+#endif
{
HandlerList::iterator pslot = handler_list->begin();
/** Specify a slot to be called when an exception is thrown by a signal handler.
*/
-sigc::connection add_exception_handler(const sigc::slot<void()>& slot);
+sigc::connection add_exception_handler(const sigc::slot<void>& slot);
#ifndef DOXYGEN_SHOULD_SKIP_THIS
// internal
* public:
* MyWidget()
* :
- * // The GType name will be gtkmm__CustomObject_MyMidget
+ * // The GType name will be gtkmm__CustomObject_MyWidget
* Glib::ObjectBase("MyWidget"), // Unique class name
* MyExtraInit("my-widget"),
* Gtk::Widget()
* must be listed before Glib::Object or a class derived from
* %Glib::Object (Gtk::Widget in the example) in the list of base classes.
*
- * @newin{2,58}
+ * @newin{2,60}
*/
class ExtraClassInit : virtual public ObjectBase
{
glibmm_files_built_h = $(glibmm_files_used_hg:.hg=.h) $(glibmm_files_h_m4:.m4=)
glibmm_files_extra_cc = \
+ arrayhandle.cc \
base64.cc \
class.cc \
+ containers.cc \
debug.cc \
dispatcher.cc \
error.cc \
exception.cc \
exceptionhandler.cc \
- extraclassinit.cc \
+ extraclassinit.cc \
init.cc \
interface.cc \
main.cc \
propertyproxy_base.cc \
quark.cc \
random.cc \
+ sarray.cc \
signalproxy.cc \
signalproxy_connectionnode.cc \
+ streamiochannel.cc \
stringutils.cc \
+ threadpool.cc \
timer.cc \
timeval.cc \
ustring.cc \
wrap.cc
glibmm_files_extra_h = \
+ arrayhandle.h \
base64.h \
class.h \
containerhandle_shared.h \
+ containers.h \
debug.h \
dispatcher.h \
error.h \
exception.h \
exceptionhandler.h \
- extraclassinit.h \
+ extraclassinit.h \
+ helperlist.h \
i18n-lib.h \
i18n.h \
init.h \
interface.h \
+ listhandle.h \
main.h \
object.h \
objectbase.h \
quark.h \
random.h \
refptr.h \
+ sarray.h \
signalproxy.h \
signalproxy_connectionnode.h \
+ slisthandle.h \
+ streamiochannel.h \
stringutils.h \
+ threadpool.h \
timer.h \
timeval.h \
ustring.h \
value_custom.h \
variantdbusstring.h \
vectorutils.h \
+ weakref.h \
wrap.h \
wrap_init.h
include $(top_srcdir)/glib/glibmm/filelist.am
+# Split out from $(top_srcdir)/glib/glimm/filelist.am
glibmm_files_built_ph = $(patsubst %.hg,private/%_p.h,$(glibmm_files_used_hg))
--- /dev/null
+#ifndef _GLIBMM_HELPERLIST_H
+#define _GLIBMM_HELPERLIST_H
+
+/* helperlist.h
+ *
+ * Copyright 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+// This is not hidden by GLIBMM_DISABLE_DEPRECATED
+// because gtkmm-2.24 still uses this type in its public API.
+// Note that gtkmm-2.24 itself is completely deprecated, so we really
+// can remove this whole class some time soon.
+//#ifndef GLIBMM_DISABLE_DEPRECATED
+
+#include <glibmm/containers.h>
+
+namespace Glib
+{
+
+// This class has some pure virtual methods which need to be implemented by derived classes.
+
+/**
+ * @deprecated This class should no longer be necessary. It has not been used
+ * by glibmm or gtkmm since gtkmm-2.4.
+ */
+template <typename T_Child, typename T_CppElement, typename T_Iterator>
+class HelperList
+{
+public:
+ HelperList() : gparent_(nullptr) {}
+
+ HelperList(GObject*
+ gp) // We use gp instead of gparent because that can cause warnings about a shadowed member.
+ : gparent_(gp)
+ {
+ }
+
+ virtual ~HelperList() noexcept {}
+
+ using value_type = T_Child;
+ using reference = value_type&;
+ using const_reference = const value_type&;
+
+ using iterator = T_Iterator;
+ using const_iterator = List_ConstIterator<iterator>;
+ using reverse_iterator = List_ReverseIterator<iterator>;
+ using const_reverse_iterator = List_ConstIterator<reverse_iterator>;
+
+ using element_type = T_CppElement;
+
+ using difference_type = std::size_t; // TODO Why not std::ptrdiff_t?
+ using size_type = std::size_t;
+
+ // These are implemented differently for each Helper List.
+ virtual iterator erase(iterator) = 0;
+
+ virtual void erase(iterator start, iterator stop)
+ {
+ while (start != stop)
+ start = erase(start); // Implemented in derived class.
+ }
+
+ virtual void remove(const_reference) = 0;
+
+ size_type size() const { return g_list_length(glist()); }
+
+ inline size_type max_size() { return size_type(-1); }
+ inline bool empty() { return glist() == nullptr; }
+
+ inline iterator begin() { return begin_(); }
+ inline iterator end() { return end_(); }
+
+ inline const_iterator begin() const { return const_iterator(begin_()); }
+ inline const_iterator end() const { return const_iterator(end_()); }
+
+ inline reverse_iterator rbegin() { return reverse_iterator(end_()); }
+ inline reverse_iterator rend() { return reverse_iterator(begin_()); }
+
+ inline const_reverse_iterator rbegin() const
+ {
+ return const_reverse_iterator(reverse_iterator(end_()));
+ }
+ inline const_reverse_iterator rend() const
+ {
+ return const_reverse_iterator(reverse_iterator(begin_()));
+ }
+
+ reference front() const { return *begin(); }
+
+ reference back() const { return *(--end()); }
+
+ reference operator[](size_type l) const
+ {
+ size_type j = 0;
+ iterator i;
+ for (i = begin(), j = 0; i != end() && j < l; ++i, ++j)
+ ;
+ return (*i);
+ }
+
+ // iterator find(const_reference w)
+ // {
+ // iterator i = begin();
+ // for(i = begin(); i != end() && (*i != w); i++);
+ // return i;
+ // }
+ //
+ // iterator find(Widget& w)
+ // {
+ // iterator i;
+ // for (i = begin(); i != end() && ((*i)->$1() != &w); i++);
+ // return i;
+ // }
+
+ // Derived classes might choose to reimplement these as public:
+ inline void pop_front() { erase(begin()); }
+ inline void pop_back() { erase(--end()); }
+
+ void clear() { erase(begin(), end()); }
+
+ GObject* gparent() { return gparent_; };
+ const GObject* gparent() const { return gparent_; };
+
+protected:
+ virtual GList*& glist() const = 0; // front of list
+
+ iterator begin_() const { return iterator(glist(), glist()); }
+
+ iterator end_() const { return iterator(glist(), (GList*)nullptr); }
+
+ GObject* gparent_;
+};
+
+} /* namespace Glib */
+
+//#endif //GLIBMM_DISABLE_DEPRECATED
+
+#endif /* _GLIBMM_HELPERLIST_H */
#include <glibmm/init.h>
#include <glibmm/error.h>
-#include <locale>
-#include <clocale>
-#include <stdexcept>
-
-namespace
-{
- bool init_to_users_preferred_locale = true;
-
-} // anonymous namespace
namespace Glib
{
-void set_init_to_users_preferred_locale(bool state)
-{
- init_to_users_preferred_locale = state;
-}
-
-bool get_init_to_users_preferred_locale()
-{
- return init_to_users_preferred_locale;
-}
-void init()
+void
+init()
{
- static bool is_initialized = false;
-
- if (is_initialized)
- return;
-
- if (init_to_users_preferred_locale)
- {
- try
- {
- // Set the global locale for C++ functions and the locale for C functions
- // to the user-preferred locale.
- std::locale::global(std::locale(""));
- }
- catch (const std::runtime_error& ex)
- {
- g_warning("Can't set the global locale to the user's preferred locale.\n"
- " %s\n The environment variable LANG may be wrong.\n", ex.what());
- }
- }
- else
- {
- try
- {
- // Make the C++ locale equal to the C locale.
- std::locale::global(std::locale(std::setlocale(LC_ALL, nullptr)));
- }
- catch (const std::runtime_error& ex)
- {
- g_warning("Can't make the global C++ locale equal to the C locale.\n"
- " %s\n C locale = %s\n", ex.what(), std::setlocale(LC_ALL, nullptr));
- }
- }
-
// Also calls Glib::wrap_register_init() and Glib::wrap_init().
Glib::Error::register_init();
-
- is_initialized = true;
}
} // namespace Glib
+// -*- c++ -*-
#ifndef _GLIBMM_INIT_H
#define _GLIBMM_INIT_H
+/* $Id$ */
+
/* Copyright (C) 2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
{
/** Initialize glibmm.
- *
- * You may call this more than once. Calls after the first one have no effect.
- * Sets the global locale as specified by set_init_to_users_preferred_locale().
- * You do not need to call %Glib::init() if you are using Gtk::Application,
- * because it calls %Glib::init() for you.
- *
- * @see set_init_to_users_preferred_locale()
+ * You may call this more than once.
+ * You do not need to call this if you are using Glib::MainLoop or Gtk::Main,
+ * because they call it for you.
*/
void init();
-/** Instruct Glib::init() which global locale to set.
- *
- * To have the intended effect, this function must be called before init() is called.
- * Not calling it has the same effect as calling it with @a state = <tt>true</tt>.
- *
- * Note the confusing difference between C locale and "C" locale.
- * The C locale is the locale used by C code, set by std::setlocale(LC_ALL, locale_name).
- * The "C" locale is the classic locale, set by std::setlocale(LC_ALL, "C")
- * or std::locale::global(std::locale::classic()). It's the default global locale
- * in a C or C++ program.
- *
- * In a mixed C and C++ program, like a program using glibmm, having the C global
- * locale differ from std::locale::global() is error prone. Glib::init() tries
- * to avoid that.
- *
- * @param state If <tt>true</tt>, init() will set the C and C++ global locale
- * to the user's preferred locale (std::locale::global(std::locale(""))).
- * The user's preferred locale is set in the program's environment,
- * usually with the LANG environment variable.<br>
- * If <tt>false</tt>, init() will set the C++ global locale to the C global locale
- * (std::locale::global(std::locale(std::setlocale(LC_ALL, nullptr)))).
- *
- * @newin{2,58}
- */
-void set_init_to_users_preferred_locale(bool state = true);
-
-/** Get the state, set with set_init_to_users_preferred_locale().
- * @returns The state, set with set_init_to_users_preferred_locale(); <tt>true</tt>
- * if set_init_to_users_preferred_locale() has not been called.
- *
- * @newin{2,58}
- */
-bool get_init_to_users_preferred_locale();
-
} // namespace Glib
#endif /* _GLIBMM_INIT_H */
RefPtr<ObjectBase>
wrap_interface(GObject* object, bool take_copy)
{
- return Glib::make_refptr_for_instance<ObjectBase>(wrap_auto(object, take_copy));
+ return Glib::RefPtr<ObjectBase>(wrap_auto(object, take_copy));
}
} // namespace Glib
--- /dev/null
+#ifndef _GLIBMM_LISTHANDLE_H
+#define _GLIBMM_LISTHANDLE_H
+
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+#include <glibmm/containerhandle_shared.h>
+#include <glib.h>
+
+namespace Glib
+{
+
+namespace Container_Helpers
+{
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/* Create and fill a GList as efficient as possible.
+ * This requires bidirectional iterators.
+ */
+template <class Bi, class Tr>
+GList*
+create_list(Bi pbegin, Bi pend, Tr)
+{
+ GList* head = nullptr;
+
+ while (pend != pbegin)
+ {
+ // Use & to force a warning if the iterator returns a temporary object.
+ const void* const item = Tr::to_c_type(*&*--pend);
+ head = g_list_prepend(head, const_cast<void*>(item));
+ }
+
+ return head;
+}
+
+/* Create a GList from a 0-terminated input sequence.
+ * Build it in reverse order and reverse the whole list afterwards,
+ * because appending to the list would be horribly inefficient.
+ */
+template <class For, class Tr>
+GList*
+create_list(For pbegin, Tr)
+{
+ GList* head = nullptr;
+
+ while (*pbegin)
+ {
+ // Use & to force a warning if the iterator returns a temporary object.
+ const void* const item = Tr::to_c_type(*&*pbegin);
+ head = g_list_prepend(head, const_cast<void*>(item));
+ ++pbegin;
+ }
+
+ return g_list_reverse(head);
+}
+
+/* Convert from any container that supports bidirectional iterators.
+ */
+template <class Tr, class Cont>
+struct ListSourceTraits
+{
+ static GList* get_data(const Cont& cont)
+ {
+ return Glib::Container_Helpers::create_list(cont.begin(), cont.end(), Tr());
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+/* Convert from a 0-terminated array. The Cont
+ * argument must be a pointer to the first element.
+ */
+template <class Tr, class Cont>
+struct ListSourceTraits<Tr, Cont*>
+{
+ static GList* get_data(const Cont* array)
+ {
+ return (array) ? Glib::Container_Helpers::create_list(array, Tr()) : nullptr;
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+template <class Tr, class Cont>
+struct ListSourceTraits<Tr, const Cont*> : ListSourceTraits<Tr, Cont*>
+{
+};
+
+/* Convert from a 0-terminated array. The Cont argument must be a pointer
+ * to the first element. For consistency, the array must be 0-terminated,
+ * even though the array size is known at compile time.
+ */
+template <class Tr, class Cont, std::size_t N>
+struct ListSourceTraits<Tr, Cont[N]>
+{
+ static GList* get_data(const Cont* array)
+ {
+ return Glib::Container_Helpers::create_list(array, array + (N - 1), Tr());
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+template <class Tr, class Cont, std::size_t N>
+struct ListSourceTraits<Tr, const Cont[N]> : ListSourceTraits<Tr, Cont[N]>
+{
+};
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+/**
+ * @ingroup ContHelpers
+ */
+template <class Tr>
+class ListHandleIterator
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using iterator_category = std::forward_iterator_tag;
+ using value_type = CppType;
+ using difference_type = std::ptrdiff_t;
+ using reference = value_type;
+ using pointer = void;
+
+ explicit inline ListHandleIterator(const GList* node);
+
+ inline value_type operator*() const;
+ inline ListHandleIterator<Tr>& operator++();
+ inline const ListHandleIterator<Tr> operator++(int);
+
+ inline bool operator==(const ListHandleIterator<Tr>& rhs) const;
+ inline bool operator!=(const ListHandleIterator<Tr>& rhs) const;
+
+private:
+ const GList* node_;
+};
+
+} // namespace Container_Helpers
+
+// TODO: Remove this when we can break glibmm API.
+/** This is an intermediate type. When a method takes this, or returns this, you
+ * should use a standard C++ container of your choice, such as std::list or
+ * std::vector.
+ *
+ * However, this is not used in new API. We now prefer to just use std::vector,
+ * which is less flexibile, but makes the API clearer.
+ *
+ * @ingroup ContHandles
+ */
+template <class T, class Tr = Glib::Container_Helpers::TypeTraits<T>>
+class ListHandle
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using value_type = CppType;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using const_iterator = Glib::Container_Helpers::ListHandleIterator<Tr>;
+ using iterator = Glib::Container_Helpers::ListHandleIterator<Tr>;
+
+ template <class Cont>
+ inline ListHandle(const Cont& container);
+
+ // Take over ownership of an array created by GTK+ functions.
+ inline ListHandle(GList* glist, Glib::OwnershipType ownership);
+
+ // Copying clears the ownership flag of the source handle.
+ inline ListHandle(const ListHandle<T, Tr>& other);
+
+ ~ListHandle() noexcept;
+
+ inline const_iterator begin() const;
+ inline const_iterator end() const;
+
+ template <class U>
+ inline operator std::vector<U>() const;
+ template <class U>
+ inline operator std::deque<U>() const;
+ template <class U>
+ inline operator std::list<U>() const;
+
+ template <class Cont>
+ inline void assign_to(Cont& container) const;
+
+ template <class Out>
+ inline void copy(Out pdest) const;
+
+ inline GList* data() const;
+ inline std::size_t size() const;
+ inline bool empty() const;
+
+private:
+ GList* plist_;
+ mutable Glib::OwnershipType ownership_;
+
+ // No copy assignment.
+ ListHandle<T, Tr>& operator=(const ListHandle<T, Tr>&);
+};
+
+/***************************************************************************/
+/* Inline implementation */
+/***************************************************************************/
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+namespace Container_Helpers
+{
+
+/**** Glib::Container_Helpers::ListHandleIterator<> ************************/
+
+template <class Tr>
+inline ListHandleIterator<Tr>::ListHandleIterator(const GList* node) : node_(node)
+{
+}
+
+template <class Tr>
+inline typename ListHandleIterator<Tr>::value_type ListHandleIterator<Tr>::operator*() const
+{
+ return Tr::to_cpp_type(static_cast<typename Tr::CTypeNonConst>(node_->data));
+}
+
+template <class Tr>
+inline ListHandleIterator<Tr>& ListHandleIterator<Tr>::operator++()
+{
+ node_ = node_->next;
+ return *this;
+}
+
+template <class Tr>
+inline const ListHandleIterator<Tr> ListHandleIterator<Tr>::operator++(int)
+{
+ const ListHandleIterator<Tr> tmp(*this);
+ node_ = node_->next;
+ return tmp;
+}
+
+template <class Tr>
+inline bool
+ListHandleIterator<Tr>::operator==(const ListHandleIterator<Tr>& rhs) const
+{
+ return (node_ == rhs.node_);
+}
+
+template <class Tr>
+inline bool
+ListHandleIterator<Tr>::operator!=(const ListHandleIterator<Tr>& rhs) const
+{
+ return (node_ != rhs.node_);
+}
+
+} // namespace Container_Helpers
+
+/**** Glib::ListHandle<> ***************************************************/
+
+template <class T, class Tr>
+template <class Cont>
+inline ListHandle<T, Tr>::ListHandle(const Cont& container)
+: plist_(Glib::Container_Helpers::ListSourceTraits<Tr, Cont>::get_data(container)),
+ ownership_(Glib::Container_Helpers::ListSourceTraits<Tr, Cont>::initial_ownership)
+{
+}
+
+template <class T, class Tr>
+inline ListHandle<T, Tr>::ListHandle(GList* glist, Glib::OwnershipType ownership)
+: plist_(glist), ownership_(ownership)
+{
+}
+
+template <class T, class Tr>
+inline ListHandle<T, Tr>::ListHandle(const ListHandle<T, Tr>& other)
+: plist_(other.plist_), ownership_(other.ownership_)
+{
+ other.ownership_ = Glib::OWNERSHIP_NONE;
+}
+
+template <class T, class Tr>
+ListHandle<T, Tr>::~ListHandle() noexcept
+{
+ if (ownership_ != Glib::OWNERSHIP_NONE)
+ {
+ if (ownership_ != Glib::OWNERSHIP_SHALLOW)
+ {
+ // Deep ownership: release each container element.
+ for (GList* node = plist_; node != nullptr; node = node->next)
+ Tr::release_c_type(static_cast<typename Tr::CTypeNonConst>(node->data));
+ }
+ g_list_free(plist_);
+ }
+}
+
+template <class T, class Tr>
+inline typename ListHandle<T, Tr>::const_iterator
+ListHandle<T, Tr>::begin() const
+{
+ return Glib::Container_Helpers::ListHandleIterator<Tr>(plist_);
+}
+
+template <class T, class Tr>
+inline typename ListHandle<T, Tr>::const_iterator
+ListHandle<T, Tr>::end() const
+{
+ return Glib::Container_Helpers::ListHandleIterator<Tr>(nullptr);
+}
+
+template <class T, class Tr>
+template <class U>
+inline ListHandle<T, Tr>::operator std::vector<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::vector<U>(this->begin(), this->end());
+#else
+ std::vector<U> temp;
+ temp.reserve(this->size());
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline ListHandle<T, Tr>::operator std::deque<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::deque<U>(this->begin(), this->end());
+#else
+ std::deque<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline ListHandle<T, Tr>::operator std::list<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::list<U>(this->begin(), this->end());
+#else
+ std::list<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class Cont>
+inline void
+ListHandle<T, Tr>::assign_to(Cont& container) const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ container.assign(this->begin(), this->end());
+#else
+ Cont temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ container.swap(temp);
+#endif
+}
+
+template <class T, class Tr>
+template <class Out>
+inline void
+ListHandle<T, Tr>::copy(Out pdest) const
+{
+ std::copy(this->begin(), this->end(), pdest);
+}
+
+template <class T, class Tr>
+inline GList*
+ListHandle<T, Tr>::data() const
+{
+ return plist_;
+}
+
+template <class T, class Tr>
+inline std::size_t
+ListHandle<T, Tr>::size() const
+{
+ return g_list_length(plist_);
+}
+
+template <class T, class Tr>
+inline bool
+ListHandle<T, Tr>::empty() const
+{
+ return (plist_ == nullptr);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} // namespace Glib
+
+#endif /* _GLIBMM_LISTHANDLE_H */
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmmconfig.h> // May define GLIBMM_DISABLE_DEPRECATED
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+// Include glibmm/thread.h first because we need it to be first to include <glib.h>,
+// so we can do an undef trick to still use deprecated API in the header:
+#include <glibmm/thread.h>
+#include <glibmm/threads.h>
+#endif // GLIBMM_DISABLE_DEPRECATED
+
#include <glibmm/main.h>
#include <glibmm/exceptionhandler.h>
#include <glibmm/wrap.h>
#include <glibmm/iochannel.h>
#include <glibmm/utility.h>
#include <algorithm>
+#include <map> // Needed until the next ABI break.
namespace
{
-// Convert an interval from milliseconds to microseconds,
-// suitable for adding to Source::get_time().
-inline gint64 ms2us(unsigned int ms)
-{
- return static_cast<gint64>(ms) * 1000;
-}
+void
+time64_to_time_val(gint64 time64, Glib::TimeVal& time_val)
+{
+ // This function is not guaranteed to convert correctly if time64 is negative.
+ const long seconds = static_cast<long>(time64 / G_GINT64_CONSTANT(1000000));
+ const long microseconds =
+ static_cast<long>(time64 - static_cast<gint64>(seconds) * G_GINT64_CONSTANT(1000000));
+ time_val = Glib::TimeVal(seconds, microseconds);
+}
+
+// TODO: At the next ABI break, replace ExtraSourceData by new data members in Source.
+// Then the mutex is not necessary, but to keep the code thread-safe, use the
+// g_atomic_*() functions on these data elements.
+// These are new data members that can't be added to Glib::Source now,
+// because it would break ABI.
+struct ExtraSourceData
+{
+ ExtraSourceData() : ref_count(1), keep_wrapper(2) {}
+ int ref_count;
+ // When both Source::unreference() and SourceCallbackData::destroy_notify_callback()
+ // have decreased keep_wrapper, it's time to delete the C++ wrapper.
+ int keep_wrapper;
+};
+
+std::map<const Glib::Source*, ExtraSourceData> extra_source_data;
+// Source instances may be used in different threads.
+// Accesses to extra_source_data must be thread-safe.
+std::mutex extra_source_data_mutex;
-class SourceConnectionNode : public sigc::notifiable
+class SourceConnectionNode
{
public:
explicit inline SourceConnectionNode(const sigc::slot_base& slot);
- static void notify(sigc::notifiable* data);
- static void destroy_notify_callback(sigc::notifiable* data);
+ static void* notify(void* data);
+ static void destroy_notify_callback(void* data);
inline void install(GSource* source);
inline sigc::slot_base* get_slot();
slot_.set_parent(this, &SourceConnectionNode::notify);
}
-void
-SourceConnectionNode::notify(sigc::notifiable* data)
+void*
+SourceConnectionNode::notify(void* data)
{
SourceConnectionNode* const self = static_cast<SourceConnectionNode*>(data);
// Destroying the object triggers execution of destroy_notify_handler(),
// either immediately or later, so we leave that to do the deletion.
}
+
+ return nullptr;
}
// static
void
-SourceConnectionNode::destroy_notify_callback(sigc::notifiable* data)
+SourceConnectionNode::destroy_notify_callback(void* data)
{
SourceConnectionNode* const self = static_cast<SourceConnectionNode*>(data);
if (self->node)
SourceConnectionNode::destroy_notify_callback(self->node);
- // destroy_notify_callback2() does nothing if self->wrapper == nullptr.
- Glib::Source::destroy_notify_callback2(self->wrapper);
+ if (self->wrapper)
+ {
+ std::unique_lock<std::mutex> lock(extra_source_data_mutex);
+ if (--extra_source_data[self->wrapper].keep_wrapper == 0)
+ {
+ // No other reference exists to the wrapper. Delete it!
+ extra_source_data.erase(self->wrapper);
+ lock.unlock();
+ Glib::Source::destroy_notify_callback(self->wrapper);
+ }
+ }
delete self;
}
try
{
// Recreate the specific slot from the generic slot node.
- return (*static_cast<sigc::slot<bool()>*>(conn_data->get_slot()))();
+ return (*static_cast<sigc::slot<bool>*>(conn_data->get_slot()))();
}
catch (...)
{
try
{
// Recreate the specific slot from the generic slot node.
- (*static_cast<sigc::slot<void()>*>(conn_data->get_slot()))();
+ (*static_cast<sigc::slot<void>*>(conn_data->get_slot()))();
}
catch (...)
{
return 0; // Destroy the event source after one call
}
-static void
-glibmm_source_destroy_notify_callback(void* data)
-{
- SourceConnectionNode* const conn_data = static_cast<SourceConnectionNode*>(data);
- SourceConnectionNode::destroy_notify_callback(conn_data);
-}
-
static gboolean
glibmm_iosource_callback(GIOChannel*, GIOCondition condition, void* data)
{
try
{
// Recreate the specific slot from the generic slot node.
- return (*static_cast<sigc::slot<bool(Glib::IOCondition)>*>(callback_data->node->get_slot()))(
+ return (*static_cast<sigc::slot<bool, Glib::IOCondition>*>(callback_data->node->get_slot()))(
(Glib::IOCondition)condition);
}
catch (...)
try
{
// Recreate the specific slot from the generic slot node.
- (*static_cast<sigc::slot<void(GPid, int)>*>(conn_data->get_slot()))(pid, child_status);
+ (*static_cast<sigc::slot<void, GPid, int>*>(conn_data->get_slot()))(pid, child_status);
}
catch (...)
{
static void
glibmm_signal_connect_once(
- const sigc::slot<void()>& slot, int priority, GSource* source, GMainContext* context)
+ const sigc::slot<void>& slot, int priority, GSource* source, GMainContext* context)
{
SourceConnectionNode* const conn_node = new SourceConnectionNode(slot);
g_source_set_priority(source, priority);
g_source_set_callback(source, &glibmm_source_callback_once, conn_node,
- &glibmm_source_destroy_notify_callback);
+ &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context);
try
{
// Recreate the specific slot from the generic slot node.
- return (*static_cast<sigc::slot<bool()>*>(slot))();
+ return (*static_cast<sigc::slot<bool>*>(slot))();
}
catch (...)
{
PollFD::PollFD(PollFD::fd_t fd, IOCondition events)
{
gobject_.fd = fd;
- gobject_.events = static_cast<decltype(gobject_.events)>(events);
+ gobject_.events = events;
gobject_.revents = 0;
}
/* Note that this is our equivalent of g_timeout_add(). */
sigc::connection
-SignalTimeout::connect(const sigc::slot<bool()>& slot, unsigned int interval, int priority)
+SignalTimeout::connect(const sigc::slot<bool>& slot, unsigned int interval, int priority)
{
SourceConnectionNode* const conn_node = new SourceConnectionNode(slot);
const sigc::connection connection(*conn_node->get_slot());
g_source_set_priority(source, priority);
g_source_set_callback(
- source, &glibmm_source_callback, conn_node,
- &glibmm_source_destroy_notify_callback);
+ source, &glibmm_source_callback, conn_node, &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context_);
}
void
-SignalTimeout::connect_once(const sigc::slot<void()>& slot, unsigned int interval, int priority)
+SignalTimeout::connect_once(const sigc::slot<void>& slot, unsigned int interval, int priority)
{
GSource* const source = g_timeout_source_new(interval);
glibmm_signal_connect_once(slot, priority, source, context_);
/* Note that this is our equivalent of g_timeout_add_seconds(). */
sigc::connection
-SignalTimeout::connect_seconds(const sigc::slot<bool()>& slot, unsigned int interval, int priority)
+SignalTimeout::connect_seconds(const sigc::slot<bool>& slot, unsigned int interval, int priority)
{
SourceConnectionNode* const conn_node = new SourceConnectionNode(slot);
const sigc::connection connection(*conn_node->get_slot());
g_source_set_priority(source, priority);
g_source_set_callback(
- source, &glibmm_source_callback, conn_node,
- &glibmm_source_destroy_notify_callback);
+ source, &glibmm_source_callback, conn_node, &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context_);
void
SignalTimeout::connect_seconds_once(
- const sigc::slot<void()>& slot, unsigned int interval, int priority)
+ const sigc::slot<void>& slot, unsigned int interval, int priority)
{
GSource* const source = g_timeout_source_new_seconds(interval);
glibmm_signal_connect_once(slot, priority, source, context_);
}
sigc::connection
-SignalIdle::connect(const sigc::slot<bool()>& slot, int priority)
+SignalIdle::connect(const sigc::slot<bool>& slot, int priority)
{
SourceConnectionNode* const conn_node = new SourceConnectionNode(slot);
const sigc::connection connection(*conn_node->get_slot());
g_source_set_priority(source, priority);
g_source_set_callback(
- source, &glibmm_source_callback, conn_node,
- &glibmm_source_destroy_notify_callback);
+ source, &glibmm_source_callback, conn_node, &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context_);
}
void
-SignalIdle::connect_once(const sigc::slot<void()>& slot, int priority)
+SignalIdle::connect_once(const sigc::slot<void>& slot, int priority)
{
GSource* const source = g_idle_source_new();
glibmm_signal_connect_once(slot, priority, source, context_);
sigc::connection
SignalIO::connect(
- const sigc::slot<bool(IOCondition)>& slot, PollFD::fd_t fd, IOCondition condition, int priority)
+ const sigc::slot<bool, IOCondition>& slot, PollFD::fd_t fd, IOCondition condition, int priority)
{
const auto source = IOSource::create(fd, condition);
}
sigc::connection
-SignalIO::connect(const sigc::slot<bool(IOCondition)>& slot, const Glib::RefPtr<IOChannel>& channel,
+SignalIO::connect(const sigc::slot<bool, IOCondition>& slot, const Glib::RefPtr<IOChannel>& channel,
IOCondition condition, int priority)
{
const auto source = IOSource::create(channel, condition);
}
sigc::connection
-SignalChildWatch::connect(const sigc::slot<void(GPid, int)>& slot, GPid pid, int priority)
+SignalChildWatch::connect(const sigc::slot<void, GPid, int>& slot, GPid pid, int priority)
{
SourceConnectionNode* const conn_node = new SourceConnectionNode(slot);
const sigc::connection connection(*conn_node->get_slot());
g_source_set_priority(source, priority);
g_source_set_callback(source, Glib::function_pointer_cast<GSourceFunc>(&glibmm_child_watch_callback),
- conn_node,
- &glibmm_source_destroy_notify_callback);
+ conn_node, &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context_);
Glib::RefPtr<MainContext>
MainContext::create()
{
- return Glib::make_refptr_for_instance<MainContext>(reinterpret_cast<MainContext*>(g_main_context_new()));
+ return Glib::RefPtr<MainContext>(reinterpret_cast<MainContext*>(g_main_context_new()));
}
// static
return g_main_context_acquire(gobj());
}
+#ifndef GLIBMM_DISABLE_DEPRECATED
+G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+bool
+MainContext::wait(Glib::Cond& cond, Glib::Mutex& mutex)
+{
+ return g_main_context_wait(gobj(), cond.gobj(), mutex.gobj());
+}
+
+bool
+MainContext::wait(Glib::Threads::Cond& cond, Glib::Threads::Mutex& mutex)
+{
+ return g_main_context_wait(gobj(), cond.gobj(), mutex.gobj());
+}
+G_GNUC_END_IGNORE_DEPRECATIONS
+#endif // GLIBMM_DISABLE_DEPRECATED
+
void
MainContext::release()
{
}
void
-MainContext::invoke(const sigc::slot<bool()>& slot, int priority)
+MainContext::invoke(const sigc::slot<bool>& slot, int priority)
{
// Make a copy of slot on the heap.
- sigc::slot_base* const slot_copy = new sigc::slot<bool()>(slot);
+ sigc::slot_base* const slot_copy = new sigc::slot<bool>(slot);
g_main_context_invoke_full(gobj(), priority, glibmm_main_context_invoke_callback, slot_copy,
glibmm_main_context_invoke_destroy_notify_callback);
if (take_copy && gobject)
g_main_context_ref(gobject);
- return Glib::make_refptr_for_instance<MainContext>(reinterpret_cast<MainContext*>(gobject));
+ return Glib::RefPtr<MainContext>(reinterpret_cast<MainContext*>(gobject));
}
/**** Glib::MainLoop *******************************************************/
Glib::RefPtr<MainLoop>
MainLoop::create(bool is_running)
{
- return Glib::make_refptr_for_instance<MainLoop>(reinterpret_cast<MainLoop*>(g_main_loop_new(nullptr, is_running)));
+ return Glib::RefPtr<MainLoop>(reinterpret_cast<MainLoop*>(g_main_loop_new(nullptr, is_running)));
}
Glib::RefPtr<MainLoop>
MainLoop::create(const Glib::RefPtr<MainContext>& context, bool is_running)
{
- return Glib::make_refptr_for_instance<MainLoop>(
+ return Glib::RefPtr<MainLoop>(
reinterpret_cast<MainLoop*>(g_main_loop_new(Glib::unwrap(context), is_running)));
}
if (take_copy && gobject)
g_main_loop_ref(gobject);
- return Glib::make_refptr_for_instance<MainLoop>(reinterpret_cast<MainLoop*>(gobject));
+ return Glib::RefPtr<MainLoop>(reinterpret_cast<MainLoop*>(gobject));
}
/**** Glib::Source *********************************************************/
void
Source::reference() const
{
- ++ref_count_;
+ std::lock_guard<std::mutex> lock(extra_source_data_mutex);
+ ++extra_source_data[this].ref_count;
}
void
Source::unreference() const
{
- if (--ref_count_ == 0)
+ std::unique_lock<std::mutex> lock(extra_source_data_mutex);
+ if (--extra_source_data[this].ref_count == 0)
{
GSource* const tmp_gobject = gobject_;
- destroy_notify_callback2(const_cast<Source*>(this));
+ if (--extra_source_data[this].keep_wrapper == 0)
+ {
+ // The last reference from a RefPtr<Source> has been deleted, and
+ // SourceCallbackData::destroy_notify_callback() has been called while
+ // extra_source_data[this].keep_wrapper was > 1.
+ // Delete the wrapper!
+ extra_source_data.erase(this);
+ lock.unlock();
+ destroy_notify_callback(const_cast<Source*>(this));
+ }
+ else
+ lock.unlock();
// Drop the one and only GSource reference held by the C++ wrapper.
// If the GSource instance is attached to a main context, the GMainContext
g_source_remove_poll(gobject_, poll_fd.gobj());
}
+#ifndef GLIBMM_DISABLE_DEPRECATED
+G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+void
+Source::get_current_time(Glib::TimeVal& current_time)
+{
+ g_source_get_current_time(gobject_, ¤t_time);
+}
+G_GNUC_END_IGNORE_DEPRECATIONS
+#endif // GLIBMM_DISABLE_DEPRECATED
+
gint64
Source::get_time() const
{
// static
void
-Source::destroy_notify_callback2(void* data)
+Source::destroy_notify_callback(void* data)
{
if (data)
{
Source* const self = static_cast<Source*>(data);
- if (--self->keep_wrapper_ == 0)
- {
- // gobject_ is already invalid at this point.
- self->gobject_ = nullptr;
- // No exception checking: if the dtor throws, you're out of luck anyway.
- delete self;
- }
+ // gobject_ is already invalid at this point.
+ self->gobject_ = nullptr;
+
+ // No exception checking: if the dtor throws, you're out of luck anyway.
+ delete self;
}
}
g_source_set_priority(source, priority);
g_source_set_callback(
- source, callback_func, conn_node,
- &glibmm_source_destroy_notify_callback);
+ source, callback_func, conn_node, &SourceConnectionNode::destroy_notify_callback);
conn_node->install(source);
g_source_attach(source, context);
Glib::RefPtr<TimeoutSource>
TimeoutSource::create(unsigned int interval)
{
- return Glib::make_refptr_for_instance<TimeoutSource>(new TimeoutSource(interval));
+ return Glib::RefPtr<TimeoutSource>(new TimeoutSource(interval));
}
sigc::connection
-TimeoutSource::connect(const sigc::slot<bool()>& slot)
+TimeoutSource::connect(const sigc::slot<bool>& slot)
{
return connect_generic(slot);
}
TimeoutSource::TimeoutSource(unsigned int interval) : interval_(interval)
{
- expiration_ = get_time() + ms2us(interval_);
+ time64_to_time_val(get_time(), expiration_);
+ expiration_.add_milliseconds(std::min<unsigned long>(G_MAXLONG, interval_));
}
TimeoutSource::~TimeoutSource() noexcept
bool
TimeoutSource::prepare(int& timeout)
{
- gint64 remaining = expiration_ - get_time();
+ Glib::TimeVal current_time;
+ time64_to_time_val(get_time(), current_time);
+
+ Glib::TimeVal remaining = expiration_;
+ remaining.subtract(current_time);
- if (remaining <= 0)
+ if (remaining.negative())
{
// Already expired.
timeout = 0;
}
else
{
+ const unsigned long milliseconds = static_cast<unsigned long>(remaining.tv_sec) * 1000U +
+ static_cast<unsigned long>(remaining.tv_usec) / 1000U;
+
// Set remaining milliseconds.
- timeout = std::min<gint64>(G_MAXINT, remaining / 1000);
+ timeout = std::min<unsigned long>(G_MAXINT, milliseconds);
// Check if the system time has been set backwards. (remaining > interval)
- if (remaining > ms2us(interval_))
+ remaining.add_milliseconds(-std::min<unsigned long>(G_MAXLONG, interval_) - 1);
+ if (!remaining.negative())
{
// Oh well. Reset the expiration time to now + interval;
// this at least avoids hanging for long periods of time.
- expiration_ = get_time() + ms2us(interval_);
+ expiration_ = current_time;
+ expiration_.add_milliseconds(interval_);
timeout = std::min<unsigned int>(G_MAXINT, interval_);
}
}
bool
TimeoutSource::check()
{
- return expiration_ <= get_time();
+ Glib::TimeVal current_time;
+ time64_to_time_val(get_time(), current_time);
+
+ return (expiration_ <= current_time);
}
bool
TimeoutSource::dispatch(sigc::slot_base* slot)
{
- const bool again = (*static_cast<sigc::slot<bool()>*>(slot))();
+ const bool again = (*static_cast<sigc::slot<bool>*>(slot))();
if (again)
- expiration_ = get_time() + ms2us(interval_);
+ {
+ time64_to_time_val(get_time(), expiration_);
+ expiration_.add_milliseconds(std::min<unsigned long>(G_MAXLONG, interval_));
+ }
return again;
}
Glib::RefPtr<IdleSource>
IdleSource::create()
{
- return Glib::make_refptr_for_instance<IdleSource>(new IdleSource());
+ return Glib::RefPtr<IdleSource>(new IdleSource());
}
sigc::connection
-IdleSource::connect(const sigc::slot<bool()>& slot)
+IdleSource::connect(const sigc::slot<bool>& slot)
{
return connect_generic(slot);
}
bool
IdleSource::dispatch(sigc::slot_base* slot)
{
- return (*static_cast<sigc::slot<bool()>*>(slot))();
+ return (*static_cast<sigc::slot<bool>*>(slot))();
}
/**** Glib::IOSource *******************************************************/
Glib::RefPtr<IOSource>
IOSource::create(PollFD::fd_t fd, IOCondition condition)
{
- return Glib::make_refptr_for_instance<IOSource>(new IOSource(fd, condition));
+ return Glib::RefPtr<IOSource>(new IOSource(fd, condition));
}
Glib::RefPtr<IOSource>
IOSource::create(const Glib::RefPtr<IOChannel>& channel, IOCondition condition)
{
- return Glib::make_refptr_for_instance<IOSource>(new IOSource(channel, condition));
-}
-
-Glib::RefPtr<IOSource>
-IOSource::create(GIOChannel* channel, IOCondition condition)
-{
- return Glib::make_refptr_for_instance<IOSource>(new IOSource(channel, condition));
+ return Glib::RefPtr<IOSource>(new IOSource(channel, condition));
}
sigc::connection
-IOSource::connect(const sigc::slot<bool(IOCondition)>& slot)
+IOSource::connect(const sigc::slot<bool, IOCondition>& slot)
{
return connect_generic(slot);
}
{
}
-IOSource::IOSource(GIOChannel* channel, IOCondition condition)
-: Source(g_io_create_watch(channel, (GIOCondition)condition),
- Glib::function_pointer_cast<GSourceFunc>(&glibmm_iosource_callback))
-{
-}
-
IOSource::IOSource(GSource* cast_item, GSourceFunc callback_func) : Source(cast_item, callback_func)
{
}
bool
IOSource::check()
{
- return static_cast<int>(poll_fd_.get_revents() & poll_fd_.get_events()) != 0;
+ return ((poll_fd_.get_revents() & poll_fd_.get_events()) != 0);
}
bool
IOSource::dispatch(sigc::slot_base* slot)
{
- return (*static_cast<sigc::slot<bool(IOCondition)>*>(slot))(poll_fd_.get_revents());
+ return (*static_cast<sigc::slot<bool, IOCondition>*>(slot))(poll_fd_.get_revents());
}
} // namespace Glib
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+#include <glibmmconfig.h>
#include <glibmm/refptr.h>
+#include <glibmm/timeval.h>
#include <glibmm/priorities.h>
#include <glibmm/iochannel.h>
#include <sigc++/sigc++.h>
#include <vector>
#include <cstddef>
-#include <atomic>
namespace Glib
{
+#ifndef GLIBMM_DISABLE_DEPRECATED
+class Cond;
+class Mutex;
+
+namespace Threads
+{
+class Cond;
+class Mutex;
+}
+#endif // GLIBMM_DISABLE_DEPRECATED
+
/** @defgroup MainLoop The Main Event Loop
* Manages all available sources of events.
* @{
void set_fd(fd_t fd) { gobject_.fd = fd; }
fd_t get_fd() const { return gobject_.fd; }
- void set_events(IOCondition events) { gobject_.events = static_cast<decltype(gobject_.events)>(events); }
+ void set_events(IOCondition events) { gobject_.events = events; }
IOCondition get_events() const { return static_cast<IOCondition>(gobject_.events); }
- void set_revents(IOCondition revents) { gobject_.revents = static_cast<decltype(gobject_.revents)>(revents); }
+ void set_revents(IOCondition revents) { gobject_.revents = revents; }
IOCondition get_revents() const { return static_cast<IOCondition>(gobject_.revents); }
GPollFD* gobj() { return &gobject_; }
GPollFD gobject_;
};
+// Concerning SignalTimeout::connect_once(), SignalTimeout::connect_seconds_once()
+// and SignalIdle::connect_once():
+// See https://bugzilla.gnome.org/show_bug.cgi?id=396963 and
+// http://bugzilla.gnome.org/show_bug.cgi?id=512348 about the sigc::trackable issue.
+// It's recommended to replace sigc::slot<void>& by std::function<void()>& in
+// Threads::Thread::create() and ThreadPool::push() at the next ABI break.
+// Such a replacement would be a mixed blessing in SignalTimeout and SignalIdle.
+// In a single-threaded program auto-disconnection of trackable slots is safe
+// and can be useful.
+
class SignalTimeout
{
public:
* @return A connection handle, which can be used to disconnect the handler.
*/
sigc::connection connect(
- const sigc::slot<bool()>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
+ const sigc::slot<bool>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
/** Connects a timeout handler that runs only once.
* This method takes a function pointer to a function with a void return
* @param priority The priority of the new event source.
*/
void connect_once(
- const sigc::slot<void()>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
+ const sigc::slot<void>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
/** Connects a timeout handler with whole second granularity.
*
* @newin{2,14}
*/
sigc::connection connect_seconds(
- const sigc::slot<bool()>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
+ const sigc::slot<bool>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
/** Connects a timeout handler that runs only once with whole second
* granularity.
* @param priority The priority of the new event source.
*/
void connect_seconds_once(
- const sigc::slot<void()>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
+ const sigc::slot<void>& slot, unsigned int interval, int priority = PRIORITY_DEFAULT);
private:
GMainContext* context_;
* @param priority The priority of the new event source.
* @return A connection handle, which can be used to disconnect the handler.
*/
- sigc::connection connect(const sigc::slot<bool()>& slot, int priority = PRIORITY_DEFAULT_IDLE);
+ sigc::connection connect(const sigc::slot<bool>& slot, int priority = PRIORITY_DEFAULT_IDLE);
/** Connects an idle handler that runs only once.
* This method takes a function pointer to a function with a void return
* @endcode
* @param priority The priority of the new event source.
*/
- void connect_once(const sigc::slot<void()>& slot, int priority = PRIORITY_DEFAULT_IDLE);
+ void connect_once(const sigc::slot<void>& slot, int priority = PRIORITY_DEFAULT_IDLE);
private:
GMainContext* context_;
* @param priority The priority of the new event source.
* @return A connection handle, which can be used to disconnect the handler.
*/
- sigc::connection connect(const sigc::slot<bool(IOCondition)>& slot, PollFD::fd_t fd, IOCondition condition,
+ sigc::connection connect(const sigc::slot<bool, IOCondition>& slot, PollFD::fd_t fd, IOCondition condition,
int priority = PRIORITY_DEFAULT);
/** Connects an I/O handler that watches an I/O channel.
* @param priority The priority of the new event source.
* @return A connection handle, which can be used to disconnect the handler.
*/
- sigc::connection connect(const sigc::slot<bool(IOCondition)>& slot,
+ sigc::connection connect(const sigc::slot<bool, IOCondition>& slot,
const Glib::RefPtr<IOChannel>& channel, IOCondition condition, int priority = PRIORITY_DEFAULT);
private:
* @return A connection handle, which can be used to disconnect the handler.
*/
sigc::connection connect(
- const sigc::slot<void(GPid, int)>& slot, GPid pid, int priority = PRIORITY_DEFAULT);
+ const sigc::slot<void, GPid, int>& slot, GPid pid, int priority = PRIORITY_DEFAULT);
private:
GMainContext* context_;
*/
bool acquire();
+#ifndef GLIBMM_DISABLE_DEPRECATED
+ /** Tries to become the owner of the specified context, as with acquire().
+ * But if another thread is the owner, atomically drop mutex and wait on cond
+ * until that owner releases ownership or until cond is signaled, then try
+ * again (once) to become the owner.
+ * @param cond A condition variable.
+ * @param mutex A mutex, currently held.
+ * @return true if the operation succeeded, and this thread is now the owner of context.
+ *
+ * @deprecated Use the underlying g_main_context_is_owner() function
+ * and separate locking, if you really need this functionality.
+ */
+ bool wait(Glib::Cond& cond, Glib::Mutex& mutex);
+
+ /** Tries to become the owner of the specified context, as with acquire().
+ * But if another thread is the owner, atomically drop mutex and wait on cond
+ * until that owner releases ownership or until cond is signaled, then try
+ * again (once) to become the owner.
+ * @param cond A condition variable.
+ * @param mutex A mutex, currently held.
+ * @return true if the operation succeeded, and this thread is now the owner of context.
+ *
+ * @deprecated Use the underlying g_main_context_is_owner() function
+ * and separate locking, if you really need this functionality.
+ */
+ bool wait(Glib::Threads::Cond& cond, Glib::Threads::Mutex& mutex);
+#endif // GLIBMM_DISABLE_DEPRECATED
+
/** Releases ownership of a context previously acquired by this thread with acquire(). If the
* context was acquired
* multiple times, the only release ownership when release() is called as many times as it was
*
* @newin{2,38}
*/
- void invoke(const sigc::slot<bool()>& slot, int priority = PRIORITY_DEFAULT);
+ void invoke(const sigc::slot<bool>& slot, int priority = PRIORITY_DEFAULT);
/** Timeout signal, attached to this MainContext.
* @return A signal proxy; you want to use SignalTimeout::connect().
*/
void remove_poll(PollFD& poll_fd);
+#ifndef GLIBMM_DISABLE_DEPRECATED
+ /** Gets the "current time" to be used when checking this source.
+ *
+ * @param[out] current_time Glib::TimeVal in which to store current time.
+ *
+ * @deprecated Use get_time() instead.
+ */
+ void get_current_time(Glib::TimeVal& current_time);
+#endif // GLIBMM_DISABLE_DEPRECATED
+
// TODO: Remove mention of g_get_monotonic time when we wrap it in C++.
/** Gets the time to be used when checking this source. The advantage of
* calling this function over calling g_get_monotonic_time() directly is
private:
GSource* gobject_;
- mutable std::atomic_int ref_count_ {1};
- // The C++ wrapper (the Source instance) is deleted, when both Source::unreference()
- // and SourceCallbackData::destroy_notify_callback() have decreased keep_wrapper_
- // by calling destroy_notify_callback2().
- // https://bugzilla.gnome.org/show_bug.cgi?id=561885
- std::atomic_int keep_wrapper_ {2};
-
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static inline Source* get_wrapper(GSource* source);
static gboolean dispatch_vfunc(GSource* source, GSourceFunc callback, void* user_data);
public:
- // Really destroys the object during the second call. See keep_wrapper_.
- static void destroy_notify_callback2(void* data);
+ static void destroy_notify_callback(void* data);
// Used by SignalXyz, possibly in other files.
static sigc::connection attach_signal_source(const sigc::slot_base& slot, int priority,
GSource* source, GMainContext* context, GSourceFunc callback_func);
using CppObjectType = Glib::TimeoutSource;
static Glib::RefPtr<TimeoutSource> create(unsigned int interval);
- sigc::connection connect(const sigc::slot<bool()>& slot);
+ sigc::connection connect(const sigc::slot<bool>& slot);
protected:
explicit TimeoutSource(unsigned int interval);
bool dispatch(sigc::slot_base* slot) override;
private:
- gint64 expiration_; // microseconds
- unsigned int interval_; // milliseconds
+ // TODO: Replace with gint64, because TimeVal is deprecated, when we can break ABI.
+ Glib::TimeVal expiration_;
+
+ unsigned int interval_;
};
class IdleSource : public Glib::Source
using CppObjectType = Glib::IdleSource;
static Glib::RefPtr<IdleSource> create();
- sigc::connection connect(const sigc::slot<bool()>& slot);
+ sigc::connection connect(const sigc::slot<bool>& slot);
protected:
IdleSource();
static Glib::RefPtr<IOSource> create(PollFD::fd_t fd, IOCondition condition);
static Glib::RefPtr<IOSource> create(
const Glib::RefPtr<IOChannel>& channel, IOCondition condition);
- sigc::connection connect(const sigc::slot<bool(IOCondition)>& slot);
+ sigc::connection connect(const sigc::slot<bool, IOCondition>& slot);
protected:
IOSource(PollFD::fd_t fd, IOCondition condition);
bool dispatch(sigc::slot_base* slot) override;
private:
- friend IOChannel;
-
- // This is just to avoid the need for Gio::Socket to create a RefPtr<> to itself.
- static Glib::RefPtr<IOSource> create(GIOChannel* channel, IOCondition condition);
-
- // This is just to avoid the need for Gio::Socket to create a RefPtr<> to itself.
- IOSource(GIOChannel* channel, IOCondition condition);
-
PollFD poll_fd_;
};
#include <string.h>
+// Weak references:
+// I'm not sure what the point of these are apart from being a hacky way out of circular references,
+// but maybe we could make it easier to use them by making a Java Reference Object -style class like
+// so:
+// Glib::WeakRef<SomeDerivedObject> weakrefSomeObject(object1);
+// ...
+// if(weakrefSomeObject->isStillAlive())
+// {
+// weakrefSomeObject->some_method();
+// }
+// else
+// {
+// //Deal with it, maybe recreating the object.
+// }
+//
+// Without this, the coder has to define his own signal handler which sets his own isStillAlive
+// boolean.
+// weakrefSomeObject<> could still have its own signal_destroyed signal so that coders can choose to
+// deal
+// with the destruction as soon as it happens instead of just checking later before they try to use
+// it.
+
namespace Glib
{
ConstructParams::ConstructParams(const Glib::Class& glibmm_class_)
-: glibmm_class(glibmm_class_), n_parameters(0), parameter_names(nullptr), parameter_values(nullptr)
+: glibmm_class(glibmm_class_), n_parameters(0), parameters(nullptr)
{
}
*/
ConstructParams::ConstructParams(
const Glib::Class& glibmm_class_, const char* first_property_name, ...)
-: glibmm_class(glibmm_class_), n_parameters(0), parameter_names(nullptr), parameter_values(nullptr)
+: glibmm_class(glibmm_class_), n_parameters(0), parameters(nullptr)
{
va_list var_args;
va_start(var_args, first_property_name);
break;
}
- if (n_parameters >= n_alloced_params) {
- n_alloced_params += 8;
- parameter_names = g_renew(const char*, parameter_names, n_alloced_params);
- parameter_values = g_renew(GValue, parameter_values, n_alloced_params);
- }
+ if (n_parameters >= n_alloced_params)
+ parameters = g_renew(GParameter, parameters, n_alloced_params += 8);
- auto& param_name = parameter_names[n_parameters];
- auto& param_value = parameter_values[n_parameters];
- param_name = name;
- param_value.g_type = 0;
+ GParameter& param = parameters[n_parameters];
+
+ param.name = name;
+ param.value.g_type = 0;
// Fill the GValue with the current vararg, and move on to the next one.
- g_value_init(¶m_value, G_PARAM_SPEC_VALUE_TYPE(pspec));
- G_VALUE_COLLECT(¶m_value, var_args, 0, &collect_error);
+ g_value_init(¶m.value, G_PARAM_SPEC_VALUE_TYPE(pspec));
+ G_VALUE_COLLECT(¶m.value, var_args, 0, &collect_error);
if (collect_error)
{
g_warning("Glib::ConstructParams::ConstructParams(): %s", collect_error);
g_free(collect_error);
- g_value_unset(¶m_value);
+ g_value_unset(¶m.value);
break;
}
ConstructParams::~ConstructParams() noexcept
{
- while (n_parameters > 0) {
- auto& param_value = parameter_values[--n_parameters];
- g_value_unset(¶m_value);
- }
+ while (n_parameters > 0)
+ g_value_unset(¶meters[--n_parameters].value);
- g_free(parameter_names);
- g_free(parameter_values);
+ g_free(parameters);
+}
+
+/*
+ * Some compilers require the existence of a copy constructor in certain
+ * usage contexts. This implementation is fully functional, but unlikely
+ * to be ever actually called due to optimization.
+ */
+ConstructParams::ConstructParams(const ConstructParams& other)
+: glibmm_class(other.glibmm_class),
+ n_parameters(other.n_parameters),
+ parameters(g_new(GParameter, n_parameters))
+{
+ for (unsigned int i = 0; i < n_parameters; ++i)
+ {
+ parameters[i].name = other.parameters[i].name;
+ parameters[i].value.g_type = 0;
+
+ g_value_init(¶meters[i].value, G_VALUE_TYPE(&other.parameters[i].value));
+ g_value_copy(&other.parameters[i].value, ¶meters[i].value);
+ }
}
/**** Glib::Object_Class ***************************************************/
if (custom_type_name_ && !is_anonymous_custom_())
{
object_class_.init();
-
// This creates a type that is derived (indirectly) from GObject.
object_type = object_class_.clone_custom_type(custom_type_name_,
get_custom_interface_classes(), get_custom_class_init_functions(),
custom_class_init_finished();
}
- GObject* const new_object = g_object_new_with_properties(object_type, 0, nullptr, nullptr);
+ void* const new_object = g_object_new(object_type, nullptr);
// Connect the GObject and Glib::Object instances.
- ObjectBase::initialize(new_object);
+ ObjectBase::initialize(static_cast<GObject*>(new_object));
}
Object::Object(const Glib::ConstructParams& construct_params)
// This works with custom types too, since those inherit the properties of
// their base class.
- GObject* const new_object =
- g_object_new_with_properties(object_type, construct_params.n_parameters, construct_params.parameter_names, construct_params.parameter_values);
+ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+ //TODO: Replace g_object_newv() by g_object_new_with_properties() when we can
+ // require glib 2.54. GParameter is also deprecated (only mentioned in a comment).
+ // Don't use it in ConstructParams when we can break ABI.
+ void* const new_object =
+ g_object_newv(object_type, construct_params.n_parameters, construct_params.parameters);
+ G_GNUC_END_IGNORE_DEPRECATIONS
// Connect the GObject and Glib::Object instances.
- ObjectBase::initialize(new_object);
+ ObjectBase::initialize(static_cast<GObject*>(new_object));
}
Object::Object(GObject* castitem)
/* ConstructParams::ConstructParams() takes a varargs list of properties
* and values, like g_object_new() does. This list will then be converted
- * to an array of parameter names and an array of parameter values,
- * for use with g_object_new_with_properties(). No overhead is
- * involved, since g_object_new() is just a wrapper around g_object_new_with_properties()
+ * to a GParameter array, for use with g_object_newv(). No overhead is
+ * involved, since g_object_new() is just a wrapper around g_object_newv()
* as well.
*
* The advantage of an auxiliary ConstructParams object over g_object_new()
public:
const Glib::Class& glibmm_class;
unsigned int n_parameters;
- const char ** parameter_names;
- GValue* parameter_values;
+ GParameter* parameters;
explicit ConstructParams(const Glib::Class& glibmm_class_);
ConstructParams(const Glib::Class& glibmm_class_, const char* first_property_name,
...) G_GNUC_NULL_TERMINATED; // warn if called without a trailing NULL pointer
~ConstructParams() noexcept;
- ConstructParams(const ConstructParams& other) = delete;
- ConstructParams& operator=(const ConstructParams&) = delete;
+ // The copy constructor is semantically required by the C++ compiler
+ // (since g++ 3.4) to be able to create temporary instances, depending
+ // on the usage context. Apparently the compiler will actually optimize
+ // away the copy, though. See bug #132300.
+ ConstructParams(const ConstructParams& other);
+
+private:
+ // no copy assignment
+ ConstructParams& operator=(const ConstructParams&);
};
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
// because that would be "dependent", and g++ 3.4 does not allow that.
// The specific Glib::wrap() overloads don't do anything special anyway.
GObject* cobj = (GObject*)const_cast<CTypeNonConst>(ptr);
- return Glib::make_refptr_for_instance<T>(dynamic_cast<T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
+ return Glib::RefPtr<T>(dynamic_cast<T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
// We use dynamic_cast<> in case of multiple inheritance.
}
// because that would be "dependent", and g++ 3.4 does not allow that.
// The specific Glib::wrap() overloads don't do anything special anyway.
GObject* cobj = (GObject*)(ptr);
- return Glib::make_refptr_for_instance<const T>(
+ return Glib::RefPtr<const T>(
dynamic_cast<const T*>(Glib::wrap_auto(cobj, true /* take_copy */)));
// We use dynamic_cast<> in case of multiple inheritance.
}
} // namespace Container_Helpers
-template <class PtrT>
+template <class T, class PtrT>
inline PtrT
-Value_Pointer<PtrT>::get_(Glib::Object*) const
+Value_Pointer<T, PtrT>::get_(Glib::Object*) const
{
return dynamic_cast<T*>(get_object());
}
static GType value_type() { return T::get_base_type(); }
- void set(const CppType& data) { set_object(data.get()); }
- CppType get() const { return std::dynamic_pointer_cast<T>(get_object_copy()); }
+ void set(const CppType& data) { set_object(data.operator->()); }
+ CppType get() const { return Glib::RefPtr<T>::cast_dynamic(get_object_copy()); }
};
// The SUN Forte Compiler has a problem with this:
static GType value_type() { return T::get_base_type(); }
- void set(const CppType& data) { set_object(const_cast<T*>(data.get())); }
- CppType get() const { return std::dynamic_pointer_cast<T>(get_object_copy()); }
+ void set(const CppType& data) { set_object(const_cast<T*>(data.operator->())); }
+ CppType get() const { return Glib::RefPtr<T>::cast_dynamic(get_object_copy()); }
};
#endif /* GLIBMM_HAVE_DISAMBIGUOUS_CONST_TEMPLATE_SPECIALIZATIONS */
/**** Glib::ObjectBase *****************************************************/
-// Used only during the construction of named custom types.
-struct ObjectBase::PrivImpl
-{
- // Pointers to the interfaces of custom types.
- Class::interface_classes_type custom_interface_classes;
- // Pointers to extra class init functions.
- Class::class_init_funcs_type custom_class_init_functions;
- // Pointer to the instance init function.
- GInstanceInitFunc custom_instance_init_function = nullptr;
-};
+// static data members
+ObjectBase::extra_object_base_data_type ObjectBase::extra_object_base_data;
+std::mutex ObjectBase::extra_object_base_data_mutex;
ObjectBase::ObjectBase()
: gobject_(nullptr),
}
ObjectBase::ObjectBase(const char* custom_type_name)
-: gobject_(nullptr), custom_type_name_(custom_type_name),
- cpp_destruction_in_progress_(false)
+: gobject_(nullptr), custom_type_name_(custom_type_name), cpp_destruction_in_progress_(false)
{
}
ObjectBase::ObjectBase(const std::type_info& custom_type_info)
-: gobject_(nullptr), custom_type_name_(custom_type_info.name()),
- cpp_destruction_in_progress_(false)
+: gobject_(nullptr), custom_type_name_(custom_type_info.name()), cpp_destruction_in_progress_(false)
{
}
// we have to call g_object_unref() on our own.
//
+ // Just a precaution. Unless a derived class's ctor has thrown an exception,
+ // 'this' should have been erased from extra_object_base_data by
+ // Glib::Object's constructor.
+ {
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ extra_object_base_data.erase(this);
+ }
+
if (GObject* const gobject = gobject_)
{
#ifdef GLIBMM_DEBUG_REFCOUNTING
(void*)cppObject, (void*)cppObject->gobject_, G_OBJECT_TYPE_NAME(cppObject->gobject_));
#endif
- if (cppObject) // This will be nullptr if the C++ destructor has already run.
+ if (cppObject) // This will be 0 if the C++ destructor has already run.
{
- cppObject->destroy_notify_(); // Virtual - it does different things for Glib::ObjectBase and Gtk::Object.
+ cppObject->destroy_notify_(); // Virtual - it does different things for GObject and GtkObject.
}
}
{
// The C instance is about to be disposed, making it unusable. Now is a
// good time to delete the C++ wrapper of the C instance. There is no way
-// to force the disposal of the GObject (though Gtk::Object::destroy_notify_()
-// can call g_object_run_dispose()), so this is the *only* place where we delete
-// the C++ wrapper.
+// to force the disposal of the GObject (though GtkObject has
+// gtk_object_destroy()), So this is the *only* place where we delete the
+// C++ wrapper.
//
// This will only happen after the last unreference(), which will be done by
// the RefPtr<> destructor. There should be no way to access the wrapper or
-// the underlying object instance after that, so it's OK to delete this.
+// the undobjecterlying instance after that, so it's OK to delete this.
#ifdef GLIBMM_DEBUG_REFCOUNTING
g_warning("Glib::ObjectBase::destroy_notify_: gobject_ = %p", (void*)gobject_);
g_object_get_property(const_cast<GObject*>(gobj()), property_name.c_str(), value.gobj());
}
-sigc::connection
+void
ObjectBase::connect_property_changed(
- const Glib::ustring& property_name, const sigc::slot<void()>& slot)
+ const Glib::ustring& property_name, const sigc::slot<void>& slot)
+{
+ connect_property_changed_with_return(property_name, slot);
+}
+
+void
+ObjectBase::connect_property_changed(const Glib::ustring& property_name, sigc::slot<void>&& slot)
+{
+ connect_property_changed_with_return(property_name, std::move(slot));
+}
+
+sigc::connection
+ObjectBase::connect_property_changed_with_return(
+ const Glib::ustring& property_name, const sigc::slot<void>& slot)
{
// Create a proxy to hold our connection info
// This will be deleted by destroy_notify_handler.
}
sigc::connection
-ObjectBase::connect_property_changed(
- const Glib::ustring& property_name, sigc::slot<void()>&& slot)
+ObjectBase::connect_property_changed_with_return(
+ const Glib::ustring& property_name, sigc::slot<void>&& slot)
{
// Create a proxy to hold our connection info
// This will be deleted by destroy_notify_handler.
void ObjectBase::add_custom_interface_class(const Interface_Class* iface_class)
{
- if (!priv_pimpl_)
- priv_pimpl_ = std::make_unique<PrivImpl>();
- priv_pimpl_->custom_interface_classes.emplace_back(iface_class);
+ // The GObject is not instantiated yet. Add to the custom_interface_classes
+ // and add the interface in the Glib::Object constructor.
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ extra_object_base_data[this].custom_interface_classes.emplace_back(iface_class);
}
void ObjectBase::add_custom_class_init_function(GClassInitFunc class_init_func, void* class_data)
{
- if (!priv_pimpl_)
- priv_pimpl_ = std::make_unique<PrivImpl>();
- priv_pimpl_->custom_class_init_functions.emplace_back(
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ extra_object_base_data[this].custom_class_init_functions.emplace_back(
std::make_tuple(class_init_func, class_data));
}
void ObjectBase::set_custom_instance_init_function(GInstanceInitFunc instance_init_func)
{
- if (!priv_pimpl_)
- priv_pimpl_ = std::make_unique<PrivImpl>();
- priv_pimpl_->custom_instance_init_function = instance_init_func;
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ extra_object_base_data[this].custom_instance_init_function = instance_init_func;
}
-const Class::interface_classes_type* ObjectBase::get_custom_interface_classes() const
+const Class::interface_class_vector_type* ObjectBase::get_custom_interface_classes() const
{
- return priv_pimpl_ ? &priv_pimpl_->custom_interface_classes : nullptr;
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ const auto iter = extra_object_base_data.find(this);
+ return (iter != extra_object_base_data.end()) ? &iter->second.custom_interface_classes : nullptr;
}
const Class::class_init_funcs_type* ObjectBase::get_custom_class_init_functions() const
{
- return priv_pimpl_ ? &priv_pimpl_->custom_class_init_functions : nullptr;
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ const auto iter = extra_object_base_data.find(this);
+ return (iter != extra_object_base_data.end()) ? &iter->second.custom_class_init_functions : nullptr;
}
GInstanceInitFunc ObjectBase::get_custom_instance_init_function() const
{
- return priv_pimpl_ ? priv_pimpl_->custom_instance_init_function : nullptr;
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ const auto iter = extra_object_base_data.find(this);
+ return (iter != extra_object_base_data.end()) ? iter->second.custom_instance_init_function : nullptr;
}
void ObjectBase::custom_class_init_finished()
{
- priv_pimpl_.reset();
+ std::lock_guard<std::mutex> lock(extra_object_base_data_mutex);
+ const auto iter = extra_object_base_data.find(this);
+ if (iter != extra_object_base_data.end())
+ extra_object_base_data.erase(iter);
}
/**** Global function *****************************************************/
#include <glibmm/debug.h>
#include <sigc++/trackable.h>
#include <typeinfo>
-#include <memory>
+#include <map> // Needed until the next ABI break.
+#include <memory> // Not used by ObjectBase any more, but user code may rely on it being here.
+#include <mutex>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" {
template <class PropertyType>
void get_property(const Glib::ustring& property_name, PropertyType& value) const;
- /// You probably want to use a specific property_*() accessor method instead.
- template <class PropertyType>
- PropertyType get_property(const Glib::ustring& property_name) const;
+ // TODO: At the next ABI break, delete connect_property_changed_with_return()
+ // and let connect_property_changed() return sigc::connection.
+ /** You can use the signal_changed() signal of the property proxy instead.
+ *
+ * See also connect_property_changed_with_return().
+ */
+ void connect_property_changed(const Glib::ustring& property_name, const sigc::slot<void>& slot);
+
+ /** You can use the signal_changed() signal of the property proxy instead.
+ *
+ * @newin{2,48}
+ */
+ void connect_property_changed(const Glib::ustring& property_name, sigc::slot<void>&& slot);
/** You can use the signal_changed() signal of the property proxy instead.
+ *
+ * This method was added because connect_property_changed() does not return a sigc::connection,
+ * and we could not break the ABI by changing that function.
*/
- sigc::connection connect_property_changed(const Glib::ustring& property_name, const sigc::slot<void()>& slot);
+ sigc::connection connect_property_changed_with_return(
+ const Glib::ustring& property_name, const sigc::slot<void>& slot);
/** You can use the signal_changed() signal of the property proxy instead.
*
* @newin{2,48}
*/
- sigc::connection connect_property_changed(const Glib::ustring& property_name, sigc::slot<void()>&& slot);
+ sigc::connection connect_property_changed_with_return(
+ const Glib::ustring& property_name, sigc::slot<void>&& slot);
/** Increases the freeze count on object. If the freeze count is non-zero, the
* emission of "notify" signals on object is stopped. The signals are queued
void add_custom_interface_class(const Interface_Class* iface_class);
void add_custom_class_init_function(GClassInitFunc class_init_func, void* class_data = nullptr);
void set_custom_instance_init_function(GInstanceInitFunc instance_init_func);
- const Class::interface_classes_type* get_custom_interface_classes() const;
+ const Class::interface_class_vector_type* get_custom_interface_classes() const;
const Class::class_init_funcs_type* get_custom_class_init_functions() const;
GInstanceInitFunc get_custom_instance_init_function() const;
void custom_class_init_finished();
private:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ virtual void set_manage(); // calls g_error()
+
+ // TODO: At the next ABI break, replace extra_object_base_data by a non-static
+ // data member.
// Private part of implementation.
// Used only during construction of named custom types.
- struct PrivImpl;
- std::unique_ptr<PrivImpl> priv_pimpl_;
-
- virtual void set_manage(); // calls g_error()
+ // This is a new data member that can't be added as instance data to
+ // ObjectBase now, because it would break ABI.
+ struct ExtraObjectBaseData
+ {
+ // Pointers to the interfaces of custom types.
+ Class::interface_class_vector_type custom_interface_classes;
+ // Pointers to extra class init functions.
+ Class::class_init_funcs_type custom_class_init_functions;
+ // Pointer to the instance init function.
+ GInstanceInitFunc custom_instance_init_function = nullptr;
+ };
+
+ using extra_object_base_data_type = std::map<const ObjectBase*, ExtraObjectBaseData>;
+ static extra_object_base_data_type extra_object_base_data;
+ // ObjectBase instances may be used in different threads.
+ // Accesses to extra_object_base_data must be thread-safe.
+ static std::mutex extra_object_base_data_mutex;
+#endif // DOXYGEN_SHOULD_SKIP_THIS
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
friend class Glib::GSigConnectionNode; // for GSigConnectionNode::notify()
-#endif // DOXYGEN_SHOULD_SKIP_THIS
+#endif
};
#ifndef DOXYGEN_SHOULD_SKIP_THIS
value = property_value.get();
}
-template <class PropertyType>
-inline PropertyType
-ObjectBase::get_property(const Glib::ustring& property_name) const
-{
- PropertyType value;
- get_property(property_name, value);
-
- return value;
-}
-
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
bool _gobject_cppinstance_already_deleted(GObject* gobject);
*
* This Property class currently supports the name, nick name, description default value and flags.
* The minimum and maximum bounds are set to the full range of the value.
- * Because of internal implementation, flags shouldn't be set to values: Glib::ParamFlags::STATIC_NAME,
- * Glib::ParamFlags::STATIC_NICK, Glib::ParamFlags::STATIC_BLURB, Glib::ParamFlags::CONSTRUCT and
- * Glib::ParamFlags::CONSTRUCT_ONLY.
+ * Because of internal implementation, flags shouldn't be set to values: Glib::PARAM_STATIC_NAME,
+ * Glib::PARAM_STATIC_NICK, Glib::PARAM_STATIC_BLURB, Glib::PARAM_CONSTRUCT and
+ * Glib::PARAM_CONSTRUCT_ONLY.
*
* The class information must be installed into the GObject system once per
* property, but this is handled automatically.
template <class T>
Property<T>::Property(Glib::Object& object, const Glib::ustring& name)
-: Property(object, name, Glib::ustring(), Glib::ustring(), Glib::ParamFlags::READWRITE)
+: Property(object, name, Glib::ustring(), Glib::ustring(), Glib::PARAM_READWRITE)
{
}
Property<T>::Property(Glib::Object& object, const Glib::ustring& name,
const typename Property<T>::PropertyType& default_value)
: Property(object, name, default_value, Glib::ustring(),
- Glib::ustring(), Glib::ParamFlags::READWRITE)
+ Glib::ustring(), Glib::PARAM_READWRITE)
{
}
const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags)
: PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::READWRITE;
+ flags |= Glib::PARAM_READWRITE;
if (!lookup_property(name))
install_property(static_cast<ValueType&>(value_).create_param_spec(name, nick, blurb, flags));
:
PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::READWRITE;
+ flags |= Glib::PARAM_READWRITE;
static_cast<ValueType&>(value_).set(default_value);
template <class T>
Property_ReadOnly<T>::Property_ReadOnly(Glib::Object& object, const Glib::ustring& name)
-: Property_ReadOnly(object, name, Glib::ustring(), Glib::ustring(), Glib::ParamFlags::READABLE)
+: Property_ReadOnly(object, name, Glib::ustring(), Glib::ustring(), Glib::PARAM_READABLE)
{
}
Property_ReadOnly<T>::Property_ReadOnly(Glib::Object& object, const Glib::ustring& name,
const typename Property_ReadOnly<T>::PropertyType& default_value)
: Property_ReadOnly(object, name, default_value, Glib::ustring(), Glib::ustring(),
- Glib::ParamFlags::READABLE)
+ Glib::PARAM_READABLE)
{
}
const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags)
: PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::READABLE;
- flags &= ~Glib::ParamFlags::WRITABLE;
+ flags |= Glib::PARAM_READABLE;
+ flags &= ~Glib::PARAM_WRITABLE;
if (!lookup_property(name))
install_property(static_cast<ValueType&>(value_).create_param_spec(name, nick, blurb, flags));
const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags)
: PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::READABLE;
- flags &= ~Glib::ParamFlags::WRITABLE;
+ flags |= Glib::PARAM_READABLE;
+ flags &= ~Glib::PARAM_WRITABLE;
static_cast<ValueType&>(value_).set(default_value);
template <class T>
Property_WriteOnly<T>::Property_WriteOnly(Glib::Object& object, const Glib::ustring& name)
: Property_WriteOnly(object, name, Glib::ustring(),
- Glib::ustring(), Glib::ParamFlags::WRITABLE)
+ Glib::ustring(), Glib::PARAM_WRITABLE)
{
}
Property_WriteOnly<T>::Property_WriteOnly(Glib::Object& object, const Glib::ustring& name,
const typename Property_WriteOnly<T>::PropertyType& default_value)
: Property_WriteOnly(object, name, default_value, Glib::ustring(),
- Glib::ustring(), Glib::ParamFlags::WRITABLE)
+ Glib::ustring(), Glib::PARAM_WRITABLE)
{
}
const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags)
: PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::WRITABLE;
- flags &= ~Glib::ParamFlags::READABLE;
+ flags |= Glib::PARAM_WRITABLE;
+ flags &= ~Glib::PARAM_READABLE;
if (!lookup_property(name))
install_property(static_cast<ValueType&>(value_).create_param_spec(name, nick, blurb, flags));
const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags)
: PropertyBase(object, ValueType::value_type())
{
- flags |= Glib::ParamFlags::WRITABLE;
- flags &= ~Glib::ParamFlags::READABLE;
+ flags |= Glib::PARAM_WRITABLE;
+ flags &= ~Glib::PARAM_READABLE;
static_cast<ValueType&>(value_).set(default_value);
if (pspec && data)
{
if (sigc::slot_base* const slot = SignalProxyBase::data_to_slot(data))
- (*static_cast<sigc::slot<void()>*>(slot))();
+ (*static_cast<sigc::slot<void>*>(slot))();
}
}
SignalProxyProperty(Glib::ObjectBase* obj, const gchar* property_name);
~SignalProxyProperty() noexcept;
- using SlotType = sigc::slot<void()>;
+ using SlotType = sigc::slot<void>;
sigc::connection connect(const SlotType& slot);
/** @newin{2,48}
*/
#include <glibmmconfig.h>
#include <glib.h>
-#include <memory>
+#include <utility>
namespace Glib
{
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-template <class T_CppObject>
-void RefPtrDeleter(T_CppObject* object)
-{
- if (!object)
- return;
-
- object->unreference();
-}
-#endif // DOXYGEN_SHOULD_SKIP_THIS
-
/** RefPtr<> is a reference-counting shared smartpointer.
*
* Some objects in gtkmm are obtained from a shared
* store. Consequently you cannot instantiate them yourself. Instead they
* return a RefPtr which behaves much like an ordinary pointer in that members
* can be reached with the usual <code>object_ptr->member</code> notation.
+ * Unlike most other smart pointers, RefPtr doesn't support dereferencing
+ * through <code>*object_ptr</code>.
*
* Reference counting means that a shared reference count is incremented each
* time a RefPtr is copied, and decremented each time a RefPtr is destroyed,
* zero, the contained object is deleted, meaning you don't need to remember
* to delete the object.
*
+ * RefPtr<> can store any class that has reference() and unreference() methods,
+ * and whose destructor is noexcept (the default for destructors).
+ * In gtkmm, that is anything derived from Glib::ObjectBase, such as
+ * Gdk::Pixbuf.
+ *
* See the "Memory Management" section in the "Programming with gtkmm"
* book for further information.
*/
template <class T_CppObject>
-using RefPtr = std::shared_ptr<T_CppObject>;
+class RefPtr
+{
+private:
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ /** Helper class for disallowing use of Glib::RefPtr with certain classes.
+ *
+ * Disallow for instance in Gtk::Widget and its subclasses.
+ * Glib::RefPtr<T>::is_allowed_type::value is false if
+ * T:dont_allow_use_in_glib_refptr_ is a public type, else it's true.
+ * Example:
+ * @code
+ * using dont_allow_use_in_glib_refptr_ = int;
+ * @endcode
+ */
+ class is_allowed_type
+ {
+ private:
+ struct big
+ {
+ int memory[64];
+ };
-/* This would not be useful,
- * because application code should not new these objects anyway.
- * And it is not useful inside glibmm or gtkmm code because
- * the constructors are protected, so can't be called from this utilility
- * function.
- *
-template <class T_CppObject, class... T_Arg>
-RefPtr<T_CppObject>
-make_refptr(T_Arg... arg)
+ static big check(...);
+
+ // If X::dont_allow_use_in_glib_refptr_ is not a type, this check() overload
+ // is ignored because of the SFINAE rule (Substitution Failure Is Not An Error).
+ template <typename X>
+ static typename X::dont_allow_use_in_glib_refptr_ check(X* obj);
+
+ public:
+ static const bool value = sizeof(check(static_cast<T_CppObject*>(nullptr))) == sizeof(big);
+ };
+
+ static_assert(is_allowed_type::value, "Glib::RefPtr must not be used with this class.");
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+public:
+ /** Default constructor
+ *
+ * Afterwards it will be null and use of -> will invoke undefined behaviour.
+ */
+ inline RefPtr() noexcept;
+
+ /// Destructor - decrements reference count.
+ inline ~RefPtr() noexcept;
+
+ /// For use only by the \::create() methods.
+ explicit inline RefPtr(T_CppObject* pCppObject) noexcept;
+
+ /** Copy constructor
+ *
+ * This increments the shared reference count.
+ */
+ inline RefPtr(const RefPtr& src) noexcept;
+
+ /** Move constructor
+ */
+ inline RefPtr(RefPtr&& src) noexcept;
+
+ /** Move constructor (from different, but castable type).
+ */
+ template <class T_CastFrom>
+ inline RefPtr(RefPtr<T_CastFrom>&& src) noexcept;
+
+ /** Copy constructor (from different, but castable type).
+ *
+ * Increments the reference count.
+ */
+ template <class T_CastFrom>
+ inline RefPtr(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /** Swap the contents of two RefPtr<>.
+ * This method swaps the internal pointers to T_CppObject. This can be
+ * done safely without involving a reference/unreference cycle and is
+ * therefore highly efficient.
+ */
+ inline void swap(RefPtr& other) noexcept;
+
+ /// Copy from another RefPtr:
+ inline RefPtr& operator=(const RefPtr& src) noexcept;
+
+ /// Move assignment operator:
+ inline RefPtr& operator=(RefPtr&& src) noexcept;
+
+ /// Move assignment operator (from different, but castable type):
+ template <class T_CastFrom>
+ inline RefPtr& operator=(RefPtr<T_CastFrom>&& src) noexcept;
+
+ /** Copy from different, but castable type.
+ *
+ * Increments the reference count.
+ */
+ template <class T_CastFrom>
+ inline RefPtr& operator=(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /// Tests whether the RefPtr<> point to the same underlying instance.
+ inline bool operator==(const RefPtr& src) const noexcept;
+
+ /// See operator==().
+ inline bool operator!=(const RefPtr& src) const noexcept;
+
+ /** Dereferencing.
+ *
+ * Use the methods of the underlying instance like so:
+ * <code>refptr->memberfun()</code>.
+ */
+ inline T_CppObject* operator->() const noexcept;
+
+ /** Returns the stored pointer.
+ *
+ * @newin{2,56}
+ */
+ inline T_CppObject* get() const noexcept;
+
+ /** Test whether the RefPtr<> points to any underlying instance.
+ *
+ * Mimics usage of ordinary pointers:
+ * @code
+ * if (ptr)
+ * do_something();
+ * @endcode
+ */
+ inline explicit operator bool() const noexcept;
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+ /// @deprecated Use reset() instead because this leads to confusion with clear() methods on the
+ /// underlying class. For instance, people use .clear() when they mean ->clear().
+ inline void clear() noexcept;
+#endif // GLIBMM_DISABLE_DEPRECATED
+
+ /** Set underlying instance to nullptr, decrementing reference count of existing instance
+ * appropriately.
+ * @newin{2,16}
+ */
+ inline void reset() noexcept;
+
+ /** Release the ownership of underlying instance.
+ *
+ * RefPtr's underlying instance is set to nullptr, therefore underlying object can't be accessed
+ * through this RefPtr anymore.
+ * @return an underlying instance.
+ *
+ * Most users should not use release(). It can spoil the automatic destruction
+ * of the managed object. A legitimate use is if you immediately give RefPtr's
+ * reference to another object.
+ */
+ inline T_CppObject* release() noexcept G_GNUC_WARN_UNUSED_RESULT;
+
+ /** Dynamic cast to derived class.
+ *
+ * The RefPtr can't be cast with the usual notation so instead you can use
+ * @code
+ * ptr_derived = RefPtr<Derived>::cast_dynamic(ptr_base);
+ * @endcode
+ */
+ template <class T_CastFrom>
+ static inline RefPtr cast_dynamic(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /** Static cast to derived class.
+ *
+ * Like the dynamic cast; the notation is
+ * @code
+ * ptr_derived = RefPtr<Derived>::cast_static(ptr_base);
+ * @endcode
+ */
+ template <class T_CastFrom>
+ static inline RefPtr cast_static(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /** Cast to non-const.
+ *
+ * The RefPtr can't be cast with the usual notation so instead you can use
+ * @code
+ * ptr_unconst = RefPtr<UnConstType>::cast_const(ptr_const);
+ * @endcode
+ */
+ template <class T_CastFrom>
+ static inline RefPtr cast_const(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /** Compare based on the underlying instance address.
+ *
+ * This is needed in code that requires an ordering on
+ * RefPtr<T_CppObject> instances, e.g. std::set<RefPtr<T_CppObject> >.
+ *
+ * Without these, comparing two RefPtr<T_CppObject> instances
+ * is still syntactically possible, but the result is semantically
+ * wrong, as p1 REL_OP p2 is interpreted as (bool)p1 REL_OP (bool)p2.
+ */
+ inline bool operator<(const RefPtr& src) const noexcept;
+
+ /// See operator<().
+ inline bool operator<=(const RefPtr& src) const noexcept;
+
+ /// See operator<().
+ inline bool operator>(const RefPtr& src) const noexcept;
+
+ /// See operator<().
+ inline bool operator>=(const RefPtr& src) const noexcept;
+
+private:
+ T_CppObject* pCppObject_;
+};
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+// RefPtr<>::operator->() comes first here since it's used by other methods.
+// If it would come after them it wouldn't be inlined.
+
+template <class T_CppObject>
+inline T_CppObject* RefPtr<T_CppObject>::operator->() const noexcept
{
- return RefPtr<T_CppObject>(new T_CppObject(arg...));
+ return pCppObject_;
}
-*/
-/** Create a RefPtr<> to an instance of any class that has reference() and
- * unreference() methods, and whose destructor is noexcept (the default for destructors).
- *
- * In gtkmm, that is anything derived from Glib::ObjectBase, such as
- * Gdk::Pixbuf.
- *
- * Normal application code should not need to use this. However, this is necessary
- * when implementing create() methods for derived Glib::ObjectBase-derived
- * (not Gtk::Widget-derived) classes, such as derived Gtk::TreeModels.
- */
template <class T_CppObject>
-RefPtr<T_CppObject>
-make_refptr_for_instance(T_CppObject* object)
+inline RefPtr<T_CppObject>::RefPtr() noexcept : pCppObject_(nullptr)
+{
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>::~RefPtr() noexcept
+{
+ if (pCppObject_)
+ pCppObject_->unreference(); // This could cause pCppObject to be deleted.
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>::RefPtr(T_CppObject* pCppObject) noexcept : pCppObject_(pCppObject)
+{
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>::RefPtr(const RefPtr& src) noexcept : pCppObject_(src.pCppObject_)
+{
+ if (pCppObject_)
+ pCppObject_->reference();
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>::RefPtr(RefPtr&& src) noexcept : pCppObject_(src.pCppObject_)
+{
+ src.pCppObject_ = nullptr;
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>::RefPtr(RefPtr<T_CastFrom>&& src) noexcept : pCppObject_(src.release())
+{
+}
+
+// The templated ctor allows copy construction from any object that's
+// castable. Thus, it does downcasts:
+// base_ref = derived_ref
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>::RefPtr(const RefPtr<T_CastFrom>& src) noexcept :
+ // A different RefPtr<> will not allow us access to pCppObject_. We need
+ // to add a get_underlying() for this, but that would encourage incorrect
+ // use, so we use the less well-known operator->() accessor:
+ pCppObject_(src.operator->())
+{
+ if (pCppObject_)
+ pCppObject_->reference();
+}
+
+template <class T_CppObject>
+inline void
+RefPtr<T_CppObject>::swap(RefPtr& other) noexcept
+{
+ T_CppObject* const temp = pCppObject_;
+ pCppObject_ = other.pCppObject_;
+ other.pCppObject_ = temp;
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>&
+RefPtr<T_CppObject>::operator=(const RefPtr& src) noexcept
+{
+ // In case you haven't seen the swap() technique to implement copy
+ // assignment before, here's what it does:
+ //
+ // 1) Create a temporary RefPtr<> instance via the copy ctor, thereby
+ // increasing the reference count of the source object.
+ //
+ // 2) Swap the internal object pointers of *this and the temporary
+ // RefPtr<>. After this step, *this already contains the new pointer,
+ // and the old pointer is now managed by temp.
+ //
+ // 3) The destructor of temp is executed, thereby unreferencing the
+ // old object pointer.
+ //
+ // This technique is described in Herb Sutter's "Exceptional C++", and
+ // has a number of advantages over conventional approaches:
+ //
+ // - Code reuse by calling the copy ctor.
+ // - Strong exception safety for free.
+ // - Self assignment is handled implicitely.
+ // - Simplicity.
+ // - It just works and is hard to get wrong; i.e. you can use it without
+ // even thinking about it to implement copy assignment whereever the
+ // object data is managed indirectly via a pointer, which is very common.
+
+ RefPtr<T_CppObject> temp(src);
+ this->swap(temp);
+ return *this;
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>&
+RefPtr<T_CppObject>::operator=(RefPtr&& src) noexcept
+{
+ RefPtr<T_CppObject> temp(std::move(src));
+ this->swap(temp);
+ src.pCppObject_ = nullptr;
+
+ return *this;
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>&
+RefPtr<T_CppObject>::operator=(RefPtr<T_CastFrom>&& src) noexcept
+{
+ if (pCppObject_)
+ pCppObject_->unreference();
+ pCppObject_ = src.release();
+
+ return *this;
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>&
+RefPtr<T_CppObject>::operator=(const RefPtr<T_CastFrom>& src) noexcept
+{
+ RefPtr<T_CppObject> temp(src);
+ this->swap(temp);
+ return *this;
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator==(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ == src.pCppObject_);
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator!=(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ != src.pCppObject_);
+}
+
+template <class T_CppObject>
+inline T_CppObject* RefPtr<T_CppObject>::get() const noexcept
+{
+ return pCppObject_;
+}
+
+template <class T_CppObject>
+inline RefPtr<T_CppObject>::operator bool() const noexcept
+{
+ return (pCppObject_ != nullptr);
+}
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+template <class T_CppObject>
+inline void
+RefPtr<T_CppObject>::clear() noexcept
+{
+ reset();
+}
+#endif // GLIBMM_DISABLE_DEPRECATED
+
+template <class T_CppObject>
+inline void
+RefPtr<T_CppObject>::reset() noexcept
+{
+ RefPtr<T_CppObject> temp; // swap with an empty RefPtr<> to clear *this
+ this->swap(temp);
+}
+
+template <class T_CppObject>
+inline T_CppObject*
+RefPtr<T_CppObject>::release() noexcept
+{
+ T_CppObject* tmp = pCppObject_;
+ pCppObject_ = nullptr;
+ return tmp;
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>
+RefPtr<T_CppObject>::cast_dynamic(const RefPtr<T_CastFrom>& src) noexcept
+{
+ T_CppObject* const pCppObject = dynamic_cast<T_CppObject*>(src.operator->());
+
+ if (pCppObject)
+ pCppObject->reference();
+
+ return RefPtr<T_CppObject>(pCppObject);
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>
+RefPtr<T_CppObject>::cast_static(const RefPtr<T_CastFrom>& src) noexcept
+{
+ T_CppObject* const pCppObject = static_cast<T_CppObject*>(src.operator->());
+
+ if (pCppObject)
+ pCppObject->reference();
+
+ return RefPtr<T_CppObject>(pCppObject);
+}
+
+template <class T_CppObject>
+template <class T_CastFrom>
+inline RefPtr<T_CppObject>
+RefPtr<T_CppObject>::cast_const(const RefPtr<T_CastFrom>& src) noexcept
+{
+ T_CppObject* const pCppObject = const_cast<T_CppObject*>(src.operator->());
+
+ if (pCppObject)
+ pCppObject->reference();
+
+ return RefPtr<T_CppObject>(pCppObject);
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator<(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ < src.pCppObject_);
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator<=(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ <= src.pCppObject_);
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator>(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ > src.pCppObject_);
+}
+
+template <class T_CppObject>
+inline bool
+RefPtr<T_CppObject>::operator>=(const RefPtr& src) const noexcept
+{
+ return (pCppObject_ >= src.pCppObject_);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+/** @relates Glib::RefPtr */
+template <class T_CppObject>
+inline void
+swap(RefPtr<T_CppObject>& lhs, RefPtr<T_CppObject>& rhs) noexcept
{
- return RefPtr<T_CppObject>(object, &RefPtrDeleter<T_CppObject>);
+ lhs.swap(rhs);
}
} // namespace Glib
-/* Copyright (C) 2017 The giomm Development Team
+/* sarray.cc
+ *
+ * Copyright (C) 2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <gio/gio.h>
-#include <gio/gfiledescriptorbased.h>
+#include <glibmm/sarray.h>
-/* Copyright (C) 2017 The giomm Development Team
+#ifndef _GLIBMM_SARRAY_H
+#define _GLIBMM_SARRAY_H
+
+/* array.h
+ *
+ * Copyright (C) 2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <gio/gio.h>
+#include <glibmmconfig.h>
-namespace Gio
-{
+#ifndef GLIBMM_DISABLE_DEPRECATED
+#include <glibmm/arrayhandle.h>
+#include <glibmm/ustring.h>
-PropertyAction::PropertyAction(const Glib::ustring& name,
- const Glib::PropertyProxy_Base& property_proxy, bool invert_boolean)
-:
-_CONSTRUCT("name", name.c_str(), "object", property_proxy.get_object()->gobj(),
- "property-name", property_proxy.get_name(),
- "invert-boolean", invert_boolean)
+namespace Glib
{
+
+/**
+ * @deprecated Use a std::vector instead.
+ */
+using SArray = Glib::ArrayHandle<Glib::ustring>;
}
-} // namespace Gio
+#endif // GLIBMM_DISABLE_DEPRECATED
+
+#endif // _GLIBMM_SARRAY_H
}
sigc::slot_base&
-SignalProxyNormal::connect_impl_(bool notify, const sigc::slot_base& slot, bool after)
+SignalProxyNormal::connect_(const sigc::slot_base& slot, bool after)
+{
+ return connect_impl_(info_->callback, slot, after);
+}
+
+sigc::slot_base&
+SignalProxyNormal::connect_notify_(const sigc::slot_base& slot, bool after)
+{
+ return connect_impl_(info_->notify_callback, slot, after);
+}
+
+sigc::slot_base&
+SignalProxyNormal::connect_impl_(GCallback callback, const sigc::slot_base& slot, bool after)
{
// create a proxy to hold our connection info
auto pConnectionNode = new SignalProxyConnectionNode(slot, obj_->gobj());
// connect it to glib
// pConnectionNode will be passed in the data argument to the callback.
pConnectionNode->connection_id_ = g_signal_connect_data(obj_->gobj(), info_->signal_name,
- notify ? info_->notify_callback : info_->callback, pConnectionNode,
- &SignalProxyConnectionNode::destroy_notify_handler,
- static_cast<GConnectFlags>(after ? G_CONNECT_AFTER : 0));
+ callback, pConnectionNode, &SignalProxyConnectionNode::destroy_notify_handler,
+ static_cast<GConnectFlags>((after) ? G_CONNECT_AFTER : 0));
return pConnectionNode->slot_;
}
try
{
if (sigc::slot_base* const slot = data_to_slot(data))
- (*static_cast<sigc::slot<void()>*>(slot))();
+ (*static_cast<sigc::slot<void>*>(slot))();
}
catch (...)
{
}
}
-// SignalProxyDetailedBase implementation:
+// SignalProxyDetailed implementation:
-SignalProxyDetailedBase::SignalProxyDetailedBase(
+SignalProxyDetailed::SignalProxyDetailed(
Glib::ObjectBase* obj, const SignalProxyInfo* info, const Glib::ustring& detail_name)
: SignalProxyBase(obj),
info_(info),
{
}
-SignalProxyDetailedBase::~SignalProxyDetailedBase() noexcept
+SignalProxyDetailed::~SignalProxyDetailed() noexcept
{
}
sigc::slot_base&
-SignalProxyDetailedBase::connect_impl_(bool notify, const sigc::slot_base& slot, bool after)
+SignalProxyDetailed::connect_impl_(bool notify, const sigc::slot_base& slot, bool after)
{
// create a proxy to hold our connection info
auto pConnectionNode = new SignalProxyConnectionNode(slot, obj_->gobj());
}
sigc::slot_base&
-SignalProxyDetailedBase::connect_impl_(bool notify, sigc::slot_base&& slot, bool after)
+SignalProxyDetailed::connect_impl_(bool notify, sigc::slot_base&& slot, bool after)
{
// create a proxy to hold our connection info
auto pConnectionNode = new SignalProxyConnectionNode(std::move(slot), obj_->gobj());
}
void
-SignalProxyDetailedBase::emission_stop()
+SignalProxyDetailed::emission_stop()
{
g_signal_stop_emission_by_name(obj_->gobj(), detailed_name_.c_str());
}
#endif // DOXYGEN_SHOULD_SKIP_THIS
-// This base class is used by SignalProxyNormal, SignalProxyDetailedBase and SignalProxyProperty.
+// This base class is used by SignalProxyNormal, SignalProxyDetailed and SignalProxyProperty.
class SignalProxyBase
{
public:
ObjectBase* obj_;
private:
- SignalProxyBase& operator=(const SignalProxyBase&) = delete;
+ SignalProxyBase& operator=(const SignalProxyBase&); // not implemented
};
// Shared portion of a Signal without detail
* the template derivatives, which serve as gatekeepers for the
* types allowed on a particular signal.
*
- * For signals with a detailed name (signal_name::detail_name) see SignalProxyDetailedBase.
+ * For signals with a detailed name (signal_name::detail_name) see SignalProxyDetailed.
*/
class SignalProxyNormal : public SignalProxyBase
{
void emission_stop();
#ifndef DOXYGEN_SHOULD_SKIP_THIS
- // This callback for SignalProxy<void()>
+ // This callback for SignalProxy<void>
// is defined here to avoid code duplication.
static void slot0_void_callback(GObject*, void* data);
#endif
*/
SignalProxyNormal(Glib::ObjectBase* obj, const SignalProxyInfo* info);
- /** Connects a signal handler to a signal.
- * This is called by connect() and connect_notify() in derived SignalProxy classes.
+ /** Connects a generic signal handler to a signal.
+ * This is called by connect() in derived SignalProxy classes.
*
- * @param notify Whether this method is called by connect_notify() or by connect().
* @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
* @param after Whether this signal handler should be called before or after the default signal
* handler.
+ */
+ sigc::slot_base& connect_(const sigc::slot_base& slot, bool after);
+
+ /** Connects a signal handler without a return value to a signal.
+ * This is called by connect_notify() in derived SignalProxy classes.
*
- * @newin{2,58}
+ * @param slot The signal handler, which should have a @c void return type,
+ * usually created with sigc::mem_fun() or sigc::ptr_fun().
+ * @param after Whether this signal handler should be called before or after the default signal
+ * handler.
*/
- sigc::slot_base& connect_impl_(bool notify, const sigc::slot_base& slot, bool after);
+ sigc::slot_base& connect_notify_(const sigc::slot_base& slot, bool after);
/** Connects a signal handler to a signal.
- * @see connect_impl_(bool notify, const sigc::slot_base& slot, bool after).
+ * @see connect_(const sigc::slot_base& slot, bool after) and
+ * connect_notify_(const sigc::slot_base& slot, bool after).
*
* @newin{2,48}
*/
private:
const SignalProxyInfo* info_;
+ // TODO: We could maybe replace both connect_() and connect_notify_() with this in future, because
+ // they don't do anything extra.
+ /** This is called by connect_() and connect_notify_().
+ */
+ sigc::slot_base& connect_impl_(GCallback callback, const sigc::slot_base& slot, bool after);
+
// no copy assignment
- SignalProxyNormal& operator=(const SignalProxyNormal&) = delete;
+ SignalProxyNormal& operator=(const SignalProxyNormal&);
};
/**** Glib::SignalProxy ***************************************************/
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-template <class R, class... T>
-class SignalProxy;
-#endif // DOXYGEN_SHOULD_SKIP_THIS
-
/** Proxy for signals with any number of arguments.
* Use the connect() or connect_notify() method, with sigc::mem_fun() or sigc::ptr_fun()
* to connect signal handlers to signals.
- *
- * This is the primary template. There is a specialization for signal handlers
- * that return @c void. The specialization has no %connect_notify() method, and
- * the @a after parameter in its %connect() method has a default value.
*/
template <class R, class... T>
-class SignalProxy<R(T...)> : public SignalProxyNormal
+class SignalProxy : public SignalProxyNormal
{
public:
- using SlotType = sigc::slot<R(T...)>;
- using VoidSlotType = sigc::slot<void(T...)>;
+ using SlotType = sigc::slot<R, T...>;
+ using VoidSlotType = sigc::slot<void, T...>;
SignalProxy(ObjectBase* obj, const SignalProxyInfo* info) : SignalProxyNormal(obj, info) {}
/** Connects a signal handler to a signal.
*
- * For instance, connect(sigc::mem_fun(*this, &TheClass::on_something), false);
- *
- * For some signal handlers that return a value, it can make a big difference
- * whether you connect before or after the default signal handler.
- * Examples:
- * - Gio::Application::signal_command_line() calls only one signal handler.
- * A handler connected after the default handler will never be called.
- * - X event signals, such as Gtk::Widget::signal_button_press_event(), stop
- * calling signal handlers as soon as a called handler returns <tt>true</tt>.
- * If the default handler returns <tt>true</tt>, a handler connected after it
- * will not be called.
+ * For instance, connect( sigc::mem_fun(*this, &TheClass::on_something) );
*
* @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
* @param after Whether this signal handler should be called before or after the default signal
* handler.
- * @return A sigc::connection.
*/
- sigc::connection connect(const SlotType& slot, bool after)
+ sigc::connection connect(const SlotType& slot, bool after = true)
{
- return sigc::connection(connect_impl_(false, slot, after));
+ return sigc::connection(connect_(slot, after));
}
/** Connects a signal handler to a signal.
*
* @newin{2,48}
*/
- sigc::connection connect(SlotType&& slot, bool after)
+ sigc::connection connect(SlotType&& slot, bool after = true)
{
return sigc::connection(connect_impl_(false, std::move(slot), after));
}
*
* For instance, connect_notify( sigc::mem_fun(*this, &TheClass::on_something) );
*
+ * If the signal requires signal handlers with a @c void return type,
+ * the only difference between connect() and connect_notify() is the default
+ * value of @a after.
+ *
* If the signal requires signal handlers with a return value of type T,
- * %connect_notify() binds <tt>return T()</tt> to the connected signal handler.
+ * connect_notify() binds <tt>return T()</tt> to the connected signal handler.
* For instance, if the return type is @c bool, the following two calls are equivalent.
* @code
- * connect_notify(sigc::mem_fun(*this, &TheClass::on_something));
- * connect(sigc::bind_return<bool>(sigc::mem_fun(*this, &TheClass::on_something), false), false);
+ * connect_notify( sigc::mem_fun(*this, &TheClass::on_something) );
+ * connect( sigc::bind_return<bool>(sigc::mem_fun(*this, &TheClass::on_something), false), false
+ * );
* @endcode
*
* @param slot The signal handler, which should have a @c void return type,
* usually created with sigc::mem_fun() or sigc::ptr_fun().
* @param after Whether this signal handler should be called before or after the default signal
* handler.
- * @return A sigc::connection.
*/
sigc::connection connect_notify(const VoidSlotType& slot, bool after = false)
{
- return sigc::connection(connect_impl_(true, slot, after));
+ return sigc::connection(connect_notify_(slot, after));
}
/** Connects a signal handler without a return value to a signal.
}
};
-/** Proxy for signals with any number of arguments.
- * Use the connect() method, with sigc::mem_fun() or sigc::ptr_fun()
- * to connect signal handlers to signals.
- *
- * This is a specialization for signal handlers that return @c void.
+/* Templates below has been added to avoid API break, and should not be
+ * used in a newly created code. SignalProxy class should be used instead
+ * of SignalProxy# class.
*/
-template <class... T>
-class SignalProxy<void(T...)> : public SignalProxyNormal
-{
-public:
- using SlotType = sigc::slot<void(T...)>;
-
- SignalProxy(ObjectBase* obj, const SignalProxyInfo* info) : SignalProxyNormal(obj, info) {}
-
- /** Connects a signal handler to a signal.
- *
- * For instance, connect( sigc::mem_fun(*this, &TheClass::on_something) );
- *
- * By default, the signal handler will be called after the default signal handler.
- * This is usually fine for signal handlers that don't return a value.
- *
- * @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
- * @param after Whether this signal handler should be called before or after the default signal
- * handler.
- * @return A sigc::connection.
- */
- sigc::connection connect(const SlotType& slot, bool after = true)
- {
- return sigc::connection(connect_impl_(false, slot, after));
- }
-
- /** Connects a signal handler to a signal.
- * @see connect(const SlotType& slot, bool after).
- *
- * @newin{2,48}
- */
- sigc::connection connect(SlotType&& slot, bool after = true)
- {
- return sigc::connection(connect_impl_(false, std::move(slot), after));
- }
-};
+template <typename R>
+using SignalProxy0 = SignalProxy<R>;
+template <typename R, typename T1>
+using SignalProxy1 = SignalProxy<R, T1>;
+template <typename R, typename T1, typename T2>
+using SignalProxy2 = SignalProxy<R, T1, T2>;
+template <typename R, typename T1, typename T2, typename T3>
+using SignalProxy3 = SignalProxy<R, T1, T2, T3>;
+template <typename R, typename T1, typename T2, typename T3, typename T4>
+using SignalProxy4 = SignalProxy<R, T1, T2, T3, T4>;
+template <typename R, typename T1, typename T2, typename T3, typename T4, typename T5>
+using SignalProxy5 = SignalProxy<R, T1, T2, T3, T4, T5>;
+template <typename R, typename T1, typename T2, typename T3, typename T4, typename T5, typename T6>
+using SignalProxy6 = SignalProxy<R, T1, T2, T3, T4, T5, T6>;
+
+// TODO: When we can break ABI, consider renaming
+// SignalProxyDetailed => SignalProxyDetailedBase
+// SignalProxyDetailedAnyType => SignalProxyDetailed
// Shared portion of a Signal with detail
/** The SignalProxy provides an API similar to sigc::signal that can be used to
* the template derivatives, which serve as gatekeepers for the
* types allowed on a particular signal.
*/
-class SignalProxyDetailedBase : public SignalProxyBase
+class SignalProxyDetailed : public SignalProxyBase
{
public:
- ~SignalProxyDetailedBase() noexcept;
+ ~SignalProxyDetailed() noexcept;
/// Stops the current signal emission (not in libsigc++)
void emission_stop();
* and the C callbacks that should be called by glib.
* @param detail_name The detail name, if any.
*/
- SignalProxyDetailedBase(
+ SignalProxyDetailed(
Glib::ObjectBase* obj, const SignalProxyInfo* info, const Glib::ustring& detail_name);
/** Connects a signal handler to a signal.
- * This is called by connect() and connect_notify() in derived SignalProxyDetailed classes.
+ * This is called by connect() and connect_notify() in derived SignalProxyDetailedAnyType classes.
*
* @param notify Whether this method is called by connect_notify() or by connect().
* @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
const Glib::ustring detailed_name_; // signal_name[::detail_name]
// no copy assignment
- SignalProxyDetailedBase& operator=(const SignalProxyDetailedBase&) = delete;
+ SignalProxyDetailed& operator=(const SignalProxyDetailed&);
};
-/**** Glib::SignalProxyDetailed **********************************************/
-
-#ifndef DOXYGEN_SHOULD_SKIP_THIS
-template <class R, class... T>
-class SignalProxyDetailed;
-#endif // DOXYGEN_SHOULD_SKIP_THIS
-
/** Proxy for signals with any number of arguments and possibly a detailed name.
* Use the connect() or connect_notify() method, with sigc::mem_fun() or sigc::ptr_fun()
* to connect signal handlers to signals.
- *
- * This is the primary template. There is a specialization for signal handlers
- * that return @c void. The specialization has no %connect_notify() method, and
- * the @a after parameter in its %connect() method has a default value.
*/
template <class R, class... T>
-class SignalProxyDetailed<R(T...)> : public SignalProxyDetailedBase
+class SignalProxyDetailedAnyType : public SignalProxyDetailed
{
public:
- using SlotType = sigc::slot<R(T...)>;
- using VoidSlotType = sigc::slot<void(T...)>;
+ using SlotType = sigc::slot<R, T...>;
+ using VoidSlotType = sigc::slot<void, T...>;
- SignalProxyDetailed(
+ SignalProxyDetailedAnyType(
ObjectBase* obj, const SignalProxyInfo* info, const Glib::ustring& detail_name)
- : SignalProxyDetailedBase(obj, info, detail_name)
+ : SignalProxyDetailed(obj, info, detail_name)
{
}
/** Connects a signal handler to a signal.
*
- * For instance, connect(sigc::mem_fun(*this, &TheClass::on_something), false);
- *
- * For some signal handlers that return a value, it can make a big difference
- * whether you connect before or after the default signal handler.
- * Examples:
- * - Gio::Application::signal_command_line() calls only one signal handler.
- * A handler connected after the default handler will never be called.
- * - X event signals, such as Gtk::Widget::signal_button_press_event(), stop
- * calling signal handlers as soon as a called handler returns <tt>true</tt>.
- * If the default handler returns <tt>true</tt>, a handler connected after it
- * will not be called.
+ * For instance, connect( sigc::mem_fun(*this, &TheClass::on_something) );
*
* @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
* @param after Whether this signal handler should be called before or after the default signal
* handler.
- * @return A sigc::connection.
*/
- sigc::connection connect(const SlotType& slot, bool after)
+ sigc::connection connect(const SlotType& slot, bool after = true)
{
return sigc::connection(connect_impl_(false, slot, after));
}
*
* @newin{2,48}
*/
- sigc::connection connect(SlotType&& slot, bool after)
+ sigc::connection connect(SlotType&& slot, bool after = true)
{
return sigc::connection(connect_impl_(false, std::move(slot), after));
}
*
* For instance, connect_notify( sigc::mem_fun(*this, &TheClass::on_something) );
*
+ * If the signal requires signal handlers with a @c void return type,
+ * the only difference between connect() and connect_notify() is the default
+ * value of @a after.
+ *
* If the signal requires signal handlers with a return value of type T,
- * %connect_notify() binds <tt>return T()</tt> to the connected signal handler.
+ * connect_notify() binds <tt>return T()</tt> to the connected signal handler.
* For instance, if the return type is @c bool, the following two calls are equivalent.
* @code
- * connect_notify(sigc::mem_fun(*this, &TheClass::on_something));
- * connect(sigc::bind_return<bool>(sigc::mem_fun(*this, &TheClass::on_something), false), false);
+ * connect_notify( sigc::mem_fun(*this, &TheClass::on_something) );
+ * connect( sigc::bind_return<bool>(sigc::mem_fun(*this, &TheClass::on_something), false), false
+ * );
* @endcode
*
* @param slot The signal handler, which should have a @c void return type,
* usually created with sigc::mem_fun() or sigc::ptr_fun().
* @param after Whether this signal handler should be called before or after the default signal
* handler.
- * @return A sigc::connection.
*/
sigc::connection connect_notify(const VoidSlotType& slot, bool after = false)
{
}
};
-/** Proxy for signals with any number of arguments and possibly a detailed name.
- * Use the connect() method, with sigc::mem_fun() or sigc::ptr_fun()
- * to connect signal handlers to signals.
- *
- * This is a specialization for signal handlers that return @c void.
+/* Templates below has been added to avoid API break, and should not be
+ * used in a newly created code. SignalProxyDetailedAnyType class should be
+ * used instead of SignalProxyDetailed# class.
*/
-template <class... T>
-class SignalProxyDetailed<void(T...)> : public SignalProxyDetailedBase
-{
-public:
- using SlotType = sigc::slot<void(T...)>;
-
- SignalProxyDetailed(
- ObjectBase* obj, const SignalProxyInfo* info, const Glib::ustring& detail_name)
- : SignalProxyDetailedBase(obj, info, detail_name)
- {
- }
-
- /** Connects a signal handler to a signal.
- *
- * For instance, connect( sigc::mem_fun(*this, &TheClass::on_something) );
- *
- * By default, the signal handler will be called after the default signal handler.
- * This is usually fine for signal handlers that don't return a value.
- *
- * @param slot The signal handler, usually created with sigc::mem_fun() or sigc::ptr_fun().
- * @param after Whether this signal handler should be called before or after the default signal
- * handler.
- * @return A sigc::connection.
- */
- sigc::connection connect(const SlotType& slot, bool after = true)
- {
- return sigc::connection(connect_impl_(false, slot, after));
- }
-
- /** Connects a signal handler to a signal.
- * @see connect(const SlotType& slot, bool after).
- *
- * @newin{2,48}
- */
- sigc::connection connect(SlotType&& slot, bool after = true)
- {
- return sigc::connection(connect_impl_(false, std::move(slot), after));
- }
-};
+template <typename R>
+using SignalProxyDetailed0 = SignalProxyDetailedAnyType<R>;
+template <typename R, typename T1>
+using SignalProxyDetailed1 = SignalProxyDetailedAnyType<R, T1>;
+template <typename R, typename T1, typename T2>
+using SignalProxyDetailed2 = SignalProxyDetailedAnyType<R, T1, T2>;
+template <typename R, typename T1, typename T2, typename T3>
+using SignalProxyDetailed3 = SignalProxyDetailedAnyType<R, T1, T2, T3>;
+template <typename R, typename T1, typename T2, typename T3, typename T4>
+using SignalProxyDetailed4 = SignalProxyDetailedAnyType<R, T1, T2, T3, T4>;
+template <typename R, typename T1, typename T2, typename T3, typename T4, typename T5>
+using SignalProxyDetailed5 = SignalProxyDetailedAnyType<R, T1, T2, T3, T4, T5>;
+template <typename R, typename T1, typename T2, typename T3, typename T4, typename T5, typename T6>
+using SignalProxyDetailed6 = SignalProxyDetailedAnyType<R, T1, T2, T3, T4, T5, T6>;
} // namespace Glib
// notify is a message coming up from the slot to be passed back to Gtk+
// disconnect is a message coming up from the Gtk+ to be passed down to SigC++
// static
-void
-SignalProxyConnectionNode::notify(sigc::notifiable* data)
+void*
+SignalProxyConnectionNode::notify(void* data)
{
// notification from libsigc++.
SignalProxyConnectionNode* conn = static_cast<SignalProxyConnectionNode*>(data);
g_signal_handler_disconnect(o, connection_id);
}
}
+
+ return nullptr; // apparently unused in libsigc++
}
// static
* It lives between the layer of Gtk+ and libsigc++.
* It is very much an internal class.
*/
-class SignalProxyConnectionNode : public sigc::notifiable
+class SignalProxyConnectionNode
{
public:
/** @param slot The signal handler for the glib signal.
* This callback is registered in the slot.
* @param data The SignalProxyConnectionNode object (@p this).
*/
- static void notify(sigc::notifiable* data);
+ static void* notify(void* data);
/** Callback that is executed when the glib closure is destroyed.
* @param data The SignalProxyConnectionNode object (@p this).
--- /dev/null
+#ifndef _GLIBMM_SLISTHANDLE_H
+#define _GLIBMM_SLISTHANDLE_H
+
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+#include <glibmm/containerhandle_shared.h>
+#include <glib.h>
+
+namespace Glib
+{
+
+namespace Container_Helpers
+{
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/* Create and fill a GSList as efficient as possible.
+ * This requires bidirectional iterators.
+ */
+template <class Bi, class Tr>
+GSList*
+create_slist(Bi pbegin, Bi pend, Tr)
+{
+ GSList* head = nullptr;
+
+ while (pend != pbegin)
+ {
+ // Use & to force a warning if the iterator returns a temporary object.
+ const void* const item = Tr::to_c_type(*&*--pend);
+ head = g_slist_prepend(head, const_cast<void*>(item));
+ }
+
+ return head;
+}
+
+/* Create a GSList from a 0-terminated input sequence.
+ * Build it in reverse order and reverse the whole list afterwards,
+ * because appending to the list would be horribly inefficient.
+ */
+template <class For, class Tr>
+GSList*
+create_slist(For pbegin, Tr)
+{
+ GSList* head = nullptr;
+
+ while (*pbegin)
+ {
+ // Use & to force a warning if the iterator returns a temporary object.
+ const void* const item = Tr::to_c_type(*&*pbegin);
+ head = g_slist_prepend(head, const_cast<void*>(item));
+ ++pbegin;
+ }
+
+ return g_slist_reverse(head);
+}
+
+/* Convert from any container that supports bidirectional iterators.
+ */
+template <class Tr, class Cont>
+struct SListSourceTraits
+{
+ static GSList* get_data(const Cont& cont)
+ {
+ return Glib::Container_Helpers::create_slist(cont.begin(), cont.end(), Tr());
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+/* Convert from a 0-terminated array. The Cont
+ * argument must be a pointer to the first element.
+ */
+template <class Tr, class Cont>
+struct SListSourceTraits<Tr, Cont*>
+{
+ static GSList* get_data(const Cont* array)
+ {
+ return (array) ? Glib::Container_Helpers::create_slist(array, Tr()) : nullptr;
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+template <class Tr, class Cont>
+struct SListSourceTraits<Tr, const Cont*> : SListSourceTraits<Tr, Cont*>
+{
+};
+
+/* Convert from a 0-terminated array. The Cont argument must be a pointer
+ * to the first element. For consistency, the array must be 0-terminated,
+ * even though the array size is known at compile time.
+ */
+template <class Tr, class Cont, std::size_t N>
+struct SListSourceTraits<Tr, Cont[N]>
+{
+ static GSList* get_data(const Cont* array)
+ {
+ return Glib::Container_Helpers::create_slist(array, array + (N - 1), Tr());
+ }
+
+ static const Glib::OwnershipType initial_ownership = Glib::OWNERSHIP_SHALLOW;
+};
+
+template <class Tr, class Cont, std::size_t N>
+struct SListSourceTraits<Tr, const Cont[N]> : SListSourceTraits<Tr, Cont[N]>
+{
+};
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+/**
+ * @ingroup ContHelpers
+ */
+template <class Tr>
+class SListHandleIterator
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using iterator_category = std::forward_iterator_tag;
+ using value_type = CppType;
+ using difference_type = std::ptrdiff_t;
+ using reference = value_type;
+ using pointer = void;
+
+ explicit inline SListHandleIterator(const GSList* node);
+
+ inline value_type operator*() const;
+ inline SListHandleIterator<Tr>& operator++();
+ inline const SListHandleIterator<Tr> operator++(int);
+
+ inline bool operator==(const SListHandleIterator<Tr>& rhs) const;
+ inline bool operator!=(const SListHandleIterator<Tr>& rhs) const;
+
+private:
+ const GSList* node_;
+};
+
+} // namespace Container_Helpers
+
+// TODO: Remove this when we can break glibmm API.
+/** This is an intermediate type. When a method takes this, or returns this, you
+ * should use a standard C++ container of your choice, such as std::list or
+ * std::vector.
+ *
+ * However, this is not used in new API. We now prefer to just use std::vector,
+ * which is less flexibile, but makes the API clearer.
+ * @ingroup ContHandles
+ */
+template <class T, class Tr = Glib::Container_Helpers::TypeTraits<T>>
+class SListHandle
+{
+public:
+ using CppType = typename Tr::CppType;
+ using CType = typename Tr::CType;
+
+ using value_type = CppType;
+ using size_type = std::size_t;
+ using difference_type = std::ptrdiff_t;
+
+ using const_iterator = Glib::Container_Helpers::SListHandleIterator<Tr>;
+ using iterator = Glib::Container_Helpers::SListHandleIterator<Tr>;
+
+ template <class Cont>
+ inline SListHandle(const Cont& container);
+
+ // Take over ownership of a GSList created by GTK+ functions.
+ inline SListHandle(GSList* glist, Glib::OwnershipType ownership);
+
+ // Copying clears the ownership flag of the source handle.
+ inline SListHandle(const SListHandle<T, Tr>& other);
+
+ ~SListHandle() noexcept;
+
+ inline const_iterator begin() const;
+ inline const_iterator end() const;
+
+ template <class U>
+ inline operator std::vector<U>() const;
+ template <class U>
+ inline operator std::deque<U>() const;
+ template <class U>
+ inline operator std::list<U>() const;
+
+ template <class Cont>
+ inline void assign_to(Cont& container) const;
+ template <class Out>
+ inline void copy(Out pdest) const;
+
+ inline GSList* data() const;
+ inline std::size_t size() const;
+ inline bool empty() const;
+
+private:
+ GSList* pslist_;
+ mutable Glib::OwnershipType ownership_;
+
+ // No copy assignment.
+ SListHandle<T, Tr>& operator=(const SListHandle<T, Tr>&);
+};
+
+/***************************************************************************/
+/* Inline implementation */
+/***************************************************************************/
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+namespace Container_Helpers
+{
+
+/**** Glib::Container_Helpers::SListHandleIterator<> ***********************/
+
+template <class Tr>
+inline SListHandleIterator<Tr>::SListHandleIterator(const GSList* node) : node_(node)
+{
+}
+
+template <class Tr>
+inline typename SListHandleIterator<Tr>::value_type SListHandleIterator<Tr>::operator*() const
+{
+ return Tr::to_cpp_type(static_cast<typename Tr::CTypeNonConst>(node_->data));
+}
+
+template <class Tr>
+inline SListHandleIterator<Tr>& SListHandleIterator<Tr>::operator++()
+{
+ node_ = node_->next;
+ return *this;
+}
+
+template <class Tr>
+inline const SListHandleIterator<Tr> SListHandleIterator<Tr>::operator++(int)
+{
+ const SListHandleIterator<Tr> tmp(*this);
+ node_ = node_->next;
+ return tmp;
+}
+
+template <class Tr>
+inline bool
+SListHandleIterator<Tr>::operator==(const SListHandleIterator<Tr>& rhs) const
+{
+ return (node_ == rhs.node_);
+}
+
+template <class Tr>
+inline bool
+SListHandleIterator<Tr>::operator!=(const SListHandleIterator<Tr>& rhs) const
+{
+ return (node_ != rhs.node_);
+}
+
+} // namespace Container_Helpers
+
+/**** Glib::SListHandle<> **************************************************/
+
+template <class T, class Tr>
+template <class Cont>
+inline SListHandle<T, Tr>::SListHandle(const Cont& container)
+: pslist_(Glib::Container_Helpers::SListSourceTraits<Tr, Cont>::get_data(container)),
+ ownership_(Glib::Container_Helpers::SListSourceTraits<Tr, Cont>::initial_ownership)
+{
+}
+
+template <class T, class Tr>
+inline SListHandle<T, Tr>::SListHandle(GSList* gslist, Glib::OwnershipType ownership)
+: pslist_(gslist), ownership_(ownership)
+{
+}
+
+template <class T, class Tr>
+inline SListHandle<T, Tr>::SListHandle(const SListHandle<T, Tr>& other)
+: pslist_(other.pslist_), ownership_(other.ownership_)
+{
+ other.ownership_ = Glib::OWNERSHIP_NONE;
+}
+
+template <class T, class Tr>
+SListHandle<T, Tr>::~SListHandle() noexcept
+{
+ if (ownership_ != Glib::OWNERSHIP_NONE)
+ {
+ if (ownership_ != Glib::OWNERSHIP_SHALLOW)
+ {
+ // Deep ownership: release each container element.
+ for (GSList* node = pslist_; node != nullptr; node = node->next)
+ Tr::release_c_type(static_cast<typename Tr::CTypeNonConst>(node->data));
+ }
+ g_slist_free(pslist_);
+ }
+}
+
+template <class T, class Tr>
+inline typename SListHandle<T, Tr>::const_iterator
+SListHandle<T, Tr>::begin() const
+{
+ return Glib::Container_Helpers::SListHandleIterator<Tr>(pslist_);
+}
+
+template <class T, class Tr>
+inline typename SListHandle<T, Tr>::const_iterator
+SListHandle<T, Tr>::end() const
+{
+ return Glib::Container_Helpers::SListHandleIterator<Tr>(nullptr);
+}
+
+template <class T, class Tr>
+template <class U>
+inline SListHandle<T, Tr>::operator std::vector<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::vector<U>(this->begin(), this->end());
+#else
+ std::vector<U> temp;
+ temp.reserve(this->size());
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline SListHandle<T, Tr>::operator std::deque<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::deque<U>(this->begin(), this->end());
+#else
+ std::deque<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class U>
+inline SListHandle<T, Tr>::operator std::list<U>() const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ return std::list<U>(this->begin(), this->end());
+#else
+ std::list<U> temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ return temp;
+#endif
+}
+
+template <class T, class Tr>
+template <class Cont>
+inline void
+SListHandle<T, Tr>::assign_to(Cont& container) const
+{
+#ifdef GLIBMM_HAVE_TEMPLATE_SEQUENCE_CTORS
+ container.assign(this->begin(), this->end());
+#else
+ Cont temp;
+ Glib::Container_Helpers::fill_container(temp, this->begin(), this->end());
+ container.swap(temp);
+#endif
+}
+
+template <class T, class Tr>
+template <class Out>
+inline void
+SListHandle<T, Tr>::copy(Out pdest) const
+{
+ std::copy(this->begin(), this->end(), pdest);
+}
+
+template <class T, class Tr>
+inline GSList*
+SListHandle<T, Tr>::data() const
+{
+ return pslist_;
+}
+
+template <class T, class Tr>
+inline std::size_t
+SListHandle<T, Tr>::size() const
+{
+ return g_slist_length(pslist_);
+}
+
+template <class T, class Tr>
+inline bool
+SListHandle<T, Tr>::empty() const
+{
+ return (pslist_ == nullptr);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} // namespace Glib
+
+#endif /* _GLIBMM_SLISTHANDLE_H */
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/streamiochannel.h>
+#include <glibmm/main.h> //For Source
+#include <glib.h>
+#include <fstream>
+#include <iostream>
+
+namespace Glib
+{
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+
+// static
+Glib::RefPtr<StreamIOChannel>
+StreamIOChannel::create(std::istream& stream)
+{
+ return Glib::RefPtr<StreamIOChannel>(new StreamIOChannel(&stream, nullptr));
+}
+
+// static
+Glib::RefPtr<StreamIOChannel>
+StreamIOChannel::create(std::ostream& stream)
+{
+ return Glib::RefPtr<StreamIOChannel>(new StreamIOChannel(nullptr, &stream));
+}
+
+// static
+Glib::RefPtr<StreamIOChannel>
+StreamIOChannel::create(std::iostream& stream)
+{
+ return Glib::RefPtr<StreamIOChannel>(new StreamIOChannel(&stream, &stream));
+}
+
+StreamIOChannel::StreamIOChannel(std::istream* stream_in, std::ostream* stream_out)
+: stream_in_(stream_in), stream_out_(stream_out)
+{
+ get_flags_vfunc(); // initialize GIOChannel flag bits
+}
+
+StreamIOChannel::~StreamIOChannel() noexcept
+{
+}
+
+IOStatus
+StreamIOChannel::read_vfunc(char* buf, gsize count, gsize& bytes_read)
+{
+ g_return_val_if_fail(stream_in_ != nullptr, IO_STATUS_ERROR);
+
+ stream_in_->clear();
+ stream_in_->read(buf, count);
+ bytes_read = stream_in_->gcount();
+
+ if (stream_in_->eof())
+ return IO_STATUS_EOF;
+
+ if (stream_in_->fail())
+ {
+ throw Glib::Error(G_IO_CHANNEL_ERROR, G_IO_CHANNEL_ERROR_FAILED, "Reading from stream failed");
+ }
+
+ return IO_STATUS_NORMAL;
+}
+
+IOStatus
+StreamIOChannel::write_vfunc(const char* buf, gsize count, gsize& bytes_written)
+{
+ g_return_val_if_fail(stream_out_ != nullptr, IO_STATUS_ERROR);
+
+ bytes_written = 0;
+
+ stream_out_->clear();
+ stream_out_->write(buf, count);
+
+ if (stream_out_->fail())
+ {
+ throw Glib::Error(G_IO_CHANNEL_ERROR, G_IO_CHANNEL_ERROR_FAILED, "Writing to stream failed");
+ }
+
+ bytes_written = count; // all or nothing ;)
+
+ return IO_STATUS_NORMAL;
+}
+
+IOStatus
+StreamIOChannel::seek_vfunc(gint64 offset, SeekType type)
+{
+ std::ios::seekdir direction = std::ios::beg;
+
+ switch (type)
+ {
+ case SEEK_TYPE_SET:
+ direction = std::ios::beg;
+ break;
+ case SEEK_TYPE_CUR:
+ direction = std::ios::cur;
+ break;
+ case SEEK_TYPE_END:
+ direction = std::ios::end;
+ break;
+ }
+
+ bool failed = false;
+
+ if (stream_in_)
+ {
+ stream_in_->clear();
+ stream_in_->seekg(offset, direction);
+ failed = stream_in_->fail();
+ }
+ if (stream_out_)
+ {
+ stream_out_->clear();
+ stream_out_->seekp(offset, direction);
+ failed = (failed || stream_out_->fail());
+ }
+
+ if (failed)
+ {
+ throw Glib::Error(G_IO_CHANNEL_ERROR, G_IO_CHANNEL_ERROR_FAILED, "Seeking into stream failed");
+ }
+
+ return Glib::IO_STATUS_NORMAL;
+}
+
+IOStatus
+StreamIOChannel::close_vfunc()
+{
+ bool failed = false;
+
+ if (std::fstream* const fstream = dynamic_cast<std::fstream*>(stream_in_))
+ {
+ fstream->clear();
+ fstream->close();
+ failed = fstream->fail();
+ }
+ else if (std::ifstream* const ifstream = dynamic_cast<std::ifstream*>(stream_in_))
+ {
+ ifstream->clear();
+ ifstream->close();
+ failed = ifstream->fail();
+ }
+ else if (std::ofstream* const ofstream = dynamic_cast<std::ofstream*>(stream_out_))
+ {
+ ofstream->clear();
+ ofstream->close();
+ failed = ofstream->fail();
+ }
+ else
+ {
+ throw Glib::Error(
+ G_IO_CHANNEL_ERROR, G_IO_CHANNEL_ERROR_FAILED, "Attempt to close non-file stream");
+ }
+
+ if (failed)
+ {
+ throw Glib::Error(G_IO_CHANNEL_ERROR, G_IO_CHANNEL_ERROR_FAILED, "Failed to close stream");
+ }
+
+ return IO_STATUS_NORMAL;
+}
+
+IOStatus StreamIOChannel::set_flags_vfunc(IOFlags)
+{
+ return IO_STATUS_NORMAL;
+}
+
+IOFlags
+StreamIOChannel::get_flags_vfunc()
+{
+ gobj()->is_seekable = 1;
+ gobj()->is_readable = (stream_in_ != nullptr);
+ gobj()->is_writeable = (stream_out_ != nullptr);
+
+ IOFlags flags = IO_FLAG_IS_SEEKABLE;
+
+ if (stream_in_)
+ flags |= IO_FLAG_IS_READABLE;
+ if (stream_out_)
+ flags |= IO_FLAG_IS_WRITEABLE;
+
+ return flags;
+}
+
+Glib::RefPtr<Glib::Source> StreamIOChannel::create_watch_vfunc(IOCondition)
+{
+ g_warning("Glib::StreamIOChannel::create_watch_vfunc() not implemented");
+ return Glib::RefPtr<Glib::Source>();
+}
+
+#endif // GLIBMM_DISABLE_DEPRECATED
+
+} // namespace Glib
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef _GLIBMM_STREAMIOCHANNEL_H
+#define _GLIBMM_STREAMIOCHANNEL_H
+
+#include <glibmmconfig.h>
+#include <glibmm/iochannel.h>
+#include <iosfwd>
+
+namespace Glib
+{
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+
+/** @deprecated This whole class was deprecated in glibmm 2.2 - See the Glib::IOChannel
+ * documentation for an explanation.
+ */
+class StreamIOChannel : public Glib::IOChannel
+{
+public:
+ ~StreamIOChannel() noexcept override;
+
+ static Glib::RefPtr<StreamIOChannel> create(std::istream& stream);
+ static Glib::RefPtr<StreamIOChannel> create(std::ostream& stream);
+ static Glib::RefPtr<StreamIOChannel> create(std::iostream& stream);
+
+protected:
+ std::istream* stream_in_;
+ std::ostream* stream_out_;
+
+ StreamIOChannel(std::istream* stream_in, std::ostream* stream_out);
+
+ IOStatus read_vfunc(char* buf, gsize count, gsize& bytes_read) override;
+ IOStatus write_vfunc(const char* buf, gsize count, gsize& bytes_written) override;
+ IOStatus seek_vfunc(gint64 offset, SeekType type) override;
+ IOStatus close_vfunc() override;
+ IOStatus set_flags_vfunc(IOFlags flags) override;
+ IOFlags get_flags_vfunc() override;
+ Glib::RefPtr<Glib::Source> create_watch_vfunc(IOCondition cond) override;
+};
+
+#endif //#GLIBMM_DISABLE_DEPRECATED
+
+} // namespace Glib
+
+#endif /* _GLIBMM_STREAMIOCHANNEL_H */
*
* @param str The string to convert to a numeric value.
* @param start_index The index of the first character that should be used in the conversion.
- * @retval end_index The index of the character after the last character used in the conversion.
+ * @param[out] end_index The index of the character after the last character used in the conversion.
* @return The <tt>double</tt> value.
* @throw std::out_of_range Thrown if @a start_index is out of range.
* @throw std::overflow_error Thrown if the correct value would cause overflow.
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+#ifndef GLIBMM_DISABLE_DEPRECATED
+
+#include <glibmm/threadpool.h>
+#include <glibmm/exceptionhandler.h>
+#include <glibmm/threads.h>
+#include <glib.h>
+#include <list>
+
+namespace Glib
+{
+
+// internal
+class ThreadPool::SlotList
+{
+public:
+ SlotList();
+ ~SlotList() noexcept;
+
+ // noncopyable
+ SlotList(const ThreadPool::SlotList&) = delete;
+ ThreadPool::SlotList& operator=(const ThreadPool::SlotList&) = delete;
+
+ sigc::slot<void>* push(const sigc::slot<void>& slot);
+ sigc::slot<void> pop(sigc::slot<void>* slot_ptr);
+
+ void lock_and_unlock();
+
+private:
+ Glib::Threads::Mutex mutex_;
+ std::list<sigc::slot<void>> list_;
+};
+
+ThreadPool::SlotList::SlotList()
+{
+}
+
+ThreadPool::SlotList::~SlotList() noexcept
+{
+}
+
+sigc::slot<void>*
+ThreadPool::SlotList::push(const sigc::slot<void>& slot)
+{
+ Threads::Mutex::Lock lock(mutex_);
+
+ list_.emplace_back(slot);
+ return &list_.back();
+}
+
+sigc::slot<void>
+ThreadPool::SlotList::pop(sigc::slot<void>* slot_ptr)
+{
+ sigc::slot<void> slot;
+
+ {
+ Threads::Mutex::Lock lock(mutex_);
+
+ std::list<sigc::slot<void>>::iterator pslot = list_.begin();
+ while (pslot != list_.end() && slot_ptr != &*pslot)
+ ++pslot;
+
+ if (pslot != list_.end())
+ {
+ slot = *pslot;
+ list_.erase(pslot);
+ }
+ }
+
+ return slot;
+}
+
+void
+ThreadPool::SlotList::lock_and_unlock()
+{
+ mutex_.lock();
+ mutex_.unlock();
+}
+
+} // namespace Glib
+
+namespace
+{
+
+static void
+call_thread_entry_slot(void* data, void* user_data)
+{
+ try
+ {
+ Glib::ThreadPool::SlotList* const slot_list =
+ static_cast<Glib::ThreadPool::SlotList*>(user_data);
+
+ sigc::slot<void> slot(slot_list->pop(static_cast<sigc::slot<void>*>(data)));
+
+ slot();
+ }
+ catch (Glib::Threads::Thread::Exit&)
+ {
+ // Just exit from the thread. The Thread::Exit exception
+ // is our sane C++ replacement of g_thread_exit().
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+}
+
+} // anonymous namespace
+
+namespace Glib
+{
+
+ThreadPool::ThreadPool(int max_threads, bool exclusive)
+: gobject_(nullptr), slot_list_(new SlotList())
+{
+ GError* error = nullptr;
+
+ gobject_ = g_thread_pool_new(&call_thread_entry_slot, slot_list_, max_threads, exclusive, &error);
+
+ if (error)
+ {
+ delete slot_list_;
+ slot_list_ = nullptr;
+ Glib::Error::throw_exception(error);
+ }
+}
+
+ThreadPool::~ThreadPool() noexcept
+{
+ if (gobject_)
+ g_thread_pool_free(gobject_, 1, 1);
+
+ if (slot_list_)
+ {
+ slot_list_->lock_and_unlock();
+ delete slot_list_;
+ }
+}
+
+void
+ThreadPool::push(const sigc::slot<void>& slot)
+{
+ sigc::slot<void>* const slot_ptr = slot_list_->push(slot);
+
+ GError* error = nullptr;
+ g_thread_pool_push(gobject_, slot_ptr, &error);
+
+ if (error)
+ {
+ slot_list_->pop(slot_ptr);
+ Glib::Error::throw_exception(error);
+ }
+}
+
+void
+ThreadPool::set_max_threads(int max_threads)
+{
+ GError* error = nullptr;
+ g_thread_pool_set_max_threads(gobject_, max_threads, &error);
+
+ if (error)
+ Glib::Error::throw_exception(error);
+}
+
+int
+ThreadPool::get_max_threads() const
+{
+ return g_thread_pool_get_max_threads(gobject_);
+}
+
+unsigned int
+ThreadPool::get_num_threads() const
+{
+ return g_thread_pool_get_num_threads(gobject_);
+}
+
+unsigned int
+ThreadPool::unprocessed() const
+{
+ return g_thread_pool_unprocessed(gobject_);
+}
+
+bool
+ThreadPool::get_exclusive() const
+{
+ g_return_val_if_fail(gobject_ != nullptr, false);
+
+ return gobject_->exclusive;
+}
+
+void
+ThreadPool::shutdown(bool immediately)
+{
+ if (gobject_)
+ {
+ g_thread_pool_free(gobject_, immediately, 1);
+ gobject_ = nullptr;
+ }
+
+ if (slot_list_)
+ {
+ slot_list_->lock_and_unlock();
+ delete slot_list_;
+ slot_list_ = nullptr;
+ }
+}
+
+// static
+void
+ThreadPool::set_max_unused_threads(int max_threads)
+{
+ g_thread_pool_set_max_unused_threads(max_threads);
+}
+
+// static
+int
+ThreadPool::get_max_unused_threads()
+{
+ return g_thread_pool_get_max_unused_threads();
+}
+
+// static
+unsigned int
+ThreadPool::get_num_unused_threads()
+{
+ return g_thread_pool_get_num_unused_threads();
+}
+
+// static
+void
+ThreadPool::stop_unused_threads()
+{
+ g_thread_pool_stop_unused_threads();
+}
+
+} // namespace Glib
+
+#endif // GLIBMM_DISABLE_DEPRECATED
--- /dev/null
+#ifndef _GLIBMM_THREADPOOL_H
+#define _GLIBMM_THREADPOOL_H
+
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmmconfig.h>
+
+#ifndef GLIBMM_DISABLE_DEPRECATED
+
+#include <sigc++/sigc++.h>
+
+extern "C" {
+using GThreadPool = struct _GThreadPool;
+}
+
+namespace Glib
+{
+
+/** @defgroup ThreadPools Thread Pools
+ * Pools of threads to execute work concurrently.
+ *
+ * @deprecated This is deprecated in favor of the standard C++ concurrency API in C++11 and C++14.
+ *
+ * @{
+ */
+
+// TODO: Is std::async() an appropriate replacement to mention for this deprecated API?
+
+/** A pool of threads to execute work concurrently.
+ *
+ * @deprecated This is deprecated in favor of the standard C++ concurrency API in C++11 and C++14.
+ */
+class ThreadPool
+{
+public:
+ /** Constructs a new thread pool.
+ * Whenever you call ThreadPool::push(), either a new thread is created or an
+ * unused one is reused. At most @a max_threads threads are running
+ * concurrently for this thread pool. @a max_threads = -1 allows
+ * unlimited threads to be created for this thread pool.
+ *
+ * The parameter @a exclusive determines, whether the thread pool owns all
+ * threads exclusive or whether the threads are shared globally. If @a
+ * exclusive is <tt>true</tt>, @a max_threads threads are started immediately
+ * and they will run exclusively for this thread pool until it is destroyed
+ * by ~ThreadPool(). If @a exclusive is <tt>false</tt>, threads are created
+ * when needed and shared between all non-exclusive thread pools. This
+ * implies that @a max_threads may not be -1 for exclusive thread pools.
+ *
+ * @param max_threads The maximal number of threads to execute concurrently
+ * in the new thread pool, -1 means no limit.
+ * @param exclusive Should this thread pool be exclusive?
+ * @throw Glib::ThreadError An error can only occur when @a exclusive is
+ * set to <tt>true</tt> and not all @a max_threads threads could be created.
+ */
+ explicit ThreadPool(int max_threads = -1, bool exclusive = false);
+ virtual ~ThreadPool() noexcept;
+
+ // See http://bugzilla.gnome.org/show_bug.cgi?id=512348 about the sigc::trackable issue.
+ // TODO: At the next ABI break, consider changing const sigc::slot<void>& slot
+ // to const std::function<void()>& func, if it can be assumed that all supported
+ // compilers understand the C++11 template class std::function<>.
+ /** Inserts @a slot into the list of tasks to be executed by the pool.
+ * When the number of currently running threads is lower than the maximal
+ * allowed number of threads, a new thread is started (or reused). Otherwise
+ * @a slot stays in the queue until a thread in this pool finishes its
+ * previous task and processes @a slot.
+ *
+ * Because sigc::trackable is not thread-safe, if the slot represents a
+ * non-static class method and is created by sigc::mem_fun(), the class concerned
+ * should not derive from sigc::trackable. You can use, say, boost::bind() or,
+ * in C++11, std::bind() or a C++11 lambda expression instead of sigc::mem_fun().
+ *
+ * @param slot A new task for the thread pool.
+ * @throw Glib::ThreadError An error can only occur when a new thread
+ * couldn't be created. In that case @a slot is simply appended to the
+ * queue of work to do.
+ */
+ void push(const sigc::slot<void>& slot);
+
+ /** Sets the maximal allowed number of threads for the pool.
+ * A value of -1 means that the maximal number of threads is unlimited.
+ * Setting @a max_threads to 0 means stopping all work for pool. It is
+ * effectively frozen until @a max_threads is set to a non-zero value again.
+ *
+ * A thread is never terminated while it is still running. Instead the
+ * maximal number of threads only has effect for the allocation of new
+ * threads in ThreadPool::push(). A new thread is allocated whenever the
+ * number of currently running threads in the pool is smaller than the
+ * maximal number.
+ *
+ * @param max_threads A new maximal number of threads for the pool.
+ * @throw Glib::ThreadError An error can only occur when a new thread
+ * couldn't be created.
+ */
+ void set_max_threads(int max_threads);
+
+ /** Returns the maximal number of threads for the pool.
+ * @return The maximal number of threads.
+ */
+ int get_max_threads() const;
+
+ /** Returns the number of threads currently running in the pool.
+ * @return The number of threads currently running.
+ */
+ unsigned int get_num_threads() const;
+
+ /** Returns the number of tasks still unprocessed in the pool.
+ * @return The number of unprocessed tasks.
+ */
+ unsigned int unprocessed() const;
+
+ /** Returns whether all threads are exclusive to this pool.
+ * @return Whether all threads are exclusive to this pool.
+ */
+ bool get_exclusive() const;
+
+ /** Frees all resources allocated for the pool.
+ * If @a immediately is <tt>true</tt>, no new task is processed. Otherwise the
+ * pool is not freed before the last task is processed. Note however, that no
+ * thread of this pool is interrupted while processing a task. Instead at least
+ * all still running threads can finish their tasks before the pool is freed.
+ *
+ * This method does not return before all tasks to be processed (dependent on
+ * @a immediately, whether all or only the currently running) are ready.
+ * After calling shutdown() the pool must not be used anymore.
+ *
+ * @param immediately Should the pool shut down immediately?
+ */
+ void shutdown(bool immediately = false);
+
+ /** Sets the maximal number of unused threads to @a max_threads.
+ * If @a max_threads is -1, no limit is imposed on the number of unused threads.
+ * @param max_threads Maximal number of unused threads.
+ */
+ static void set_max_unused_threads(int max_threads);
+
+ /** Returns the maximal allowed number of unused threads.
+ * @return The maximal number of unused threads.
+ */
+ static int get_max_unused_threads();
+
+ /** Returns the number of currently unused threads.
+ * @return The number of currently unused threads.
+ */
+ static unsigned int get_num_unused_threads();
+
+ /** Stops all currently unused threads.
+ * This does not change the maximal number of unused threads. This function can
+ * be used to regularly stop all unused threads e.g. from Glib::signal_timeout().
+ */
+ static void stop_unused_threads();
+
+ GThreadPool* gobj() { return gobject_; }
+ const GThreadPool* gobj() const { return gobject_; }
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ class SlotList;
+#endif
+
+private:
+ GThreadPool* gobject_;
+ SlotList* slot_list_;
+
+ ThreadPool(const ThreadPool&);
+ ThreadPool& operator=(const ThreadPool&);
+};
+
+/** @} group ThreadPools */
+
+/***************************************************************************/
+/* inline implementation */
+/***************************************************************************/
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/**** Glib::Private ********************************************************/
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} // namespace Glib
+
+#endif // GLIBMM_DISABLE_DEPRECATED
+
+#endif /* _GLIBMM_THREADPOOL_H */
return (is_valid != 0);
}
-ustring
-ustring::make_valid() const
-{
- return ustring(g_utf8_make_valid(string_.data(), string_.size()));
-}
-
bool
ustring::is_ascii() const
{
// static
ustring
-ustring::compose_private(const Glib::ustring& fmt, std::initializer_list<const ustring*> const ilist)
+ustring::compose_argv(const Glib::ustring& fmt, int argc, const ustring* const* argv)
{
std::string::size_type result_size = fmt.raw().size();
// Guesstimate the final string size.
- for (auto const it: ilist)
- result_size += it->raw().size();
+ for (int i = 0; i < argc; ++i)
+ result_size += argv[i]->raw().size();
std::string result;
result.reserve(result_size);
else
{
const int index = Ascii::digit_value(stop[1]) - 1;
- const int size = ilist.size();
- if (index >= 0 && index < size)
+ if (index >= 0 && index < argc)
{
result.append(start, stop - start);
- result += (*(ilist.begin() + index))->raw();
+ result += argv[index]->raw();
start = stop + 2;
}
else
#include <glibmm/unicode.h>
#include <glib.h>
-#include <cstddef> // for std::size_t and optionally std::ptrdiff_t
-#include <initializer_list>
#include <iosfwd>
#include <iterator>
#include <sstream>
#include <string>
+#ifndef GLIBMM_HAVE_STD_ITERATOR_TRAITS
+#include <cstddef> /* for std::ptrdiff_t */
+#endif
namespace Glib
{
* If you're using std::ostringstream to build strings for display in the
* user interface, you must convert the result back to UTF-8 as shown below:
* @code
- * std::locale::global(std::locale("")); // Set the global locale to the user's preferred locale.
- * // Usually unnecessary here, because Glib::init()
- * // does it for you.
+ * std::locale::global(std::locale("")); // set the global locale to the user's preferred locale
* std::ostringstream output;
* output << percentage << " % done";
* label->set_text(Glib::locale_to_utf8(output.str()));
/*! Check whether the string is valid UTF-8. */
bool validate(const_iterator& first_invalid) const;
- /*! Return a copy that is a valid UTF-8 string replacing invalid bytes in the
- * original with Unicode replacement character (U+FFFD).
- * If the string is valid - return it's copy.
- */
- ustring make_valid() const;
-
/*! Check whether the string is plain 7-bit ASCII. @par
* Unlike any other ustring method, is_ascii() is safe to use on invalid
* UTF-8 strings. If the string isn't valid UTF-8, it cannot be valid
bool is_ascii() const;
/*! "Normalize" the %Unicode character representation of the string. */
- ustring normalize(NormalizeMode mode = NormalizeMode::DEFAULT_COMPOSE) const;
+ ustring normalize(NormalizeMode mode = NORMALIZE_DEFAULT_COMPOSE) const;
//! @}
//! @name Character case conversion.
/* Returns fmt as is, but checks for invalid references in the format string.
* @newin{2,18}
*/
+ template <class T1>
static inline ustring compose(const ustring& fmt);
/*! Substitute placeholders in a format string with the referenced arguments.
- *
- * The template string uses a similar format to Qt’s QString class, in that
- * <tt>%1</tt>, <tt>%2</tt>, and so on to <tt>%9</tt> are used as placeholders
- * to be substituted with the string representation of the @a args 1–9, while
- * <tt>%%</tt> inserts a literal <tt>%</tt> in the output. Placeholders do not
- * have to appear in the same order as their corresponding function arguments.
- *
+ * The template string should be in <tt>qt-format</tt>, that is
+ * <tt>"%1"</tt>, <tt>"%2"</tt>, ..., <tt>"%9"</tt> are used as placeholders
+ * and <tt>"%%"</tt> denotes a literal <tt>"%"</tt>. Substitutions may be
+ * reordered.
* @par Example:
* @code
* using Glib::ustring;
* const int percentage = 50;
* const ustring text = ustring::compose("%1%% done", percentage);
* @endcode
- *
- * @param fmt The template string, in the format described above.
- * @param args 1 to 9 arguments to substitute for <tt>%1</tt> to <tt>%9</tt>
- * respectively.
- *
+ * @param fmt A template string in <tt>qt-format</tt>.
+ * @param a1 The argument to substitute for <tt>"%1"</tt>.
* @return The substituted message string.
- *
* @throw Glib::ConvertError
*
- * @newin{2,58}
+ * @newin{2,16}
*/
- template <class... Ts>
- static inline ustring compose(const ustring& fmt, const Ts&... args);
+ template <class T1>
+ static inline ustring compose(const ustring& fmt, const T1& a1);
- /*! Format the argument(s) to a string representation.
- *
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4>
+ static inline ustring compose(
+ const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5>
+ static inline ustring compose(
+ const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3,
+ const T4& a4, const T5& a5, const T6& a6);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6, class T7>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3,
+ const T4& a4, const T5& a5, const T6& a6, const T7& a7);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3,
+ const T4& a4, const T5& a5, const T6& a6, const T7& a7, const T8& a8);
+
+ /* See the documentation for compose(const ustring& fmt, const T1& a1).
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8,
+ class T9>
+ static inline ustring compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3,
+ const T4& a4, const T5& a5, const T6& a6, const T7& a7, const T8& a8, const T9& a9);
+
+ /*! Format the argument to its string representation.
* Applies the arguments in order to an std::wostringstream and returns the
* resulting string. I/O manipulators may also be used as arguments. This
* greatly simplifies the common task of converting a number to a string, as
* demonstrated by the example below. The format() methods can also be used
* in conjunction with compose() to facilitate localization of user-visible
* messages.
- *
* @code
* using Glib::ustring;
* double value = 22.0 / 7.0;
* ustring text = ustring::format(std::fixed, std::setprecision(2), value);
* @endcode
- *
* @note The use of a wide character stream in the implementation of format()
* is almost completely transparent. However, one of the instances where the
* use of wide streams becomes visible is when the std::setfill() stream
* manipulator is used. In order for std::setfill() to work the argument
* must be of type <tt>wchar_t</tt>. This can be achieved by using the
* <tt>L</tt> prefix with a character literal, as shown in the example.
- *
* @code
* using Glib::ustring;
* // Insert leading zeroes to fill in at least six digits
* ustring text = ustring::format(std::setfill(L'0'), std::setw(6), 123);
* @endcode
*
- * @param args One or more streamable values or I/O manipulators.
- *
+ * @param a1 A streamable value or an I/O manipulator.
* @return The string representation of the argument stream.
- *
* @throw Glib::ConvertError
*
- * @newin{2,58}
+ * @newin{2,16}
+ */
+ template <class T1>
+ static inline ustring format(const T1& a1);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2>
+ static inline ustring format(const T1& a1, const T2& a2);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
*/
- template <class... Ts>
- static inline ustring format(const Ts&... args);
+ template <class T1, class T2, class T3>
+ static inline ustring format(const T1& a1, const T2& a2, const T3& a3);
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4>
+ static inline ustring format(const T1& a1, const T2& a2, const T3& a3, const T4& a4);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5>
+ static inline ustring format(
+ const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6>
+ static inline ustring format(
+ const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5, const T6& a6);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6, class T7>
+ static inline ustring format(const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5,
+ const T6& a6, const T7& a7);
+
+ /* See the documentation for format(const T1& a1).
+ *
+ * @newin{2,16}
+ */
+ template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
+ static inline ustring format(const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5,
+ const T6& a6, const T7& a7, const T8& a8);
//! @}
private:
template <class T>
class Stringify;
-
- static ustring compose_private(const ustring& fmt, std::initializer_list<const ustring*> ilist);
-
class FormatStream;
+ static ustring compose_argv(const ustring& fmt, int argc, const ustring* const* argv);
+
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
std::string string_;
return string_;
}
-template <class... Ts>
+template <class T1>
+inline // static
+ ustring
+ ustring::format(const T1& a1)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ return buf.to_string();
+}
+
+template <class T1, class T2>
+inline // static
+ ustring
+ ustring::format(const T1& a1, const T2& a2)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3>
+inline // static
+ ustring
+ ustring::format(const T1& a1, const T2& a2, const T3& a3)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3, class T4>
+inline // static
+ ustring
+ ustring::format(const T1& a1, const T2& a2, const T3& a3, const T4& a4)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ buf.stream(a4);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3, class T4, class T5>
inline // static
ustring
- ustring::format(const Ts&... args)
+ ustring::format(const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5)
{
ustring::FormatStream buf;
- (buf.stream(args), ...);
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ buf.stream(a4);
+ buf.stream(a5);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6>
+inline // static
+ ustring
+ ustring::format(
+ const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5, const T6& a6)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ buf.stream(a4);
+ buf.stream(a5);
+ buf.stream(a6);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6, class T7>
+inline // static
+ ustring
+ ustring::format(const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5,
+ const T6& a6, const T7& a7)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ buf.stream(a4);
+ buf.stream(a5);
+ buf.stream(a6);
+ buf.stream(a7);
+ return buf.to_string();
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
+inline // static
+ ustring
+ ustring::format(const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5,
+ const T6& a6, const T7& a7, const T8& a8)
+{
+ ustring::FormatStream buf;
+ buf.stream(a1);
+ buf.stream(a2);
+ buf.stream(a3);
+ buf.stream(a4);
+ buf.stream(a5);
+ buf.stream(a6);
+ buf.stream(a7);
+ buf.stream(a8);
return buf.to_string();
}
class ustring::Stringify
{
private:
- const ustring string_;
+ ustring string_;
public:
explicit inline Stringify(const T& arg) : string_(ustring::format(arg)) {}
+ // TODO: Why is this here? See the template specialization:
+ explicit inline Stringify(const char* arg) : string_(arg) {}
+
// noncopyable
Stringify(const ustring::Stringify<T>&) = delete;
Stringify<T>& operator=(const ustring::Stringify<T>&) = delete;
- inline const ustring& ref() const { return string_; }
+ inline const ustring* ptr() const { return &string_; }
};
/// A template specialization for Stringify<ustring>:
Stringify(const ustring::Stringify<ustring>&) = delete;
Stringify<ustring>& operator=(const ustring::Stringify<ustring>&) = delete;
- inline const ustring& ref() const { return string_; }
+ inline const ustring* ptr() const { return &string_; }
};
/** A template specialization for Stringify<const char*>,
Stringify(const ustring::Stringify<const char*>&) = delete;
Stringify<ustring>& operator=(const ustring::Stringify<const char*>&) = delete;
- inline const ustring& ref() const { return string_; }
+ inline const ustring* ptr() const { return &string_; }
};
/** A template specialization for Stringify<char[N]> (for string literals),
Stringify(const ustring::Stringify<char[N]>&) = delete;
Stringify<ustring>& operator=(const ustring::Stringify<char[N]>&) = delete;
- inline const ustring& ref() const { return string_; }
+ inline const ustring* ptr() const { return &string_; }
};
/** A template specialization for Stringify<const char[N]> (for string literals),
Stringify(const ustring::Stringify<const char[N]>&) = delete;
Stringify<ustring>& operator=(const ustring::Stringify<const char[N]>&) = delete;
- inline const ustring& ref() const { return string_; }
+ inline const ustring* ptr() const { return &string_; }
};
+template <class T1>
inline // static
ustring
ustring::compose(const ustring& fmt)
{
- return ustring::compose_private(fmt, {});
+ return ustring::compose_argv(fmt, 0, nullptr);
}
-template <class... Ts>
+template <class T1>
inline // static
ustring
- ustring::compose(const ustring& fmt, const Ts&... args)
+ ustring::compose(const ustring& fmt, const T1& a1)
{
- static_assert(sizeof...(Ts) <= 9,
- "ustring::compose only supports up to 9 placeholders.");
+ const ustring::Stringify<T1> s1(a1);
- return compose_private(fmt, {&Stringify<Ts>(args).ref()...});
+ const ustring* const argv[] = { s1.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4, class T5>
+inline // static
+ ustring
+ ustring::compose(
+ const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4, const T5& a5)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+ const ustring::Stringify<T5> s5(a5);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr(), s5.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4,
+ const T5& a5, const T6& a6)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+ const ustring::Stringify<T5> s5(a5);
+ const ustring::Stringify<T6> s6(a6);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr(), s5.ptr(), s6.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6, class T7>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4,
+ const T5& a5, const T6& a6, const T7& a7)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+ const ustring::Stringify<T5> s5(a5);
+ const ustring::Stringify<T6> s6(a6);
+ const ustring::Stringify<T7> s7(a7);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr(), s5.ptr(), s6.ptr(),
+ s7.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4,
+ const T5& a5, const T6& a6, const T7& a7, const T8& a8)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+ const ustring::Stringify<T5> s5(a5);
+ const ustring::Stringify<T6> s6(a6);
+ const ustring::Stringify<T7> s7(a7);
+ const ustring::Stringify<T8> s8(a8);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr(), s5.ptr(), s6.ptr(),
+ s7.ptr(), s8.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
+}
+
+template <class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8, class T9>
+inline // static
+ ustring
+ ustring::compose(const ustring& fmt, const T1& a1, const T2& a2, const T3& a3, const T4& a4,
+ const T5& a5, const T6& a6, const T7& a7, const T8& a8, const T9& a9)
+{
+ const ustring::Stringify<T1> s1(a1);
+ const ustring::Stringify<T2> s2(a2);
+ const ustring::Stringify<T3> s3(a3);
+ const ustring::Stringify<T4> s4(a4);
+ const ustring::Stringify<T5> s5(a5);
+ const ustring::Stringify<T6> s6(a6);
+ const ustring::Stringify<T7> s7(a7);
+ const ustring::Stringify<T8> s8(a8);
+ const ustring::Stringify<T9> s9(a9);
+
+ const ustring* const argv[] = { s1.ptr(), s2.ptr(), s3.ptr(), s4.ptr(), s5.ptr(), s6.ptr(),
+ s7.ptr(), s8.ptr(), s9.ptr() };
+ return ustring::compose_argv(fmt, G_N_ELEMENTS(argv), argv);
}
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
#ifndef DOXYGEN_SHOULD_SKIP_THIS
+#ifndef GLIBMM_DISABLE_DEPRECATED
+/* Occasionally, a struct variable has to be initialized after its definition,
+ * i.e. when using structs as class member data. For convenience, the macro
+ * GLIBMM_INITIALIZE_STRUCT(Var, Type) is provided. It even avoids creating
+ * a temporary if the compiler is GCC.
+ *
+ * @deprecated Use e.g. std::memset() instead.
+ * It's not used any more in the code generated by _CLASS_BOXEDTYPE_STATIC.
+ * It generates compiler warnings if __STRICT_ANSI__ is defined.
+ */
+#if ((__GNUC__ >= 3) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)) && !defined(__STRICT_ANSI__)
+
+#define GLIBMM_INITIALIZE_STRUCT(Var, Type) __builtin_memset(&(Var), 0, sizeof(Type))
+
+#else
+
+// TODO: This causes warnings like this:
+//"missing initializer for member"
+#define GLIBMM_INITIALIZE_STRUCT(Var, Type) \
+ G_STMT_START \
+ { \
+ Type const temp_initializer__ = { \
+ 0, \
+ }; \
+ (Var) = temp_initializer__; \
+ } \
+ G_STMT_END
+
+#endif
+#endif // GLIBMM_DISABLE_DEPRECATED
+
namespace Glib
{
// These are used by gmmproc-generated type conversions:
+#ifndef GLIBMM_DISABLE_DEPRECATED
+/** Helper to deal with memory allocated
+ * by GLib functions in an exception-safe manner.
+ *
+ * @deprecated Use make_unique_ptr_gfree() instead.
+ */
+template <typename T>
+class ScopedPtr
+{
+private:
+ T* ptr_;
+ ScopedPtr(const ScopedPtr<T>&);
+ ScopedPtr<T>& operator=(const ScopedPtr<T>&);
+
+public:
+ ScopedPtr() : ptr_(nullptr) {}
+ explicit ScopedPtr(T* ptr) : ptr_(ptr) {}
+ ~ScopedPtr() noexcept { g_free(ptr_); }
+ T* get() const { return ptr_; }
+ T** addr() { return &ptr_; }
+};
+#endif // GLIBMM_DISABLE_DEPRECATED
+
/** Helper to deal with memory allocated
* by GLib functions in an exception-safe manner.
*
return std::unique_ptr<T[], decltype(&g_free)>(p, &g_free);
}
+// TODO: Deprecate this? We don't use it ourselves.
+/** Removes the const nature of a ptr
+ *
+ */
+template <class T>
+inline T*
+unconst(const T* t)
+{
+ return const_cast<T*>(t);
+}
+
// Convert const gchar* to ustring, while treating NULL as empty string.
inline Glib::ustring
convert_const_gchar_ptr_to_ustring(const char* str)
#include <glibmm/value.h>
#include <glibmm/objectbase.h>
#include <glibmm/utility.h>
+#include <glibmm/vectorutils.h>
#include <glibmm/wrap.h>
#include <cstring> // std::memset()
ValueBase_Object::get_object_copy() const
{
GObject* const data = static_cast<GObject*>(g_value_get_object(&gobject_));
- return Glib::make_refptr_for_instance<Glib::ObjectBase>(Glib::wrap_auto(data, true));
+ return Glib::RefPtr<Glib::ObjectBase>(Glib::wrap_auto(data, true));
}
GParamSpec*
get_cstring(), static_cast<GParamFlags>(flags));
}
+/**** Glib::ValueBase_Variant ************************************************/
+
+// static
+GType ValueBase_Variant::value_type()
+{
+ return G_TYPE_VARIANT;
+}
+
+void ValueBase_Variant::set_variant(GVariant* data)
+{
+ g_value_set_variant(&gobject_, data);
+}
+
+GVariant* ValueBase_Variant::get_variant() const
+{
+ return g_value_get_variant(&gobject_);
+}
+
+GParamSpec* ValueBase_Variant::create_param_spec(const Glib::ustring& name,
+ const Glib::ustring& nick, const Glib::ustring& blurb, Glib::ParamFlags flags) const
+{
+ GVariant* gvariant = g_value_get_variant(&gobject_);
+ const GVariantType* gvariant_type = gvariant ? g_variant_get_type(gvariant) : G_VARIANT_TYPE_ANY;
+
+ return g_param_spec_variant(
+ name.c_str(), c_str_or_nullptr(nick), c_str_or_nullptr(blurb),
+ gvariant_type, gvariant, static_cast<GParamFlags>(flags));
+}
+
/**** Glib::Value<std::string> *********************************************/
void
g_value_set_string(&gobject_, data.c_str());
}
+/**** Glib::Value<std::vector<std::string>> ********************************/
+
+// static
+GType Value<std::vector<std::string>>::value_type()
+{
+ return G_TYPE_STRV;
+}
+
+void Value<std::vector<std::string>>::set(const CppType& data)
+{
+ set_boxed(Glib::ArrayHandler<std::string>::vector_to_array(data).data());
+}
+
+std::vector<std::string> Value<std::vector<std::string>>::get() const
+{
+ return Glib::ArrayHandler<std::string>::array_to_vector(
+ static_cast<const char* const*>(get_boxed()), Glib::OWNERSHIP_NONE);
+}
+
+/**** Glib::Value<std::vector<Glib::ustring>> ********************************/
+
+// static
+GType Value<std::vector<Glib::ustring>>::value_type()
+{
+ return G_TYPE_STRV;
+}
+
+void Value<std::vector<Glib::ustring>>::set(const CppType& data)
+{
+ set_boxed(Glib::ArrayHandler<Glib::ustring>::vector_to_array(data).data());
+}
+
+std::vector<Glib::ustring> Value<std::vector<Glib::ustring>>::get() const
+{
+ return Glib::ArrayHandler<Glib::ustring>::array_to_vector(
+ static_cast<const char* const*>(get_boxed()), Glib::OWNERSHIP_NONE);
+}
+
} // namespace Glib
#include <glibmm/ustring.h>
#include <glibmm/enums.h>
#include <glib-object.h>
+#include <vector>
namespace Glib
{
class ValueBase_Enum : public ValueBase
{
public:
+ using CType = gint;
static GType value_type() G_GNUC_CONST;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
class ValueBase_Flags : public ValueBase
{
public:
+ using CType = guint;
static GType value_type() G_GNUC_CONST;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
class ValueBase_String : public ValueBase
{
public:
+ using CType = const gchar*;
static GType value_type() G_GNUC_CONST;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
const char* get_cstring() const; // never returns nullptr
};
+/**
+ * @ingroup glibmmValue
+ */
+class ValueBase_Variant : public ValueBase
+{
+public:
+ static GType value_type() G_GNUC_CONST;
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ GParamSpec* create_param_spec(const Glib::ustring& name, const Glib::ustring& nick,
+ const Glib::ustring& blurb, Glib::ParamFlags flags) const;
+#endif
+
+protected:
+ void set_variant(GVariant* data);
+ GVariant* get_variant() const; // doesn't copy, may return nullptr
+};
+
+
} // namespace Glib
-/* Include generic Glib::Value<> template, before any specializations:
+/* Include primary Glib::Value<> template, before any specializations:
*/
#define _GLIBMM_VALUE_H_INCLUDE_VALUE_CUSTOM_H
#include <glibmm/value_custom.h>
template <class T>
class Value_Boxed : public ValueBase_Boxed
{
+// Used by _CLASS_BOXEDTYPE and _CLASS_BOXEDTYPE_STATIC
public:
using CppType = T;
+ using CType = typename T::BaseObjectType*;
static GType value_type() { return T::get_type(); }
void set(const CppType& data) { set_boxed(data.gobj()); }
- CppType get() const { return CppType(static_cast<typename T::BaseObjectType*>(get_boxed())); }
+ CppType get() const { return CppType(static_cast<CType>(get_boxed())); }
};
-// More spec-compliant compilers (such as Tru64) need this to be near Glib::Object instead.
-#ifdef GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
-
-namespace Traits {
-
-template<typename, typename>
-struct HasGetBaseType;
-
-template<typename T, typename Ret, typename... Args>
-struct HasGetBaseType<T, Ret(Args...)> {
- template<typename U, U>
- struct Check;
+/**
+ * @ingroup glibmmValue
+ */
+template <class T>
+class Value_RefPtrBoxed : public ValueBase_Boxed
+{
+// Used by _CLASS_OPAQUE_REFCOUNTED with _IS_REFCOUNTED_BOXEDTYPE
+public:
+ using CppType = Glib::RefPtr<T>;
- template<typename U>
- static std::true_type
- Test(Check<Ret(*)(Args...), &U::get_base_type>*);
+ static GType value_type() { return T::get_type(); }
- template<typename U>
- static std::false_type Test(...);
+ // Equivalent to set_boxed(Glib::unwrap(data)) without including wrap.h.
+ void set(const CppType& data) { set_boxed(data ? data->gobj() : nullptr); }
- static const bool value = decltype(Test<T>(0))::value;
- //using type = decltype(Test<T>(0));
+ // get() is defined in the Value<> specializations. It requires the declaration
+ // of Glib::wrap(T::BaseObjectType*, bool) to be visible.
+ // CppType get() const { return Glib::wrap(static_cast<typename T::BaseObjectType*>(get_boxed()), true); }
};
-} // namespace Traits
+// More spec-compliant compilers (such as Tru64) need this to be near Glib::Object instead.
+#ifdef GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
/** Partial specialization for RefPtr<> to Glib::Object.
* @ingroup glibmmValue
*/
template <class T>
-class Value<Glib::RefPtr<T>, typename std::enable_if<Glib::Traits::HasGetBaseType<T, GType()>::value>::type>
-: public ValueBase_Object
+class Value<Glib::RefPtr<T>> : public ValueBase_Object
{
public:
using CppType = Glib::RefPtr<T>;
+ using CType = typename T::BaseObjectType*;
static GType value_type() { return T::get_base_type(); }
- void set(const CppType& data) { set_object(const_cast<std::remove_const_t<T>*>(data.get())); }
- CppType get() const { return std::dynamic_pointer_cast<T>(get_object_copy()); }
+ void set(const CppType& data) { set_object(data.operator->()); }
+ CppType get() const { return Glib::RefPtr<T>::cast_dynamic(get_object_copy()); }
};
// The SUN Forte Compiler has a problem with this:
/** Partial specialization for RefPtr<> to const Glib::Object.
* @ingroup glibmmValue
*/
-/*
template <class T>
-class Value<Glib::RefPtr<const T>, typename std::enable_if<std::is_base_of<Glib::ObjectBase, T>::value>::type> : public ValueBase_Object
+class Value<Glib::RefPtr<const T>> : public ValueBase_Object
{
public:
using CppType = Glib::RefPtr<const T>;
+ using CType = typename T::BaseObjectType*;
static GType value_type() { return T::get_base_type(); }
- void set(const CppType& data) { set_object(const_cast<T*>(data.get())); }
- CppType get() const { return std::dynamic_pointer_cast<T>(get_object_copy()); }
+ void set(const CppType& data) { set_object(const_cast<T*>(data.operator->())); }
+ CppType get() const { return Glib::RefPtr<T>::cast_dynamic(get_object_copy()); }
};
-*/
#endif // GLIBMM_HAVE_DISAMBIGUOUS_CONST_TEMPLATE_SPECIALIZATIONS
#endif // GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
Glib::ustring get() const { return get_cstring(); }
};
+/** Specialization for vectors of strings.
+ * @ingroup glibmmValue
+ */
+template <>
+class Value<std::vector<std::string>> : public ValueBase_Boxed
+{
+public:
+ using CppType = std::vector<std::string>;
+
+ static GType value_type();
+
+ void set(const CppType& data);
+ CppType get() const;
+};
+
+/** Specialization for vectors of UTF-8 strings.
+ * @ingroup glibmmValue
+ */
+template <>
+class Value<std::vector<Glib::ustring>> : public ValueBase_Boxed
+{
+public:
+ using CppType = std::vector<Glib::ustring>;
+
+ static GType value_type();
+
+ void set(const CppType& data);
+ CppType get() const;
+};
+
/** Base class of Glib::Value<T> specializations for enum types.
* @ingroup glibmmValue
*/
public:
using CppType = T;
- void set(CppType data) { set_enum(static_cast<int>(data)); }
+ void set(CppType data) { set_enum(data); }
CppType get() const { return CppType(get_enum()); }
};
public:
using CppType = T;
- void set(CppType data) { set_flags(static_cast<unsigned int>(data)); }
+ void set(CppType data) { set_flags(data); }
CppType get() const { return CppType(get_flags()); }
};
/**
* @ingroup glibmmValue
*/
-template <class PtrT>
+template <class T, class PtrT>
class Value_Pointer : public ValueBase_Object
{
public:
- using T = std::remove_cv_t<std::remove_pointer_t<PtrT>>;
using CppType = PtrT;
+ using CType = void*;
static inline GType value_type() G_GNUC_CONST;
* cannot ensure that no exceptions will be thrown, consider using either
* a normal pointer or a smart pointer to hold your objects indirectly.
*/
-template <class T, typename Enable = void>
+template <class T>
class Value : public ValueBase_Boxed
{
public:
using CppType = T;
+ using CType = T*;
static GType value_type() G_GNUC_CONST;
* No attempt is made to manage the memory associated with the
* pointer, you must take care of that yourself.
*/
-template <class T, typename Enable>
-class Value<T*, Enable> : public Value_Pointer<T*>
+template <class T>
+class Value<T*> : public Value_Pointer<T, T*>
{
};
* No attempt is made to manage the memory associated with the
* pointer, you must take care of that yourself.
*/
-template <class T, typename Enable>
-class Value<const T*, Enable> : public Value_Pointer<const T*>
+template <class T>
+class Value<const T*> : public Value_Pointer<T, const T*>
{
};
#ifndef DOXYGEN_SHOULD_SKIP_THIS
-/**** Glib::Value_Pointer<PtrT> *****************************************/
+/**** Glib::Value_Pointer<T, PtrT> *****************************************/
/** Implementation for Glib::Object pointers **/
// static
-template <class PtrT>
+template <class T, class PtrT>
inline GType
-Value_Pointer<PtrT>::value_type_(Glib::Object*)
+Value_Pointer<T, PtrT>::value_type_(Glib::Object*)
{
return T::get_base_type();
}
-template <class PtrT>
+template <class T, class PtrT>
inline void
-Value_Pointer<PtrT>::set_(PtrT data, Glib::Object*)
+Value_Pointer<T, PtrT>::set_(PtrT data, Glib::Object*)
{
set_object(const_cast<T*>(data));
}
// More spec-compliant compilers (such as Tru64) need this to be near Glib::Object instead.
#ifdef GLIBMM_CAN_USE_DYNAMIC_CAST_IN_UNUSED_TEMPLATE_WITHOUT_DEFINITION
-template <class PtrT>
+template <class T, class PtrT>
inline PtrT
-Value_Pointer<PtrT>::get_(Glib::Object*) const
+Value_Pointer<T, PtrT>::get_(Glib::Object*) const
{
return dynamic_cast<T*>(get_object());
}
/** Implementation for custom pointers **/
// static
-template <class PtrT>
+template <class T, class PtrT>
GType
-Value_Pointer<PtrT>::value_type_(void*)
+Value_Pointer<T, PtrT>::value_type_(void*)
{
static GType custom_type = 0;
return custom_type;
}
-template <class PtrT>
+template <class T, class PtrT>
inline void
-Value_Pointer<PtrT>::set_(PtrT data, void*)
+Value_Pointer<T, PtrT>::set_(PtrT data, void*)
{
gobject_.data[0].v_pointer = const_cast<T*>(data);
}
-template <class PtrT>
+template <class T, class PtrT>
inline PtrT
-Value_Pointer<PtrT>::get_(void*) const
+Value_Pointer<T, PtrT>::get_(void*) const
{
return static_cast<T*>(gobject_.data[0].v_pointer);
}
/** Public forwarding interface **/
// static
-template <class PtrT>
+template <class T, class PtrT>
inline GType
-Value_Pointer<PtrT>::value_type()
+Value_Pointer<T, PtrT>::value_type()
{
// Dispatch to the specific value_type_() overload.
- return Value_Pointer<PtrT>::value_type_(static_cast<T*>(nullptr));
+ return Value_Pointer<T, PtrT>::value_type_(static_cast<T*>(nullptr));
}
-template <class PtrT>
+template <class T, class PtrT>
inline void
-Value_Pointer<PtrT>::set(PtrT data)
+Value_Pointer<T, PtrT>::set(PtrT data)
{
// Dispatch to the specific set_() overload.
this->set_(data, static_cast<T*>(nullptr));
}
-template <class PtrT>
+template <class T, class PtrT>
inline PtrT
-Value_Pointer<PtrT>::get() const
+Value_Pointer<T, PtrT>::get() const
{
// Dispatch to the specific get_() overload.
return this->get_(static_cast<T*>(nullptr));
/**** Glib::Value<T> *******************************************************/
// Static data, specific to each template instantiation.
-template <class T, typename Enable>
-GType Value<T, Enable>::custom_type_ = 0;
+template <class T>
+GType Value<T>::custom_type_ = 0;
-template <class T, typename Enable>
+template <class T>
inline void
-Value<T, Enable>::set(const typename Value<T, Enable>::CppType& data)
+Value<T>::set(const typename Value<T>::CppType& data)
{
// Assume the value is already default-initialized. See value_init_func().
*static_cast<T*>(gobject_.data[0].v_pointer) = data;
}
-template <class T, typename Enable>
-inline typename Value<T, Enable>::CppType
-Value<T, Enable>::get() const
+template <class T>
+inline typename Value<T>::CppType
+Value<T>::get() const
{
// Assume the pointer is not NULL. See value_init_func().
return *static_cast<T*>(gobject_.data[0].v_pointer);
}
// static
-template <class T, typename Enable>
+template <class T>
GType
-Value<T, Enable>::value_type()
+Value<T>::value_type()
{
if (!custom_type_)
{
}
// static
-template <class T, typename Enable>
+template <class T>
void
-Value<T, Enable>::value_init_func(GValue* value)
+Value<T>::value_init_func(GValue* value)
{
// Never store a NULL pointer (unless we're out of memory).
value->data[0].v_pointer = new (std::nothrow) T();
}
// static
-template <class T, typename Enable>
+template <class T>
void
-Value<T, Enable>::value_free_func(GValue* value)
+Value<T>::value_free_func(GValue* value)
{
delete static_cast<T*>(value->data[0].v_pointer);
}
// static
-template <class T, typename Enable>
+template <class T>
void
-Value<T, Enable>::value_copy_func(const GValue* src_value, GValue* dest_value)
+Value<T>::value_copy_func(const GValue* src_value, GValue* dest_value)
{
// Assume the source is not NULL. See value_init_func().
const T& source = *static_cast<T*>(src_value->data[0].v_pointer);
--- /dev/null
+#ifndef _GLIBMM_WEAKREF_H
+#define _GLIBMM_WEAKREF_H
+
+/* Copyright (C) 2015 The glibmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glib-object.h>
+#include <glibmm/refptr.h>
+#include <glibmm/objectbase.h>
+#include <type_traits> // std::is_base_of<>
+#include <utility> // std::swap<>, std::forward<>
+
+namespace Glib
+{
+
+/** WeakRef<> is a weak reference smartpointer.
+ *
+ * WeakRef can store a pointer to any class that is derived from Glib::ObjectBase,
+ * and whose reference() method is noexcept.
+ * In glibmm and gtkmm, that is anything derived from Glib::ObjectBase.
+ *
+ * Unlike a RefPtr, a WeakRef does not contribute to the reference counting of
+ * the underlying object.
+ *
+ * @newin{2,46}
+ */
+template <typename T_CppObject>
+class WeakRef
+{
+ static_assert(std::is_base_of<Glib::ObjectBase, T_CppObject>::value,
+ "Glib::WeakRef can be used only for classes derived from Glib::ObjectBase.");
+
+public:
+ /** Default constructor.
+ *
+ * Create an empty weak reference.
+ */
+ inline WeakRef() noexcept;
+
+ /// Copy constructor.
+ inline WeakRef(const WeakRef& src) noexcept;
+
+ /// Move constructor.
+ inline WeakRef(WeakRef&& src) noexcept;
+
+ /// Copy constructor from different, but castable type.
+ template <typename T_CastFrom>
+ inline WeakRef(const WeakRef<T_CastFrom>& src) noexcept;
+
+ /// Move constructor from different, but castable type.
+ template <typename T_CastFrom>
+ inline WeakRef(WeakRef<T_CastFrom>&& src) noexcept;
+
+ /** Constructor from a RefPtr of the same or a castable type.
+ *
+ * Create a weak reference from a RefPtr of the same or a castable type.
+ * If the RefPtr references nothing, an empty weak reference will be constructed.
+ */
+ template <typename T_CastFrom>
+ inline WeakRef(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /// Destructor.
+ inline ~WeakRef() noexcept;
+
+ /// Swap the contents of two WeakRef<>.
+ inline void swap(WeakRef& other) noexcept;
+
+ /// Copy assignment operator.
+ inline WeakRef& operator=(const WeakRef& src) noexcept;
+
+ /// Move assignment operator.
+ inline WeakRef& operator=(WeakRef&& src) noexcept;
+
+ /// Copy assignment from different, but castable type.
+ template <typename T_CastFrom>
+ inline WeakRef& operator=(const WeakRef<T_CastFrom>& src) noexcept;
+
+ /// Move assignment from different, but castable type.
+ template <typename T_CastFrom>
+ inline WeakRef& operator=(WeakRef<T_CastFrom>&& src) noexcept;
+
+ /// Assignment from a RefPtr of the same or a castable type.
+ template <typename T_CastFrom>
+ inline WeakRef& operator=(const RefPtr<T_CastFrom>& src) noexcept;
+
+ /** Test whether the WeakRef<> points to any underlying instance.
+ *
+ * Mimics usage of ordinary pointers:
+ * @code
+ * if (ptr)
+ * do_something();
+ * @endcode
+ *
+ * In a multi-threaded program a <tt>true</tt> return value can become
+ * obsolete at any time, even before the caller has a chance to test it,
+ * because the underlying instance may lose its last reference in another
+ * thread. Use get() if this is not acceptable.
+ */
+ inline explicit operator bool() const noexcept;
+
+ /** Create a strong reference to the underlying object.
+ *
+ * This is a thread-safe way to acquire a strong reference to the underlying
+ * object. If the WeakRef is empty, the returned RefPtr will reference nothing.
+ */
+ inline RefPtr<T_CppObject> get() const noexcept;
+
+ /// Make this WeakRef empty.
+ inline void reset() noexcept;
+
+ /** Dynamic cast to derived class.
+ *
+ * The WeakRef can't be cast with the usual notation so instead you can use
+ * @code
+ * ptr_derived = Glib::WeakRef<Derived>::cast_dynamic(ptr_base);
+ * @endcode
+ */
+ template <typename T_CastFrom>
+ static inline WeakRef cast_dynamic(const WeakRef<T_CastFrom>& src) noexcept;
+
+ /** Static cast to derived class.
+ *
+ * The WeakRef can't be cast with the usual notation so instead you can use
+ * @code
+ * ptr_derived = Glib::WeakRef<Derived>::cast_static(ptr_base);
+ * @endcode
+ */
+ template <typename T_CastFrom>
+ static inline WeakRef cast_static(const WeakRef<T_CastFrom>& src) noexcept;
+
+ /** Cast to non-const.
+ *
+ * The WeakRef can't be cast with the usual notation so instead you can use
+ * @code
+ * ptr_nonconst = Glib::WeakRef<NonConstType>::cast_const(ptr_const);
+ * @endcode
+ */
+ template <typename T_CastFrom>
+ static inline WeakRef cast_const(const WeakRef<T_CastFrom>& src) noexcept;
+
+private:
+ // Let all instantiations of WeakRef access private data.
+ template <typename T_CastFrom>
+ friend class WeakRef;
+
+ // If pCppObject != nullptr && gobject == nullptr,
+ // then the caller holds a strong reference.
+ void set(T_CppObject* pCppObject, GWeakRef* gobject) noexcept;
+
+ // WeakRef owns *gobject_, but it does not own *pCppObject_.
+ // Invariant: (!pCppObject_ || gobject_),
+ // i.e. if pCppObject_ != nullptr then also gobject_ != nullptr.
+ T_CppObject* pCppObject_;
+ GWeakRef* gobject_;
+
+ // Some methods would be simpler if gobject_ were a GWeakRef instead of
+ // a GWeakRef*, but then the move constructor and the move assignment
+ // operation would not be efficient.
+
+}; // end class WeakRef
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>::WeakRef() noexcept : pCppObject_(nullptr), gobject_(nullptr)
+{
+}
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>::WeakRef(const WeakRef& src) noexcept : pCppObject_(src.pCppObject_),
+ gobject_(nullptr)
+{
+ if (pCppObject_)
+ {
+ // We must own a strong reference to the underlying GObject while
+ // calling g_weak_ref_init().
+ gpointer ptr = g_weak_ref_get(src.gobject_);
+ if (ptr)
+ {
+ gobject_ = new GWeakRef;
+ g_weak_ref_init(gobject_, pCppObject_->gobj());
+ g_object_unref(ptr);
+ }
+ else
+ pCppObject_ = nullptr;
+ }
+}
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>::WeakRef(WeakRef&& src) noexcept : pCppObject_(src.pCppObject_),
+ gobject_(src.gobject_)
+{
+ src.pCppObject_ = nullptr;
+ src.gobject_ = nullptr;
+}
+
+// The templated ctor allows copy construction from any object that's
+// castable. Thus, it does downcasts:
+// base_ref = derived_ref
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>::WeakRef(const WeakRef<T_CastFrom>& src) noexcept
+ : pCppObject_(src.pCppObject_),
+ gobject_(nullptr)
+{
+ if (pCppObject_)
+ {
+ // We must own a strong reference to the underlying GObject while
+ // calling g_weak_ref_init().
+ gpointer ptr = g_weak_ref_get(src.gobject_);
+ if (ptr)
+ {
+ gobject_ = new GWeakRef;
+ g_weak_ref_init(gobject_, pCppObject_->gobj());
+ g_object_unref(ptr);
+ }
+ else
+ pCppObject_ = nullptr;
+ }
+}
+
+// The templated ctor allows move construction from any object that's
+// castable. Thus, it does downcasts:
+// base_ref = std::move(derived_ref)
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>::WeakRef(WeakRef<T_CastFrom>&& src) noexcept : pCppObject_(src.pCppObject_),
+ gobject_(src.gobject_)
+{
+ src.pCppObject_ = nullptr;
+ src.gobject_ = nullptr;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>::WeakRef(const RefPtr<T_CastFrom>& src) noexcept
+ : pCppObject_(src.operator->()),
+ gobject_(nullptr)
+{
+ if (pCppObject_)
+ {
+ gobject_ = new GWeakRef;
+ g_weak_ref_init(gobject_, pCppObject_->gobj());
+ }
+}
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>::~WeakRef() noexcept
+{
+ if (gobject_)
+ {
+ g_weak_ref_clear(gobject_);
+ delete gobject_;
+ }
+}
+
+template <class T_CppObject>
+void
+WeakRef<T_CppObject>::swap(WeakRef& other) noexcept
+{
+ std::swap(pCppObject_, other.pCppObject_);
+ std::swap(gobject_, other.gobject_);
+}
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>&
+WeakRef<T_CppObject>::operator=(const WeakRef& src) noexcept
+{
+ set(src.pCppObject_, src.gobject_);
+ return *this;
+}
+
+template <typename T_CppObject>
+WeakRef<T_CppObject>&
+WeakRef<T_CppObject>::operator=(WeakRef&& src) noexcept
+{
+ // See RefPtr for an explanation of the swap() technique to implement
+ // copy assignment and move assignment.
+ // This technique is inefficient for copy assignment of WeakRef,
+ // because it involves copy construction + destruction, i.e. in a typical
+ // case g_weak_ref_init() + g_weak_ref_clear(), when a g_weak_ref_set()
+ // would be enough. For move assignment, the swap technique is fine.
+ WeakRef<T_CppObject> temp(std::forward<WeakRef<T_CppObject>>(src));
+ this->swap(temp);
+ return *this;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>&
+WeakRef<T_CppObject>::operator=(const WeakRef<T_CastFrom>& src) noexcept
+{
+ set(src.pCppObject_, src.gobject_);
+ return *this;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>&
+WeakRef<T_CppObject>::operator=(WeakRef<T_CastFrom>&& src) noexcept
+{
+ WeakRef<T_CppObject> temp(std::forward<WeakRef<T_CastFrom>>(src));
+ this->swap(temp);
+ return *this;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>&
+WeakRef<T_CppObject>::operator=(const RefPtr<T_CastFrom>& src) noexcept
+{
+ T_CppObject* pCppObject = src.operator->();
+ set(pCppObject, nullptr);
+ return *this;
+}
+
+template <class T_CppObject>
+WeakRef<T_CppObject>::operator bool() const noexcept
+{
+ if (!pCppObject_)
+ return false;
+
+ gpointer ptr = g_weak_ref_get(gobject_);
+ if (!ptr)
+ return false;
+
+ g_object_unref(ptr);
+ return true;
+}
+
+template <typename T_CppObject>
+RefPtr<T_CppObject>
+WeakRef<T_CppObject>::get() const noexcept
+{
+ RefPtr<T_CppObject> ret;
+
+ if (!pCppObject_)
+ return ret;
+
+ gpointer ptr = g_weak_ref_get(gobject_);
+ if (!ptr)
+ return ret;
+
+ // A RefPtr constructed from pointer expects reference to be done externally.
+ pCppObject_->reference();
+ ret = RefPtr<T_CppObject>(pCppObject_);
+
+ g_object_unref(ptr);
+
+ return ret;
+}
+
+template <typename T_CppObject>
+void
+WeakRef<T_CppObject>::reset() noexcept
+{
+ set(nullptr, nullptr);
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>
+WeakRef<T_CppObject>::cast_dynamic(const WeakRef<T_CastFrom>& src) noexcept
+{
+ WeakRef<T_CppObject> ret;
+
+ if (!src.pCppObject_)
+ return ret;
+
+ gpointer ptr = g_weak_ref_get(src.gobject_);
+ if (!ptr)
+ return ret;
+
+ // Don't call dynamic_cast<>() unless we know that the referenced object
+ // still exists.
+ T_CppObject* const pCppObject = dynamic_cast<T_CppObject*>(src.pCppObject_);
+ ret.set(pCppObject, nullptr);
+ g_object_unref(ptr);
+
+ return ret;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>
+WeakRef<T_CppObject>::cast_static(const WeakRef<T_CastFrom>& src) noexcept
+{
+ T_CppObject* const pCppObject = static_cast<T_CppObject*>(src.pCppObject_);
+
+ WeakRef<T_CppObject> ret;
+ ret.set(pCppObject, src.gobject_);
+ return ret;
+}
+
+template <typename T_CppObject>
+template <typename T_CastFrom>
+WeakRef<T_CppObject>
+WeakRef<T_CppObject>::cast_const(const WeakRef<T_CastFrom>& src) noexcept
+{
+ T_CppObject* const pCppObject = const_cast<T_CppObject*>(src.pCppObject_);
+
+ WeakRef<T_CppObject> ret;
+ ret.set(pCppObject, src.gobject_);
+ return ret;
+}
+
+template <typename T_CppObject>
+void
+WeakRef<T_CppObject>::set(T_CppObject* pCppObject, GWeakRef* gobject) noexcept
+{
+ // We must own a strong reference to the underlying GObject while
+ // calling g_weak_ref_init() or g_weak_ref_set().
+ // If pCppObject != nullptr && gobject == nullptr,
+ // then the caller holds a strong reference.
+
+ // An aim with this moderately complicated method is to keep the same
+ // GWeakRef, calling g_weak_ref_set() when possible, instead of using swap(),
+ // which implies creating a new WeakRef, swapping with *this, and deleting
+ // the new WeakRef.
+
+ gpointer ptr = nullptr;
+ if (pCppObject && gobject)
+ ptr = g_weak_ref_get(gobject);
+
+ pCppObject_ = (ptr || !gobject) ? pCppObject : nullptr;
+ if (pCppObject_ && !gobject_)
+ {
+ gobject_ = new GWeakRef;
+ g_weak_ref_init(gobject_, pCppObject_->gobj());
+ }
+ else if (gobject_)
+ g_weak_ref_set(gobject_, pCppObject_ ? pCppObject_->gobj() : nullptr);
+
+ if (ptr)
+ g_object_unref(ptr);
+}
+
+#endif // DOXYGEN_SHOULD_SKIP_THIS
+
+/** Swap the contents of two WeakRef<>.
+ * @relates Glib::WeakRef
+ */
+template <class T_CppObject>
+inline void
+swap(WeakRef<T_CppObject>& lhs, WeakRef<T_CppObject>& rhs) noexcept
+{
+ lhs.swap(rhs);
+}
+
+} // namespace Glib
+
+#endif // _GLIBMM_WEAKREF_H
Glib::RefPtr<Object>
wrap(GObject* object, bool take_copy /* = false */)
{
- return Glib::make_refptr_for_instance<Object>(dynamic_cast<Object*>(wrap_auto(object, take_copy)));
+ return Glib::RefPtr<Object>(dynamic_cast<Object*>(wrap_auto(object, take_copy)));
}
} /* namespace Glib */
#include <glibmm/refptr.h>
#include <glibmm/ustring.h>
#include <glibmm/error.h>
-#include <sigc++/slot.h>
-#include <sigc++/bind.h>
+#include <glibmm/arrayhandle.h>
#include <glib.h>
namespace Glib
{
_CLASS_GENERIC(BalancedTree, GTree)
public:
- using TraverseFunc = sigc::slot<bool(const K&, const V&)>;
- using CompareFunc = sigc::slot<int(const K&, const K&)>;
+ using TraverseFunc = sigc::slot<bool, const K&, const V&>;
+ using CompareFunc = sigc::slot<int, const K&, const K&>;
protected:
BalancedTree() :
gobject_ = g_tree_new_full(on_compare_tree, &key_compare_slot, on_destroy_key, on_destroy_value);
}
- explicit BalancedTree(const CompareFunc &key_compare_slot_) :
+ BalancedTree(const CompareFunc &key_compare_slot_) :
key_compare_slot(key_compare_slot_)
{
gobject_ = g_tree_new_full(on_compare_tree, &key_compare_slot, on_destroy_key, on_destroy_value);
public:
static Glib::RefPtr< BalancedTree<K, V> > create()
{
- return Glib::make_refptr_for_instance< BalancedTree<K, V> >(new BalancedTree());
+ return Glib::RefPtr< BalancedTree<K, V> >(new BalancedTree());
}
static Glib::RefPtr< BalancedTree<K, V> > create(const CompareFunc &key_compare_slot)
{
- return Glib::make_refptr_for_instance< BalancedTree<K, V> >(new BalancedTree(key_compare_slot));
+ return Glib::RefPtr< BalancedTree<K, V> >(new BalancedTree(key_compare_slot));
}
~BalancedTree()
*/
V* search(const CompareFunc &search_func, const K& key)
{
- sigc::slot<int(const K&, const CompareFunc&, const K&)> real_slot = sigc::ptr_fun(on_compare_key);
- sigc::slot<int(const K&)> bound_slot = sigc::bind(real_slot, search_func, key);
+ sigc::slot<int, const K&, const CompareFunc&, const K&> real_slot = sigc::ptr_fun(on_compare_key);
+ sigc::slot<int, const K&> bound_slot = sigc::bind(real_slot, search_func, key);
gpointer value = g_tree_search(gobj(), c_callback_search, reinterpret_cast<gconstpointer>(&bound_slot));
return reinterpret_cast<V*>(value);
/// Wrapper for invoking GCompareFunc.
static gint c_callback_search(gconstpointer a, gconstpointer b)
{
- const auto slot = reinterpret_cast<const sigc::slot<int(const K&)> *>(b);
+ const sigc::slot<int, const K&>* slot = reinterpret_cast<const sigc::slot<int, const K&> *>(b);
return (*slot)(*reinterpret_cast<const K*>(a));
}
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-using Flags = Glib::Binding::Flags;
-
#include <glibmm/binding.h>
#include <glib.h>
// static
Glib::RefPtr<Binding>
Binding::bind_property_value(const PropertyProxy_Base& source_property,
- const PropertyProxy_Base& target_property, Flags flags, const SlotTransform& transform_to,
+ const PropertyProxy_Base& target_property, BindingFlags flags, const SlotTransform& transform_to,
const SlotTransform& transform_from)
{
GBinding* binding = nullptr;
// either the source object or the target object is finalized.
// The GBinding object must not be destroyed while there are RefPtrs around.
g_object_ref(binding);
- return Glib::make_refptr_for_instance<Binding>(new Binding(binding));
+ return Glib::RefPtr<Binding>(new Binding(binding));
}
void
namespace Glib
{
+_WRAP_ENUM(BindingFlags, GBindingFlags, newin "2,44")
/** Bind two object properties.
*
_CLASS_GOBJECT(Binding, GBinding, G_BINDING, Glib::Object, GObject)
public:
- _WRAP_ENUM(Flags, GBindingFlags, newin "2,44")
-
/** For instance,<br>
* bool on_transform_to(const GValue* from_value, GValue* to_value);
*
* @return <tt>true</tt> if the transformation was successful, and <tt>false</tt> otherwise.
*/
- using SlotTransform = sigc::slot<bool(const GValue*, GValue*)>;
+ using SlotTransform = sigc::slot<bool, const GValue*, GValue*>;
/** Creates a binding between @a source_property and @a target_property,
* allowing you to set the transformation functions to be used by the binding.
static Glib::RefPtr<Binding> bind_property_value(
const PropertyProxy_Base& source_property,
const PropertyProxy_Base& target_property,
- Flags flags = Flags::DEFAULT,
+ BindingFlags flags = BINDING_DEFAULT,
const SlotTransform& transform_to = SlotTransform(),
const SlotTransform& transform_from = SlotTransform());
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy_Base& source_property,
const PropertyProxy_Base& target_property,
- Flags flags = Flags::DEFAULT)
+ BindingFlags flags = BINDING_DEFAULT)
{
return bind_property_value(source_property, target_property, flags);
}
* stored in a Glib::Value<T_target> object.
* @tparam T_functor_to Type of functor that translates from the source to the target.
* Must be convertible to<br>
- * sigc::slot<bool(const T_source&, T_target&)>.
+ * sigc::slot<bool, const T_source&, T_target&>.
*
* @see bind_property_value()
*
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy<T_source>& source_property,
const PropertyProxy<T_target>& target_property,
- Flags flags,
+ BindingFlags flags,
const T_functor_to& transform_to)
{
- sigc::slot<bool(const T_source&, T_target&)> slot_transform_to = transform_to;
+ sigc::slot<bool, const T_source&, T_target&> slot_transform_to = transform_to;
return bind_property_value(source_property, target_property, flags,
slot_transform_to.empty() ? SlotTransform() : TransformProp<T_source, T_target>(slot_transform_to));
* stored in a Glib::Value<T_target> object.
* @tparam T_functor_to Type of functor that translates from the source to the target.
* Must be convertible to<br>
- * sigc::slot<bool(const T_source&, T_target&)>.
+ * sigc::slot<bool, const T_source&, T_target&>.
*
* @see bind_property_value()
*
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy<T_source>& source_property,
const PropertyProxy_WriteOnly<T_target>& target_property,
- Flags flags,
+ BindingFlags flags,
const T_functor_to& transform_to)
{
- sigc::slot<bool(const T_source&, T_target&)> slot_transform_to = transform_to;
+ sigc::slot<bool, const T_source&, T_target&> slot_transform_to = transform_to;
return bind_property_value(source_property, target_property, flags,
slot_transform_to.empty() ? SlotTransform() : TransformProp<T_source, T_target>(slot_transform_to));
* stored in a Glib::Value<T_target> object.
* @tparam T_functor_to Type of functor that translates from the source to the target.
* Must be convertible to<br>
- * sigc::slot<bool(const T_source&, T_target&)>.
+ * sigc::slot<bool, const T_source&, T_target&>.
*
* @see bind_property_value()
*
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy_ReadOnly<T_source>& source_property,
const PropertyProxy<T_target>& target_property,
- Flags flags,
+ BindingFlags flags,
const T_functor_to& transform_to)
{
- sigc::slot<bool(const T_source&, T_target&)> slot_transform_to = transform_to;
+ sigc::slot<bool, const T_source&, T_target&> slot_transform_to = transform_to;
return bind_property_value(source_property, target_property, flags,
slot_transform_to.empty() ? SlotTransform() : TransformProp<T_source, T_target>(slot_transform_to));
* stored in a Glib::Value<T_target> object.
* @tparam T_functor_to Type of functor that translates from the source to the target.
* Must be convertible to<br>
- * sigc::slot<bool(const T_source&, T_target&)>.
+ * sigc::slot<bool, const T_source&, T_target&>.
*
* @see bind_property_value()
*
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy_ReadOnly<T_source>& source_property,
const PropertyProxy_WriteOnly<T_target>& target_property,
- Flags flags,
+ BindingFlags flags,
const T_functor_to& transform_to)
{
- sigc::slot<bool(const T_source&, T_target&)> slot_transform_to = transform_to;
+ sigc::slot<bool, const T_source&, T_target&> slot_transform_to = transform_to;
return bind_property_value(source_property, target_property, flags,
slot_transform_to.empty() ? SlotTransform() : TransformProp<T_source, T_target>(slot_transform_to));
* stored in a Glib::Value<T_target> object.
* @tparam T_functor_to Type of functor that translates from the source to the target.
* Must be convertible to<br>
- * sigc::slot<bool(const T_source&, T_target&)>.
+ * sigc::slot<bool, const T_source&, T_target&>.
* @tparam T_functor_from Type of functor that translates from the target to the source.
* Must be convertible to<br>
- * sigc::slot<bool(const T_target&, T_source&)>.
+ * sigc::slot<bool, const T_target&, T_source&>.
*
* @see bind_property_value()
*
static Glib::RefPtr<Binding> bind_property(
const PropertyProxy<T_source>& source_property,
const PropertyProxy<T_target>& target_property,
- Flags flags,
+ BindingFlags flags,
const T_functor_to& transform_to,
const T_functor_from& transform_from)
{
- sigc::slot<bool(const T_source&, T_target&)> slot_transform_to = transform_to;
- sigc::slot<bool(const T_target&, T_source&)> slot_transform_from = transform_from;
+ sigc::slot<bool, const T_source&, T_target&> slot_transform_to = transform_to;
+ sigc::slot<bool, const T_target&, T_source&> slot_transform_from = transform_from;
return bind_property_value(source_property, target_property, flags,
slot_transform_to.empty() ? SlotTransform() : TransformProp<T_source, T_target>(slot_transform_to),
_WRAP_METHOD(Glib::RefPtr<Glib::ObjectBase> get_target(), g_binding_get_target, refreturn, newin "2,44")
_WRAP_METHOD(Glib::RefPtr<const Glib::ObjectBase> get_target() const, g_binding_get_target, refreturn, constversion, newin "2,44")
_WRAP_METHOD(Glib::ustring get_target_property() const, g_binding_get_target_property, newin "2,44")
- _WRAP_METHOD(Flags get_flags() const, g_binding_get_flags, newin "2,44")
+ _WRAP_METHOD(BindingFlags get_flags() const, g_binding_get_flags, newin "2,44")
/** Explicitly releases the binding between the source and the target
* property expressed by this Binding instance.
void unbind();
_IGNORE(g_binding_unbind)
- _WRAP_PROPERTY("flags", Flags, newin "2,44")
+ _WRAP_PROPERTY("flags", Glib::BindingFlags, newin "2,44")
_WRAP_PROPERTY("source", Glib::RefPtr<Glib::ObjectBase>, newin "2,44")
_WRAP_PROPERTY("source-property", Glib::ustring, newin "2,44")
_WRAP_PROPERTY("target", Glib::RefPtr<Glib::ObjectBase>, newin "2,44")
// The functor TransformProp can be implicitly converted to a SlotTransform
// and used in a call to bind_property_value().
template <typename T_from, typename T_to>
- class TransformProp
+ class TransformProp : public sigc::functor_base
{
public:
- using SlotTypedTransform = sigc::slot<bool(const T_from&, T_to&)>;
+ using result_type = bool;
+ using SlotTypedTransform = sigc::slot<bool, const T_from&, T_to&>;
- explicit TransformProp(const SlotTypedTransform& slot) : typed_transform(slot) {}
+ TransformProp(const SlotTypedTransform& slot) : typed_transform(slot) {}
bool operator()(const GValue* from_value, GValue* to_value)
{
* int compare(const guint8* first, const guint8* second);
* </code>
*/
- using SlotCompare = sigc::slot<int(const guint8*, const guint8*)>;
+ using SlotCompare = sigc::slot<int, const guint8*, const guint8*>;
_WRAP_METHOD(static Glib::RefPtr<ByteArray> create(), g_byte_array_new)
public:
static GType value_type() { return Glib::ByteArray::get_type(); }
void set(const Glib::RefPtr<Glib::ByteArray>& array) { set_boxed(Glib::unwrap(array)); }
- Glib::RefPtr<Glib::ByteArray> get() { return make_refptr_for_instance<Glib::ByteArray>(reinterpret_cast<Glib::ByteArray*>(get_boxed())); }
+ Glib::RefPtr<Glib::ByteArray> get() { return Glib::RefPtr<Glib::ByteArray>(reinterpret_cast<Glib::ByteArray*>(get_boxed())); }
};
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
#include <glibmm/refptr.h>
#include <glibmm/ustring.h>
#include <glibmm/error.h>
+#include <glibmm/arrayhandle.h>
#include <glib.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
-Checksum::Checksum(Type type) : gobject_(g_checksum_new((GChecksumType)type))
+Checksum::Checksum(ChecksumType type) : gobject_(g_checksum_new((GChecksumType)type))
{
}
}
gssize
-Checksum::get_length(Type checksum_type)
+Checksum::get_length(ChecksumType checksum_type)
{
return g_checksum_type_get_length((GChecksumType)checksum_type);
}
std::string
-Checksum::compute_checksum(Type checksum_type, const std::string& data)
+Checksum::compute_checksum(ChecksumType checksum_type, const std::string& data)
{
return Glib::convert_return_gchar_ptr_to_ustring(
g_compute_checksum_for_string(((GChecksumType)checksum_type), data.c_str(), data.size()));
_IGNORE(g_checksum_copy, g_checksum_free)
public:
- _WRAP_ENUM(Type, GChecksumType, NO_GTYPE)
+ _WRAP_ENUM(ChecksumType, GChecksumType, NO_GTYPE)
-#m4 _CONVERSION(`Type', `GChecksumType', `(static_cast<$2>($3))')
+#m4 _CONVERSION(`ChecksumType', `GChecksumType', `(($2)$3)')
/** Creates a new Checksum, using the checksum algorithm @a checksum_type.
* If the checksum_type is not known, then operator bool() will return false.
*
* @param checksum_type Checksum type, one of defined above.
*/
- explicit Checksum(Type checksum_type);
+ explicit Checksum(ChecksumType checksum_type);
/** Returns true if the Checksum object is valid.
* This will return false, for instance, if an unsupported checksum type was provided to the constructor.
_WRAP_METHOD(void reset(), g_checksum_reset)
- _WRAP_METHOD(void update(const guchar* data, gssize length), g_checksum_update)
+ //TODO: length should really be gssize, not gsize, when we can break ABI:
+#m4 _CONVERSION(`gsize',`gssize',`(gssize)($3)')
+ _WRAP_METHOD(void update(const guchar* data, gsize length), g_checksum_update)
/** Feeds data into an existing Checksum.
* The checksum must still be open, that is get_string() or get_digest() must not have been called on the checksum.
_WRAP_METHOD(std::string get_string() const, g_checksum_get_string)
- _WRAP_METHOD(static std::string compute_checksum(Type checksum_type, const guchar* data, gsize length), g_compute_checksum_for_data)
+ _WRAP_METHOD(static std::string compute_checksum(ChecksumType checksum_type, const guchar* data, gsize length), g_compute_checksum_for_data)
/** Computes the checksum of a string.
*
- * @param checksum_type A Type
+ * @param checksum_type A ChecksumType
* @param str The string to compute the checksum of.
* @result The checksum as a hexadecimal string.
*/
- static std::string compute_checksum(Type checksum_type, const std::string& str);
+ static std::string compute_checksum(ChecksumType checksum_type, const std::string& str);
_IGNORE(g_compute_checksum_for_string)
//We don't use _WRAP_METHOD because this is not really a GCheckSum function:
/** Gets the length in bytes of digests of type @a checksum_type.
*
- * @param checksum_type A Type.
+ * @param checksum_type A ChecksumType.
* @result The checksum length, or -1 if @a checksum_type is not supported.
*/
- static gssize get_length(Type checksum_type);
+ static gssize get_length(ChecksumType checksum_type);
};
} //namespace Glib
+
g_date_set_parse(&gobject_, str.c_str());
}
+_DEPRECATE_IFDEF_START
+
+// Avoid a build problem in the case that std::time_t is equivalent to gint32 (GTime is also gint32)
+// That would make the set_time() method overload impossible.
+#ifdef GLIBMM_HAVE_C_STD_TIME_T_IS_NOT_INT32
+void
+Date::set_time(GTime time)
+{
+ // This method, and the C function g_date_set_time() that it wraps, are deprecated.
+ //(::time_t is used here instead of std::time_t, since the C function is declared
+ // with ::time_t. It's not important. The C++ standard requires that ::time_t
+ // and std::time_t shall be identical when both are defined.)
+ g_date_set_time_t(&gobject_, static_cast<time_t>(time));
+}
+#endif // GLIBMM_HAVE_C_STD_TIME_T_IS_NOT_INT32
+
+_DEPRECATE_IFDEF_END
+
void
Date::set_time(std::time_t timet)
{
return (Date::Weekday)g_date_get_weekday(&gobject_);
}
-int Date::get_weekday_as_int() const
-{
- return g_date_get_weekday(&gobject_);
-}
-
Date::Month
Date::get_month() const
{
return (Date::Month)g_date_get_month(&gobject_);
}
-int Date::get_month_as_int() const
-{
- return g_date_get_month(&gobject_);
-}
-
Date::Year
Date::get_year() const
{
using Day = guint8 ;
using Year = guint16;
- _WRAP_ENUM(Month, GDateMonth, NO_GTYPE)
- _WRAP_ENUM(Weekday, GDateWeekday, NO_GTYPE)
- _WRAP_ENUM(DMY, GDateDMY, NO_GTYPE)
+ _WRAP_ENUM(Month, GDateMonth, s#^DATE_##, NO_GTYPE)
+ _WRAP_ENUM(Weekday, GDateWeekday, s#^DATE_##, NO_GTYPE)
+ _WRAP_ENUM(DMY, GDateDMY, s#^DATE_##, NO_GTYPE)
static const Day BAD_DAY = 0;
static const Year BAD_YEAR = 0;
*/
void set_parse (const Glib::ustring& str);
+
+ _DEPRECATE_IFDEF_START
+
+ //Avoid a build problem in the case that std::time_t is equivalent to gint32 (GTime is also gint32)
+ //That would make the set_time() method overload impossible.
+ #ifdef GLIBMM_HAVE_C_STD_TIME_T_IS_NOT_INT32
+ /** Sets the value of a date from a GTime value.
+ *
+ * @param time GTime value to set.
+ *
+ * @deprecated Please use set_time(std::time_t) or set_time(const GTimeVal&).
+ */
+ void set_time(GTime time);
+ #endif //GLIBMM_HAVE_C_STD_TIME_T_IS_NOT_INT32
+
+ _DEPRECATE_IFDEF_END
+
+
/** Sets the value of a date from a <type>std::time_t</type> value.
*
* @param timet std::time_t value to set
*/
Weekday get_weekday() const;
- /** Returns the day of the week for a Date. The date must be valid.
- * @return Day of the week as an int. Monday=1 .. Sunday=7.
- */
- int get_weekday_as_int() const;
-
/** Returns the month of the year. The date must be valid.
* @return Month of the year as a Date::Month.
*/
Month get_month() const;
- /** Returns the month of the year. The date must be valid.
- * @return Month of the year as an int. January=1 .. December=12.
- */
- int get_month_as_int() const;
-
/** Returns the year of a Date. The date must be valid.
* @return Year in which the date falls.
*/
#include <glibmm/utility.h>
#include <glibmm/timeval.h>
-#include <glibmm/timezone.h>
#include <glibmm/wrap.h>
-
-namespace Glib
-{
-
-} // namespace Glib
#include <glibmmconfig.h>
#include <glibmm/refptr.h>
+#include <glibmm/timezone.h>
#include <glibmm/ustring.h>
#include <glib.h>
{
struct TimeVal;
-class TimeZone;
/** A value representing an interval of time, in microseconds. As GTimeSpan,
* its underlying type is gint64.
_IGNORE(g_date_time_ref, g_date_time_unref)
public:
- _WRAP_METHOD(static DateTime create_now(const TimeZone& tz), g_date_time_new_now)
+ _WRAP_METHOD(static DateTime create_now(const TimeZone& tz), g_date_time_new_now)
_WRAP_METHOD(static DateTime create_now_local(), g_date_time_new_now_local)
_WRAP_METHOD(static DateTime create_now_utc(), g_date_time_new_now_utc)
_WRAP_METHOD(gint64 to_unix() const, g_date_time_to_unix)
_WRAP_METHOD(bool to_timeval(TimeVal& tv) const, g_date_time_to_timeval)
_WRAP_METHOD(TimeSpan get_utc_offset() const, g_date_time_get_utc_offset)
+#m4 _CONVERSION(`GTimeZone*',`TimeZone',`Glib::wrap($3, true)')
+ _WRAP_METHOD(TimeZone get_timezone() const, g_date_time_get_timezone, newin "2,60")
_WRAP_METHOD(Glib::ustring get_timezone_abbreviation() const, g_date_time_get_timezone_abbreviation)
_WRAP_METHOD(bool is_daylight_savings() const, g_date_time_is_daylight_savings)
_WRAP_METHOD(DateTime to_timezone(const TimeZone& tz) const, g_date_time_to_timezone)
regex.hg \
shell.hg \
spawn.hg \
+ thread.hg \
+ threads.hg \
timezone.hg \
unicode.hg \
uriutils.hg \
+ valuearray.hg \
variant.hg \
variantdict.hg \
variantiter.hg \
s#^PERM$#NOT_OWNER#
)
+/** @enum FileError::Code
+ * Values corresponding to <tt>errno</tt> codes returned from file operations
+ * on UNIX.
+ * Unlike <tt>errno</tt> codes, FileError::Code values are available on all
+ * systems, even Windows. The exact meaning of each code depends on what sort
+ * of file operation you were performing; the UNIX documentation gives more
+ * details. The following error code descriptions come from the GNU C Library
+ * manual, and are under the copyright of that manual.
+ *
+ * It's not very portable to make detailed assumptions about exactly which
+ * errors will be returned from a given operation. Some errors don't occur on
+ * some systems, etc., sometimes there are subtle differences in when a system
+ * will report a given error, etc.
+ */
+
/** @var FileError::Code FileError::EXISTS
- * <tt>(EEXIST)</tt>
- *
- * @var FileError::Code FileError::IS_DIRECTORY
- * <tt>(EISDIR)</tt>
- *
- * @var FileError::Code FileError::ACCESS_DENIED
- * <tt>(EACCES)</tt>
- *
- * @var FileError::Code FileError::NAME_TOO_LONG
- * <tt>(ENAMETOOLONG)</tt>
- *
- * @var FileError::Code FileError::NO_SUCH_ENTITY
- * <tt>(ENOENT)</tt>
- *
- * @var FileError::Code FileError::NOT_DIRECTORY
- * <tt>(ENOTDIR)</tt>
- *
- * @var FileError::Code FileError::NO_SUCH_DEVICE
- * <tt>(ENXIO)</tt>
- *
- * @var FileError::Code FileError::NOT_DEVICE
- * <tt>(ENODEV)</tt>
- *
- * @var FileError::Code FileError::READONLY_FILESYSTEM
- * <tt>(EROFS)</tt>
- *
- * @var FileError::Code FileError::TEXT_FILE_BUSY
- * <tt>(ETXTBSY)</tt>
- *
- * @var FileError::Code FileError::FAULTY_ADDRESS
- * <tt>(EFAULT)</tt>
- *
- * @var FileError::Code FileError::SYMLINK_LOOP
- * <tt>(ELOOP)</tt>
- *
- * @var FileError::Code FileError::NO_SPACE_LEFT
- * <tt>(ENOSPC)</tt>
- *
- * @var FileError::Code FileError::NOT_ENOUGH_MEMORY
- * <tt>(ENOMEM)</tt>
- *
- * @var FileError::Code FileError::TOO_MANY_OPEN_FILES
- * <tt>(EMFILE)</tt>
- *
- * @var FileError::Code FileError::FILE_TABLE_OVERFLOW
- * <tt>(ENFILE)</tt>
- *
- * @var FileError::Code FileError::BAD_FILE_DESCRIPTOR
- * <tt>(EBADF)</tt>
- *
- * @var FileError::Code FileError::INVALID_ARGUMENT
- * <tt>(EINVAL)</tt>
- *
- * @var FileError::Code FileError::BROKEN_PIPE
- * <tt>(EPIPE)</tt>
- *
- * @var FileError::Code FileError::TRYAGAIN
- * <tt>(EAGAIN)</tt>
- *
- * We use TRYAGAIN instead of TRY_AGAIN, because that is defined as a macro by a Unix header.
- *
- * @var FileError::Code FileError::INTERRUPTED
- * <tt>(EINTR)</tt>
- *
- * @var FileError::Code FileError::IO_ERROR
- * <tt>(EIO)</tt>
- *
- * @var FileError::Code FileError::NOT_OWNER
- * <tt>(EPERM)</tt>
- *
- * @var FileError::Code FileError::FAILED
- * Returned if no specific code applies.
+ * <tt>(EEXIST)</tt> Operation not permitted; only the owner of the file (or
+ * other resource) or processes with special privileges can perform the operation.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::IS_DIRECTORY
+ * <tt>(EISDIR)</tt> File is a directory; you cannot open a directory for writing,
+ * or create or remove hard links to it.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::ACCESS_DENIED
+ * <tt>(EACCES)</tt> Permission denied; the file permissions do not allow the
+ * attempted operation.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NAME_TOO_LONG
+ * <tt>(ENAMETOOLONG)</tt> Filename too long.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NO_SUCH_ENTITY
+ * <tt>(ENOENT)</tt> No such file or directory. This is a "file doesn't exist"
+ * error for ordinary files that are referenced in contexts where they are expected
+ * to already exist.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NOT_DIRECTORY
+ * <tt>(ENOTDIR)</tt> A file that isn't a directory was specified when a directory
+ * is required.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NO_SUCH_DEVICE
+ * <tt>(ENXIO)</tt> No such device or address. The system tried to use the device
+ * represented by a file you specified, and it couldn't find the device. This can
+ * mean that the device file was installed incorrectly, or that the physical device
+ * is missing or not correctly attached to the computer.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NOT_DEVICE
+ * <tt>(ENODEV)</tt> This file is of a type that doesn't support mapping.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::READONLY_FILESYSTEM
+ * <tt>(EROFS)</tt> The directory containing the new link can't be modified
+ * because it's on a read-only file system.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::TEXT_FILE_BUSY
+ * <tt>(ETXTBSY)</tt> Text file busy.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::FAULTY_ADDRESS
+ * <tt>(EFAULT)</tt> You passed in a pointer to bad memory. (Glib won't
+ * reliably return this, don't pass in pointers to bad memory.)
+ * <br><br>
+ */
+/** @var FileError::Code FileError::SYMLINK_LOOP
+ * <tt>(ELOOP)</tt> Too many levels of symbolic links were encountered in
+ * looking up a file name. This often indicates a cycle of symbolic links.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NO_SPACE_LEFT
+ * <tt>(ENOSPC)</tt> No space left on device; write operation on a file failed
+ * because the disk is full.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NOT_ENOUGH_MEMORY
+ * <tt>(ENOMEM)</tt> No memory available. The system cannot allocate more
+ * virtual memory because its capacity is full.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::TOO_MANY_OPEN_FILES
+ * <tt>(EMFILE)</tt> The current process has too many files open and can't
+ * open any more. Duplicate descriptors do count toward this limit.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::FILE_TABLE_OVERFLOW
+ * <tt>(ENFILE)</tt> There are too many distinct file openings in the
+ * entire system.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::BAD_FILE_DESCRIPTOR
+ * <tt>(EBADF)</tt> Bad file descriptor; for example, I/O on a descriptor
+ * that has been closed or reading from a descriptor open only for writing
+ * (or vice versa).
+ * <br><br>
+ */
+/** @var FileError::Code FileError::INVALID_ARGUMENT
+ * <tt>(EINVAL)</tt> Invalid argument. This is used to indicate various kinds
+ * of problems with passing the wrong argument to a library function.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::BROKEN_PIPE
+ * <tt>(EPIPE)</tt> Broken pipe; there is no process reading from the other
+ * end of a pipe. Every library function that returns this error code also
+ * generates a <tt>SIGPIPE</tt> signal; this signal terminates the program
+ * if not handled or blocked. Thus, your program will never actually see
+ * this code unless it has handled or blocked <tt>SIGPIPE</tt>.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::TRYAGAIN
+ * <tt>(EAGAIN)</tt> Resource temporarily unavailable; the call might work
+ * if you try again later.
+ * We used TRYAGAIN instead of TRY_AGAIN, because that is a defined as a macro by a Unix header.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::INTERRUPTED
+ * <tt>(EINTR)</tt> Interrupted function call; an asynchronous signal occurred
+ * and prevented completion of the call. When this happens, you should try
+ * the call again.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::IO_ERROR
+ * <tt>(EIO)</tt> Input/output error; usually used for physical read or write
+ * errors. I.e. the disk or other physical device hardware is returning errors.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::NOT_OWNER
+ * <tt>(EPERM)</tt> Operation not permitted; only the owner of the file (or other
+ * resource) or processes with special privileges can perform the operation.
+ * <br><br>
+ */
+/** @var FileError::Code FileError::FAILED
+ * Does not correspond to a UNIX error code; this is the standard "failed for
+ * unspecified reason" error code present in all Glib::Error error code
+ * enumerations. Returned if no specific code applies.
*/
class Dir;
*
* The actual name used is returned in @a name_used.
*
+ * @param[out] name_used The actual name used.
* @param prefix Template for file name, basename only.
- * @retval name_used The actual name used.
* @return A file handle (as from <tt>open()</tt>) to the file opened for reading
* and writing. The file is opened in binary mode on platforms where there is a
* difference. The file handle should be closed with <tt>close()</tt>.
* This function works like file_open_tmp(std::string&, const std::string&)
* but uses a default basename prefix.
*
- * @retval name_used The actual name used.
+ * @param[out] name_used The actual name used.
* @return A file handle (as from <tt>open()</tt>) to the file opened for reading
* and writing. The file is opened in binary mode on platforms where there is a
* difference. The file handle should be closed with <tt>close()</tt>.
@base that is within inclusive bounds limited by @min and @max. If
this is true, then the converted number is stored in @out_num. An
empty string is not a valid input. A string with leading or
-trailing whitespace is also an invalid input.
+trailing whitespace is also an invalid input. A string with a leading sign
+(`-` or `+`) is not a valid input for the unsigned parser.
@base can be between 2 and 36 inclusive. Hexadecimal numbers must
not be prefixed with "0x" or "0X". Such a problem does not exist
changing the current locale, since that would not be
thread-safe.
+Note that input with a leading minus sign (`-`) is accepted, and will return
+the negation of the parsed number, unless that would overflow a #guint64.
+Critically, this means you cannot assume that a short fixed length input will
+never result in a low return value, as the input could have a leading `-`.
+
This function is typically used when reading configuration
files or other non-user input that should be locale independent.
To handle input from the user you should normally use the
</parameter>
<parameter name="cmp">
<parameter_description> The comparison operator to use.
-One of ==, !=, <, >, <=, >=.
+One of `==`, `!=`, `<`, `>`, `<=`, `>=`.
</parameter_description>
</parameter>
<parameter name="n2">
</parameter>
<parameter name="cmp">
<parameter_description> The comparison operator to use.
-One of ==, !=, <, >, <=, >=.
+One of `==`, `!=`, `<`, `>`, `<=`, `>=`.
</parameter_description>
</parameter>
<parameter name="n2">
</parameter>
<parameter name="cmp">
<parameter_description> The comparison operator to use.
-One of ==, !=, <, >, <=, >=.
+One of `==`, `!=`, `<`, `>`, `<=`, `>=`.
</parameter_description>
</parameter>
<parameter name="n2">
</parameter>
<parameter name="cmp">
<parameter_description> The comparison operator to use.
-One of ==, !=, <, >, <=, >=.
+One of `==`, `!=`, `<`, `>`, `<=`, `>=`.
</parameter_description>
</parameter>
<parameter name="s2">
</parameter>
<parameter name="cmp">
<parameter_description> The comparison operator to use.
-One of ==, !=, <, >, <=, >=.
+One of `==`, `!=`, `<`, `>`, `<=`, `>=`.
</parameter_description>
</parameter>
<parameter name="n2">
<return></return>
</function>
+<function name="g_assert_cmpvariant">
+<description>
+Debugging macro to compare two #GVariants. If the comparison fails,
+an error message is logged and the application is either terminated
+or the testcase marked as failed. The variants are compared using
+g_variant_equal().
+
+The effect of `g_assert_cmpvariant (v1, v2)` is the same as
+`g_assert_true (g_variant_equal (v1, v2))`. The advantage of this macro is
+that it can produce a message that includes the actual values of @v1 and @v2.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="v1">
+<parameter_description> pointer to a #GVariant
+</parameter_description>
+</parameter>
+<parameter name="v2">
+<parameter_description> pointer to another #GVariant
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_assert_error">
<description>
Debugging macro to check that a method has returned
This can only be used to test for a specific error. If you want to
test that @err is set, but don't care what it's set to, just use
-`g_assert (err != NULL)`
+`g_assert_nonnull (err)`.
Since: 2.20
<function name="g_assertion_message_expr">
<description>
+Internal function used to print messages from the public g_assert() and
+g_assert_not_reached() macros.
</description>
<parameters>
<parameter name="domain">
-<parameter_description>
+<parameter_description> log domain
</parameter_description>
</parameter>
<parameter name="file">
-<parameter_description>
+<parameter_description> file containing the assertion
</parameter_description>
</parameter>
<parameter name="line">
-<parameter_description>
+<parameter_description> line number of the assertion
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description>
+<parameter_description> function containing the assertion
</parameter_description>
</parameter>
<parameter name="expr">
-<parameter_description>
+<parameter_description> expression which failed
</parameter_description>
</parameter>
</parameters>
The data will be freed when its reference count drops to
zero.
+The allocated data is guaranteed to be suitably aligned for any
+built-in type.
+
Since: 2.58
</description>
The data will be freed when its reference count drops to
zero.
+The allocated data is guaranteed to be suitably aligned for any
+built-in type.
+
Since: 2.58
</description>
<function name="g_atomic_ref_count_init">
<description>
-Atomically initializes a reference count variable.
+Initializes a reference count variable.
Since: 2.58
<function name="g_bookmark_file_load_from_data_dirs">
<description>
This function looks for a desktop bookmark file named @file in the
-paths returned from g_get_user_data_dir() and g_get_system_data_dirs(),
-loads the file into @bookmark and returns the file's full path in
+paths returned from g_get_user_data_dir() and g_get_system_data_dirs(),
+loads the file into @bookmark and returns the file's full path in
@full_path. If the file could not be loaded then @error is
set to either a #GFileError or #GBookmarkFileError.
If no bookmark for @uri is found then it is created.
-The "visited" time should only be set if the bookmark was launched,
+The "visited" time should only be set if the bookmark was launched,
either using the command line retrieved by g_bookmark_file_get_app_info()
or by the default application for the bookmark's MIME type, retrieved
using g_bookmark_file_get_mime_type(). Changing the "visited" time
Formats a size (for example the size of a file) into a human readable
string. Sizes are rounded to the nearest size prefix (kB, MB, GB)
and are displayed rounded to the nearest tenth. E.g. the file size
-3292528 bytes will be converted into the string "3.2 MB".
+3292528 bytes will be converted into the string "3.2 MB". The returned string
+is UTF-8, and may use a non-breaking space to separate the number and units,
+to ensure they aren’t separated when line wrapped.
The prefix units base is 1000 (i.e. 1 kB is 1000 bytes).
@group_name. If both @key and @group_name are %NULL, then
@comment will be read from above the first group in the file.
-Note that the returned string includes the '#' comment markers.
+Note that the returned string does not include the '#' comment markers,
+but does include any whitespace after them (on each line). It includes
+the line breaks between lines, but does not include the final line break.
Since: 2.6
of bidirectional bindings, otherwise it will be ignored
The binding will automatically be removed when either the @source or the
-@target instances are finalized. To remove the binding without affecting the
-@source and the @target you can just call g_object_unref() on the returned
-#GBinding instance.
+@target instances are finalized. This will release the reference that is
+being held on the #GBinding instance; if you want to hold on to the
+#GBinding instance, you will need to hold a reference to it.
+
+To remove the binding, call g_binding_unbind().
A #GObject can have multiple bindings.
<return></return>
</function>
+<function name="g_queue_clear_full">
+<description>
+Convenience method, which frees all the memory used by a #GQueue,
+and calls the provided @free_func on each item in the #GQueue.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a pointer to a #GQueue
+</parameter_description>
+</parameter>
+<parameter name="free_func">
+<parameter_description> the function to be called to free memory allocated
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_queue_copy">
<description>
Copies a @queue. Note that is a shallow copy. If the elements in the
The data will be freed when its reference count drops to
zero.
+The allocated data is guaranteed to be suitably aligned for any
+built-in type.
+
Since: 2.58
</description>
The data will be freed when its reference count drops to
zero.
+The allocated data is guaranteed to be suitably aligned for any
+built-in type.
+
Since: 2.58
</description>
<return></return>
</function>
+<function name="g_rec_mutex_locker_free">
+<description>
+Unlock @locker's recursive mutex. See g_rec_mutex_locker_new() for details.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="locker">
+<parameter_description> a GRecMutexLocker
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rec_mutex_locker_new">
+<description>
+Lock @rec_mutex and return a new #GRecMutexLocker. Unlock with
+g_rec_mutex_locker_free(). Using g_rec_mutex_unlock() on @rec_mutex
+while a #GRecMutexLocker exists can lead to undefined behaviour.
+
+This is intended to be used with g_autoptr(). Note that g_autoptr()
+is only available when using GCC or clang, so the following example
+will only work with those compilers:
+|[
+typedef struct
+{
+...
+GRecMutex rec_mutex;
+...
+} MyObject;
+
+static void
+my_object_do_stuff (MyObject *self)
+{
+g_autoptr(GRecMutexLocker) locker = g_rec_mutex_locker_new (&self->rec_mutex);
+
+// Code with rec_mutex locked here
+
+if (cond)
+// No need to unlock
+return;
+
+// Optionally early unlock
+g_clear_pointer (&locker, g_rec_mutex_locker_free);
+
+// Code with rec_mutex unlocked here
+}
+]|
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> a recursive mutex to lock
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GRecMutexLocker
+</return>
+</function>
+
<function name="g_rec_mutex_trylock">
<description>
Tries to lock @rec_mutex. If @rec_mutex is already locked
that the latest on-disk version is used. Call this only
if you just changed the data on disk yourself.
-Due to threadsafety issues this may cause leaking of strings
+Due to thread safety issues this may cause leaking of strings
that were previously returned from g_get_user_special_dir()
that can't be freed. We ensure to only leak the data for
the directories that actually changed value though.
<function name="g_return_if_fail_warning">
<description>
+Internal function used to print messages from the public g_return_if_fail()
+and g_return_val_if_fail() macros.
</description>
<parameters>
<parameter name="log_domain">
-<parameter_description>
+<parameter_description> log domain
</parameter_description>
</parameter>
<parameter name="pretty_function">
-<parameter_description>
+<parameter_description> function containing the assertion
</parameter_description>
</parameter>
<parameter name="expression">
-<parameter_description>
+<parameter_description> expression which failed
</parameter_description>
</parameter>
</parameters>
a command line, and the C runtime startup code does a corresponding
reconstruction of an argument vector from the command line, to be
passed to main(). Complications arise when you have argument vector
-elements that contain spaces of double quotes. The spawn*() functions
+elements that contain spaces or double quotes. The `spawn*()` functions
don't do any quoting or escaping, but on the other hand the startup
code does do unquoting and unescaping in order to enable receiving
arguments with embedded spaces or double quotes. To work around this
<function name="g_string_append_len">
<description>
-Appends @len bytes of @val to @string. Because @len is
-provided, @val may contain embedded nuls and need not
-be nul-terminated.
+Appends @len bytes of @val to @string.
-Since this function does not stop at nul bytes, it is
-the caller's responsibility to ensure that @val has at
-least @len addressable bytes.
+If @len is positive, @val may contain embedded nuls and need
+not be nul-terminated. It is the caller's responsibility to
+ensure that @val has at least @len addressable bytes.
+
+If @len is negative, @val must be nul-terminated and @len
+is considered to request the entire string length. This
+makes g_string_append_len() equivalent to g_string_append().
</description>
</parameter_description>
</parameter>
<parameter name="len">
-<parameter_description> number of bytes of @val to use
+<parameter_description> number of bytes of @val to use, or -1 for all of @val
</parameter_description>
</parameter>
</parameters>
<function name="g_string_insert_len">
<description>
Inserts @len bytes of @val into @string at @pos.
-Because @len is provided, @val may contain embedded
-nuls and need not be nul-terminated. If @pos is -1,
-bytes are inserted at the end of the string.
-Since this function does not stop at nul bytes, it is
-the caller's responsibility to ensure that @val has at
-least @len addressable bytes.
+If @len is positive, @val may contain embedded nuls and need
+not be nul-terminated. It is the caller's responsibility to
+ensure that @val has at least @len addressable bytes.
+
+If @len is negative, @val must be nul-terminated and @len
+is considered to request the entire string length.
+
+If @pos is -1, bytes are inserted at the end of the string.
</description>
</parameter_description>
</parameter>
<parameter name="len">
-<parameter_description> number of bytes of @val to insert
+<parameter_description> number of bytes of @val to insert, or -1 for all of @val
</parameter_description>
</parameter>
</parameters>
<function name="g_string_prepend_len">
<description>
Prepends @len bytes of @val to @string.
-Because @len is provided, @val may contain
-embedded nuls and need not be nul-terminated.
-Since this function does not stop at nul bytes,
-it is the caller's responsibility to ensure that
-@val has at least @len addressable bytes.
+If @len is positive, @val may contain embedded nuls and need
+not be nul-terminated. It is the caller's responsibility to
+ensure that @val has at least @len addressable bytes.
+
+If @len is negative, @val must be nul-terminated and @len
+is considered to request the entire string length. This
+makes g_string_prepend_len() equivalent to g_string_prepend().
</description>
</parameter_description>
</parameter>
<parameter name="len">
-<parameter_description> number of bytes in @val to prepend
+<parameter_description> number of bytes in @val to prepend, or -1 for all of @val
</parameter_description>
</parameter>
</parameters>
</return>
</function>
+<function name="g_strv_equal">
+<description>
+Checks if @strv1 and @strv2 contain exactly the same elements in exactly the
+same order. Elements are compared using g_str_equal(). To match independently
+of order, sort the arrays first (using g_qsort_with_data() or similar).
+
+Two empty arrays are considered equal. Neither @strv1 not @strv2 may be
+%NULL.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="strv1">
+<parameter_description> a %NULL-terminated array of strings
+</parameter_description>
+</parameter>
+<parameter name="strv2">
+<parameter_description> another %NULL-terminated array of strings
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @strv1 and @strv2 are equal
+</return>
+</function>
+
<function name="g_strv_length">
<description>
Returns the length of the given %NULL-terminated
the test will be skipped by default, and only run if explicitly
required via the `-p` command-line option or g_test_trap_subprocess().
+No component of @testpath may start with a dot (`.`) if the
+%G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to
+do so even if it isn’t.
+
Since: 2.16
</description>
the test will be skipped by default, and only run if explicitly
required via the `-p` command-line option or g_test_trap_subprocess().
+No component of @testpath may start with a dot (`.`) if the
+%G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to
+do so even if it isn’t.
+
Since: 2.16
</description>
- `--debug-log`: Debug test logging output.
+Options which can be passed to @... are:
+
+- `"no_g_set_prgname"`: Causes g_test_init() to not call g_set_prgname().
+- %G_TEST_OPTION_ISOLATE_DIRS: Creates a unique temporary directory for each
+unit test and uses g_set_user_dirs() to set XDG directories to point into
+that temporary directory for the duration of the unit test. See the
+documentation for %G_TEST_OPTION_ISOLATE_DIRS.
+
Since 2.58, if tests are compiled with `G_DISABLE_ASSERT` defined,
g_test_init() will print an error and exit. This is to prevent no-op tests
from being executed, as g_assert() is commonly (erroneously) used in unit
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> %NULL-terminated list of special options. Currently the only
-defined option is `"no_g_set_prgname"`, which
-will cause g_test_init() to not call g_set_prgname().
+<parameter_description> %NULL-terminated list of special options, documented below.
</parameter_description>
</parameter>
</parameters>
string specifies what type of value is expected to be inside of the
variant. If the value inside the variant has a different type then
%NULL is returned. In the event that @dictionary has a value type other
-than v then @expected_type must directly match the key type and it is
+than v then @expected_type must directly match the value type and it is
used to unpack the value directly or an error occurs.
In either case, if @key is not found in @dictionary, %NULL is returned.
A reference is taken on @bytes.
+The data in @bytes must be aligned appropriately for the @type being loaded.
+Otherwise this function will internally create a copy of the memory (since
+GLib 2.60) or (in older versions) fail and exit the process.
+
Since: 2.36
</description>
needed. The exact time of this call is unspecified and might even be
before this function returns.
+Note: @data must be backed by memory that is aligned appropriately for the
+@type being loaded. Otherwise this function will internally create a copy of
+the memory (since GLib 2.60) or (in older versions) fail and exit the
+process.
+
Since: 2.24
</description>
<function name="g_warn_message">
<description>
+Internal function used to print messages from the public g_warn_if_reached()
+and g_warn_if_fail() macros.
</description>
<parameters>
<parameter name="domain">
-<parameter_description>
+<parameter_description> log domain
</parameter_description>
</parameter>
<parameter name="file">
-<parameter_description>
+<parameter_description> file containing the warning
</parameter_description>
</parameter>
<parameter name="line">
-<parameter_description>
+<parameter_description> line number of the warning
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description>
+<parameter_description> function containing the warning
</parameter_description>
</parameter>
<parameter name="warnexpr">
-<parameter_description>
+<parameter_description> expression which failed
</parameter_description>
</parameter>
</parameters>
Variables of this type should only contain the value
%TRUE or %FALSE.
+Never directly compare the contents of a #gboolean variable with the values
+%TRUE or %FALSE. Use `if (condition)` to check a #gboolean is "true", instead
+of `if (condition == TRUE)`. Likewise use `if (!condition)` to check a
+#gboolean is "false".
+
+There is no validation when assigning to a #gboolean variable and so it could
+contain any value represented by a #gint. This is why the use of `if
+(condition)` is recommended. All non-zero values in C evaluate to "true".
+
</description>
<parameters>
</parameters>
<root>
- <substitute_type_name from="GBindingFlags" to="Glib::Binding::Flags" />
- <substitute_type_name from="GChecksumType" to="Glib::Checksum::Type" />
<substitute_type_name from="GDateMonth" to="Glib::Date::Month" />
<substitute_type_name from="GDateWeekday" to="Glib::Date::Weekday" />
<substitute_type_name from="GDateDMY" to="Glib::Date::DMY" />
- <substitute_type_name from="GKeyFileFlags" to="Glib::KeyFile::Flags" />
- <substitute_type_name from="GMarkupParseFlags" to="Glib::Markup::ParseFlags" />
- <substitute_type_name from="GModuleFlags" to="Glib::Module::Flags" />
- <substitute_type_name from="GRegexCompileFlags" to="Glib::Regex::CompileFlags" />
- <substitute_type_name from="GRegexMatchFlags" to="Glib::Regex::MatchFlags" />
-
- <substitute_enumerator_name from_prefix="G_BINDING_" to_prefix="Glib::Binding::Flags::" />
- <substitute_enumerator_name from_prefix="G_DATE_" to_prefix="Glib::Date::" />
- <substitute_enumerator_name from_prefix="G_PARAM_" to_prefix="Glib::ParamFlags::" />
- <substitute_enumerator_name from_prefix="G_REGEX_MATCH_" to_prefix="Glib::Regex::MatchFlags::" />
- <substitute_enumerator_name from_prefix="G_REGEX_" to_prefix="Glib::Regex::CompileFlags::" />
- <substitute_enumerator_name from_prefix="G_SPAWN_ERROR_" to_prefix="Glib::SpawnError::" />
- <substitute_enumerator_name from_prefix="G_TIME_TYPE_" to_prefix="Glib::TimeType::" />
- <substitute_enumerator_name from_prefix="G_UNICODE_BREAK_" to_prefix="Glib::UnicodeBreakType::" />
- <substitute_enumerator_name from_prefix="G_NORMALIZE_" to_prefix="Glib::NormalizeMode::" />
- <substitute_enumerator_name from="G_FILE_ERROR" to="Glib::FileError" />
- <substitute_enumerator_name from="G_KEY_FILE_ERROR" to="Glib::KeyFileError" />
- <substitute_enumerator_name from_prefix="G_KEY_FILE_ERROR_" to_prefix="Glib::KeyFileError::" />
+
<!-- enum GOptionArg is not wrapped. Don't substitute. -->
<substitute_enumerator_name from_prefix="G_OPTION_ARG_" to_prefix="G_OPTION_ARG_" />
<!-- These are preprocessor defines. Don't substitute. -->
(gtype-id "G_TYPE_MATCH_INFO")
)
-(define-object NodeTree
- (in-module "Glib")
- (c-name "GNode")
-)
-
(define-object Object
(in-module "Glib")
(c-name "GObject")
(c-name "GTimeZone")
)
-(define-object Tree
- (in-module "Glib")
- (c-name "GTree")
-)
-
(define-object Variant
(in-module "Glib")
(c-name "GVariant")
(return-type "gboolean")
)
+(define-method clear_full
+ (of-object "GQueue")
+ (c-name "g_queue_clear_full")
+ (return-type "none")
+ (parameters
+ '("GDestroyNotify" "free_func")
+ )
+)
+
(define-method get_length
(of-object "GQueue")
(c-name "g_queue_get_length")
)
)
+(define-function g_strv_equal
+ (c-name "g_strv_equal")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*-const*" "strv1")
+ '("const-gchar*-const*" "strv2")
+ )
+)
+
(define-function g_number_parser_error_quark
(c-name "g_number_parser_error_quark")
(return-type "GQuark")
(return-type "none")
)
+(define-method locker_new
+ (of-object "GRecMutex")
+ (c-name "g_rec_mutex_locker_new")
+ (return-type "GRecMutexLocker*")
+)
+
+(define-method free
+ (of-object "GRecMutexLocker")
+ (c-name "g_rec_mutex_locker_free")
+ (return-type "none")
+)
+
;; From gthreadpool.h
)
)
+(define-method check
+ (of-object "GVariantSerialised")
+ (c-name "g_variant_serialised_check")
+ (return-type "gboolean")
+)
+
(define-method is_normal
(of-object "GVariantSerialised")
(c-name "g_variant_serialised_is_normal")
)
+
+;; From glibconfig.h
+
+
)
+
+;; From gmoduleconf.h
+
+
)
+
+;; From glib-enumtypes.h
+
+(define-function g_unicode_type_get_type
+ (c-name "g_unicode_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_unicode_break_type_get_type
+ (c-name "g_unicode_break_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_unicode_script_get_type
+ (c-name "g_unicode_script_get_type")
+ (return-type "GType")
+)
+
+(define-function g_normalize_mode_get_type
+ (c-name "g_normalize_mode_get_type")
+ (return-type "GType")
+)
+
+
+
+;; From gobjectenumtypes.h
+
+(define-function g_unicode_type_get_type
+ (c-name "g_unicode_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_unicode_break_type_get_type
+ (c-name "g_unicode_break_type_get_type")
+ (return-type "GType")
+)
+
+(define-function g_unicode_script_get_type
+ (c-name "g_unicode_script_get_type")
+ (return-type "GType")
+)
+
+(define-function g_normalize_mode_get_type
+ (c-name "g_normalize_mode_get_type")
+ (return-type "GType")
+)
+
+
// g_io_channel_new_file(). Neither is there a way to hook up a wrapper
// object in an existing GIOChannel, nor exists any destroy notification.
//
-// So that means: If the IOChannel backend is unknown (normal case), then the
+// So that means: If the IOChannel is implemented in C++ -- that is, our
+// GlibmmIOChannel backend is used -- we use the GIOChannel reference
+// counting mechanism. If the IOChannel backend is unknown, then the
// wrapper instance holds always exactly one reference to the GIOChannel.
// The wrapper object itself is then managed via our own refcounting
// mechanism. To do that a utility class ForeignIOChannel is introduced to
namespace Glib
{
+class GlibmmIOChannel
+{
+public:
+ GIOChannel base;
+ Glib::IOChannel* wrapper;
+
+ static const GIOFuncs vfunc_table;
+
+ static GIOStatus io_read(
+ GIOChannel* channel, char* buf, gsize count, gsize* bytes_read, GError** err);
+
+ static GIOStatus io_write(
+ GIOChannel* channel, const char* buf, gsize count, gsize* bytes_written, GError** err);
+
+ static GIOStatus io_seek(GIOChannel* channel, gint64 offset, GSeekType type, GError** err);
+ static GIOStatus io_close(GIOChannel* channel, GError** err);
+
+ static GSource* io_create_watch(GIOChannel* channel, GIOCondition condition);
+ static void io_free(GIOChannel* channel);
+
+ static GIOStatus io_set_flags(GIOChannel* channel, GIOFlags flags, GError** err);
+ static GIOFlags io_get_flags(GIOChannel* channel);
+};
+
+// static
+const GIOFuncs GlibmmIOChannel::vfunc_table = {
+ &GlibmmIOChannel::io_read, &GlibmmIOChannel::io_write, &GlibmmIOChannel::io_seek,
+ &GlibmmIOChannel::io_close, &GlibmmIOChannel::io_create_watch, &GlibmmIOChannel::io_free,
+ &GlibmmIOChannel::io_set_flags, &GlibmmIOChannel::io_get_flags,
+};
+
/**** GLib::IOChannel ******************************************************/
+/* Construct a custom C++-implemented IOChannel. GlibmmIOChannel is an
+ * extended GIOChannel struct which allows us to hook up a pointer to this
+ * persistent wrapper instance.
+ */
+IOChannel::IOChannel() : gobject_(static_cast<GIOChannel*>(g_malloc(sizeof(GlibmmIOChannel))))
+{
+ g_io_channel_init(gobject_);
+ gobject_->funcs = const_cast<GIOFuncs*>(&GlibmmIOChannel::vfunc_table);
+
+ reinterpret_cast<GlibmmIOChannel*>(gobject_)->wrapper = this;
+}
+
IOChannel::IOChannel(IOChannel&& other) noexcept : sigc::trackable(std::move(other)),
gobject_(std::move(other.gobject_))
{
*/
IOChannel::IOChannel(GIOChannel* gobject, bool take_copy) : gobject_(gobject)
{
+ // This ctor should never be called for GlibmmIOChannel instances.
g_assert(gobject != nullptr);
+ g_assert(gobject->funcs != &GlibmmIOChannel::vfunc_table);
if (take_copy)
g_io_channel_ref(gobject_);
{
if (gobject_)
{
+ // Check whether this IOChannel is implemented in C++, i.e. whether it
+ // uses our GlibmmIOChannel forwarding backend. Normally, this will never
+ // be true because the wrapper should only be deleted in the io_free()
+ // callback, which clears gobject_ before deleting. But in case the ctor
+ // of a derived class threw an exception the GIOChannel must be destroyed
+ // prematurely.
+ //
+ if (gobject_->funcs == &GlibmmIOChannel::vfunc_table)
+ {
+ // Disconnect the wrapper object so that it won't be deleted twice.
+ reinterpret_cast<GlibmmIOChannel*>(gobject_)->wrapper = nullptr;
+ }
+
const auto tmp_gobject = gobject_;
gobject_ = nullptr;
Glib::RefPtr<IOSource>
IOChannel::create_watch(IOCondition condition)
{
- return IOSource::create(gobj(), condition);
+ // The corresponding unreference() takes place in the dtor
+ // of the Glib::RefPtr<IOChannel> object below.
+ reference();
+ return IOSource::create(Glib::RefPtr<IOChannel>(this), condition);
+}
+
+IOStatus
+IOChannel::read_vfunc(char*, gsize, gsize&)
+{
+ g_assert_not_reached();
+ return IO_STATUS_ERROR;
+}
+
+IOStatus
+IOChannel::write_vfunc(const char*, gsize, gsize&)
+{
+ g_assert_not_reached();
+ return IO_STATUS_ERROR;
+}
+
+IOStatus IOChannel::seek_vfunc(gint64, SeekType)
+{
+ g_assert_not_reached();
+ return IO_STATUS_ERROR;
+}
+
+IOStatus
+IOChannel::close_vfunc()
+{
+ g_assert_not_reached();
+ return IO_STATUS_ERROR;
+}
+
+Glib::RefPtr<Glib::Source> IOChannel::create_watch_vfunc(IOCondition)
+{
+ g_assert_not_reached();
+ return Glib::RefPtr<Glib::Source>();
+}
+
+IOStatus IOChannel::set_flags_vfunc(IOFlags)
+{
+ g_assert_not_reached();
+ return IO_STATUS_ERROR;
+}
+
+IOFlags
+IOChannel::get_flags_vfunc()
+{
+ g_assert_not_reached();
+ return IOFlags(0);
}
void
if (gobject)
{
- cpp_object = new ForeignIOChannel(gobject, take_copy);
- cpp_object->reference(); // the refcount is initially 0
+ if (gobject->funcs == &GlibmmIOChannel::vfunc_table)
+ {
+ cpp_object = reinterpret_cast<GlibmmIOChannel*>(gobject)->wrapper;
+
+ if (take_copy && cpp_object)
+ cpp_object->reference();
+ }
+ else
+ {
+ cpp_object = new ForeignIOChannel(gobject, take_copy);
+ cpp_object->reference(); // the refcount is initially 0
+ }
+ }
+
+ return Glib::RefPtr<IOChannel>(cpp_object);
+}
+
+/**** Glib::GlibmmIOChannel ************************************************/
+
+GIOStatus
+GlibmmIOChannel::io_read(
+ GIOChannel* channel, char* buf, gsize count, gsize* bytes_read, GError** err)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOStatus)wrapper->read_vfunc(buf, count, *bytes_read);
+ }
+ catch (Glib::Error& error)
+ {
+ error.propagate(err);
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return G_IO_STATUS_ERROR;
+}
+
+GIOStatus
+GlibmmIOChannel::io_write(
+ GIOChannel* channel, const char* buf, gsize count, gsize* bytes_written, GError** err)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOStatus)wrapper->write_vfunc(buf, count, *bytes_written);
+ }
+ catch (Glib::Error& error)
+ {
+ error.propagate(err);
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return G_IO_STATUS_ERROR;
+}
+
+GIOStatus
+GlibmmIOChannel::io_seek(GIOChannel* channel, gint64 offset, GSeekType type, GError** err)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOStatus)wrapper->seek_vfunc(offset, (SeekType)type);
+ }
+ catch (Glib::Error& error)
+ {
+ error.propagate(err);
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return G_IO_STATUS_ERROR;
+}
+
+GIOStatus
+GlibmmIOChannel::io_close(GIOChannel* channel, GError** err)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOStatus)wrapper->close_vfunc();
+ }
+ catch (Glib::Error& error)
+ {
+ error.propagate(err);
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return G_IO_STATUS_ERROR;
+}
+
+// static
+GSource*
+GlibmmIOChannel::io_create_watch(GIOChannel* channel, GIOCondition condition)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ const auto source = wrapper->create_watch_vfunc((IOCondition)condition);
+ return (source) ? source->gobj_copy() : nullptr;
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return nullptr;
+}
+
+// static
+void
+GlibmmIOChannel::io_free(GIOChannel* channel)
+{
+ if (IOChannel* const wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper)
+ {
+ wrapper->gobject_ = nullptr;
+ delete wrapper;
+ }
+
+ g_free(channel);
+}
+
+GIOStatus
+GlibmmIOChannel::io_set_flags(GIOChannel* channel, GIOFlags flags, GError** err)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOStatus)wrapper->set_flags_vfunc((IOFlags)flags);
+ }
+ catch (Glib::Error& error)
+ {
+ error.propagate(err);
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return G_IO_STATUS_ERROR;
+}
+
+// static
+GIOFlags
+GlibmmIOChannel::io_get_flags(GIOChannel* channel)
+{
+ const auto wrapper = reinterpret_cast<GlibmmIOChannel*>(channel)->wrapper;
+
+ try
+ {
+ return (GIOFlags)wrapper->get_flags_vfunc();
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
}
- return Glib::make_refptr_for_instance<IOChannel>(cpp_object);
+ return GIOFlags(0);
}
} // namespace Glib
_DEFS(glibmm,glib)
#include <glibmmconfig.h>
-#include <glib.h> //For the GIOCondition enum values.
+#include <glib.h> //For the GIOChannel enum values.
#include <glibmm/error.h>
#include <glibmm/refptr.h>
#include <glibmm/ustring.h>
class Source;
class IOSource;
-_WRAP_ENUM(SeekType, GSeekType, NO_GTYPE)
-_WRAP_ENUM(IOStatus, GIOStatus, NO_GTYPE, s#^EOF$#ENDOFFILE#)
+_WRAP_ENUM(SeekType, GSeekType, NO_GTYPE, s#^SEEK_#SEEK_TYPE_#)
+_WRAP_ENUM(IOStatus, GIOStatus, NO_GTYPE)
_WRAP_ENUM(IOFlags, GIOFlags, NO_GTYPE)
-// Glib::IOCondition::IN and Glib::IOCondition::OUT would be problematic.
-// IN and OUT can be preprocessor macros.
-// See https://bugzilla.gnome.org/show_bug.cgi?id=786717
-/** @enum IOCondition
- * A bitwise combination representing an I/O condition to watch for on an
+/** A bitwise combination representing an I/O condition to watch for on an
* event source.
* The flags correspond to those used by the <tt>%poll()</tt> system call
* on UNIX (see <tt>man 2 poll</tt>). To test for individual flags, do
* something like this:
* @code
- * if ((condition & Glib::IOCondition::IO_OUT) == Glib::IOCondition::IO_OUT)
+ * if((condition & Glib::IO_OUT) != 0)
* do_some_output();
* @endcode
*/
-_WRAP_ENUM(IOCondition, GIOCondition, NO_GTYPE,
- s#^IN$#IO_IN#,
- s#^OUT$#IO_OUT#,
- s#^PRI$#IO_PRI#,
- s#^ERR$#IO_ERR#,
- s#^HUP$#IO_HUP#,
- s#^NVAL$#IO_NVAL#)
+_WRAP_ENUM(IOCondition, GIOCondition, NO_GTYPE)
/** Exception class for IOChannel errors.
*/
#endif /* G_OS_WIN32 */
/** Read a single UCS-4 character.
- * @retval thechar The Unicode character.
+ * @param[out] thechar The Unicode character.
* @return The status of the operation.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
* @param count The size of the buffer in bytes. Note that the buffer may
* not be complelely filled even if there is data in the buffer if the
* remaining data is not a complete character.
- * @retval bytes_read The number of bytes read. This may be zero even on
+ * @param[out] bytes_read The number of bytes read. This may be zero even on
* success if @a count < 6 and the channel's encoding is not <tt>""</tt>.
* This indicates that the next UTF-8 character is too wide for the buffer.
* @return The status of the operation.
g_io_channel_read_chars, errthrow)
/** Read a maximum of @a count bytes into @a str.
+ * @param[out] str The characters that have been read.
* @param count The maximum number of bytes to read.
- * @retval str The characters that have been read.
* @return The status of the operation.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
/** Read a whole line.
* Reads until the line separator is found, which is included
* in the result string.
- * @retval line The line that was read.
+ * @param[out] line The line that was read.
* @return The status of the operation.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
_IGNORE(g_io_channel_read_line, g_io_channel_read_line_string)
/** Reads all the remaining data from the file.
- * @retval str The resulting string.
- * @return Glib::IOStatus::NORMAL on success. This function never
- * returns Glib::IOStatus::ENDOFFILE.
+ * @param[out] str The resulting string.
+ * @return Glib::IO_STATUS_NORMAL on success. This function never
+ * returns Glib::IO_STATUS_EOF.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
*/
/** Write a string to the I/O channel.
* Note that this method does not return the number of characters written.
* If the channel is blocking and the returned value is
- * Glib::IOStatus::NORMAL, the whole string was written.
+ * Glib::IO_STATUS_NORMAL, the whole string was written.
* @param str the string to write.
* @return The status of the operation.
* @throw Glib::IOChannelError
/** Write a memory area of @a count bytes to the I/O channel.
* @param buf The start of the memory area.
* @param count The number of bytes to write.
- * @retval bytes_written The number of bytes written to the channel.
+ * @param[out] bytes_written The number of bytes written to the channel.
* @return The status of the operation.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
/** Seek the I/O channel to a specific position.
* @param offset The offset in bytes from the position specified by @a type.
- * @param type A SeekType. The type Glib::SeekType::CUR is only allowed in
+ * @param type A SeekType. The type Glib::SEEK_TYPE_CUR is only allowed in
* those cases where a call to set_encoding() is allowed. See the
* documentation for set_encoding() for details.
* @return The status of the operation.
* @throw Glib::IOChannelError
* @throw Glib::ConvertError
*/
- _WRAP_METHOD(IOStatus seek(gint64 offset, SeekType type = SeekType::SET),
+ _WRAP_METHOD(IOStatus seek(gint64 offset, SeekType type = SEEK_TYPE_SET),
g_io_channel_seek_position, errthrow)
/** Flush the buffers of the I/O channel.
*
* A buffered channel can only be set unbuffered if the channel's internal
* buffers have been flushed. Newly created channels or channels which have
- * returned Glib::IOStatus::ENDOFFILE not require such a flush. For write-only
+ * returned Glib::IO_STATUS_EOF not require such a flush. For write-only
* channels, a call to flush() is sufficient. For all other channels, the
* buffers may be flushed by a call to seek(). This includes the possibility
- * of seeking with seek type Glib::SeekType::CUR and an offset of zero. Note
+ * of seeking with seek type Glib::SEEK_TYPE_CUR and an offset of zero. Note
* that this means that socket-based channels cannot be set unbuffered once
* they have had data read from them.
*
* -# The channel is a file, and the file pointer was just repositioned by a
* call to seek_position(). (This flushes all the internal buffers.)
* -# The current encoding is <tt>""</tt> or UTF-8.
- * -# One of the read methods has just returned Glib::IOStatus::ENDOFFILE (or, in
- * the case of read_to_end(), Glib::IOStatus::NORMAL).
- * -# The read() method has returned Glib::IOStatus::AGAIN or thrown
+ * -# One of the read methods has just returned Glib::IO_STATUS_EOF (or, in
+ * the case of read_to_end(), Glib::IO_STATUS_NORMAL).
+ * -# The read() method has returned Glib::IO_STATUS_AGAIN or thrown
* a Glib::Error exception. This may be useful in the case of
* ConvertError::ILLEGAL_SEQUENCE. Returning one of these statuses
* from read_line() or read_to_end() does <em>not</em> guarantee that
* the encoding can be changed.
*
* Channels which do not meet one of the above conditions cannot call
- * seek_position() with a seek type of Glib::SeekType::CUR and, if they
+ * seek_position() with a seek type of Glib::SEEK_TYPE_CUR and, if they
* are "seekable", cannot call write() after calling one of the API
* "read" methods.
*
* @param encoding The encoding name, or <tt>""</tt> for binary.
- * @return Glib::IOStatus::NORMAL if the encoding was successfully set.
+ * @return Glib::IO_STATUS_NORMAL if the encoding was successfully set.
* @throw Glib::IOChannelError
*/
IOStatus set_encoding(const std::string& encoding = std::string());
protected:
GIOChannel* gobject_;
+ /** Constructor that should be used by derived classes.
+ * Use this constructor if you want to inherit from IOChannel.
+ * It will set up a GIOChannel that will call the vfuncs of your
+ * class even if it is being used from C code, and it will keep
+ * a reference to the C++ code while the GIOChannel exists.
+ */
+ IOChannel();
_IGNORE(g_io_channel_init)
#ifndef DOXYGEN_SHOULD_SKIP_THIS
IOChannel(GIOChannel* gobject, bool take_copy);
#endif
+ //We don't put GLIBMM_DISABLE_DEPRECATED around these deprecated methods
+ //because they are virtual and that would make the ABI dependent on the ifdef.
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOStatus read_vfunc(char* buf, gsize count, gsize& bytes_read);
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOStatus write_vfunc(const char* buf, gsize count, gsize& bytes_written);
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOStatus seek_vfunc(gint64 offset, SeekType type);
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOStatus close_vfunc();
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOStatus set_flags_vfunc(IOFlags flags);
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual IOFlags get_flags_vfunc();
+
+ /**
+ * @deprecated Custom Glib::IOChannel implementation was never really supported.
+ */
+ virtual Glib::RefPtr<Glib::Source> create_watch_vfunc(IOCondition cond);
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ friend class Glib::GlibmmIOChannel;
+#endif
+
private:
void release_gobject();
};
}
bool
-KeyFile::load_from_data(const Glib::ustring& data, Flags flags)
+KeyFile::load_from_data(const Glib::ustring& data, KeyFileFlags flags)
{
GError* gerror = nullptr;
}
bool
-KeyFile::load_from_data_dirs(const std::string& file, std::string& full_path, Flags flags)
+KeyFile::load_from_data_dirs(const std::string& file, std::string& full_path, KeyFileFlags flags)
{
GError* gerror = nullptr;
char* full_path_c = nullptr;
}
bool
-KeyFile::load_from_dirs(const std::string& file, const std::vector<std::string>& search_dirs,
- std::string& full_path, Flags flags)
+KeyFile::load_from_dirs(const std::string& file, const Glib::ArrayHandle<std::string>& search_dirs,
+ std::string& full_path, KeyFileFlags flags)
{
GError* gerror = nullptr;
char* full_path_c = nullptr;
const gboolean result =
- g_key_file_load_from_dirs(gobj(), file.c_str(), const_cast<const gchar**>(Glib::ArrayHandler<std::string>::vector_to_array(search_dirs).data()),
+ g_key_file_load_from_dirs(gobj(), file.c_str(), const_cast<const gchar**>(search_dirs.data()),
&full_path_c, static_cast<GKeyFileFlags>(unsigned(flags)), &gerror);
if (gerror)
return Glib::convert_return_gchar_ptr_to_ustring(str);
}
-std::vector<Glib::ustring>
+Glib::ArrayHandle<Glib::ustring>
KeyFile::get_groups() const
{
gsize length = 0;
char** const array = g_key_file_get_groups(const_cast<GKeyFile*>(gobj()), &length);
- return Glib::ArrayHandler<Glib::ustring>::array_to_vector(array, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<Glib::ustring>(array, length, Glib::OWNERSHIP_DEEP);
}
-std::vector<Glib::ustring>
+Glib::ArrayHandle<Glib::ustring>
KeyFile::get_keys(const Glib::ustring& group_name) const
{
gsize length = 0;
if (gerror)
Glib::Error::throw_exception(gerror);
- return Glib::ArrayHandler<Glib::ustring>::array_to_vector(array, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<Glib::ustring>(array, length, Glib::OWNERSHIP_DEEP);
}
Glib::ustring
if (err) \
Glib::Error::throw_exception(err)
-std::vector<Glib::ustring>
+Glib::ArrayHandle<Glib::ustring>
KeyFile::get_string_list(
const Glib::ustring& group_name, const Glib::ustring& key GLIBMM_ERROR_ARG) const
{
GLIBMM_THROW(gerror);
- return Glib::ArrayHandler<Glib::ustring>::array_to_vector(array, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<Glib::ustring>(array, length, Glib::OWNERSHIP_DEEP);
}
-std::vector<Glib::ustring>
+Glib::ArrayHandle<Glib::ustring>
KeyFile::get_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key,
const Glib::ustring& locale GLIBMM_ERROR_ARG) const
{
GLIBMM_THROW(gerror);
- return Glib::ArrayHandler<Glib::ustring>::array_to_vector(array, length, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<Glib::ustring>(array, length, Glib::OWNERSHIP_DEEP);
}
-std::vector<bool>
+Glib::ArrayHandle<bool>
KeyFile::get_boolean_list(
const Glib::ustring& group_name, const Glib::ustring& key GLIBMM_ERROR_ARG) const
{
GLIBMM_THROW(gerror);
- return Glib::ArrayHandler<bool>::array_to_vector(array, length, Glib::OWNERSHIP_SHALLOW);
+ return Glib::ArrayHandle<bool>(array, length, Glib::OWNERSHIP_SHALLOW);
}
-std::vector<int>
+Glib::ArrayHandle<int>
KeyFile::get_integer_list(
const Glib::ustring& group_name, const Glib::ustring& key GLIBMM_ERROR_ARG) const
{
GLIBMM_THROW(gerror);
- return Glib::ArrayHandler<int>::array_to_vector(array, length, Glib::OWNERSHIP_SHALLOW);
+ return Glib::ArrayHandle<int>(array, length, Glib::OWNERSHIP_SHALLOW);
}
-std::vector<double>
+Glib::ArrayHandle<double>
KeyFile::get_double_list(
const Glib::ustring& group_name, const Glib::ustring& key GLIBMM_ERROR_ARG) const
{
const_cast<GKeyFile*>(gobj()), group_name.c_str(), key.c_str(), &length, &gerror);
GLIBMM_THROW(gerror);
- return Glib::ArrayHandler<double>::array_to_vector(array, length, Glib::OWNERSHIP_SHALLOW);
+ return Glib::ArrayHandle<double>(array, length, Glib::OWNERSHIP_SHALLOW);
}
void
KeyFile::set_string_list(const Glib::ustring& group_name, const Glib::ustring& key,
- const std::vector<Glib::ustring>& list)
+ const Glib::ArrayHandle<Glib::ustring>& list)
{
g_key_file_set_string_list(
- gobj(), Glib::c_str_or_nullptr(group_name), key.c_str(), Glib::ArrayHandler<Glib::ustring>::vector_to_array(list).data(), list.size());
+ gobj(), Glib::c_str_or_nullptr(group_name), key.c_str(), list.data(), list.size());
}
void
KeyFile::set_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key,
- const Glib::ustring& locale, const std::vector<Glib::ustring>& list)
+ const Glib::ustring& locale, const Glib::ArrayHandle<Glib::ustring>& list)
{
g_key_file_set_locale_string_list(gobj(), Glib::c_str_or_nullptr(group_name), key.c_str(),
- locale.c_str(), Glib::ArrayHandler<Glib::ustring>::vector_to_array(list).data(), list.size());
+ locale.c_str(), list.data(), list.size());
}
void
KeyFile::set_integer_list(
- const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<int>& list)
+ const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<int>& list)
{
g_key_file_set_integer_list(gobj(), Glib::c_str_or_nullptr(group_name), key.c_str(),
- const_cast<int*>(Glib::ArrayHandler<int>::vector_to_array(list).data()), list.size());
+ const_cast<int*>(list.data()), list.size());
}
void
KeyFile::set_double_list(
- const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<double>& list)
+ const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<double>& list)
{
g_key_file_set_double_list(
- gobj(), group_name.c_str(), key.c_str(), const_cast<double*>(Glib::ArrayHandler<double>::vector_to_array(list).data()), list.size());
+ gobj(), group_name.c_str(), key.c_str(), const_cast<double*>(list.data()), list.size());
}
void
KeyFile::set_boolean_list(
- const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<bool>& list)
+ const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<bool>& list)
{
g_key_file_set_boolean_list(gobj(), Glib::c_str_or_nullptr(group_name), key.c_str(),
- const_cast<gboolean*>(Glib::ArrayHandler<bool>::vector_to_array(list).data()), list.size());
+ const_cast<gboolean*>(list.data()), list.size());
}
Glib::ustring
#include <glibmmconfig.h>
#include <glibmm/ustring.h>
+#include <glibmm/arrayhandle.h>
#include <glibmm/error.h>
#include <glibmm/utility.h>
#include <glib.h>
-#include <vector>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" { typedef struct _GKeyFile GKeyFile; }
namespace Glib
{
+ _WRAP_ENUM(KeyFileFlags, GKeyFileFlags, NO_GTYPE)
+
/** Exception class for KeyFile errors.
*/
_WRAP_GERROR(KeyFileError, GKeyFileError, G_KEY_FILE_ERROR, NO_GTYPE)
_CLASS_GENERIC(KeyFile, GKeyFile)
public:
- _WRAP_ENUM(Flags, GKeyFileFlags, NO_GTYPE)
-
//TODO: GKeyFile now seems to be a reference-counted type.
//TODO: Maybe replace all the get_*/set_* methods with some generic get/set
KeyFile(GKeyFile* castitem, bool takes_ownership = false);
public:
- _WRAP_METHOD(bool load_from_file(const std::string& file, Flags flags = Flags::NONE), g_key_file_load_from_file, errthrow)
+ _WRAP_METHOD(bool load_from_file(const std::string& file, KeyFileFlags flags = Glib::KEY_FILE_NONE), g_key_file_load_from_file, errthrow)
/** Loads a KeyFile from memory
* @param data The data to use as a KeyFile
* @return true if the KeyFile was successfully loaded, false otherwise
* @throw Glib::KeyFileError
*/
- bool load_from_data(const Glib::ustring& data, Flags flags = Flags::NONE);
+ bool load_from_data(const Glib::ustring& data, KeyFileFlags flags = Glib::KEY_FILE_NONE);
_IGNORE(g_key_file_load_from_data)
-#m4 _CONVERSION(`const std::vector<std::string>& ', `const gchar**', `const_cast<const gchar**>($3.data())')
+#m4 _CONVERSION(`const Glib::ArrayHandle<std::string>&', `const gchar**', `const_cast<const gchar**>($3.data())')
+#m4 _CONVERSION(`Glib::ArrayHandle<std::string>&', `gchar**', `const_cast<gchar**>($3.data())')
- _IGNORE(g_key_file_load_from_dirs)
+ _WRAP_METHOD(bool load_from_dirs(const std::string& file, const Glib::ArrayHandle<std::string>& search_dirs, Glib::ArrayHandle<std::string>& full_path, KeyFileFlags flags = Glib::KEY_FILE_NONE),
+ g_key_file_load_from_dirs, errthrow "Glib::KeyFileError, Glib::FileError", errthrow, deprecated "Use the load_from_dirs() method that takes a std::string& full_path.")
_WRAP_METHOD_DOCS_ONLY(g_key_file_load_from_dirs, errthrow "Glib::KeyFileError, Glib::FileError")
- bool load_from_dirs(const std::string& file, const std::vector<std::string>& search_dirs, std::string& full_path, Flags flags = Flags::NONE);
+ bool load_from_dirs(const std::string& file, const Glib::ArrayHandle<std::string>& search_dirs, std::string& full_path, KeyFileFlags flags = Glib::KEY_FILE_NONE);
/** Looks for a KeyFile named @a file in the paths returned from
* g_get_user_data_dir() and g_get_system_data_dirs() and loads them
* @throw Glib::KeyFileError
* @throw Glib::FileError
*/
- bool load_from_data_dirs(const std::string& file, std::string& full_path, Flags flags = Flags::NONE);
+ bool load_from_data_dirs(const std::string& file, std::string& full_path, KeyFileFlags flags = Glib::KEY_FILE_NONE);
_IGNORE(g_key_file_load_from_data_dirs)
/** Outputs the KeyFile as a string
Glib::ustring to_data();
_IGNORE(g_key_file_to_data)
- _WRAP_METHOD(bool save_to_file(const std::string& filename), g_key_file_save_to_file, errthrow "Glib::FileError")
+ _WRAP_METHOD(bool save_to_file(const std::string& filename), g_key_file_save_to_file, errthrow "Glib::FileError", errthrow)
_WRAP_METHOD(Glib::ustring get_start_group() const, g_key_file_get_start_group)
/** Gets a list of all groups in the KeyFile
* @returns A list containing the names of the groups
*/
- std::vector<Glib::ustring> get_groups() const;
+ Glib::ArrayHandle<Glib::ustring> get_groups() const;
_IGNORE(g_key_file_get_groups)
/** Gets a list of all keys from the group @a group_name.
* @returns A list containing the names of the keys in @a group_name
* @throw Glib::KeyFileError
*/
- std::vector<Glib::ustring> get_keys(const Glib::ustring& group_name) const;
+ Glib::ArrayHandle<Glib::ustring> get_keys(const Glib::ustring& group_name) const;
_IGNORE(g_key_file_get_keys)
_WRAP_METHOD(bool has_group(const Glib::ustring& group_name) const, g_key_file_has_group)
_WRAP_METHOD(Glib::ustring get_value(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_value, errthrow)
_WRAP_METHOD(Glib::ustring get_string(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_string, errthrow)
+ _WRAP_METHOD(Glib::ustring get_locale_for_key(const Glib::ustring& group_name,
+ const Glib::ustring& key, const Glib::ustring& locale{NULL} = {}) const,
+ g_key_file_get_locale_for_key, newin "2,60")
+
/** Gets the value associated with @a key under @a group_name translated
* into the current locale.
* @return the value as a Glib::ustring
*/
gint64 get_int64(const Glib::ustring& key) const;
- _WRAP_METHOD(gint64 get_int64(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_int64, errthrow "Glib::KeyFileError")
+ _WRAP_METHOD(gint64 get_int64(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_int64, errthrow "Glib::KeyFileError", errthrow)
/** Gets the value in the first group, under @a key, interpreting it as
* an unsigned 64-bit integer. This is similar to get_integer() but can
*/
guint64 get_uint64(const Glib::ustring& key) const;
- _WRAP_METHOD(guint64 get_uint64(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_uint64, errthrow "Glib::KeyFileError")
+ _WRAP_METHOD(guint64 get_uint64(const Glib::ustring& group_name, const Glib::ustring& key) const, g_key_file_get_uint64, errthrow "Glib::KeyFileError", errthrow)
/** Gets the value in the first group, under @a key, interpreting it as
* a double.
* @return A list containing the values requested
* @throw Glib::KeyFileError
*/
- std::vector<Glib::ustring> get_string_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
+ Glib::ArrayHandle<Glib::ustring> get_string_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
_IGNORE(g_key_file_get_string_list)
/** Returns the values associated with @a key under @a group_name
* @return A list containing the values requested
* @throw Glib::KeyFileError
*/
- std::vector<Glib::ustring> get_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
+ Glib::ArrayHandle<Glib::ustring> get_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
/** Returns the values associated with @a key under @a group_name
* translated into @a locale, if available.
* @return A list containing the values requested
* @throw Glib::KeyFileError
*/
- std::vector<Glib::ustring> get_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ustring& locale) const;
+ Glib::ArrayHandle<Glib::ustring> get_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ustring& locale) const;
_IGNORE(g_key_file_get_locale_string_list)
/** Returns the values associated with @a key under @a group_name
* @return A list of booleans
* @throw Glib::KeyFileError
*/
- std::vector<bool> get_boolean_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
+ Glib::ArrayHandle<bool> get_boolean_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
_IGNORE(g_key_file_get_boolean_list)
/** Returns the values associated with @a key under @a group_name
* @return A list of integers
* @throw Glib::KeyFileError
*/
- std::vector<int> get_integer_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
+ Glib::ArrayHandle<int> get_integer_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
_IGNORE(g_key_file_get_integer_list)
/** Returns the values associated with @a key under @a group_name
* @return A list of doubles
* @throw Glib::KeyFileError
*/
- std::vector<double> get_double_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
+ Glib::ArrayHandle<double> get_double_list(const Glib::ustring& group_name, const Glib::ustring& key) const;
_IGNORE(g_key_file_get_double_list)
/** Get comment from top of file
* @param key The name of a key
* @param list A list holding objects of type Glib::ustring
*/
- void set_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<Glib::ustring>& list);
+ void set_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<Glib::ustring>& list);
_IGNORE(g_key_file_set_string_list)
/** Sets a list of string values for the @a key under @a group_name and marks
* @param locale A locale
* @param list A list holding objects of type Glib::ustring
*/
- void set_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ustring& locale, const std::vector<Glib::ustring>& list);
+ void set_locale_string_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ustring& locale, const Glib::ArrayHandle<Glib::ustring>& list);
_IGNORE(g_key_file_set_locale_string_list)
/** Sets a list of booleans for the @a key under @a group_name.
* @param key The name of a key
* @param list A list holding object of type bool
*/
- void set_boolean_list(const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<bool>& list);
+ void set_boolean_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<bool>& list);
_IGNORE(g_key_file_set_boolean_list)
/** Sets a list of integers for the @a key under @a group_name.
* @param key The name of a key
* @param list A list holding object of type int
*/
- void set_integer_list(const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<int>& list);
+ void set_integer_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<int>& list);
_IGNORE(g_key_file_set_integer_list)
/** Sets a list of doubles for the @a key under @a group_name.
*
* @newin{2,14}
*/
- void set_double_list(const Glib::ustring& group_name, const Glib::ustring& key, const std::vector<double>& list);
+ void set_double_list(const Glib::ustring& group_name, const Glib::ustring& key, const Glib::ArrayHandle<double>& list);
_IGNORE(g_key_file_set_double_list)
*/
Glib::ustring escape_text(const Glib::ustring& text);
-_WRAP_ENUM(ParseFlags, GMarkupParseFlags, NO_GTYPE)
+
+/** There are no flags right now. Pass <tt>Glib::Markup::ParseFlags(0)</tt> for
+ * the flags argument to all functions (this should be the default argument
+ * anyway).
+ */
+_WRAP_ENUM(ParseFlags, GMarkupParseFlags, NO_GTYPE, s#^MARKUP_##)
+
+/*! @var Markup::ParseFlags DO_NOT_USE_THIS_UNSUPPORTED_FLAG
+ * Flag you should not use.
+ */
+
/** Binary predicate used by Markup::Parser::AttributeMap.
* @ingroup Markup
g_unsetenv(variable.c_str());
}
-std::vector<std::string>
+Glib::ArrayHandle<std::string>
listenv()
{
- return Glib::ArrayHandler<std::string>::array_to_vector(g_listenv(), Glib::OWNERSHIP_DEEP);
+ char** value = g_listenv();
+ char** end = value;
+ while (*end)
+ {
+ ++end;
+ }
+ return Glib::ArrayHandle<std::string>(value, end - value, Glib::OWNERSHIP_DEEP);
}
std::string
return convert_return_gchar_ptr_to_stdstring(g_get_current_dir());
}
+#ifndef GLIBMM_DISABLE_DEPRECATED
+std::string
+get_user_special_dir(GUserDirectory directory)
+{
+ return convert_const_gchar_ptr_to_stdstring(g_get_user_special_dir(directory));
+}
+#endif // GLIBMM_DISABLE_DEPRECATED
+
std::string
get_user_special_dir(UserDirectory directory)
{
std::vector<std::string>
get_system_data_dirs()
{
- return Glib::ArrayHandler<std::string>::array_to_vector(g_get_system_data_dirs(), Glib::OWNERSHIP_NONE);
+ // TODO: Use a utility function:
+ std::vector<std::string> result;
+ const char* const* cresult = g_get_system_data_dirs();
+ if (!cresult)
+ return result;
+
+ for (const gchar* const* iter = cresult; *iter != nullptr; ++iter)
+ {
+ result.emplace_back(convert_const_gchar_ptr_to_stdstring(*iter));
+ }
+
+ return result;
}
std::vector<std::string>
get_system_config_dirs()
{
- return Glib::ArrayHandler<std::string>::array_to_vector(g_get_system_config_dirs(), Glib::OWNERSHIP_NONE);
+ // TODO: Use a utility function:
+ std::vector<std::string> result;
+ const char* const* cresult = g_get_system_config_dirs();
+ if (!cresult)
+ return result;
+
+ for (const gchar* const* iter = cresult; *iter != nullptr; ++iter)
+ {
+ result.emplace_back(convert_const_gchar_ptr_to_stdstring(*iter));
+ }
+
+ return result;
}
std::string
}
std::string
-build_filename(const std::vector<std::string>& elements)
+build_filename(const Glib::ArrayHandle<std::string>& elements)
{
return convert_return_gchar_ptr_to_stdstring(
- g_build_filenamev(const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(elements).data())));
+ g_build_filenamev(const_cast<char**>(elements.data())));
}
std::string
}
std::string
-build_path(const std::string& separator, const std::vector<std::string>& elements)
+build_path(const std::string& separator, const Glib::ArrayHandle<std::string>& elements)
{
return convert_return_gchar_ptr_to_stdstring(
- g_build_pathv(separator.c_str(), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(elements).data())));
+ g_build_pathv(separator.c_str(), const_cast<char**>(elements.data())));
}
std::string
_DEFS(glibmm,glib)
+#include <glibmm/arrayhandle.h>
#include <glibmm/ustring.h>
-#include <vector>
namespace Glib
{
-_WRAP_ENUM(UserDirectory, GUserDirectory, NO_GTYPE, s#^DIRECTORY_##)
+_WRAP_ENUM(UserDirectory, GUserDirectory, NO_GTYPE)
_WRAP_ENUM(FormatSizeFlags, GFormatSizeFlags, NO_GTYPE)
/** @defgroup MiscUtils Miscellaneous Utility Functions
* @return Array of environment names (The generic ArrayHandle will be
* implicitly converted to any STL compatible container type).
*/
-std::vector<std::string> listenv();
+Glib::ArrayHandle<std::string> listenv();
/** Gets the user name of the current user.
*
*/
std::string get_current_dir();
+#ifndef GLIBMM_DISABLE_DEPRECATED
+/** Returns the full path of a special directory using its logical id.
+ *
+ * On Unix this is done using the XDG special user directories.
+ * For compatibility with existing practise, G_USER_DIRECTORY_DESKTOP
+ * falls back to `$HOME/Desktop` when XDG special user directories have
+ * not been set up.
+ *
+ * Depending on the platform, the user might be able to change the path
+ * of the special directory without requiring the session to restart; GLib
+ * will not reflect any change once the special directories are loaded.
+ *
+ * @param directory The logical id of special directory.
+ * @return The path to the specified special directory, or an empty string
+ * if the logical id was not found.
+ *
+ * @newin{2,14}
+ * @deprecated Use get_user_special_dir(Glib::UserDirectory directory) instead.
+ */
+std::string get_user_special_dir(GUserDirectory directory);
+#endif // GLIBMM_DISABLE_DEPRECATED
+
/** Returns the full path of a special directory using its logical id.
*
* On Unix this is done using the XDG special user directories.
* Any STL compatible container type is accepted.
* @return The resulting path.
*/
-std::string build_filename(const std::vector<std::string>& elements);
+std::string build_filename(const Glib::ArrayHandle<std::string>& elements);
/** Creates a filename from two elements using the correct separator for filenames.
* No attempt is made to force the resulting filename to be an absolute path.
* @return The resulting path.
*/
std::string build_path(const std::string& separator,
- const std::vector<std::string>& elements);
+ const Glib::ArrayHandle<std::string>& elements);
/** Locates the first executable named @a program in the user's path, in the
* same way that <tt>execvp()</tt> would locate it.
* 3292528 bytes will be converted into the string "3.2 MB".
*
* The prefix units base is 1000 (i.e. 1 kB is 1000 bytes), unless the
- * Glib::FormatSizeFlags::IEC_UNITS flag is set.
+ * Glib::FORMAT_SIZE_IEC_UNITS flag is set.
*
* @param size A size in bytes.
* @param flags Flags to modify the output.
*
* @newin{2,46}
*/
-Glib::ustring format_size(guint64 size, FormatSizeFlags flags = FormatSizeFlags::DEFAULT);
+Glib::ustring format_size(guint64 size, FormatSizeFlags flags = FORMAT_SIZE_DEFAULT);
/** @} group MiscUtils */
namespace Glib
{
-Module::Module(const std::string& file_name, Flags flags)
+Module::Module(const std::string& file_name, ModuleFlags flags)
: gobject_(g_module_open(file_name.c_str(), (GModuleFlags)flags))
{
}
namespace Glib
{
+_WRAP_ENUM(ModuleFlags, GModuleFlags, NO_GTYPE)
+
//TODO: Replace get_last_error() with exceptions?
//Provide operator()?
public:
- _WRAP_ENUM(Flags, GModuleFlags, NO_GTYPE)
-
/** Opens a module.
*
* First of all it tries to open file_name as a module. If that
* @param file_name The library filename to open
* @param flags Flags to configure the load process
*/
- explicit Module(const std::string& file_name, Flags flags = Flags(0));
+ explicit Module(const std::string& file_name, ModuleFlags flags = ModuleFlags(0));
Module(const Module&) = delete;
Module& operator=(const Module&) = delete;
#include <stack>
#include <deque>
-#include <sigc++/bind.h>
-#include <sigc++/slot.h>
#include <glibmm/refptr.h>
#include <glibmm/ustring.h>
#include <glibmm/error.h>
+#include <glibmm/arrayhandle.h>
#include <glib.h>
namespace Glib
{
+//Hand-written, instead of using _WRAP_ENUM,
+//because the C enum values don't have a prefix.
+
+/** Specifies the type of traveral performed by methods such as NodeTree::_traverse() and NodeTree::find().
+ *
+ * @ingroup glibmmEnums
+ */
+enum TraverseType
+{
+ TRAVERSE_IN_ORDER = G_IN_ORDER, /*!< Visits a node's left child first, then the node itself, then its right child. This is the one to use if you want the output sorted according to the compare function. */
+ TRAVERSE_PRE_ORDER = G_PRE_ORDER, /*!< Visits a node, then its children. */
+ TRAVERSE_POST_ORDER = G_POST_ORDER, /*!< Visits the node's children, then the node itself. */
+ TRAVERSE_LEVEL_ORDER = G_LEVEL_ORDER /*!< For NodeTree, it vists the root node first, then its children, then its grandchildren, and so on. Note that this is less efficient than the other orders. This is not implemented for Glib::Tree. */
+};
+
/** N-ary Trees - trees of data with any number of branches
* The NodeTree class and its associated functions provide an N-ary tree data structure, in which nodes in the tree can contain arbitrary data.
*
{
_CLASS_GENERIC(NodeTree, GNode)
public:
- _WRAP_ENUM(TraverseType, GTraverseType, NO_GTYPE)
-
- using TraverseFunc = sigc::slot<bool(NodeTree<T>&)>;
- using ForeachFunc = sigc::slot<void(NodeTree<T>&)>;
+ using TraverseFunc = sigc::slot<bool, NodeTree<T>&>;
+ using ForeachFunc = sigc::slot<void, NodeTree<T>&>;
private:
static NodeTree<T>* wrap(GNode* node)
}
_IGNORE(g_node_get_root)
- // Can't use _WRAP_ENUM for a Flags-type enum in a template class.
- // gmmproc would get the bitwise operators wrong.
+
/** Specifies which nodes are visited during several of the NodeTree methods,
* including traverse() and find().
*
* @ingroup glibmmEnums
*/
- enum class TraverseFlags
+ enum TraverseFlags
{
- LEAVES = G_TRAVERSE_LEAVES, /*!< Only leaf nodes should be visited. */
- NON_LEAVES = G_TRAVERSE_NON_LEAVES, /*!< Only non-leaf nodes should be visited. */
- ALL = G_TRAVERSE_ALL, /*!< All nodes should be visited. */
- MASK = G_TRAVERSE_MASK /*!< A mask of all traverse flags. */
+ TRAVERSE_LEAVES = G_TRAVERSE_LEAVES, /*!< Only leaf nodes should be visited. */
+ TRAVERSE_NON_LEAVES = G_TRAVERSE_NON_LEAVES, /*!< Only non-leaf nodes should be visited. */
+ TRAVERSE_ALL = G_TRAVERSE_ALL, /*!< All nodes should be visited. */
+ TRAVERSE_MASK = G_TRAVERSE_MASK /*!< A mask of all traverse flags. */
};
/** Traverses a tree starting at the current node.
* If max_depth is 2, the root and its children are visited. And so on.
* @param func the slot to invoke for each visited child
*/
- void traverse(const TraverseFunc& func, TraverseType order = TraverseType::IN_ORDER, TraverseFlags flags = TraverseFlags::ALL, int max_depth = -1)
+ void traverse(const TraverseFunc& func, TraverseType order = TRAVERSE_IN_ORDER, TraverseFlags flags = TRAVERSE_ALL, int max_depth = -1)
{
TraverseFunc func_copy = func;
g_node_traverse(gobj(), (GTraverseType)order, (GTraverseFlags)flags, max_depth, c_callback_traverse, reinterpret_cast<gpointer>(&func_copy));
* @param flags Wwhich types of children are to be visited.
* @param func The slot to invoke for each visited node.
*/
- void foreach(const ForeachFunc& func, TraverseFlags flags = TraverseFlags::ALL)
+ void foreach(const ForeachFunc& func, TraverseFlags flags = TRAVERSE_ALL)
{
ForeachFunc func_copy = func;
g_node_children_foreach(gobj(), (GTraverseFlags)flags, c_callback_foreach, reinterpret_cast<gpointer>(&func_copy));
/** Finds the first child of a NodeTree with the given data.
*
- * @param flags Which types of children are to be visited, one of TraverseFlags::ALL, TraverseFlags::LEAVES or TraverseFlags::NON_LEAVES.
+ * @param flags Which types of children are to be visited, one of TRAVERSE_ALL, TRAVERSE_LEAVES and TRAVERSE_NON_LEAVES.
* @param the_data The data for which to search.
* @return the found child, or <tt>nullptr</tt> if the data is not found
*/
- NodeTree<T>* find_child(const T& the_data, TraverseFlags flags = TraverseFlags::ALL)
+ NodeTree<T>* find_child(const T& the_data, TraverseFlags flags = TRAVERSE_ALL)
{
- sigc::slot<void(GNode*, const T&, GNode**)> real_slot = sigc::ptr_fun(on_compare_child);
+ sigc::slot<void, GNode*, const T&, GNode**> real_slot = sigc::ptr_fun(on_compare_child);
GNode* child = nullptr;
- using type_foreach_gnode_slot = sigc::slot<void(GNode*)>;
+ using type_foreach_gnode_slot = sigc::slot<void, GNode*>;
type_foreach_gnode_slot bound_slot = sigc::bind(real_slot, the_data, &child);
g_node_children_foreach(gobj(), (GTraverseFlags)flags, c_callback_foreach_compare_child, reinterpret_cast<gpointer>(&bound_slot));
/** Finds the first child of a NodeTree with the given data.
*
- * @param flags Which types of children are to be visited, one of TraverseFlags::ALL, TraverseFlags::LEAVES or TraverseFlags::NON_LEAVES.
+ * @param flags Which types of children are to be visited, one of TRAVERSE_ALL, TRAVERSE_LEAVES and TRAVERSE_NON_LEAVES.
* @param the_data The data for which to search.
* @return the found child, or <tt>nullptr</tt> if the data is not found
*/
- const NodeTree<T>* find_child(const T& the_data, TraverseFlags flags = TraverseFlags::ALL) const
+ const NodeTree<T>* find_child(const T& the_data, TraverseFlags flags = TRAVERSE_ALL) const
{
return const_cast<NodeTree<T>*>(this)->find_child(flags, the_data);
}
/** Finds a node in a tree.
*
- * @param order The order in which nodes are visited: TraverseType::IN_ORDER, TraverseType::PRE_ORDER, TraverseType::POST_ORDER, or TraverseType::LEVEL_ORDER
- * @param flags Which types of children are to be visited: one of TraverseFlags::ALL, TraverseFlags::LEAVES or TraverseFlags::NON_LEAVES.
+ * @param order The order in which nodes are visited: IN_ORDER, TRAVERSE_PRE_ORDER, TRAVERSE_POST_ORDER, or TRAVERSE_LEVEL_ORDER
+ * @param flags Which types of children are to be visited: one of TRAVERSE_ALL, TRAVERSE_LEAVES and TRAVERSE_NON_LEAVES.
* @param the_data The data for which to search.
* @return The found node, or <tt>nullptr</tt> if the data is not found.
*/
- NodeTree<T>* find(const T& the_data, TraverseType order = TraverseType::IN_ORDER, TraverseFlags flags = TraverseFlags::ALL)
+ NodeTree<T>* find(const T& the_data, TraverseType order = TRAVERSE_IN_ORDER, TraverseFlags flags = TRAVERSE_ALL)
{
//We use a sigc::slot for the C callback, so we can bind some extra data.
- sigc::slot<gboolean(GNode*, const T&, GNode**)> real_slot = sigc::ptr_fun(on_compare_node);
+ sigc::slot<gboolean, GNode*, const T&, GNode**> real_slot = sigc::ptr_fun(on_compare_node);
GNode* child = nullptr;
- using type_traverse_gnode_slot = sigc::slot<gboolean(GNode*)>;
+ using type_traverse_gnode_slot = sigc::slot<gboolean, GNode*>;
type_traverse_gnode_slot bound_slot = sigc::bind(real_slot, the_data, &child);
g_node_traverse(const_cast<GNode*>(gobj()), (GTraverseType)order, (GTraverseFlags)flags, -1, c_callback_traverse_compare_node, reinterpret_cast<gpointer>(&bound_slot));
* @param the_data The data for which to search.
* @return The found node, or <tt>nullptr</tt> if the data is not found.
*/
- const NodeTree<T>* find(const T& the_data, TraverseType order = TraverseType::IN_ORDER, TraverseFlags flags = TraverseFlags::ALL) const
+ const NodeTree<T>* find(const T& the_data, TraverseType order = TRAVERSE_IN_ORDER, TraverseFlags flags = TRAVERSE_ALL) const
{
return const_cast<NodeTree<T>*>(this)->find(order, flags, the_data);
}
/** Gets the number of nodes in a tree.
*
- * @param flags Which types of children are to be counted: one of TraverseFlags::ALL, TraverseFlags::LEAVES or TraverseFlags::NON_LEAVES
+ * @param flags Which types of children are to be counted: one of TRAVERSE_ALL, TRAVERSE_LEAVES and TRAVERSE_NON_LEAVES
* @return The number of nodes in the tree.
*/
- guint node_count(TraverseFlags flags = TraverseFlags::ALL) const
+ guint node_count(TraverseFlags flags = TRAVERSE_ALL) const
{
return g_node_n_nodes(const_cast<GNode*>(gobj()), (GTraverseFlags)flags);
}
}
}
- /// Wrapper for invoking a sigc::slot<void(GNode*)> (Internal use).
+ /// Wrapper for invoking a sigc::slot<void,GNode*> (Internal use).
static void c_callback_foreach_compare_child(GNode* node, gpointer data)
{
const ForeachFunc* slot = reinterpret_cast<const ForeachFunc*>(data);
return FALSE;
}
- /// Wrapper for invoking a sigc::slot<gboolean(GNode*)> (Internal use).
+ /// Wrapper for invoking a sigc::slot<gboolean,GNode*> (Internal use).
static gboolean c_callback_traverse_compare_node(GNode* node, gpointer data)
{
const TraverseFunc* slot = reinterpret_cast<const TraverseFunc*>(data);
void
OptionContext::add_group(OptionGroup& group)
{
- // GObjectContext takes ownership of the GOptionGroup, unrefing it later.
- g_option_context_add_group(gobj(), group.gobj_copy());
+ // Strangely, GObjectContext actually takes ownership of the GOptionGroup, deleting it later.
+ g_option_context_add_group(gobj(), (group).gobj_give_ownership());
}
void
OptionContext::set_main_group(OptionGroup& group)
{
- // GObjectContext takes ownership of the GOptionGroup, unrefing it later.
- g_option_context_set_main_group(gobj(), group.gobj_copy());
+ // Strangely, GObjectContext actually takes ownership of the GOptionGroup, deleting it later.
+ g_option_context_set_main_group(gobj(), (group).gobj_give_ownership());
}
/*
//so it should be used carefully. For instance you could not access data in a derived class via this second instance.
explicit OptionContext(GOptionContext* castitem, bool take_ownership = false);
- OptionContext(const OptionContext& other) = delete;
- OptionContext& operator=(const OptionContext& other) = delete;
+ //TODO?:
+ //OptionContext(const OptionContext& other) = delete;
+ //OptionContext& operator=(const OptionContext& other) = delete;
OptionContext(OptionContext&& other) noexcept;
OptionContext& operator=(OptionContext&& other) noexcept;
_WRAP_METHOD(bool get_strict_posix() const, g_option_context_get_strict_posix)
#m4 _CONVERSION(`char**&',`gchar***',`&($3)')
- _WRAP_METHOD(bool parse(int& argc, char**& argv), g_option_context_parse, errthrow "Glib::OptionError, Glib::ConvertError")
+ _WRAP_METHOD(bool parse(int& argc, char**& argv), g_option_context_parse, errthrow "Glib::OptionError, Glib::ConvertError", errthrow)
/** Parses the command line arguments.
*
* This function is used to translate user-visible strings, for --help output.
* The function takes an untranslated string and returns a translated string
*/
- using SlotTranslate = sigc::slot<Glib::ustring(const Glib::ustring&)>;
+ using SlotTranslate = sigc::slot<Glib::ustring, const Glib::ustring&>;
/**
* Sets the function which is used to translate user-visible
namespace Glib
{
-using Flags = OptionEntry::Flags;
-
OptionEntry::OptionEntry()
{
gobject_ = g_new0(GOptionEntry, 1);
return *this;
}
+void
+OptionEntry::set_long_name(const Glib::ustring& value)
+{
+ if (gobject_->long_name)
+ {
+ g_free((gchar*)(gobject_->long_name));
+ gobject_->long_name = nullptr;
+ }
+
+ // Note that we do not use nullptr for an empty string,
+ // because G_OPTION_REMAINING is actually a "", so it actually has a distinct meaning:
+ // TODO: Wrap G_OPTION_REMAINING in C++ somehow, maybe as an explicit set_long_name(void) or
+ // set_is_remaining()? murrayc.
+ gobj()->long_name = (value).c_str() ? g_strdup((value).c_str()) : nullptr;
+}
+
+void
+OptionEntry::set_description(const Glib::ustring& value)
+{
+ if (gobject_->description)
+ {
+ g_free((gchar*)(gobject_->description));
+ gobject_->description = nullptr;
+ }
+
+ gobj()->description = (value).empty() ? nullptr : g_strdup((value).c_str());
+}
+
+void
+OptionEntry::set_arg_description(const Glib::ustring& value)
+{
+ if (gobject_->arg_description)
+ {
+ g_free((gchar*)(gobject_->arg_description));
+ gobject_->arg_description = nullptr;
+ }
+
+ gobj()->arg_description = (value).empty() ? nullptr : g_strdup((value).c_str());
+}
+
} // namespace Glib
extern "C" { typedef struct _GOptionEntry GOptionEntry; }
#endif
+
namespace Glib
{
_CLASS_GENERIC(OptionEntry, GOptionEntry)
public:
- _WRAP_ENUM(Flags, GOptionFlags, NO_GTYPE)
+ //Copied from goption.h, instead of generated, so that we can put it inside the class.
+ enum Flags
+ {
+ FLAG_HIDDEN = 1 << 0,
+ FLAG_IN_MAIN = 1 << 1,
+ FLAG_REVERSE = 1 << 2,
+ FLAG_NO_ARG = 1 << 3,
+ FLAG_FILENAME = 1 << 4,
+ FLAG_OPTIONAL_ARG = 1 << 5,
+ FLAG_NOALIAS = 1 << 6
+ } GOptionFlags;
OptionEntry();
OptionEntry(const OptionEntry& src);
OptionEntry& operator=(const OptionEntry& src);
- // We do not use nullptr for an empty string in set_long_name(),
- // because G_OPTION_REMAINING is actually a "", so it has a distinct meaning.
- // TODO: Wrap G_OPTION_REMAINING in C++ somehow, maybe as an overloaded
- // set_long_name(void) or set_is_remaining()? murrayc.
- #m4 _CONVERSION(`Glib::ustring',`const char*',`($3).c_str()')
+ //#m4 _CONVERSION(`Glib::ustring',`const gchar*',`($3).empty() ? nullptr : g_strdup(($3).c_str())')
+
_MEMBER_GET(long_name, long_name, Glib::ustring, const char*)
- _MEMBER_SET_STR(long_name, long_name, Glib::ustring, const char*)
+
+ void set_long_name(const Glib::ustring& value);
_MEMBER_GET(short_name, short_name, gchar, gchar)
_MEMBER_SET(short_name, short_name, gchar, gchar)
-#m4 _CONVERSION(`int',`Flags',`static_cast<Flags>($3)')
- _MEMBER_GET(flags, flags, Flags, int)
+ _MEMBER_GET(flags, flags, int, int)
-#m4 _CONVERSION(`Flags',`int',`static_cast<int>($3)')
/** Set one or more OptionEntry::Flags.
- * Do not set Flags::FILENAME. Character encoding is chosen when the OptionEntry
+ * Do not set FLAG_FILENAME. Character encoding is chosen when the OptionEntry
* is added to an OptionGroup.
*/
- _MEMBER_SET(flags, flags, Flags, int)
+ _MEMBER_SET(flags, flags, int, int)
- // We use nullptr for an empty string in set_description() and set_arg_description().
- #m4 _CONVERSION(`Glib::ustring',`const char*',`Glib::c_str_or_nullptr($3)')
_MEMBER_GET(description, description, Glib::ustring, const char*)
- _MEMBER_SET_STR(description, description, Glib::ustring, const char*)
+
+ void set_description(const Glib::ustring& value);
_MEMBER_GET(arg_description, arg_description, Glib::ustring, const char*)
- _MEMBER_SET_STR(arg_description, arg_description, Glib::ustring, const char*)
+
+ void set_arg_description(const Glib::ustring& value);
GOptionEntry* gobj() { return gobject_; }
const GOptionEntry* gobj() const { return gobject_; }
void release_gobject() noexcept;
protected:
+
GOptionEntry* gobject_;
};
#include <glibmm/optioncontext.h>
#include <glibmm/utility.h>
#include <glibmm/exceptionhandler.h>
+//#include <glibmm/containers.h>
#include <glib.h> // g_malloc
#include <cstring> // std::memset()
try
{
- return option_group->on_pre_parse(cppContext);
+ return option_group->on_pre_parse(cppContext, *option_group);
}
catch (Glib::Error& err)
{
static void
g_callback_error(
- GOptionContext* context, GOptionGroup* /* group */, gpointer data, GError** error)
+ GOptionContext* context, GOptionGroup* /* group */, gpointer data, GError** /* TODO error */)
{
- // GError** error is input data containing information on an error that
- // has occurred before this function is called.
+ // TODO GError** error is input data containing information on an error that
+ // has occurred before this function is called. When API can be broken,
+ // the function prototype of on_error ought to be changed to
+ // void on_error(OptionContext& context, Error& error).
OptionContext cppContext(context, false /* take_ownership */);
auto option_group = static_cast<OptionGroup*>(data);
- if (option_group && error && *error)
- {
- try
- {
- Error::throw_exception(g_error_copy(*error));
- }
- catch (const Error& err)
- {
- return option_group->on_error(cppContext, err);
- }
- }
+ if (option_group)
+ return option_group->on_error(cppContext, *option_group);
}
const gchar*
try
{
- return option_group->on_post_parse(cppContext);
+ return option_group->on_post_parse(cppContext, *option_group);
}
catch (Glib::Error& err)
{
OptionGroup::OptionGroup(const Glib::ustring& name, const Glib::ustring& description,
const Glib::ustring& help_description)
: gobject_(g_option_group_new(name.c_str(), description.c_str(), help_description.c_str(),
- this /* user_data */, nullptr /* destroy_func */))
+ this /* user_data */, nullptr /* destroy_func */)),
+ has_ownership_(true)
{
// g_callback_pre_parse(), post_parse_callback(), g_callback_error(), and
// option_arg_callback() depend on user_data being this. The first three
g_option_group_set_error_hook(gobj(), &g_callback_error);
}
-OptionGroup::OptionGroup(GOptionGroup* castitem) : gobject_(castitem)
+OptionGroup::OptionGroup(GOptionGroup* castitem) : gobject_(castitem), has_ownership_(true)
{
// Always takes ownership - never takes copy.
}
+OptionGroup::OptionGroup(OptionGroup&& other) noexcept
+ : map_entries_(std::move(other.map_entries_)),
+ gobject_(std::move(other.gobject_)),
+ has_ownership_(std::move(other.has_ownership_))
+{
+ other.gobject_ = nullptr;
+ other.has_ownership_ = false;
+}
+
+OptionGroup&
+OptionGroup::operator=(OptionGroup&& other) noexcept
+{
+ release_gobject();
+
+ map_entries_ = std::move(other.map_entries_);
+ gobject_ = std::move(other.gobject_);
+ has_ownership_ = std::move(other.has_ownership_);
+
+ other.gobject_ = nullptr;
+ other.has_ownership_ = false;
+
+ return *this;
+}
+
void
OptionGroup::release_gobject() noexcept
{
cpp_entry.release_c_arg();
}
- if (gobject_)
+ if (has_ownership_ && gobject_)
{
g_option_group_unref(gobj());
gobject_ = nullptr;
}
// When the command argument value is to be parsed by a user-supplied function
-// (indicated by G_OPTION_ARG_CALLBACK), the OptionEntry::Flags::FILENAME in 'entry' is ignored.
+// (indicated by G_OPTION_ARG_CALLBACK), the FLAG_FILENAME in 'entry' is ignored.
// set_c_arg_default() clears or sets it as required in a copy of 'entry'.
//
// The glib API is inconsistent here. The choice between UTF-8 and filename
// G_OPTION_ARG_STRING_ARRAY, and G_OPTION_ARG_FILENAME_ARRAY, which in glibmm
// are set by OptionGroup::add_entry[_filename]. But when a callback function
// is chosen, there is only G_OPTION_ARG_CALLBACK, and the encoding is chosen
-// with OptionEntry::Flags::FILENAME. We do this automatiically in set_c_arg_default().
+// with G_OPTION_FLAG_FILENAME. We do this automatiically in set_c_arg_default().
// Other option flags are set by OptionEntry::set_flags().
void
}
bool
-OptionGroup::on_pre_parse(OptionContext& /* context */)
+OptionGroup::on_pre_parse(OptionContext& /* context */, OptionGroup& /* group */)
{
return true;
}
bool
-OptionGroup::on_post_parse(OptionContext& /* context */)
+OptionGroup::on_post_parse(OptionContext& /* context */, OptionGroup& /* group */)
{
return true;
}
void
-OptionGroup::on_error(OptionContext& /* context */, const Error& /* error */)
+OptionGroup::on_error(OptionContext& /* context */, OptionGroup& /* group */)
{
}
{
// No value to set here. The arg pointer is a function pointer.
- // Set or clear OptionEntry::Flags::FILENAME in *entry_.
+ // Set or clear FLAG_FILENAME in *entry_.
const OptionArgCallback* const option_arg = static_cast<const OptionArgCallback*>(cpp_arg);
if (option_arg->is_filename_option())
{
- entry_->set_flags(entry_->get_flags() | OptionEntry::Flags::FILENAME);
+ entry_->set_flags(entry_->get_flags() | OptionEntry::FLAG_FILENAME);
}
else
{
- entry_->set_flags(entry_->get_flags() & ~OptionEntry::Flags::FILENAME);
+ entry_->set_flags(entry_->get_flags() & ~OptionEntry::FLAG_FILENAME);
}
break;
}
typed_cpp_arg->clear();
// The C array is null-terminated.
- // std::vector<Glib::ustring> array_handle(*typed_arg, Glib::OWNERSHIP_NONE);
+ // Glib::StringArrayHandle array_handle(*typed_arg, Glib::OWNERSHIP_NONE);
// The SUN Forte compiler complains about this:
// "optiongroup.cc", line 354: Error: Cannot assign Glib::ArrayHandle<Glib::ustring,
// of a pointer dynamic_cast must be a pointer to a complete class type
// return dynamic_cast<CppType>(Glib::wrap_auto(cobj, false /* take_copy */));
- // for(auto iter = array_handle.begin(); iter !=
+ // for(Glib::StringArrayHandle::iterator iter = array_handle.begin(); iter !=
// array_handle.end(); ++iter)
//{
// typed_cpp_arg->emplace_back(*iter);
}
GOptionGroup*
-OptionGroup::gobj_copy() const
+OptionGroup::gobj_give_ownership()
{
- return g_option_group_ref(gobject_);
+ has_ownership_ = false;
+ return gobj();
}
} // namespace Glib
_DEFS(glibmm,glib)
-#include <glibmm/error.h>
#include <glibmm/ustring.h>
#include <sigc++/slot.h>
#include <map>
class OptionContext;
#endif //DOXYGEN_SHOULD_SKIP_THIS
-// GOptionGroup is now refcounted. See https://bugzilla.gnome.org/show_bug.cgi?id=743349
-// But Glib::OptionGroup can't be a _CLASS_OPAQUE_REFCOUNTED, because it has
-// other data members than gobject_. The memory management would be more involved
-// if Glib::OptionGroup were refcounted. It would need a separate refcount for the
-// wrapper, like in Glib::IOChannel and Glib::Source. It's easier and good enough
-// to let Glib::OptionGroup remain non-refcounted. GOptionGroup's refcount still helps.
-// E.g. when GOptionContext takes ownership of a GOptionGroup, it's given a ref.
-// A drawback with this approach is that it's possible to have more than one wrapper
-// for one GOptionGroup, each wrapper with its own ref.
-
+//TODO: GOptionGroup is now refcounted. See https://bugzilla.gnome.org/show_bug.cgi?id=743349
+//When we can break API/ABI, make Glib::OptionGroup refcounted. _CLASS_OPAQUE_REFCOUNTED?
/** An OptionGroup defines the options in a single group.
* Libraries which need to parse commandline options are expected to provide a function that allows their OptionGroups to
* be added to the application's OptionContext.
public:
/** For example Glib::ustring on_translate(const Glib::ustring& original);.
*/
- using SlotTranslate = sigc::slot<Glib::ustring(const Glib::ustring&)>;
+ using SlotTranslate = sigc::slot<Glib::ustring, const Glib::ustring&>;
/** For example bool on_option_arg_string(const Glib::ustring& option_name,
* const Glib::ustring& value, bool has_value);.
*/
- using SlotOptionArgString = sigc::slot<bool(const Glib::ustring&, const Glib::ustring&, bool)>;
+ using SlotOptionArgString = sigc::slot<bool, const Glib::ustring&, const Glib::ustring&, bool>;
/** For example bool on_option_arg_filename(const Glib::ustring& option_name,
* const std::string& value, bool has_value);.
*/
- using SlotOptionArgFilename = sigc::slot<bool(const Glib::ustring&, const std::string&, bool)>;
+ using SlotOptionArgFilename = sigc::slot<bool, const Glib::ustring&, const std::string&, bool>;
OptionGroup(const Glib::ustring& name, const Glib::ustring& description, const Glib::ustring& help_description = Glib::ustring());
explicit OptionGroup(GOptionGroup* castitem);
_IGNORE(g_option_group_new, g_option_group_ref)
- // OptionGroup can't be copied or moved. The underlying GOptionGroup contains
- // a pointer to the wrapper, set in the call to g_option_group_new().
- // That pointer can't be changed.
- OptionGroup(const OptionGroup& other) = delete;
- OptionGroup& operator=(const OptionGroup& other) = delete;
- OptionGroup(OptionGroup&& other) = delete;
- OptionGroup& operator=(OptionGroup&& other) = delete;
+ OptionGroup(OptionGroup&& other) noexcept;
+ OptionGroup& operator=(OptionGroup&& other) noexcept;
virtual ~OptionGroup();
_IGNORE(g_option_group_free, g_option_group_unref)
- virtual bool on_pre_parse(OptionContext& context);
- virtual bool on_post_parse(OptionContext& context);
- virtual void on_error(OptionContext& context, const Error& error);
+ virtual bool on_pre_parse(OptionContext& context, OptionGroup& group);
+ virtual bool on_post_parse(OptionContext& context, OptionGroup& group);
+ virtual void on_error(OptionContext& context, OptionGroup& group);
_IGNORE(g_option_group_set_parse_hooks, g_option_group_set_error_hook)
void add_entry(const OptionEntry& entry);
_WRAP_METHOD(void set_translation_domain(const Glib::ustring& domain), g_option_group_set_translation_domain)
- /// Provides access to the underlying C instance.
GOptionGroup* gobj() { return gobject_; }
-
- /// Provides access to the underlying C instance.
const GOptionGroup* gobj() const { return gobject_; }
-
- /// Provides access to the underlying C instance. The caller is responsible for unrefing it.
- GOptionGroup* gobj_copy() const;
+ GOptionGroup* gobj_give_ownership();
protected:
gpointer data, GError** error);
//Map of entry names to CppOptionEntry:
- using type_map_entries = std::map<Glib::ustring, CppOptionEntry>;
+ typedef std::map<Glib::ustring, CppOptionEntry> type_map_entries;
type_map_entries map_entries_;
GOptionGroup* gobject_;
+ bool has_ownership_; //Whether the gobject_ belongs to this C++ instance.
#endif //DOXYGEN_SHOULD_SKIP_THIS
private:
#include <glibmm/utility.h>
-using CompileFlags = Glib::Regex::CompileFlags;
-using MatchFlags = Glib::Regex::MatchFlags;
-
namespace Glib
{
Glib::RefPtr<Glib::Regex>
Regex::create(
- const Glib::ustring& pattern, CompileFlags compile_options, MatchFlags match_options)
+ const Glib::ustring& pattern, RegexCompileFlags compile_options, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
auto regex = g_regex_new(
bool
Regex::match(
- const Glib::ustring& string, Glib::MatchInfo& match_info, MatchFlags match_options)
+ const Glib::ustring& string, Glib::MatchInfo& match_info, RegexMatchFlags match_options)
{
GMatchInfo* ginfo = nullptr;
bool const result = static_cast<bool>(
}
bool
-Regex::match(const Glib::ustring& string, MatchFlags match_options)
+Regex::match(const Glib::ustring& string, RegexMatchFlags match_options)
{
return g_regex_match(gobj(), string.c_str(), (GRegexMatchFlags)(match_options), nullptr);
}
bool
Regex::match(const Glib::ustring& string, int start_position, Glib::MatchInfo& match_info,
- MatchFlags match_options)
+ RegexMatchFlags match_options)
{
GError* gerror = nullptr;
GMatchInfo* ginfo = nullptr;
bool
Regex::match(const Glib::ustring& string, gssize string_len, int start_position,
- Glib::MatchInfo& match_info, MatchFlags match_options)
+ Glib::MatchInfo& match_info, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
GMatchInfo* ginfo = nullptr;
}
bool
-Regex::match(const Glib::ustring& string, int start_position, MatchFlags match_options)
+Regex::match(const Glib::ustring& string, int start_position, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
bool retvalue = g_regex_match_full(gobj(), string.c_str(), -1, start_position,
bool
Regex::match(
- const Glib::ustring& string, gssize string_len, int start_position, MatchFlags match_options)
+ const Glib::ustring& string, gssize string_len, int start_position, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
bool retvalue = g_regex_match_full(gobj(), string.c_str(), string_len, start_position,
bool
Regex::match_all(
- const Glib::ustring& string, Glib::MatchInfo& match_info, MatchFlags match_options)
+ const Glib::ustring& string, Glib::MatchInfo& match_info, RegexMatchFlags match_options)
{
GMatchInfo* ginfo = nullptr;
bool const result = static_cast<bool>(g_regex_match_all(
}
bool
-Regex::match_all(const Glib::ustring& string, MatchFlags match_options)
+Regex::match_all(const Glib::ustring& string, RegexMatchFlags match_options)
{
return g_regex_match_all(gobj(), string.c_str(), ((GRegexMatchFlags)(match_options)), nullptr);
}
bool
Regex::match_all(const Glib::ustring& string, int start_position, Glib::MatchInfo& match_info,
- MatchFlags match_options)
+ RegexMatchFlags match_options)
{
GError* gerror = nullptr;
GMatchInfo* ginfo = nullptr;
bool
Regex::match_all(const Glib::ustring& string, gssize string_len, int start_position,
- Glib::MatchInfo& match_info, MatchFlags match_options)
+ Glib::MatchInfo& match_info, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
GMatchInfo* ginfo = nullptr;
}
bool
-Regex::match_all(const Glib::ustring& string, int start_position, MatchFlags match_options)
+Regex::match_all(const Glib::ustring& string, int start_position, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
bool retvalue = g_regex_match_all_full(gobj(), string.c_str(), -1, start_position,
bool
Regex::match_all(
- const Glib::ustring& string, gssize string_len, int start_position, MatchFlags match_options)
+ const Glib::ustring& string, gssize string_len, int start_position, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
bool retvalue = g_regex_match_all_full(gobj(), string.c_str(), string_len, start_position,
Glib::ustring
Regex::replace(const Glib::ustring& string, int start_position, const Glib::ustring& replacement,
- MatchFlags match_options)
+ RegexMatchFlags match_options)
{
GError* gerror = nullptr;
auto retvalue = Glib::convert_return_gchar_ptr_to_ustring(g_regex_replace(gobj(), string.c_str(),
Glib::ustring
Regex::replace_literal(const Glib::ustring& string, int start_position,
- const Glib::ustring& replacement, MatchFlags match_options)
+ const Glib::ustring& replacement, RegexMatchFlags match_options)
{
GError* gerror = nullptr;
auto retvalue =
return retvalue;
}
-std::vector<Glib::ustring>
-Regex::split(const Glib::ustring& string, int start_position, MatchFlags match_options,
+Glib::StringArrayHandle
+Regex::split(const Glib::ustring& string, int start_position, RegexMatchFlags match_options,
int max_tokens) const
{
GError* gerror = nullptr;
- auto retvalue = Glib::ArrayHandler<Glib::ustring>::array_to_vector(
+ auto retvalue = Glib::StringArrayHandle(
g_regex_split_full(const_cast<GRegex*>(gobj()), string.c_str(), -1, start_position,
((GRegexMatchFlags)(match_options)), max_tokens, &(gerror)),
Glib::OWNERSHIP_DEEP);
return retvalue;
}
-MatchInfo::MatchInfo() : gobject_(nullptr), take_ownership_(false)
+MatchInfo::MatchInfo() : gobject_(nullptr), take_ownership(false)
{
}
-MatchInfo::MatchInfo(GMatchInfo* castitem, bool take_ownership)
-: gobject_(castitem), take_ownership_(take_ownership)
+MatchInfo::MatchInfo(GMatchInfo* castitem, bool take_the_ownership)
+: gobject_(castitem), take_ownership(take_the_ownership)
{
}
MatchInfo::MatchInfo(MatchInfo&& other) noexcept : gobject_(std::move(other.gobject_)),
- take_ownership_(std::move(other.take_ownership_))
+ take_ownership(std::move(other.take_ownership))
{
other.gobject_ = nullptr;
- other.take_ownership_ = false;
+ other.take_ownership = false;
}
MatchInfo&
MatchInfo::operator=(MatchInfo&& other) noexcept
{
- if (take_ownership_ && gobject_)
+ if (take_ownership && gobject_)
g_match_info_free(gobject_);
gobject_ = std::move(other.gobject_);
- take_ownership_ = std::move(other.take_ownership_);
+ take_ownership = std::move(other.take_ownership);
other.gobject_ = nullptr;
- other.take_ownership_ = false;
+ other.take_ownership = false;
return *this;
}
void
-MatchInfo::set_gobject(GMatchInfo* castitem, bool take_ownership)
+MatchInfo::set_gobject(GMatchInfo* castitem, bool take_the_ownership)
{
- if (gobject_ && this->take_ownership_)
+ if (gobject_ && this->take_ownership)
g_match_info_free(gobject_);
gobject_ = castitem;
- this->take_ownership_ = take_ownership;
+ this->take_ownership = take_the_ownership;
}
MatchInfo::~MatchInfo()
{
- if (take_ownership_ && gobject_)
+ if (take_ownership && gobject_)
g_match_info_free(gobject_);
}
#include <glibmm/refptr.h>
#include <glibmm/ustring.h>
#include <glibmm/error.h>
+#include <glibmm/arrayhandle.h>
#include <glib.h>
-#include <vector>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GRegex GRegex;
namespace Glib
{
+_WRAP_ENUM(RegexCompileFlags, GRegexCompileFlags, NO_GTYPE)
+_WRAP_ENUM(RegexMatchFlags, GRegexMatchFlags, NO_GTYPE)
/** Exception class for Regex
*/
_IGNORE(g_regex_ref, g_regex_unref)
public:
- _WRAP_ENUM(CompileFlags, GRegexCompileFlags, NO_GTYPE)
- _WRAP_ENUM(MatchFlags, GRegexMatchFlags, NO_GTYPE)
-
/// @throws Glib::RegexError
- static Glib::RefPtr<Glib::Regex> create(const Glib::ustring& pattern, CompileFlags compile_options = static_cast<CompileFlags>(0), MatchFlags match_options = static_cast<MatchFlags>(0));
+ static Glib::RefPtr<Glib::Regex> create(const Glib::ustring& pattern, RegexCompileFlags compile_options = static_cast<RegexCompileFlags>(0), RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0));
_WRAP_METHOD(Glib::ustring get_pattern() const, g_regex_get_pattern)
_WRAP_METHOD(int get_max_backref() const, g_regex_get_max_backref)
_WRAP_METHOD(bool get_has_cr_or_lf() const, g_regex_get_has_cr_or_lf)
_WRAP_METHOD(int get_max_lookbehind() const, g_regex_get_max_lookbehind)
_WRAP_METHOD(int get_string_number(const Glib::ustring& name) const, g_regex_get_string_number)
- _WRAP_METHOD(CompileFlags get_compile_flags() const, g_regex_get_compile_flags)
- _WRAP_METHOD(MatchFlags get_match_flags() const, g_regex_get_match_flags)
+ _WRAP_METHOD(RegexCompileFlags get_compile_flags() const, g_regex_get_compile_flags)
+ _WRAP_METHOD(RegexMatchFlags get_match_flags() const, g_regex_get_match_flags)
static Glib::ustring escape_string(const Glib::ustring& string);
- _WRAP_METHOD(static bool match_simple(const Glib::ustring& pattern, const Glib::ustring& string, CompileFlags compile_options = static_cast<CompileFlags>(0), MatchFlags match_options = static_cast<MatchFlags>(0)), g_regex_match_simple)
+ _WRAP_METHOD(static bool match_simple(const Glib::ustring& pattern, const Glib::ustring& string, RegexCompileFlags compile_options = static_cast<RegexCompileFlags>(0), RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)), g_regex_match_simple)
_WRAP_METHOD_DOCS_ONLY(g_regex_match)
bool match(
const Glib::ustring& string,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
/// A match() method not requiring a Glib::MatchInfo.
- bool match(const Glib::ustring& string, MatchFlags match_options = static_cast<MatchFlags>(0));
+ bool match(const Glib::ustring& string, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0));
/** A match() method with a start position and a Glib::MatchInfo.
* @throws Glib::RegexError
const Glib::ustring& string,
int start_position,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
_WRAP_METHOD_DOCS_ONLY(g_regex_match_full, errthrow "Glib::RegexError")
gssize string_len,
int start_position,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
/** A match() method with a start position not requiring a Glib::MatchInfo.
* @throws Glib::RegexError
*/
- bool match(const Glib::ustring& string, int start_position, MatchFlags match_options);
+ bool match(const Glib::ustring& string, int start_position, RegexMatchFlags match_options);
/** A match() method with a string length and start position not requiring a
* Glib::MatchInfo.
*/
- bool match(const Glib::ustring& string, gssize string_len, int start_position, MatchFlags match_options);
+ bool match(const Glib::ustring& string, gssize string_len, int start_position, RegexMatchFlags match_options);
_WRAP_METHOD_DOCS_ONLY(g_regex_match_all)
bool match_all(
const Glib::ustring& string,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
/// A match_all() method not requiring a Glib::MatchInfo.
- bool match_all(const Glib::ustring& string, MatchFlags match_options = static_cast<MatchFlags>(0));
+ bool match_all(const Glib::ustring& string, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0));
/** A match_all() method with a start positon and a Glib::MatchInfo.
* @throws Glib::RegexError
const Glib::ustring& string,
int start_position,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
_WRAP_METHOD_DOCS_ONLY(g_regex_match_all_full, errthrow "Glib::RegexError")
gssize string_len,
int start_position,
Glib::MatchInfo& match_info,
- MatchFlags match_options = static_cast<MatchFlags>(0)
+ RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)
);
/** A match_all() method with a start position not requiring a Glib::MatchInfo.
* @throws Glib::RegexError
*/
- bool match_all(const Glib::ustring& string, int start_position, MatchFlags match_options);
+ bool match_all(const Glib::ustring& string, int start_position, RegexMatchFlags match_options);
/** A match_all() method with a start position and a string length not
* requiring a Glib::MatchInfo.
* @throws Glib::RegexError
*/
- bool match_all(const Glib::ustring& string, gssize string_len, int start_position, MatchFlags match_options);
+ bool match_all(const Glib::ustring& string, gssize string_len, int start_position, RegexMatchFlags match_options);
+
+#m4 _CONVERSION(`gchar**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)')
-#m4 _CONVERSION(`gchar**',`std::vector<Glib::ustring>',`Glib::ArrayHandler<Glib::ustring>::array_to_vector($3, Glib::OWNERSHIP_DEEP)')
- _WRAP_METHOD(static std::vector<Glib::ustring> split_simple(const Glib::ustring& pattern, const Glib::ustring& string, CompileFlags compile_options = static_cast<CompileFlags>(0), MatchFlags match_options = static_cast<MatchFlags>(0)), g_regex_split_simple)
- _WRAP_METHOD(std::vector<Glib::ustring> split(const Glib::ustring& string, MatchFlags match_options = static_cast<MatchFlags>(0)), g_regex_split)
+ _WRAP_METHOD(static Glib::StringArrayHandle split_simple(const Glib::ustring& pattern, const Glib::ustring& string, RegexCompileFlags compile_options = static_cast<RegexCompileFlags>(0), RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)), g_regex_split_simple)
+ _WRAP_METHOD(Glib::StringArrayHandle split(const Glib::ustring& string, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)), g_regex_split)
- _WRAP_METHOD(std::vector<Glib::ustring> split(const gchar* string, gssize string_len, int start_position, MatchFlags match_options = static_cast<MatchFlags>(0), int max_tokens = 0) const, g_regex_split_full, errthrow "Glib::RegexError")
+ _WRAP_METHOD(Glib::StringArrayHandle split(const gchar* string, gssize string_len, int start_position, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0), int max_tokens = 0) const, g_regex_split_full, errthrow "Glib::RegexError", errthrow)
/// @throws Glib::RegexError
- std::vector<Glib::ustring> split(const Glib::ustring& string, int start_position, MatchFlags match_options, int max_tokens) const;
+ Glib::StringArrayHandle split(const Glib::ustring& string, int start_position, RegexMatchFlags match_options, int max_tokens) const;
- _WRAP_METHOD(Glib::ustring replace(const gchar* string, gssize string_len, int start_position, const Glib::ustring& replacement, MatchFlags match_options = static_cast<MatchFlags>(0)), g_regex_replace, errthrow "Glib::RegexError")
+ _WRAP_METHOD(Glib::ustring replace(const gchar* string, gssize string_len, int start_position, const Glib::ustring& replacement, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)), g_regex_replace, errthrow "Glib::RegexError", errthrow)
/// @throws Glib::RegexError
- Glib::ustring replace(const Glib::ustring& string, int start_position, const Glib::ustring& replacement, MatchFlags match_options);
+ Glib::ustring replace(const Glib::ustring& string, int start_position, const Glib::ustring& replacement, RegexMatchFlags match_options);
- _WRAP_METHOD(Glib::ustring replace_literal(const gchar *string, gssize string_len, int start_position, const Glib::ustring& replacement, MatchFlags match_options = static_cast<MatchFlags>(0)), g_regex_replace_literal, errthrow "Glib::RegexError")
+ _WRAP_METHOD(Glib::ustring replace_literal(const gchar *string, gssize string_len, int start_position, const Glib::ustring& replacement, RegexMatchFlags match_options = static_cast<RegexMatchFlags>(0)), g_regex_replace_literal, errthrow "Glib::RegexError", errthrow)
/// @throws Glib::RegexError
- Glib::ustring replace_literal(const Glib::ustring& string, int start_position, const Glib::ustring& replacement, MatchFlags match_options);
+ Glib::ustring replace_literal(const Glib::ustring& string, int start_position, const Glib::ustring& replacement, RegexMatchFlags match_options);
- _WRAP_METHOD(Glib::ustring replace_eval(const Glib::ustring& string, gssize string_len, int start_position, MatchFlags match_options, GRegexEvalCallback eval, gpointer user_data), g_regex_replace_eval, errthrow "Glib::RegexError")
- _WRAP_METHOD(static bool check_replacement(const Glib::ustring& replacement, gboolean* has_references), g_regex_check_replacement, errthrow "Glib::RegexError")
+ _WRAP_METHOD(Glib::ustring replace_eval(const Glib::ustring& string, gssize string_len, int start_position, RegexMatchFlags match_options, GRegexEvalCallback eval, gpointer user_data), g_regex_replace_eval, errthrow "Glib::RegexError", errthrow)
+ _WRAP_METHOD(static bool check_replacement(const Glib::ustring& replacement, gboolean* has_references), g_regex_check_replacement, errthrow "Glib::RegexError", errthrow)
};
//TODO: Add C++ iterator like functionality for this class.
/** C object constructor.
* @param castitem The C object.
- * @param take_ownership Whether to destroy the C object with the wrapper or not.
+ * @param take_the_ownership Whether to destroy the C object with the wrapper or
+ * not.
*/
- explicit MatchInfo(GMatchInfo* castitem, bool take_ownership = true);
+ explicit MatchInfo(GMatchInfo* castitem, bool take_the_ownership = true); //TODO: Rename to take_ownership when we can rename the member variable.
MatchInfo(const MatchInfo& other) = delete;
MatchInfo& operator=(const MatchInfo& other) = delete;
_WRAP_METHOD(Glib::ustring get_string() const, g_match_info_get_string)
_WRAP_METHOD(bool matches() const, g_match_info_matches)
- _WRAP_METHOD(bool next(), g_match_info_next, errthrow "Glib::RegexError")
+ _WRAP_METHOD(bool next(), g_match_info_next, errthrow "Glib::RegexError", errthrow)
_WRAP_METHOD(int get_match_count() const, g_match_info_get_match_count)
_WRAP_METHOD(bool is_partial_match() const, g_match_info_is_partial_match)
- _WRAP_METHOD(Glib::ustring expand_references(const Glib::ustring& string_to_expand), g_match_info_expand_references, errthrow "Glib::RegexError")
+ _WRAP_METHOD(Glib::ustring expand_references(const Glib::ustring& string_to_expand), g_match_info_expand_references, errthrow "Glib::RegexError", errthrow)
_WRAP_METHOD(Glib::ustring fetch(int match_num), g_match_info_fetch)
_WRAP_METHOD(bool fetch_named_pos(const Glib::ustring& name, int& start_pos, int& end_pos), g_match_info_fetch_named_pos)
- _WRAP_METHOD(std::vector<Glib::ustring> fetch_all(), g_match_info_fetch_all)
+ _WRAP_METHOD(Glib::StringArrayHandle fetch_all(), g_match_info_fetch_all)
protected:
GMatchInfo* gobject_; // The C object.
- bool take_ownership_; // Bool signaling ownership.
+ bool take_ownership; // Bool signaling ownership. //TODO: Give this a _ suffix when we can break API.
protected:
// So that Glib::Regex::match() can set the C object.
/**** shell utility functions **********************************************/
-std::vector<std::string>
+Glib::ArrayHandle<std::string>
shell_parse_argv(const std::string& command_line)
{
char** argv = nullptr;
if (error)
Glib::Error::throw_exception(error);
- return Glib::ArrayHandler<std::string>::array_to_vector(argv, argc, Glib::OWNERSHIP_DEEP);
+ return Glib::ArrayHandle<std::string>(argv, argc, Glib::OWNERSHIP_DEEP);
}
std::string
_DEFS(glibmm,glib)
+#include <glibmm/arrayhandle.h>
#include <glibmm/error.h>
#include <glib.h>
#include <string>
-#include <vector>
namespace Glib
{
* converted to any STL compatible container type).
* @throw Glib::ShellError
*/
-std::vector<std::string> shell_parse_argv(const std::string& command_line);
+Glib::ArrayHandle<std::string> shell_parse_argv(const std::string& command_line);
/** Quotes a string so that the shell (/bin/sh) will interpret the quoted
* string to mean @a unquoted_string. If you pass a filename to the shell,
void
spawn_async_with_pipes(const std::string& working_directory,
- const std::vector<std::string>& argv, const std::vector<std::string>& envp,
+ const Glib::ArrayHandle<std::string>& argv, const Glib::ArrayHandle<std::string>& envp,
SpawnFlags flags, const SlotSpawnChildSetup& child_setup, Pid* child_pid, int* standard_input,
int* standard_output, int* standard_error)
{
GError* gerror = nullptr;
g_spawn_async_with_pipes(Glib::c_str_or_nullptr(working_directory),
- const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(envp).data()),
+ const_cast<char**>(argv.data()), const_cast<char**>(envp.data()),
static_cast<GSpawnFlags>(unsigned(flags)), (setup_slot) ? &child_setup_callback : nullptr,
(setup_slot) ? &child_setup_ : nullptr, child_pid, standard_input, standard_output,
standard_error, &gerror);
void
spawn_async_with_pipes(const std::string& working_directory,
- const std::vector<std::string>& argv, SpawnFlags flags,
+ const Glib::ArrayHandle<std::string>& argv, SpawnFlags flags,
const SlotSpawnChildSetup& child_setup, Pid* child_pid, int* standard_input, int* standard_output,
int* standard_error)
{
GError* gerror = nullptr;
g_spawn_async_with_pipes(Glib::c_str_or_nullptr(working_directory),
- const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()), nullptr, static_cast<GSpawnFlags>(unsigned(flags)),
+ const_cast<char**>(argv.data()), nullptr, static_cast<GSpawnFlags>(unsigned(flags)),
(setup_slot) ? &child_setup_callback : nullptr, (setup_slot) ? &child_setup_ : nullptr,
child_pid, standard_input, standard_output, standard_error, &gerror);
}
void
-spawn_async(const std::string& working_directory, const std::vector<std::string>& argv,
- const std::vector<std::string>& envp, SpawnFlags flags,
+spawn_async(const std::string& working_directory, const Glib::ArrayHandle<std::string>& argv,
+ const Glib::ArrayHandle<std::string>& envp, SpawnFlags flags,
const SlotSpawnChildSetup& child_setup, Pid* child_pid)
{
const bool setup_slot = !child_setup.empty();
auto child_setup_ = child_setup;
GError* gerror = nullptr;
- g_spawn_async(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()),
- const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(envp).data()), static_cast<GSpawnFlags>(unsigned(flags)),
+ g_spawn_async(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(argv.data()),
+ const_cast<char**>(envp.data()), static_cast<GSpawnFlags>(unsigned(flags)),
(setup_slot) ? &child_setup_callback : nullptr, (setup_slot) ? &child_setup_ : nullptr,
child_pid, &gerror);
}
void
-spawn_async(const std::string& working_directory, const std::vector<std::string>& argv,
+spawn_async(const std::string& working_directory, const Glib::ArrayHandle<std::string>& argv,
SpawnFlags flags, const SlotSpawnChildSetup& child_setup, Pid* child_pid)
{
const bool setup_slot = !child_setup.empty();
auto child_setup_ = child_setup;
GError* gerror = nullptr;
- g_spawn_async(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()), nullptr,
+ g_spawn_async(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(argv.data()), nullptr,
static_cast<GSpawnFlags>(unsigned(flags)), (setup_slot) ? &child_setup_callback : nullptr,
(setup_slot) ? &child_setup_ : nullptr, child_pid, &gerror);
}
void
-spawn_sync(const std::string& working_directory, const std::vector<std::string>& argv,
- const std::vector<std::string>& envp, SpawnFlags flags,
+spawn_sync(const std::string& working_directory, const Glib::ArrayHandle<std::string>& argv,
+ const Glib::ArrayHandle<std::string>& envp, SpawnFlags flags,
const SlotSpawnChildSetup& child_setup, std::string* standard_output, std::string* standard_error,
int* exit_status)
{
GError* gerror = nullptr;
char* pch_buf_standard_output = nullptr;
char* pch_buf_standard_error = nullptr;
- g_spawn_sync(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()),
- const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(envp).data()), static_cast<GSpawnFlags>(unsigned(flags)),
+ g_spawn_sync(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(argv.data()),
+ const_cast<char**>(envp.data()), static_cast<GSpawnFlags>(unsigned(flags)),
(setup_slot) ? &child_setup_callback : nullptr, (setup_slot) ? &child_setup_ : nullptr,
(standard_output) ? &pch_buf_standard_output : nullptr,
(standard_error) ? &pch_buf_standard_error : nullptr, exit_status, &gerror);
}
void
-spawn_sync(const std::string& working_directory, const std::vector<std::string>& argv,
+spawn_sync(const std::string& working_directory, const Glib::ArrayHandle<std::string>& argv,
SpawnFlags flags, const SlotSpawnChildSetup& child_setup, std::string* standard_output,
std::string* standard_error, int* exit_status)
{
char* pch_buf_standard_error = nullptr;
GError* gerror = nullptr;
- g_spawn_sync(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(Glib::ArrayHandler<std::string>::vector_to_array(argv).data()), nullptr,
+ g_spawn_sync(Glib::c_str_or_nullptr(working_directory), const_cast<char**>(argv.data()), nullptr,
static_cast<GSpawnFlags>(unsigned(flags)), (setup_slot) ? &child_setup_callback : nullptr,
(setup_slot) ? &child_setup_ : nullptr, (standard_output) ? &pch_buf_standard_output : nullptr,
(standard_error) ? &pch_buf_standard_error : nullptr, exit_status, &gerror);
_DEFS(glibmm,glib)
#include <glibmmconfig.h>
+#include <glibmm/arrayhandle.h>
#include <glibmm/error.h>
#include <sigc++/sigc++.h>
#include <string>
-#include <vector>
namespace Glib
{
/** For instance,<br>
* void on_child_setup();
*/
-using SlotSpawnChildSetup = sigc::slot<void()>;
+using SlotSpawnChildSetup = sigc::slot<void>;
/** Executes a child program asynchronously (your program will not
* block waiting for the child to exit). The child program is
* The first string in @a argv is of
* course the name of the program to execute. By default, the name of
* the program must be a full path; the PATH shell variable
- * will only be searched if you pass the SpawnFlags::SEARCH_PATH flag.
+ * will only be searched if you pass the SPAWN_SEARCH_PATH flag.
*
* On Windows, note that all the string or string vector arguments to
* this function and the other spawn*() functions are in UTF-8, the
* the child's environment.
*
* @a flags should be the bitwise OR of any flags you want to affect the
- * function's behaviour. The SpawnFlags::DO_NOT_REAP_CHILD flags means that
+ * function's behaviour. The SPAWN_DO_NOT_REAP_CHILD flags means that
* the child will not automatically be reaped; you must use a
* ChildWatch source to be notified about the death of the child
* process. Eventually you must call spawn_close_pid() on the
* PAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file
* descriptors will be inherited by the child; otherwise all
* descriptors except stdin/stdout/stderr will be closed before
- * calling exec() in the child. SpawnFlags::SEARCH_PATH
+ * calling exec() in the child. SPAWN_SEARCH_PATH
* means that argv[0] need not be an absolute path, it
* will be looked for in the user's PATH.
- * SpawnFlags::STDOUT_TO_DEV_NULL means that the child's standard output will
+ * SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output will
* be discarded, instead of going to the same location as the parent's
* standard output. If you use this flag, @a standard_output must be nullptr.
- * SpawnFlags::STDERR_TO_DEV_NULL means that the child's standard error
+ * SPAWN_STDERR_TO_DEV_NULL means that the child's standard error
* will be discarded, instead of going to the same location as the parent's
* standard error. If you use this flag, @a standard_error must be nullptr.
- * SpawnFlags::CHILD_INHERITS_STDIN means that the child will inherit the parent's
+ * SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's
* standard input (by default, the child's standard input is attached to
* /dev/null). If you use this flag, @a standard_input must be nullptr.
- * SpawnFlags::FILE_AND_ARGV_ZERO means that the first element of @a argv is
+ * G_SPAWN_FILE_AND_ARGV_ZERO means that the first element of @a argv is
* the file to execute, while the remaining elements are the
* actual argument vector to pass to the file. Normally
* spawn_async_with_pipes() uses argv[0] as the file to execute, and
* If non-nullptr, @a child_pid will on Unix be filled with the child's
* process ID. You can use the process ID to send signals to the
* child, or to use child_watch_add() (or waitpid()) if you specified the
- * SpawnFlags::DO_NOT_REAP_CHILD flag. On Windows, @a child_pid will be
+ * SPAWN_DO_NOT_REAP_CHILD flag. On Windows, @a child_pid will be
* filled with a handle to the child process only if you specified the
- * SpawnFlags::DO_NOT_REAP_CHILD flag. You can then access the child
+ * SPAWN_DO_NOT_REAP_CHILD flag. You can then access the child
* process using the Win32 API, for example wait for its termination
* with the WaitFor*() functions, or examine its
* exit code with GetExitCodeProcess(). You should close the handle
* pipe won't be created.
*
* If @a standard_input is nullptr, the child's standard input is attached to
- * /dev/null unless SpawnFlags::CHILD_INHERITS_STDIN is set.
+ * /dev/null unless SPAWN_CHILD_INHERITS_STDIN is set.
*
* If @a standard_error is nullptr, the child's standard error goes to the same
- * location as the parent's standard error unless SpawnFlags::STDERR_TO_DEV_NULL
+ * location as the parent's standard error unless SPAWN_STDERR_TO_DEV_NULL
* is set.
*
* If @a standard_output is nullptr, the child's standard output goes to the same
- * location as the parent's standard output unless SpawnFlags::STDOUT_TO_DEV_NULL
+ * location as the parent's standard output unless SPAWN_STDOUT_TO_DEV_NULL
* is set.
*
* If @a child_pid is not nullptr and an error does not occur then the returned
* and @a standard_error will not be filled with valid values.
*/
void spawn_async_with_pipes(const std::string& working_directory,
- const std::vector<std::string>& argv,
- const std::vector<std::string>& envp,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ const Glib::ArrayHandle<std::string>& envp,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
Pid* child_pid = nullptr,
int* standard_input = nullptr,
* and @a standard_error will not be filled with valid values.
*/
void spawn_async_with_pipes(const std::string& working_directory,
- const std::vector<std::string>& argv,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
Pid* child_pid = nullptr,
int* standard_input = nullptr,
* to users.
*/
void spawn_async(const std::string& working_directory,
- const std::vector<std::string>& argv,
- const std::vector<std::string>& envp,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ const Glib::ArrayHandle<std::string>& envp,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
Pid* child_pid = nullptr);
* to users.
*/
void spawn_async(const std::string& working_directory,
- const std::vector<std::string>& argv,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
Pid* child_pid = nullptr);
/** Executes a child synchronously (waits for the child to exit before returning).
* All output from the child is stored in @a standard_output and @a standard_error,
* if those parameters are non-nullptr. Note that you must set the
- * SpawnFlags::STDOUT_TO_DEV_NULL and SpawnFlags::STDERR_TO_DEV_NULL flags when
+ * SPAWN_STDOUT_TO_DEV_NULL and SPAWN_STDERR_TO_DEV_NULL flags when
* passing nullptr for @a standard_output and @a standard_error.
* If @a exit_status is non-nullptr, the exit status of the child is stored
* there as it would be returned by waitpid(); standard UNIX macros such
* as WIFEXITED() and WEXITSTATUS() must be used to evaluate the exit status.
* Note that this function calls waitpid() even if @a exit_status is nullptr, and
- * does not accept the SpawnFlags::DO_NOT_REAP_CHILD flag.
+ * does not accept the SPAWN_DO_NOT_REAP_CHILD flag.
* If an error occurs, no data is returned in @a standard_output,
* @a standard_error, or @a exit_status.
*
* and @a standard_error will not be filled with valid values.
*/
void spawn_sync(const std::string& working_directory,
- const std::vector<std::string>& argv,
- const std::vector<std::string>& envp,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ const Glib::ArrayHandle<std::string>& envp,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
std::string* standard_output = nullptr,
std::string* standard_error = nullptr,
* and @a standard_error will not be filled with valid values.
*/
void spawn_sync(const std::string& working_directory,
- const std::vector<std::string>& argv,
- SpawnFlags flags = SpawnFlags::DEFAULT,
+ const Glib::ArrayHandle<std::string>& argv,
+ SpawnFlags flags = SPAWN_DEFAULT,
const SlotSpawnChildSetup& child_setup = SlotSpawnChildSetup(),
std::string* standard_output = nullptr,
std::string* standard_error = nullptr,
/** A simple version of spawn_async() that parses a command line with
* shell_parse_argv() and passes it to spawn_async(). It runs a
* command line in the background. Unlike spawn_async(), the
- * SpawnFlags::SEARCH_PATH flag is enabled, other flags are not. Note
- * that SpawnFlags::SEARCH_PATH can have security implications, so
+ * SPAWN_SEARCH_PATH flag is enabled, other flags are not. Note
+ * that SPAWN_SEARCH_PATH can have security implications, so
* consider using spawn_async() directly if appropriate.
*
* The same concerns on Windows apply as for spawn_command_line_sync().
/** A simple version of spawn_sync() with little-used parameters
* removed, taking a command line instead of an argument vector. See
* spawn_sync() for full details. @a command_line will be parsed by
- * shell_parse_argv(). Unlike spawn_sync(), the SpawnFlags::SEARCH_PATH flag
- * is enabled. Note that SpawnFlags::SEARCH_PATH can have security
+ * shell_parse_argv(). Unlike spawn_sync(), the SPAWN_SEARCH_PATH flag
+ * is enabled. Note that SPAWN_SEARCH_PATH can have security
* implications, so consider using spawn_sync() directly if
* appropriate.
*
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/exceptionhandler.h>
+#include <glib.h>
+
+namespace
+{
+
+extern "C" {
+
+static void*
+call_thread_entry_slot(void* data)
+{
+ const auto slot = reinterpret_cast<sigc::slot_base*>(data);
+
+ try
+ {
+ // Recreate the specific slot, and drop the reference obtained by create().
+ (*static_cast<sigc::slot<void>*>(slot))();
+ }
+ catch (Glib::Thread::Exit&)
+ {
+ // Just exit from the thread. The Thread::Exit exception
+ // is our sane C++ replacement of g_thread_exit().
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ delete slot;
+ return nullptr;
+}
+
+} // extern "C"
+
+} // anonymous namespace
+
+namespace Glib
+{
+
+// This was always meant as an internal method. It is no longer called,
+// and no longer needs to be called. We are keeping it just to avoid
+// breaking ABI, though hopefully nobody is using it anyway.
+// TODO: Remove this when we can break ABI.
+void
+thread_init_impl()
+{
+ // Make sure the exception map is initialized before creating any thread.
+ Glib::Error::register_init();
+}
+
+/**** Glib::Thread *********************************************************/
+
+// static
+Thread*
+Thread::create(const sigc::slot<void>& slot, bool /* joinable */)
+{
+ // Make a copy of slot on the heap
+ const auto slot_copy = new sigc::slot<void>(slot);
+
+ GError* error = nullptr;
+
+ const auto thread = g_thread_try_new(nullptr, &call_thread_entry_slot, slot_copy, &error);
+
+ if (error)
+ {
+ delete slot_copy;
+ // Glib::Error::throw_exception() will probably wrap G_THREAD_ERROR in a
+ // Glib::Threads::ThreadError instance, but we want a Glib::ThreadError.
+ if (error->domain == G_THREAD_ERROR)
+ throw Glib::ThreadError(error);
+ else
+ Glib::Error::throw_exception(error);
+ }
+
+ return reinterpret_cast<Thread*>(thread);
+}
+
+// static
+Thread*
+Thread::create(const sigc::slot<void>& slot, unsigned long stack_size, bool joinable, bool bound,
+ ThreadPriority priority)
+{
+ // Make a copy of slot on the heap
+ const auto slot_copy = new sigc::slot<void>(slot);
+
+ GError* error = nullptr;
+
+ const auto thread = g_thread_create_full(&call_thread_entry_slot, slot_copy, stack_size, joinable,
+ bound, (GThreadPriority)priority, &error);
+
+ if (error)
+ {
+ delete slot_copy;
+ // Glib::Error::throw_exception() will probably wrap G_THREAD_ERROR in a
+ // Glib::Threads::ThreadError instance, but we want a Glib::ThreadError.
+ if (error->domain == G_THREAD_ERROR)
+ throw Glib::ThreadError(error);
+ else
+ Glib::Error::throw_exception(error);
+ }
+
+ return reinterpret_cast<Thread*>(thread);
+}
+
+// static
+Thread*
+Thread::self()
+{
+ return reinterpret_cast<Thread*>(g_thread_self());
+}
+
+void
+Thread::join()
+{
+ g_thread_join(&gobject_);
+}
+
+bool
+Thread::joinable() const
+{
+ return true; // An appropriate result now that this is deprecated because all threads are now
+ // joinable.
+}
+
+void
+Thread::set_priority(ThreadPriority priority)
+{
+ g_thread_set_priority(&gobject_, (GThreadPriority)priority);
+}
+
+ThreadPriority
+Thread::get_priority() const
+{
+ return THREAD_PRIORITY_NORMAL; // An appropriate result now that this is deprecated because the
+ // priority concept has been removed.
+}
+
+void
+thread_init(GThreadFunctions* /* vtable */)
+{
+ // g_thread_init() is deprecated and now does nothing,
+ // so we do not even call it. That avoids a need to link to gthread-2.0,
+ // which contains the empty g_thread_init() implementation.
+ // g_thread_init(vtable);
+
+ Glib::thread_init_impl();
+}
+
+bool
+thread_supported()
+{
+ // MSVC++ needs the != 0 to avoid an int -> bool cast warning.
+ return (g_thread_supported() != 0);
+}
+
+// static
+void
+Thread::yield()
+{
+ g_thread_yield();
+}
+
+Thread*
+wrap(GThread* gobject)
+{
+ return reinterpret_cast<Thread*>(gobject);
+}
+
+/**** Glib::StaticMutex ****************************************************/
+
+void
+StaticMutex::lock()
+{
+ g_static_mutex_lock(&gobject_);
+}
+
+bool
+StaticMutex::trylock()
+{
+ return g_static_mutex_trylock(&gobject_);
+}
+
+void
+StaticMutex::unlock()
+{
+ g_static_mutex_unlock(&gobject_);
+}
+
+StaticMutex::operator Mutex&()
+{
+ // If GStaticMutex is implemented as struct (e.g. on Linux), its first struct
+ // member (runtime_mutex) is a GMutex pointer. If the gthread implementation
+ // is native (i.e. the vtable pointer passed to g_thread_init() was 0), then
+ // the runtime_mutex pointer is unused, and the rest of the GStaticMutex
+ // struct resembles the mutex data.
+ //
+ // On Win32, GStaticMutex is just a typedef to struct _GMutex*. Either way,
+ // the first sizeof(GMutex*) bytes of GStaticMutex always resemble a GMutex
+ // pointer. The gthread implementation relies on that, and we'll also do so.
+
+ GMutex*& runtime_mutex = reinterpret_cast<GMutex*&>(gobject_);
+
+ // Fortunately, it cannot hurt if we set this to the GMutex pointer returned
+ // by g_static_mutex_get_mutex(). Either we just overwrite it with the same
+ // value, or it was unused anyway. Doing that allows casting the pointer
+ // location to a Glib::Mutex reference (its only data member is a GMutex*).
+
+ runtime_mutex = g_static_mutex_get_mutex(&gobject_);
+
+ return reinterpret_cast<Mutex&>(runtime_mutex);
+}
+
+/**** Glib::Mutex **********************************************************/
+
+Mutex::Mutex()
+: gobject_(g_mutex_new()) // TODO: Use a statically-allocated GMutext instead, with g_mutex_init().
+{
+}
+
+Mutex::~Mutex()
+{
+ g_mutex_free(gobject_);
+}
+
+void
+Mutex::lock()
+{
+ g_mutex_lock(gobject_);
+}
+
+bool
+Mutex::trylock()
+{
+ return g_mutex_trylock(gobject_);
+}
+
+void
+Mutex::unlock()
+{
+ g_mutex_unlock(gobject_);
+}
+
+/**** Glib::StaticRecMutex *************************************************/
+
+void
+StaticRecMutex::lock()
+{
+ g_static_rec_mutex_lock(&gobject_);
+}
+
+bool
+StaticRecMutex::trylock()
+{
+ return g_static_rec_mutex_trylock(&gobject_);
+}
+
+void
+StaticRecMutex::unlock()
+{
+ g_static_rec_mutex_unlock(&gobject_);
+}
+
+void
+StaticRecMutex::lock_full(unsigned int depth)
+{
+ g_static_rec_mutex_lock_full(&gobject_, depth);
+}
+
+unsigned int
+StaticRecMutex::unlock_full()
+{
+ return g_static_rec_mutex_unlock_full(&gobject_);
+}
+
+StaticRecMutex::operator RecMutex&()
+{
+ return static_cast<RecMutex&>(*this);
+}
+
+/**** Glib::RecMutex *******************************************************/
+
+RecMutex::RecMutex()
+{
+ g_static_rec_mutex_init(&gobject_);
+}
+
+RecMutex::~RecMutex()
+{
+ g_static_rec_mutex_free(&gobject_);
+}
+
+/**** Glib::StaticRWLock ***************************************************/
+
+void
+StaticRWLock::reader_lock()
+{
+ g_static_rw_lock_reader_lock(&gobject_);
+}
+
+bool
+StaticRWLock::reader_trylock()
+{
+ return g_static_rw_lock_reader_trylock(&gobject_);
+}
+
+void
+StaticRWLock::reader_unlock()
+{
+ g_static_rw_lock_reader_unlock(&gobject_);
+}
+
+void
+StaticRWLock::writer_lock()
+{
+ g_static_rw_lock_writer_lock(&gobject_);
+}
+
+bool
+StaticRWLock::writer_trylock()
+{
+ return g_static_rw_lock_writer_trylock(&gobject_);
+}
+
+void
+StaticRWLock::writer_unlock()
+{
+ g_static_rw_lock_writer_unlock(&gobject_);
+}
+
+StaticRWLock::operator RWLock&()
+{
+ return static_cast<RWLock&>(*this);
+}
+
+/**** Glib::RWLock *********************************************************/
+
+RWLock::RWLock()
+{
+ g_static_rw_lock_init(&gobject_);
+
+ // GLib doesn't have GRWLock, only GStaticRWLock. Force initialization
+ // of the mutex and the condition variables now, to mimic the behaviour
+ // of a (hypothetical) GRWLock.
+
+ if (g_static_mutex_get_mutex(&gobject_.mutex))
+ {
+ gobject_.read_cond = g_cond_new();
+ gobject_.write_cond = g_cond_new();
+ }
+}
+
+RWLock::~RWLock()
+{
+ g_static_rw_lock_free(&gobject_);
+}
+
+/**** Glib::Cond ***********************************************************/
+
+Cond::Cond() : gobject_(g_cond_new())
+{
+}
+
+Cond::~Cond()
+{
+ g_cond_free(gobject_);
+}
+
+void
+Cond::signal()
+{
+ g_cond_signal(gobject_);
+}
+
+void
+Cond::broadcast()
+{
+ g_cond_broadcast(gobject_);
+}
+
+void
+Cond::wait(Mutex& mutex)
+{
+ g_cond_wait(gobject_, mutex.gobj());
+}
+
+bool
+Cond::timed_wait(Mutex& mutex, const Glib::TimeVal& abs_time)
+{
+ return g_cond_timed_wait(gobject_, mutex.gobj(), const_cast<Glib::TimeVal*>(&abs_time));
+}
+
+void*
+StaticPrivate_get_helper(GStaticPrivate* private_key)
+{
+ return g_static_private_get(private_key);
+}
+
+void
+StaticPrivate_set_helper(GStaticPrivate* private_key, gpointer data, GDestroyNotify notify)
+{
+ return g_static_private_set(private_key, data, notify);
+}
+
+GPrivate*
+GPrivate_new_helper(GDestroyNotify notify)
+{
+ return g_private_new(notify);
+}
+
+} // namespace Glib
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+_DEFS(glibmm,glib)
+_CONFIGINCLUDE(glibmmconfig.h)
+
+_IS_DEPRECATED // This whole file is deprecated.
+
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+//Stop the compiler warnings about using the deprecated API;
+#define GLIB_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
+
+// We use GThreadFunctions in the (deprecated) API, so we must temporarily undef G_DISABLE_DEPRECATED.
+// Temporarily undef G_DISABLE_DEPRECATED, redefining it later if appropriate.
+#if defined(G_DISABLE_DEPRECATED) && !defined(GLIBMM_G_DISABLE_DEPRECATED_UNDEFED)
+//Stop the deprecation ifdef guards around the API declarations:
+#undef G_DISABLE_DEPRECATED
+#define GLIBMM_G_DISABLE_DEPRECATED_UNDEFED 1
+#endif
+
+#include <glib.h>
+
+// Redefine G_DISABLE_DEPRECATED if it was defined before we temporarily undefed it:
+#if defined(GLIBMM_G_DISABLE_DEPRECATED_UNDEFED)
+#define G_DISABLE_DEPRECATED 1
+#undef GLIBMM_G_DISABLE_DEPRECATED_UNDEFED
+#endif
+
+
+#include <glibmm/error.h>
+#include <glibmm/timeval.h>
+#include <sigc++/sigc++.h>
+
+#include <cstddef>
+
+/* Shadow THREAD_PRIORITY_NORMAL macro (from winbase.h).
+ */
+#if defined(THREAD_PRIORITY_NORMAL) && !defined(GLIBMM_MACRO_SHADOW_THREAD_PRIORITY_NORMAL)
+enum { GLIBMM_MACRO_DEFINITION_THREAD_PRIORITY_NORMAL = THREAD_PRIORITY_NORMAL };
+#undef THREAD_PRIORITY_NORMAL
+enum { THREAD_PRIORITY_NORMAL = GLIBMM_MACRO_DEFINITION_THREAD_PRIORITY_NORMAL };
+#define THREAD_PRIORITY_NORMAL THREAD_PRIORITY_NORMAL
+#define GLIBMM_MACRO_SHADOW_THREAD_PRIORITY_NORMAL 1
+#endif
+
+
+/** Initializer macro for Glib::StaticRecMutex.
+ * @relates Glib::StaticRecMutex
+ * @hideinitializer
+ *
+ * @deprecated Glib::StaticRecMutex is deprecated in favour of Glib::Threads::RecMutex, which can be used statically.
+ */
+#define GLIBMM_STATIC_REC_MUTEX_INIT { G_STATIC_REC_MUTEX_INIT }
+
+/** Initializer macro for Glib::StaticRWLock.
+ * @relates Glib::StaticRWLock
+ * @hideinitializer
+ *
+ * @deprecated Glib::StaticRWLock is deprecated in favour of Glib::Threads::RWLock, which can be used statically.
+ */
+#define GLIBMM_STATIC_RW_LOCK_INIT { G_STATIC_RW_LOCK_INIT }
+
+/** Initializer macro for Glib::StaticPrivate.
+ * @relates Glib::StaticPrivate
+ * @hideinitializer
+ *
+ * @deprecated Glib::StaticPrivate is deprecated in favour of Glib::Threads::Private, which can be used statically.
+ */
+#define GLIBMM_STATIC_PRIVATE_INIT { G_STATIC_PRIVATE_INIT }
+
+namespace Glib
+{
+
+/** @deprecated Thread priorities no longer have any effect.
+ */
+_WRAP_ENUM(ThreadPriority, GThreadPriority, NO_GTYPE)
+
+/*! @var ThreadPriority THREAD_PRIORITY_LOW
+ * A priority lower than normal.
+ */
+/*! @var ThreadPriority THREAD_PRIORITY_NORMAL
+ * The default priority.
+ */
+/*! @var ThreadPriority THREAD_PRIORITY_HIGH
+ * A priority higher than normal.
+ */
+/*! @var ThreadPriority THREAD_PRIORITY_URGENT
+ * The highest priority.
+ */
+
+/** Initializes the GLib thread system.
+ * @deprecated Calling thread_init() is no longer necessary and no longer has any effect.
+ */
+void thread_init(GThreadFunctions* vtable = nullptr);
+
+/** Returns whether the thread system is initialized.
+ * @return @c true, if the thread system is initialized.
+ * @deprecated This is no longer useful, because the thread system is always initialized.
+ */
+bool thread_supported();
+
+/**
+ * @deprecated Use Glib::Threads::NotLock instead.
+ */
+enum NotLock { NOT_LOCK };
+
+/**
+ * @deprecated Use Glib::Threads::TryLock instead.
+ */
+enum TryLock { TRY_LOCK };
+
+class Mutex;
+class RecMutex;
+class RWLock;
+
+struct StaticRecMutex;
+struct StaticRWLock;
+
+
+/** Exception class for thread-related errors.
+ * @deprecated Use Glib::Threads::ThreadError instead.
+ */
+_WRAP_GERROR(ThreadError, GThreadError, G_THREAD_ERROR, NO_GTYPE)
+
+
+/** Represents a running thread.
+ * An instance of this class can only be obtained with create(), self(),
+ * or wrap(GThread*). It's not possible to delete a Thread object. If the
+ * thread is @em not joinable, its resources will be freed automatically
+ * when it exits. Otherwise, if the thread @em is joinable, you must call
+ * join() to avoid a memory leak.
+ *
+ * @note g_thread_exit() is not wrapped, because that function exits a thread
+ * without any cleanup. That's especially dangerous in C++ code, since the
+ * destructors of automatic objects won't be invoked. Instead, you can throw
+ * a Thread::Exit exception, which will be caught by the internal thread
+ * entry function.
+ *
+ * @note You might have noticed that the thread entry slot doesn't have the
+ * usual void* return value. If you want to return any data from your thread
+ * you can pass an additional output argument to the thread's entry slot.
+ *
+ * @deprecated Use Glib::Threads::Thread instead.
+ */
+class Thread
+{
+public:
+
+ Thread(const Thread&) = delete;
+ Thread& operator=(const Thread&) = delete;
+
+ class Exit;
+
+ //See http://bugzilla.gnome.org/show_bug.cgi?id=512348 about the sigc::trackable issue.
+ /** Creates a new thread with the priority <tt>THREAD_PRIORITY_NORMAL</tt>.
+ * If @a joinable is @c true, you can wait for this thread's termination by
+ * calling join(). Otherwise the thread will just disappear, when ready.
+ *
+ * The new thread executes the function or method @a slot points to. You can
+ * pass additional arguments using sigc::bind(). If the thread was created
+ * successfully, it is returned, otherwise a ThreadError exception is thrown.
+ *
+ * Because sigc::trackable is not thread safe, if the slot represents a
+ * non-static class method (that is, it is created by sigc::mem_fun()), the
+ * class concerned should not derive from sigc::trackable.
+ *
+ * @param slot A slot to execute in the new thread.
+ * @param joinable This parameter is now ignored because Threads are now always joinable.
+ * @return The new Thread* on success.
+ * @throw Glib::ThreadError
+ */
+ static Thread* create(const sigc::slot<void>& slot, bool joinable = true);
+
+ /** Returns the Thread* corresponding to the calling thread.
+ * @return The current thread.
+ */
+ static Thread* self();
+
+ /** Waits until the thread finishes.
+ * Waits until the thread finishes, i.e. the slot, as given to create(),
+ * returns or g_thread_exit() is called by the thread. (Calling
+ * g_thread_exit() in a C++ program should be avoided.) All resources of
+ * the thread including the Glib::Thread object are released. The thread
+ * must have been created with <tt>joinable = true</tt>.
+ */
+ void join();
+
+ //See http://bugzilla.gnome.org/show_bug.cgi?id=512348 about the sigc::trackable issue.
+ /** Creates a new thread with the priority @a priority. The stack gets the
+ * size @a stack_size or the default value for the current platform, if
+ * @a stack_size is <tt>0</tt>.
+ *
+ * If @a joinable is @c true, you can wait for this thread's termination by
+ * calling join(). Otherwise the thread will just disappear, when ready.
+ * If @a bound is @c true, this thread will be scheduled in the system scope,
+ * otherwise the implementation is free to do scheduling in the process
+ * scope. The first variant is more expensive resource-wise, but generally
+ * faster. On some systems (e.g. Linux) all threads are bound.
+ *
+ * The new thread executes the function or method @a slot points to. You can
+ * pass additional arguments using sigc::bind(). If the thread was created
+ * successfully, it is returned.
+ *
+ * Because sigc::trackable is not thread safe, if the slot represents a
+ * non-static class method (that is, it is created by sigc::mem_fun()), the
+ * class concerned should not derive from sigc::trackable.
+ *
+ * @note It is not guaranteed, that threads with different priorities really
+ * behave accordingly. On some systems (e.g. Linux) only root can increase
+ * priorities. On other systems (e.g. Solaris) there doesn't seem to be
+ * different scheduling for different priorities. All in all try to avoid
+ * being dependent on priorities. Use <tt>Glib::THREAD_PRIORITY_NORMAL</tt>
+ * here as a default.
+ *
+ * @note Only use the extended
+ * create(const sigc::slot<void>&, unsigned long, bool, bool, ThreadPriority)
+ * function, when you really can't use the simple
+ * create(const sigc::slot<void>&, bool)
+ * instead. The latter overload does not take @a stack_size, @a bound and
+ * @a priority as arguments, as they should only be used for cases, where
+ * it is inevitable.
+ *
+ * @param slot A slot to execute in the new thread.
+ * @param stack_size A stack size for the new thread, or <tt>0</tt>.
+ * @param joinable Should this thread be joinable?
+ * @param bound Should this thread be bound to a system thread?
+ * @param priority A priority for the thread.
+ * @return The new Thread* on success.
+ * @throw Glib::ThreadError
+ *
+ * @deprecated Use the simpler create() method instead, because all Threads
+ * are now joinable, and bounds and priority parameters now have no effect.
+ */
+ static Thread* create(const sigc::slot<void>& slot, unsigned long stack_size,
+ bool joinable, bool bound, ThreadPriority priority);
+
+ /** Returns whether the thread is joinable.
+ * @return Whether the thread is joinable.
+ *
+ * @deprecated All threads are now joinable.
+ */
+ bool joinable() const;
+
+ /** Changes the priority of the thread to @a priority.
+ * @note It is not guaranteed, that threads with different priorities really
+ * behave accordingly. On some systems (e.g. Linux) only @c root can
+ * increase priorities. On other systems (e.g. Solaris) there doesn't seem
+ * to be different scheduling for different priorities. All in all try to
+ * avoid being dependent on priorities.
+ * @param priority A new priority for the thread.
+ *
+ * @deprecated Thread priorities no longer have any effect.
+ */
+ void set_priority(ThreadPriority priority);
+
+ /** Returns the priority of the thread.
+ * @return The thread's priority.
+ *
+ * @deprecated Thread priorities no longer have any effect.
+ */
+ ThreadPriority get_priority() const;
+
+ /** Gives way to other threads waiting to be scheduled.
+ * This function is often used as a method to make busy wait less evil. But
+ * in most cases, you will encounter, there are better methods to do that.
+ * So in general you shouldn't use this function.
+ */
+ static void yield();
+
+ GThread* gobj() { return &gobject_; }
+ const GThread* gobj() const { return &gobject_; }
+
+private:
+ GThread gobject_;
+
+ // Glib::Thread can neither be constructed nor deleted.
+ Thread();
+ void operator delete(void*, std::size_t);
+};
+
+/** %Exception class used to exit from a thread.
+ * @code
+ * throw Glib::Thread::Exit();
+ * @endcode
+ * Write this if you want to exit from a thread created by Thread::create().
+ * Of course you must make sure not to catch Thread::Exit by accident, i.e.
+ * when using <tt>catch(...)</tt> somewhere in your code.
+ *
+ * @deprecated Use Glib::Threads::Thread::Exit instead.
+ */
+class Thread::Exit
+{};
+
+
+//TODO: Make sure that Glib::wrap() uses Glib::Threads::wrap() instead.
+
+/** @relates Glib::Thread
+ *
+ * @deprecated Use Glib::Threads::wrap(GThread*) instead.
+ */
+Thread* wrap(GThread* gobject);
+
+struct StaticMutex;
+
+/** Like Glib::Mutex, but can be defined at compile time.
+ * Use @c GLIBMM_STATIC_MUTEX_INIT to initialize a StaticMutex:
+ * @code
+ * Glib::StaticMutex mutex = GLIBMM_STATIC_MUTEX_INIT;
+ * @endcode
+ *
+ * A StaticMutex can be used without calling Glib::thread_init(), it will
+ * silently do nothing then. That will also work when using the implicit
+ * conversion to Mutex&, thus you can safely use Mutex::Lock with a
+ * StaticMutex.
+ *
+ * @deprecated Use Glib::Threads::Mutex instead, which can be used statically.
+ */
+struct StaticMutex
+{
+ void lock();
+ bool trylock();
+ void unlock();
+
+ operator Mutex&();
+
+ GStaticMutex* gobj() { return &gobject_; }
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ // Must be public to allow initialization at compile time.
+ GStaticMutex gobject_;
+#endif
+};
+
+/** Initializer macro for Glib::StaticMutex.
+ * @relates Glib::StaticMutex
+ * @hideinitializer
+ *
+ * @deprecated Glib::StaticMutex is deprecated in favour of Glib::Threads::Mutex, which can be used statically.
+ */
+#define GLIBMM_STATIC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
+
+/** Represents a mutex (mutual exclusion).
+ * It can be used to protect data against shared access. Try to use
+ * Mutex::Lock instead of calling lock() and unlock() directly --
+ * it will make your life much easier.
+ *
+ * @note Glib::Mutex is not recursive, i.e. a thread will deadlock, if it
+ * already has locked the mutex while calling lock(). Use Glib::RecMutex
+ * instead, if you need recursive mutexes.
+ *
+ * @deprecated Use Glib::Threads::Mutex instead.
+ */
+class Mutex
+{
+public:
+ class Lock;
+
+ Mutex();
+
+ Mutex(const Mutex&) = delete;
+ Mutex& operator=(const Mutex&) = delete;
+
+ ~Mutex();
+
+ /** Locks the mutex.
+ * If mutex is already locked by another thread, the current thread will
+ * block until mutex is unlocked by the other thread.
+ * @see Mutex::Lock
+ */
+ void lock();
+
+ /** Tries to lock the mutex.
+ * If the mutex is already locked by another thread, it immediately returns
+ * @c false. Otherwise it locks the mutex and returns @c true.
+ * @return Whether the mutex could be locked.
+ * @see Mutex::Lock
+ */
+ bool trylock();
+
+ /** Unlocks the mutex.
+ * If another thread is blocked in a lock() call for this mutex, it will be
+ * woken and can lock the mutex itself.
+ * @see Mutex::Lock
+ */
+ void unlock();
+
+ GMutex* gobj() { return gobject_; }
+
+private:
+ GMutex* gobject_;
+};
+
+/** Utility class for exception-safe mutex locking.
+ * @par Usage example:
+ * @code
+ * {
+ * Glib::Mutex::Lock lock (mutex); // calls mutex.lock()
+ * do_something();
+ * } // the destructor calls mutex.unlock()
+ * @endcode
+ * As you can see, the compiler takes care of the unlocking. This is not
+ * only exception safe but also much less error-prone. You could even
+ * <tt>return</tt> while still holding the lock and it will be released
+ * properly.
+ *
+ * @deprecated Use Glib::Threads::Mutex::Lock instead.
+ */
+class Mutex::Lock
+{
+public:
+ explicit inline Lock(Mutex& mutex);
+ inline Lock(Mutex& mutex, NotLock);
+ inline Lock(Mutex& mutex, TryLock);
+ inline ~Lock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ Mutex& mutex_;
+ bool locked_;
+
+
+};
+
+
+/** Like Glib::RecMutex, but can be defined at compile time.
+ * Use @c GLIBMM_STATIC_REC_MUTEX_INIT to initialize a StaticRecMutex:
+ * @code
+ * Glib::StaticRecMutex mutex = GLIBMM_STATIC_REC_MUTEX_INIT;
+ * @endcode
+ * A StaticRecMutex can be used without calling Glib::thread_init(), it will
+ * silently do nothing then. That will also work when using the implicit
+ * conversion to RecMutex&, thus you can safely use RecMutex::Lock with a
+ * StaticRecMutex.
+ *
+ * @deprecated Use Glib::Threads::RecMutex instead, which can be used statically.
+ */
+struct StaticRecMutex
+{
+ void lock();
+ bool trylock();
+ void unlock();
+
+ void lock_full(unsigned int depth);
+ unsigned int unlock_full();
+
+ operator RecMutex&();
+
+ GStaticRecMutex* gobj() { return &gobject_; }
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ // Must be public to allow initialization at compile time.
+ GStaticRecMutex gobject_;
+#endif
+};
+
+/**
+ *
+ * @deprecated Use Glib::Threads::RecMutex instead.
+ */
+class RecMutex : public StaticRecMutex
+{
+public:
+ class Lock;
+
+ RecMutex();
+ ~RecMutex();
+
+private:
+ // noncopyable
+ RecMutex(const RecMutex&);
+ RecMutex& operator=(const RecMutex&);
+};
+
+/** Utility class for exception-safe locking of recursive mutexes.
+ *
+ * @deprecated Use Glib::Threads::RecMutex instead.
+ */
+class RecMutex::Lock
+{
+public:
+ explicit inline Lock(RecMutex& mutex);
+ inline Lock(RecMutex& mutex, NotLock);
+ inline Lock(RecMutex& mutex, TryLock);
+
+ Lock(const RecMutex::Lock&) = delete;
+ RecMutex::Lock& operator=(const RecMutex::Lock&) = delete;
+
+ inline ~Lock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RecMutex& mutex_;
+ bool locked_;
+};
+
+
+/** Like Glib::RWLock, but can be defined at compile time.
+ * Use @c GLIBMM_STATIC_RW_LOCK_INIT to initialize a StaticRWLock:
+ * @code
+ * Glib::StaticRWLock rw_lock = GLIBMM_STATIC_RW_LOCK_INIT;
+ * @endcode
+ * A StaticRWLock can be used without calling Glib::thread_init(), it will
+ * silently do nothing then. That will also work when using the implicit
+ * conversion to RWLock&, thus you can safely use RWLock::ReaderLock and
+ * RWLock::WriterLock with a StaticRWLock.
+ *
+ * @deprecated Use Glib::Threads::RWLock instead, which can be used statically.
+ */
+struct StaticRWLock
+{
+ void reader_lock();
+ bool reader_trylock();
+ void reader_unlock();
+
+ void writer_lock();
+ bool writer_trylock();
+ void writer_unlock();
+
+ operator RWLock&();
+
+ GStaticRWLock* gobj() { return &gobject_; }
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ // Must be public to allow initialization at compile time.
+ GStaticRWLock gobject_;
+#endif
+};
+
+/**
+ *
+ * @deprecated Use Glib::Threads::RWLock instead.
+ */
+class RWLock : public StaticRWLock
+{
+public:
+ class ReaderLock;
+ class WriterLock;
+
+ RWLock();
+
+ RWLock(const RWLock&) = delete;
+ RWLock& operator=(const RWLock&) = delete;
+
+ ~RWLock();
+};
+
+/** Utility class for exception-safe locking of read/write locks.
+ *
+ * @deprecated Use Glib::Threads::RWLock::ReaderLock instead.
+ */
+class RWLock::ReaderLock
+{
+public:
+ explicit inline ReaderLock(RWLock& rwlock);
+ inline ReaderLock(RWLock& rwlock, NotLock);
+ inline ReaderLock(RWLock& rwlock, TryLock);
+
+ ReaderLock(const RWLock::ReaderLock&) = delete;
+ RWLock::ReaderLock& operator=(const RWLock::ReaderLock&) = delete;
+
+ inline ~ReaderLock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RWLock& rwlock_;
+ bool locked_;
+};
+
+/** Utility class for exception-safe locking of read/write locks.
+ *
+ * @deprecated Use Glib::Threads::RWLock::WriterLock instead.
+ */
+class RWLock::WriterLock
+{
+public:
+ explicit inline WriterLock(RWLock& rwlock);
+ inline WriterLock(RWLock& rwlock, NotLock);
+ inline WriterLock(RWLock& rwlock, TryLock);
+
+ WriterLock(const RWLock::WriterLock&) = delete;
+ RWLock::WriterLock& operator=(const RWLock::WriterLock&) = delete;
+
+ inline ~WriterLock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RWLock& rwlock_;
+ bool locked_;
+};
+
+/** An opaque data structure to represent a condition.
+ * A @a Cond is an object that threads can block on, if they find a certain
+ * condition to be false. If other threads change the state of this condition
+ * they can signal the @a Cond, such that the waiting thread is woken up.
+ * @par Usage example:
+ * @code
+ * Glib::Cond data_cond;
+ * Glib::Mutex data_mutex;
+ * void* current_data = nullptr;
+ *
+ * void push_data(void* data)
+ * {
+ * Glib::Mutex::Lock lock (data_mutex);
+ *
+ * current_data = data;
+ * data_cond.signal();
+ * }
+ *
+ * void* pop_data()
+ * {
+ * Glib::Mutex::Lock lock (data_mutex);
+ *
+ * while (!current_data)
+ * data_cond.wait(data_mutex);
+ *
+ * void *const data = current_data;
+ * current_data = nullptr;
+ *
+ * return data;
+ * }
+ * @endcode
+ *
+ * @deprecated Use Glib::Threads::Cond instead.
+ */
+class Cond
+{
+public:
+ Cond();
+
+ Cond(const Cond&) = delete;
+ Cond& operator=(const Cond&) = delete;
+
+ ~Cond();
+
+ /** If threads are waiting for this @a Cond, exactly one of them is woken up.
+ * It is good practice to hold the same lock as the waiting thread, while calling
+ * this method, though not required.
+ *
+ */
+ void signal();
+
+ /** If threads are waiting for this @a Cond, all of them are woken up.
+ * It is good practice to hold the same lock as the waiting thread, while calling
+ * this method, though not required.
+ */
+ void broadcast();
+
+ /** Waits until this thread is woken up on this @a Cond.
+ * The mutex is unlocked before falling asleep and locked again before resuming.
+ *
+ * @param mutex a @a Mutex that is currently locked.
+ *
+ * @note It is important to use the @a wait() and @a timed_wait() methods
+ * only inside a loop, which checks for the condition to be true as it is not
+ * guaranteed that the waiting thread will find it fulfilled, even if the signaling
+ * thread left the condition in that state. This is because another thread can have
+ * altered the condition, before the waiting thread got the chance to be woken up,
+ * even if the condition itself is protected by a @a Mutex.
+ */
+ void wait(Mutex& mutex);
+
+ /** Waits until this thread is woken up on this @a Cond, but not longer than until the time, that is specified by @a abs_time.
+ * The mutex is unlocked before falling asleep and locked again before resuming.
+ *
+ * @param mutex a @a Mutex that is currently locked.
+ * @param abs_time a max time to wait.
+ *
+ * @note It is important to use the @a wait() and @a timed_wait() methods
+ * only inside a loop, which checks for the condition to be true as it is not
+ * guaranteed that the waiting thread will find it fulfilled, even if the signaling
+ * thread left the condition in that state. This is because another thread can have
+ * altered the condition, before the waiting thread got the chance to be woken up,
+ * even if the condition itself is protected by a @a Mutex.
+ */
+ bool timed_wait(Mutex& mutex, const Glib::TimeVal& abs_time);
+
+ GCond* gobj() { return gobject_; }
+
+private:
+ GCond* gobject_;
+};
+
+
+/** Thread-local data pointer.
+ *
+ * @deprecated Use Glib::Threads::Private instead, which can be used statically.
+ */
+template <class T>
+struct StaticPrivate
+{
+ using DestroyNotifyFunc = void (*) (void*);
+
+ static void delete_ptr(void* data);
+
+ inline T* get();
+ inline void set(T* data, DestroyNotifyFunc notify_func = &StaticPrivate<T>::delete_ptr);
+
+ GStaticPrivate* gobj() { return &gobject_; }
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+ // Must be public to allow initialization at compile time.
+ GStaticPrivate gobject_;
+#endif
+};
+
+/** Thread-local data pointer.
+ *
+ * @deprecated Use Glib::Threads::Private instead.
+ */
+template <class T>
+class Private
+{
+public:
+
+ Private(const Private<T>&) = delete;
+ Private<T>& operator=(const Private<T>&) = delete;
+
+ using DestructorFunc = void (*) (void*);
+
+ static void delete_ptr(void* data);
+
+ explicit inline Private(DestructorFunc destructor_func = &Private<T>::delete_ptr);
+ inline T* get();
+ inline void set(T* data);
+
+ GPrivate* gobj() { return gobject_; }
+
+private:
+ GPrivate* gobject_;
+};
+
+/** @} group Threads */
+
+/*! A glibmm thread example.
+ * @example thread/thread.cc
+ */
+
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/***************************************************************************/
+/* inline implementation */
+/***************************************************************************/
+
+// internal
+/** @deprecated This was always for internal glibmm use and is now unecessary even inside glibmm.
+ */
+void thread_init_impl();
+
+/**** Glib::Mutex::Lock ****************************************************/
+
+inline
+Mutex::Lock::Lock(Mutex& mutex)
+:
+ mutex_ (mutex),
+ locked_ (true)
+{
+ mutex_.lock();
+}
+
+inline
+Mutex::Lock::Lock(Mutex& mutex, NotLock)
+:
+ mutex_ (mutex),
+ locked_ (false)
+{}
+
+inline
+Mutex::Lock::Lock(Mutex& mutex, TryLock)
+:
+ mutex_ (mutex),
+ locked_ (mutex.trylock())
+{}
+
+inline
+Mutex::Lock::~Lock()
+{
+ if(locked_)
+ mutex_.unlock();
+}
+
+inline
+void Mutex::Lock::acquire()
+{
+ mutex_.lock();
+ locked_ = true;
+}
+
+inline
+bool Mutex::Lock::try_acquire()
+{
+ locked_ = mutex_.trylock();
+ return locked_;
+}
+
+inline
+void Mutex::Lock::release()
+{
+ mutex_.unlock();
+ locked_ = false;
+}
+
+inline
+bool Mutex::Lock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::RecMutex::Lock *************************************************/
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex)
+:
+ mutex_ (mutex),
+ locked_ (true)
+{
+ mutex_.lock();
+}
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex, NotLock)
+:
+ mutex_ (mutex),
+ locked_ (false)
+{}
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex, TryLock)
+:
+ mutex_ (mutex),
+ locked_ (mutex.trylock())
+{}
+
+inline
+RecMutex::Lock::~Lock()
+{
+ if(locked_)
+ mutex_.unlock();
+}
+
+inline
+void RecMutex::Lock::acquire()
+{
+ mutex_.lock();
+ locked_ = true;
+}
+
+inline
+bool RecMutex::Lock::try_acquire()
+{
+ locked_ = mutex_.trylock();
+ return locked_;
+}
+
+inline
+void RecMutex::Lock::release()
+{
+ mutex_.unlock();
+ locked_ = false;
+}
+
+inline
+bool RecMutex::Lock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::RWLock::ReaderLock *********************************************/
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock)
+:
+ rwlock_ (rwlock),
+ locked_ (true)
+{
+ rwlock_.reader_lock();
+}
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock, NotLock)
+:
+ rwlock_ (rwlock),
+ locked_ (false)
+{}
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock, TryLock)
+:
+ rwlock_ (rwlock),
+ locked_ (rwlock.reader_trylock())
+{}
+
+inline
+RWLock::ReaderLock::~ReaderLock()
+{
+ if(locked_)
+ rwlock_.reader_unlock();
+}
+
+inline
+void RWLock::ReaderLock::acquire()
+{
+ rwlock_.reader_lock();
+ locked_ = true;
+}
+
+inline
+bool RWLock::ReaderLock::try_acquire()
+{
+ locked_ = rwlock_.reader_trylock();
+ return locked_;
+}
+
+inline
+void RWLock::ReaderLock::release()
+{
+ rwlock_.reader_unlock();
+ locked_ = false;
+}
+
+inline
+bool RWLock::ReaderLock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::RWLock::WriterLock *********************************************/
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock)
+:
+ rwlock_ (rwlock),
+ locked_ (true)
+{
+ rwlock_.writer_lock();
+}
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock, NotLock)
+:
+ rwlock_ (rwlock),
+ locked_ (false)
+{}
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock, TryLock)
+:
+ rwlock_ (rwlock),
+ locked_ (rwlock.writer_trylock())
+{}
+
+inline
+RWLock::WriterLock::~WriterLock()
+{
+ if(locked_)
+ rwlock_.writer_unlock();
+}
+
+inline
+void RWLock::WriterLock::acquire()
+{
+ rwlock_.writer_lock();
+ locked_ = true;
+}
+
+inline
+bool RWLock::WriterLock::try_acquire()
+{
+ locked_ = rwlock_.writer_trylock();
+ return locked_;
+}
+
+inline
+void RWLock::WriterLock::release()
+{
+ rwlock_.writer_unlock();
+ locked_ = false;
+}
+
+inline
+bool RWLock::WriterLock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::StaticPrivate **************************************************/
+
+// static
+template <class T>
+void StaticPrivate<T>::delete_ptr(void* data)
+{
+ delete static_cast<T*>(data);
+}
+
+/** This is only for use by glibmm itself.
+ */
+void* StaticPrivate_get_helper(GStaticPrivate *private_key);
+
+template <class T> inline
+T* StaticPrivate<T>::get()
+{
+ return static_cast<T*>(StaticPrivate_get_helper(&gobject_));
+}
+
+/** This is only for use by glibmm itself.
+ */
+void StaticPrivate_set_helper(GStaticPrivate *private_key, gpointer data, GDestroyNotify notify);
+
+template <class T> inline
+void StaticPrivate<T>::set(T* data, typename StaticPrivate<T>::DestroyNotifyFunc notify_func)
+{
+ StaticPrivate_set_helper(&gobject_, data, notify_func);
+}
+
+
+/**** Glib::Private ********************************************************/
+
+// static
+template <class T>
+void Private<T>::delete_ptr(void* data)
+{
+ delete static_cast<T*>(data);
+}
+
+/** This is only for use by glibmm itself.
+ */
+GPrivate* GPrivate_new_helper(GDestroyNotify notify);
+
+template <class T> inline
+Private<T>::Private(typename Private<T>::DestructorFunc destructor_func)
+:
+ gobject_ (GPrivate_new_helper(destructor_func))
+{}
+
+template <class T> inline
+T* Private<T>::get()
+{
+ return static_cast<T*>(g_private_get(gobject_));
+}
+
+template <class T> inline
+void Private<T>::set(T* data)
+{
+ g_private_set(gobject_, data);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} // namespace Glib
+
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/exceptionhandler.h>
+#include <glib.h>
+
+/* Why reinterpret_cast<Thread*>(gobject) is needed:
+ *
+ * A Thread instance is in fact always a GThread instance.
+ * Unfortunately, GThread cannot be a member of Thread,
+ * because it is an opaque struct. Also, the C interface does not provide
+ * any hooks to install a destroy notification handler, thus we cannot
+ * wrap it dynamically either.
+ *
+ * The cast works because Thread does not have any member data, and
+ * it is impossible to derive from it. This is ensured by not implementing
+ * the (private) default constructor.
+ * This trick is used also in classes declared as _CLASS_OPAQUE_REFCOUNTED.
+ */
+
+namespace
+{
+
+extern "C" {
+
+static void*
+call_thread_entry_slot(void* data)
+{
+ const auto slot = reinterpret_cast<sigc::slot_base*>(data);
+
+ try
+ {
+ // Recreate the specific slot.
+ (*static_cast<sigc::slot<void>*>(slot))();
+ }
+ catch (Glib::Threads::Thread::Exit&)
+ {
+ // Just exit from the thread. The Threads::Thread::Exit exception
+ // is our sane C++ replacement of g_thread_exit().
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ delete slot;
+ return nullptr;
+}
+
+} // extern "C"
+
+} // anonymous namespace
+
+namespace Glib
+{
+
+namespace Threads
+{
+
+/**** Glib::Threads::Thread ************************************************/
+
+// static
+Thread*
+Thread::create(const sigc::slot<void>& slot, const std::string& name)
+{
+ // Make a copy of slot on the heap.
+ const auto slot_copy = new sigc::slot<void>(slot);
+
+ GError* error = nullptr;
+ auto thread = g_thread_try_new(
+ name.empty() ? nullptr : name.c_str(), &call_thread_entry_slot, slot_copy, &error);
+
+ if (error)
+ {
+ delete slot_copy;
+ Glib::Error::throw_exception(error);
+ }
+ if (!thread)
+ {
+ delete slot_copy;
+ }
+ return reinterpret_cast<Thread*>(thread);
+}
+
+// static
+Thread*
+Thread::create(const sigc::slot<void>& slot)
+{
+ return create(slot, std::string());
+}
+
+// static
+Thread*
+Thread::self()
+{
+ return reinterpret_cast<Thread*>(g_thread_self());
+}
+
+void
+Thread::join()
+{
+ g_thread_join(reinterpret_cast<GThread*>(this));
+}
+
+// static
+void
+Thread::yield()
+{
+ g_thread_yield();
+}
+
+GThread*
+Thread::gobj()
+{
+ return reinterpret_cast<GThread*>(this);
+}
+
+const GThread*
+Thread::gobj() const
+{
+ return reinterpret_cast<const GThread*>(this);
+}
+
+Thread*
+wrap(GThread* gobject)
+{
+ return reinterpret_cast<Thread*>(gobject);
+}
+
+/**** Glib::Threads::Mutex *************************************************/
+
+Mutex::Mutex()
+{
+ g_mutex_init(&gobject_);
+}
+
+Mutex::~Mutex()
+{
+ g_mutex_clear(&gobject_);
+}
+
+void
+Mutex::lock()
+{
+ g_mutex_lock(&gobject_);
+}
+
+bool
+Mutex::trylock()
+{
+ return g_mutex_trylock(&gobject_);
+}
+
+void
+Mutex::unlock()
+{
+ g_mutex_unlock(&gobject_);
+}
+
+Mutex*
+wrap(GMutex* gobject)
+{
+ return reinterpret_cast<Mutex*>(gobject);
+}
+
+/**** Glib::Threads::RecMutex **********************************************/
+
+RecMutex::RecMutex()
+{
+ g_rec_mutex_init(&gobject_);
+}
+
+RecMutex::~RecMutex()
+{
+ g_rec_mutex_clear(&gobject_);
+}
+
+void
+RecMutex::lock()
+{
+ g_rec_mutex_lock(&gobject_);
+}
+
+bool
+RecMutex::trylock()
+{
+ return g_rec_mutex_trylock(&gobject_);
+}
+
+void
+RecMutex::unlock()
+{
+ g_rec_mutex_unlock(&gobject_);
+}
+
+RecMutex*
+wrap(GRecMutex* gobject)
+{
+ return reinterpret_cast<RecMutex*>(gobject);
+}
+
+/**** Glib::Threads::RWLock ************************************************/
+
+void
+RWLock::reader_lock()
+{
+ g_rw_lock_reader_lock(&gobject_);
+}
+
+bool
+RWLock::reader_trylock()
+{
+ return g_rw_lock_reader_trylock(&gobject_);
+}
+
+void
+RWLock::reader_unlock()
+{
+ g_rw_lock_reader_unlock(&gobject_);
+}
+
+void
+RWLock::writer_lock()
+{
+ g_rw_lock_writer_lock(&gobject_);
+}
+
+bool
+RWLock::writer_trylock()
+{
+ return g_rw_lock_writer_trylock(&gobject_);
+}
+
+void
+RWLock::writer_unlock()
+{
+ g_rw_lock_writer_unlock(&gobject_);
+}
+
+RWLock::RWLock()
+{
+ g_rw_lock_init(&gobject_);
+}
+
+RWLock::~RWLock()
+{
+ g_rw_lock_clear(&gobject_);
+}
+
+/**** Glib::Threads::Cond **************************************************/
+
+Cond::Cond()
+{
+ g_cond_init(&gobject_);
+}
+
+Cond::~Cond()
+{
+ g_cond_clear(&gobject_);
+}
+
+void
+Cond::signal()
+{
+ g_cond_signal(&gobject_);
+}
+
+void
+Cond::broadcast()
+{
+ g_cond_broadcast(&gobject_);
+}
+
+void
+Cond::wait(Mutex& mutex)
+{
+ g_cond_wait(&gobject_, mutex.gobj());
+}
+
+bool
+Cond::wait_until(Mutex& mutex, gint64 end_time)
+{
+ return g_cond_wait_until(&gobject_, mutex.gobj(), end_time);
+}
+
+} // namespace Threads
+
+} // namespace Glib
--- /dev/null
+/* Copyright (C) 2002 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+_DEFS(glibmm,glib)
+_CONFIGINCLUDE(glibmmconfig.h)
+
+_IS_DEPRECATED // This whole file is deprecated.
+
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+// Don't let glibmm.h include thread.h. Pretend that it's already included.
+// glib.h can then be included with G_DISABLE_DEPRECATED defined, and
+// the compiler can react if deprecated glib functions are used.
+#define _GLIBMM_THREAD_H
+#m4 _POP()
+
+#include <glib.h>
+#include <glibmm/error.h>
+#include <sigc++/sigc++.h>
+#include <string>
+#include <cstddef>
+
+namespace Glib
+{
+
+/**
+ * @deprecated The entire Glib::Threads API is deprecated in favor of the
+ * standard C++ concurrency API in C++11 and C++14.
+ */
+namespace Threads
+{
+//The GMMPROC_EXTRA_NAMESPACE() macro is a hint to generate_wrap_init.pl to put it in the Threads sub-namespace
+_GMMPROC_EXTRA_NAMESPACE(Threads)
+
+/** @defgroup Threads Threads
+ * %Thread abstraction; including threads, different mutexes,
+ * conditions and thread private data.
+ *
+ * @deprecated The entire Glib::Threads API is deprecated in favor of the
+ * standard C++ concurrency API in C++11 and C++14.
+ * @{
+ */
+
+/// @deprecated Please use std::lock_guard or std::unique_lock instead.
+enum NotLock { NOT_LOCK };
+
+/// @deprecated Please use std::lock_guard or std::unique_lock instead.
+enum TryLock { TRY_LOCK };
+
+class Mutex;
+class RecMutex;
+class RWLock;
+
+/** %Exception class for thread-related errors.
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead.
+ */
+_WRAP_GERROR(ThreadError, GThreadError, G_THREAD_ERROR, NO_GTYPE)
+
+
+/** Represents a running thread.
+ * An instance of this class can only be obtained with create(), self(),
+ * or wrap(GThread*). It's not possible to delete a Thread object.
+ * You must call join() to avoid a memory leak.
+ *
+ * @note g_thread_exit() is not wrapped, because that function exits a thread
+ * without any cleanup. That's especially dangerous in C++ code, since the
+ * destructors of automatic objects won't be invoked. Instead, you can throw
+ * a Threads::Thread::Exit exception, which will be caught by the internal thread
+ * entry function.
+ *
+ * @note The thread entry slot doesn't have the void* return value that a
+ * GThreadFunc has. If you want to return any data from your thread,
+ * you can pass an additional output argument to the thread's entry slot.
+ *
+ * @deprecated Please use std::thread instead.
+ */
+class Thread
+{
+public:
+
+ Thread(const Thread&) = delete;
+ Thread& operator=(const Thread&) = delete;
+
+ class Exit;
+
+ //See http://bugzilla.gnome.org/show_bug.cgi?id=512348 about the sigc::trackable issue.
+ // TODO: At the next ABI break, consider changing const sigc::slot<void>& slot
+ // to const std::function<void()>& func, if it can be assumed that all supported
+ // compilers understand the C++11 template class std::function<>.
+ /** Creates a new thread.
+ * You can wait for this thread's termination by calling join().
+ *
+ * The new thread executes the function or method @a slot points to. You can
+ * pass additional arguments using sigc::bind(). If the thread was created
+ * successfully, it is returned, otherwise a Threads::ThreadError exception is thrown.
+ *
+ * Because sigc::trackable is not thread-safe, if the slot represents a
+ * non-static class method and is created by sigc::mem_fun(), the class concerned
+ * should not derive from sigc::trackable. You can use, say, boost::bind() or,
+ * in C++11, std::bind() or a C++11 lambda expression instead of sigc::mem_fun().
+ *
+ * @param slot A slot to execute in the new thread.
+ * @return The new Thread* on success.
+ * @throw Glib::Threads::ThreadError
+ */
+ static Thread* create(const sigc::slot<void>& slot);
+
+ // TODO: At next ABI break, remove the single parameter create
+ // method and default name to std::string()
+
+ /** Creates a new named thread.
+ * You can wait for this thread's termination by calling join().
+ *
+ * The new thread executes the function or method @a slot points to. You can
+ * pass additional arguments using sigc::bind(). If the thread was created
+ * successfully, it is returned, otherwise a Threads::ThreadError exception is thrown.
+ *
+ * Because sigc::trackable is not thread-safe, if the slot represents a
+ * non-static class method and is created by sigc::mem_fun(), the class concerned
+ * should not derive from sigc::trackable. You can use, say, boost::bind() or,
+ * in C++11, std::bind() or a C++11 lambda expression instead of sigc::mem_fun().
+ *
+ * The @a name can be useful for discriminating threads in a debugger.
+ * It is not used for other purposes and does not have to be unique.
+ * Some systems restrict the length of @a name to 16 bytes.
+ *
+ * @param slot A slot to execute in the new thread.
+ * @param name A name for the new thread.
+ * @return The new Thread* on success.
+ * @throw Glib::Threads::ThreadError
+ *
+ * @newin{2,36}
+ */
+ static Thread* create(const sigc::slot<void>& slot, const std::string& name);
+
+ /** Returns the Thread* corresponding to the calling thread.
+ * @return The current thread.
+ */
+ static Thread* self();
+
+ /** Waits until the thread finishes.
+ * Waits until the thread finishes, i.e. the slot, as given to create(),
+ * returns or g_thread_exit() is called by the thread. (Calling
+ * g_thread_exit() in a C++ program should be avoided.) All resources of
+ * the thread including the Glib::Threads::Thread object are released.
+ */
+ void join();
+
+ /** Gives way to other threads waiting to be scheduled.
+ * This function is often used as a method to make busy wait less evil. But
+ * in most cases, you will encounter, there are better methods to do that.
+ * So in general you shouldn't use this function.
+ */
+ static void yield();
+
+ GThread* gobj();
+ const GThread* gobj() const;
+
+private:
+ // Glib::Thread can neither be constructed nor deleted.
+ Thread();
+ void operator delete(void*, std::size_t);
+};
+
+/** %Exception class used to exit from a thread.
+ * @code
+ * throw Glib::Threads::Thread::Exit();
+ * @endcode
+ * Write this if you want to exit from a thread created by Threads::Thread::create().
+ * Of course you must make sure not to catch Threads::Thread::Exit by accident, i.e.
+ * when using <tt>catch(...)</tt> somewhere in your code.
+ *
+ * @deprecated Please use std::thread instead.
+ */
+class Thread::Exit
+{};
+
+/** A C++ wrapper for the C object.
+ *
+ * @param gobject The C instance.
+ * @return The C++ wrapper.
+ *
+ * @relates Glib::Threads::Thread
+ *
+ * @deprecated Please use std::thread instead.
+ */
+Thread* wrap(GThread* gobject);
+
+/** Represents a mutex (mutual exclusion).
+ * It can be used to protect data against shared access. Try to use
+ * Mutex::Lock instead of calling lock() and unlock() directly --
+ * it will make your life much easier.
+ *
+ * @note Glib::Threads::Mutex is not recursive, i.e. a thread will deadlock, if it
+ * already has locked the mutex while calling lock(). Use Glib::Threads::RecMutex
+ * instead, if you need recursive mutexes.
+ *
+ * @deprecated Please use std::mutex instead.
+ */
+class Mutex
+{
+public:
+ class Lock;
+
+ Mutex();
+
+ Mutex(const Mutex&) = delete;
+ Mutex& operator=(const Mutex&) = delete;
+
+ ~Mutex();
+
+ /** Locks the mutex.
+ * If mutex is already locked by another thread, the current thread will
+ * block until mutex is unlocked by the other thread.
+ * @see Mutex::Lock
+ */
+ void lock();
+
+ /** Tries to lock the mutex.
+ * If the mutex is already locked by another thread, it immediately returns
+ * @c false. Otherwise it locks the mutex and returns @c true.
+ * @return Whether the mutex could be locked.
+ * @see Mutex::Lock
+ */
+ bool trylock();
+
+ /** Unlocks the mutex.
+ * If another thread is blocked in a lock() call for this mutex, it will be
+ * woken and can lock the mutex itself.
+ * @see Mutex::Lock
+ */
+ void unlock();
+
+ GMutex* gobj() { return &gobject_; }
+
+private:
+ GMutex gobject_;
+};
+
+/** Utility class for exception-safe mutex locking.
+ * @par Usage example:
+ * @code
+ * {
+ * Glib::Threads::Mutex::Lock lock(mutex); // calls mutex.lock()
+ * do_something();
+ * } // the destructor calls mutex.unlock()
+ * @endcode
+ * As you can see, the compiler takes care of the unlocking. This is not
+ * only exception-safe but also much less error-prone. You could even
+ * <tt>return</tt> while still holding the lock and it will be released
+ * properly.
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead.
+ */
+class Mutex::Lock
+{
+public:
+ explicit inline Lock(Mutex& mutex);
+ inline Lock(Mutex& mutex, NotLock);
+ inline Lock(Mutex& mutex, TryLock);
+
+ Lock(const Mutex::Lock&) = delete;
+ Mutex::Lock& operator=(const Mutex::Lock&) = delete;
+
+ inline ~Lock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ Mutex& mutex_;
+ bool locked_;
+};
+
+/** A C++ wrapper for the C object.
+ * Do not use operator delete on the returned pointer. If the caller owns the
+ * GMutex object, the caller must destroy it in the same way as if this function
+ * had not been called.
+ *
+ * @param gobject The C instance.
+ * @result The GMutex* cast to a Glib::Threads::Mutex*.
+ *
+ * @relates Glib::Threads::Mutex
+ */
+Mutex* wrap(GMutex* gobject);
+
+/** This represents a recursive mutex.
+ * It is similar to a Mutex with the difference
+ * that it is possible to lock a RecMutex multiple times in the same
+ * thread without deadlock. When doing so, care has to be taken to
+ * unlock the recursive mutex as often as it has been locked.
+ *
+ * @deprecated Please use std::recursive_mutex instead.
+ */
+class RecMutex
+{
+public:
+ class Lock;
+
+ RecMutex();
+
+ RecMutex(const RecMutex&) = delete;
+ RecMutex& operator=(const RecMutex&) = delete;
+
+ ~RecMutex();
+
+ void lock();
+ bool trylock();
+ void unlock();
+
+ GRecMutex* gobj() { return &gobject_; }
+
+private:
+ GRecMutex gobject_;
+};
+
+/** Utility class for exception-safe locking of recursive mutexes.
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead.
+ */
+class RecMutex::Lock
+{
+public:
+ explicit inline Lock(RecMutex& mutex);
+ inline Lock(RecMutex& mutex, NotLock);
+ inline Lock(RecMutex& mutex, TryLock);
+
+ Lock(const RecMutex::Lock&) = delete;
+ RecMutex::Lock& operator=(const RecMutex::Lock&) = delete;
+
+ inline ~Lock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RecMutex& mutex_;
+ bool locked_;
+};
+
+/** A C++ wrapper for the C object.
+ * Do not use operator delete on the returned pointer. If the caller owns the
+ * GRecMutex object, the caller must destroy it in the same way as if this function
+ * had not been called.
+ *
+ * @param gobject The C instance.
+ * @result The GRecMutex* cast to a Glib::Threads::RecMutex*.
+ *
+ * @relates Glib::Threads::RecMutex
+ */
+RecMutex* wrap(GRecMutex* gobject);
+
+/** This represents a reader-writer lock.
+ * It is similar to a Mutex in that it allows
+ * multiple threads to coordinate access to a shared resource.
+ *
+ * The difference to a mutex is that a reader-writer lock discriminates
+ * between read-only ('reader') and full ('writer') access. While only
+ * one thread at a time is allowed write access (by holding the 'writer'
+ * lock via writer_lock()), multiple threads can gain
+ * simultaneous read-only access (by holding the 'reader' lock via
+ * reader_lock()).
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead, with std::shared_timed_mutex.
+ */
+class RWLock
+{
+public:
+ class ReaderLock;
+ class WriterLock;
+
+ RWLock();
+
+ RWLock(const RWLock&) = delete;
+ RWLock& operator=(const RWLock&) = delete;
+
+ ~RWLock();
+
+ void reader_lock();
+ bool reader_trylock();
+ void reader_unlock();
+
+ void writer_lock();
+ bool writer_trylock();
+ void writer_unlock();
+
+ GRWLock* gobj() { return &gobject_; }
+
+private:
+ GRWLock gobject_;
+};
+
+/** Utility class for exception-safe locking of read/write locks.
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead, with std::shared_timed_mutex.
+ */
+class RWLock::ReaderLock
+{
+public:
+ explicit inline ReaderLock(RWLock& rwlock);
+ inline ReaderLock(RWLock& rwlock, NotLock);
+ inline ReaderLock(RWLock& rwlock, TryLock);
+
+ ReaderLock(const RWLock::ReaderLock&) = delete;
+ RWLock::ReaderLock& operator=(const RWLock::ReaderLock&) = delete;
+
+ inline ~ReaderLock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RWLock& rwlock_;
+ bool locked_;
+};
+
+/** Utility class for exception-safe locking of read/write locks.
+ *
+ * @deprecated Please use std::lock_guard or std::unique_lock instead, with std::shared_timed_mutex.
+ */
+class RWLock::WriterLock
+{
+public:
+ explicit inline WriterLock(RWLock& rwlock);
+ inline WriterLock(RWLock& rwlock, NotLock);
+ inline WriterLock(RWLock& rwlock, TryLock);
+
+ WriterLock(const RWLock::WriterLock&) = delete;
+ RWLock::WriterLock& operator=(const RWLock::WriterLock&) = delete;
+
+ inline ~WriterLock();
+
+ inline void acquire();
+ inline bool try_acquire();
+ inline void release();
+ inline bool locked() const;
+
+private:
+ RWLock& rwlock_;
+ bool locked_;
+};
+
+/** An opaque data structure to represent a condition.
+ * A @a Cond is an object that threads can block on, if they find a certain
+ * condition to be false. If other threads change the state of this condition
+ * they can signal the @a Cond, such that the waiting thread is woken up.
+ *
+ * @deprecated Please use std::condition_variable instead.
+ *
+ * @par Usage example:
+ * @code
+ * Glib::Threads::Cond data_cond;
+ * Glib::Threads::Mutex data_mutex;
+ * void* current_data = nullptr;
+ *
+ * void push_data(void* data)
+ * {
+ * Glib::Threads::Mutex::Lock lock(data_mutex);
+ *
+ * current_data = data;
+ * data_cond.signal();
+ * }
+ *
+ * void* pop_data()
+ * {
+ * Glib::Threads::Mutex::Lock lock(data_mutex);
+ *
+ * while (!current_data)
+ * data_cond.wait(data_mutex);
+ *
+ * void* const data = current_data;
+ * current_data = nullptr;
+ *
+ * return data;
+ * }
+ * @endcode
+ */
+class Cond
+{
+public:
+ Cond();
+
+ Cond(const Cond&) = delete;
+ Cond& operator=(const Cond&) = delete;
+
+ ~Cond();
+
+ /** If threads are waiting for this @a Cond, exactly one of them is woken up.
+ * It is good practice to hold the same lock as the waiting thread, while calling
+ * this method, though not required.
+ */
+ void signal();
+
+ /** If threads are waiting for this @a Cond, all of them are woken up.
+ * It is good practice to hold the same lock as the waiting threads, while calling
+ * this method, though not required.
+ */
+ void broadcast();
+
+ /** Waits until this thread is woken up on this @a Cond.
+ * The mutex is unlocked before falling asleep and locked again before resuming.
+ *
+ * @param mutex A @a Mutex that is currently locked.
+ *
+ * @note It is important to use the @a wait() and @a wait_until() methods
+ * only inside a loop, which checks for the condition to be true as it is not
+ * guaranteed that the waiting thread will find it fulfilled, even if the signaling
+ * thread left the condition in that state. This is because another thread can have
+ * altered the condition, before the waiting thread got the chance to be woken up,
+ * even if the condition itself is protected by a @a Mutex.
+ */
+ void wait(Mutex& mutex);
+
+ /** Waits until this thread is woken up on this @a Cond, but not longer
+ * than until the time specified by @a end_time.
+ * The mutex is unlocked before falling asleep and locked again before resuming.
+ *
+ * @par Usage example:
+ * Extending the example presented in the documentation of class Cond.
+ * @code
+ * void* pop_data_timed()
+ * {
+ * Glib::Threads::Mutex::Lock lock(data_mutex);
+ *
+ * // Wait at most 5 seconds.
+ * const gint64 end_time = g_get_monotonic_time() + 5 * G_TIME_SPAN_SECOND;
+ * while (!current_data)
+ * if (!data_cond.wait_until(data_mutex, end_time)
+ * return nullptr; // timeout
+ *
+ * void* const data = current_data;
+ * current_data = nullptr;
+ *
+ * return data;
+ * }
+ * @endcode
+ * The end time is calculated once, before entering the loop, and reused.
+ * This is the motivation behind the use of absolute time. If a relative time
+ * of 5 seconds were passed directly to the call and a spurious wakeup
+ * occurred, the program would have to start over waiting again, which would
+ * lead to a total wait time of more than 5 seconds.
+ *
+ * @param mutex A @a Mutex that is currently locked.
+ * @param end_time The monotonic time to wait until, in microseconds.
+ * See g_get_monotonic_time().
+ * @return <tt>true</tt> if the condition variable was signalled (or in the case
+ * of a spurious wakeup), <tt>false</tt> if @a end_time has passed.
+ *
+ * @note It is important to use the @a wait() and @a wait_until() methods
+ * only inside a loop, which checks for the condition to be true as it is not
+ * guaranteed that the waiting thread will find it fulfilled, even if the signaling
+ * thread left the condition in that state. This is because another thread can have
+ * altered the condition, before the waiting thread got the chance to be woken up,
+ * even if the condition itself is protected by a @a Mutex.
+ */
+ bool wait_until(Mutex& mutex, gint64 end_time);
+
+ GCond* gobj() { return &gobject_; }
+
+private:
+ GCond gobject_;
+};
+
+/** Thread-local data pointer.
+ *
+ * It is recommended that all instances of this class are statically allocated.
+ * The first time an instance is used (get(), set() or replace() is called)
+ * glib allocates a scarce OS resource that cannot be deallocated.
+ *
+ * @deprecated Please use the thread_local keyword instead.
+ */
+template <class T>
+class Private
+{
+public:
+ Private(const Private<T>&) = delete;
+ Private<T>& operator=(const Private<T>&) = delete;
+
+ using DestructorFunc = void (*) (void*);
+
+ /** Deletes static_cast<T*>(data)
+ */
+ static void delete_ptr(void* data);
+
+ /** Constructor.
+ *
+ * @param destructor_func Function pointer, or <tt>nullptr</tt>. If @a destructor_func is not <tt>nullptr</tt>
+ * and the stored data pointer is not <tt>nullptr</tt>, this function is called when replace()
+ * is called and when the thread exits.
+ */
+ explicit inline Private(DestructorFunc destructor_func = &Private<T>::delete_ptr);
+
+ /** Gets the pointer stored in the calling thread.
+ *
+ * @return If no value has yet been set in this thread, <tt>nullptr</tt> is returned.
+ */
+ inline T* get();
+
+ /** Sets the pointer in the calling thread without calling <tt>destructor_func()</tt>.
+ */
+ inline void set(T* data);
+
+ /** Sets the pointer in the calling thread and calls <tt>destructor_func()</tt>.
+ * If a function pointer (and not <tt>nullptr</tt>) was specified in the constructor, and
+ * the stored data pointer before the call to replace() is not <tt>nullptr</tt>, then
+ * <tt>destructor_func()</tt> is called with this old pointer value.
+ *
+ * @newin{2,32}
+ */
+ inline void replace(T* data);
+
+ GPrivate* gobj() { return &gobject_; }
+
+private:
+ GPrivate gobject_;
+};
+
+/** @} group Threads */
+
+/*! A glibmm thread example.
+ * @example thread/thread.cc
+ */
+
+
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+
+/***************************************************************************/
+/* inline implementation */
+/***************************************************************************/
+
+/**** Glib::Threads::Mutex::Lock *******************************************/
+
+inline
+Mutex::Lock::Lock(Mutex& mutex)
+:
+ mutex_ (mutex),
+ locked_ (true)
+{
+ mutex_.lock();
+}
+
+inline
+Mutex::Lock::Lock(Mutex& mutex, NotLock)
+:
+ mutex_ (mutex),
+ locked_ (false)
+{}
+
+inline
+Mutex::Lock::Lock(Mutex& mutex, TryLock)
+:
+ mutex_ (mutex),
+ locked_ (mutex.trylock())
+{}
+
+inline
+Mutex::Lock::~Lock()
+{
+ if(locked_)
+ mutex_.unlock();
+}
+
+inline
+void Mutex::Lock::acquire()
+{
+ mutex_.lock();
+ locked_ = true;
+}
+
+inline
+bool Mutex::Lock::try_acquire()
+{
+ locked_ = mutex_.trylock();
+ return locked_;
+}
+
+inline
+void Mutex::Lock::release()
+{
+ mutex_.unlock();
+ locked_ = false;
+}
+
+inline
+bool Mutex::Lock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::Threads::RecMutex::Lock ****************************************/
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex)
+:
+ mutex_ (mutex),
+ locked_ (true)
+{
+ mutex_.lock();
+}
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex, NotLock)
+:
+ mutex_ (mutex),
+ locked_ (false)
+{}
+
+inline
+RecMutex::Lock::Lock(RecMutex& mutex, TryLock)
+:
+ mutex_ (mutex),
+ locked_ (mutex.trylock())
+{}
+
+inline
+RecMutex::Lock::~Lock()
+{
+ if(locked_)
+ mutex_.unlock();
+}
+
+inline
+void RecMutex::Lock::acquire()
+{
+ mutex_.lock();
+ locked_ = true;
+}
+
+inline
+bool RecMutex::Lock::try_acquire()
+{
+ locked_ = mutex_.trylock();
+ return locked_;
+}
+
+inline
+void RecMutex::Lock::release()
+{
+ mutex_.unlock();
+ locked_ = false;
+}
+
+inline
+bool RecMutex::Lock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::Threads::RWLock::ReaderLock ************************************/
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock)
+:
+ rwlock_ (rwlock),
+ locked_ (true)
+{
+ rwlock_.reader_lock();
+}
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock, NotLock)
+:
+ rwlock_ (rwlock),
+ locked_ (false)
+{}
+
+inline
+RWLock::ReaderLock::ReaderLock(RWLock& rwlock, TryLock)
+:
+ rwlock_ (rwlock),
+ locked_ (rwlock.reader_trylock())
+{}
+
+inline
+RWLock::ReaderLock::~ReaderLock()
+{
+ if(locked_)
+ rwlock_.reader_unlock();
+}
+
+inline
+void RWLock::ReaderLock::acquire()
+{
+ rwlock_.reader_lock();
+ locked_ = true;
+}
+
+inline
+bool RWLock::ReaderLock::try_acquire()
+{
+ locked_ = rwlock_.reader_trylock();
+ return locked_;
+}
+
+inline
+void RWLock::ReaderLock::release()
+{
+ rwlock_.reader_unlock();
+ locked_ = false;
+}
+
+inline
+bool RWLock::ReaderLock::locked() const
+{
+ return locked_;
+}
+
+
+/**** Glib::Threads::RWLock::WriterLock ************************************/
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock)
+:
+ rwlock_ (rwlock),
+ locked_ (true)
+{
+ rwlock_.writer_lock();
+}
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock, NotLock)
+:
+ rwlock_ (rwlock),
+ locked_ (false)
+{}
+
+inline
+RWLock::WriterLock::WriterLock(RWLock& rwlock, TryLock)
+:
+ rwlock_ (rwlock),
+ locked_ (rwlock.writer_trylock())
+{}
+
+inline
+RWLock::WriterLock::~WriterLock()
+{
+ if(locked_)
+ rwlock_.writer_unlock();
+}
+
+inline
+void RWLock::WriterLock::acquire()
+{
+ rwlock_.writer_lock();
+ locked_ = true;
+}
+
+inline
+bool RWLock::WriterLock::try_acquire()
+{
+ locked_ = rwlock_.writer_trylock();
+ return locked_;
+}
+
+inline
+void RWLock::WriterLock::release()
+{
+ rwlock_.writer_unlock();
+ locked_ = false;
+}
+
+inline
+bool RWLock::WriterLock::locked() const
+{
+ return locked_;
+}
+
+/**** Glib::Threads::Private<T> ********************************************/
+
+// static
+template <class T>
+void Private<T>::delete_ptr(void* data)
+{
+ delete static_cast<T*>(data);
+}
+
+template <class T> inline
+Private<T>::Private(typename Private<T>::DestructorFunc destructor_func)
+{
+ // gobject_ = G_PRIVATE_INIT(destructor_func);
+ // does not compile with --enable-warnings=fatal.
+ // GPrivate is a struct, and G_PRIVATE_INIT is an initializer of type { ... }.
+ // G_PRIVATE_INIT can be used only in initializations.
+ const GPrivate temp = G_PRIVATE_INIT(destructor_func);
+ gobject_ = temp;
+}
+
+template <class T> inline
+T* Private<T>::get()
+{
+ return static_cast<T*>(g_private_get(&gobject_));
+}
+
+template <class T> inline
+void Private<T>::set(T* data)
+{
+ g_private_set(&gobject_, data);
+}
+
+template <class T> inline
+void Private<T>::replace(T* data)
+{
+ g_private_replace(&gobject_, data);
+}
+
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+} //namespace Threads
+
+} // namespace Glib
_WRAP_METHOD(Glib::ustring get_abbreviation(int interval) const, g_time_zone_get_abbreviation)
_WRAP_METHOD(gint32 get_offset(int interval) const, g_time_zone_get_offset)
_WRAP_METHOD(bool is_dst(int interval) const, g_time_zone_is_dst)
+ _WRAP_METHOD(Glib::ustring get_identifier() const, g_time_zone_get_identifier, newin "2,60")
};
} // namespace Glib
GParamSpec* Value<$1>::create_param_spec(const Glib::ustring& name) const
{
return create_param_spec(name, Glib::ustring(), Glib::ustring(),
- Glib::ParamFlags::READWRITE);
+ Glib::PARAM_READWRITE);
}
GParamSpec* Value<$1>::create_param_spec(const Glib::ustring& name, const Glib::ustring& nick,
G_GNUC_EXTENSION typedef unsigned long long unsigned_long_long;
GLIB_VALUE_BASIC(bool, boolean)
+#ifndef GLIBMM_DISABLE_DEPRECATED
+GLIB_VALUE_BASIC(char, char, -128, 127)
+#endif // GLIBMM_DISABLE_DEPRECATED
GLIB_VALUE_BASIC(signed char, schar, -128, 127)
GLIB_VALUE_BASIC(unsigned char, uchar, 0, 255)
GLIB_VALUE_BASIC(int, int, G_MININT, G_MAXINT)
{
public:
using CppType = $1;
+ using CType = g$2;
static GType value_type() G_GNUC_CONST;
namespace Glib
{
GLIB_VALUE_BASIC(bool, boolean)
+#ifndef GLIBMM_DISABLE_DEPRECATED
+/// @deprecated Use Value<signed char> instead.
+GLIB_VALUE_BASIC(char, char)
+#endif // GLIBMM_DISABLE_DEPRECATED
/// @newin{2,44}
GLIB_VALUE_BASIC(signed char, int8)
GLIB_VALUE_BASIC(unsigned char, uchar)
--- /dev/null
+/* Copyright (C) 2002-2009 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/exceptionhandler.h>
+
+static int
+ValueArray_Compare_glibmm_callback(gconstpointer a, gconstpointer b, gpointer user_data)
+{
+ Glib::ValueArray::SlotCompare* the_slot = static_cast<Glib::ValueArray::SlotCompare*>(user_data);
+
+ try
+ {
+ return (*the_slot)(
+ *reinterpret_cast<const Glib::ValueBase*>(a), *reinterpret_cast<const Glib::ValueBase*>(b));
+ }
+ catch (...)
+ {
+ Glib::exception_handlers_invoke();
+ }
+
+ return 0;
+}
+
+namespace Glib
+{
+
+ValueArray::ValueArray() : gobject_(g_value_array_new(0))
+{
+}
+
+ValueArray::ValueArray(guint n_preallocated) : gobject_(g_value_array_new(n_preallocated))
+{
+}
+
+bool
+ValueArray::get_nth(guint index, Glib::ValueBase& value)
+{
+ const auto g_value = g_value_array_get_nth(gobj(), index);
+
+ if (g_value)
+ {
+ value.init(g_value);
+ return true;
+ }
+ else
+ return false;
+}
+
+Glib::ValueArray&
+ValueArray::append(const Glib::ValueBase& value)
+{
+ g_value_array_append(gobj(), value.gobj());
+ return *this;
+}
+
+Glib::ValueArray&
+ValueArray::prepend(const Glib::ValueBase& value)
+{
+ g_value_array_prepend(gobj(), value.gobj());
+ return *this;
+}
+
+Glib::ValueArray&
+ValueArray::insert(guint index, const Glib::ValueBase& value)
+{
+ g_value_array_insert(gobj(), index, value.gobj());
+ return *this;
+}
+
+Glib::ValueArray&
+ValueArray::remove(guint index)
+{
+ g_value_array_remove(gobj(), index);
+ return *this;
+}
+
+Glib::ValueArray&
+ValueArray::sort(const SlotCompare& compare_func)
+{
+ SlotCompare slot_copy(compare_func);
+ g_value_array_sort_with_data(gobj(), &ValueArray_Compare_glibmm_callback, &slot_copy);
+ return *this;
+}
+
+} // Glib namespace
--- /dev/null
+/* Copyright (C) 2002-2009 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+_CONFIGINCLUDE(glibmmconfig.h)
+
+_DEFS(glibmm,glib)
+
+#include <glib-object.h>
+#include <glibmm/value.h>
+#include <sigc++/functors/slot.h>
+
+#m4 _PUSH(SECTION_CC_PRE_INCLUDES)
+#undef G_DISABLE_DEPRECATED
+#define GLIB_DISABLE_DEPRECATION_WARNINGS 1
+#m4 _POP()
+
+_IS_DEPRECATED // This whole file is deprecated.
+
+namespace Glib
+{
+
+/** A container structure to maintain an array of generic values.
+ * The prime purpose of a ValueArray is for it to be used as an object property
+ * that holds an array of values. A ValueArray wraps an array of ValueBase
+ * elements.
+ *
+ * @newin{2,22}
+ *
+ * @deprecated Use std::vector<Glib::ValueBase*> or std::vector< Glib::Value<> >
+ * instead of Glib::ValueArray.
+ */
+class ValueArray
+{
+ _CLASS_BOXEDTYPE(ValueArray, GValueArray, NONE, g_value_array_copy, g_value_array_free)
+ _IGNORE(g_value_array_copy, g_value_array_free)
+ _CUSTOM_DEFAULT_CTOR
+
+public:
+ /** For example,
+ * int on_compare(const Glib::ValueBase& v1, const Glib::ValueBase& v2);.
+ * The compare function should return -1 if v1 < v2, 0 if v1 == v2, and 1 if
+ * v1 > v2.
+ */
+ using SlotCompare = sigc::slot<int, const Glib::ValueBase&, const Glib::ValueBase&>;
+
+ /** Default constructor. Constructs a new array with no pre-allocation.
+ */
+ ValueArray();
+
+ /** Constructs a new array with pre-allocation.
+ */
+ ValueArray(guint n_preallocated);
+
+ /** Return the value at @a index contained in the value array.
+ * @param index Index of the value of interest.
+ * @param value An uninitialized ValueBase in which to store the result. If
+ * the get is successful, @a value will be valid, otherwise it will remain
+ * uninitialized.
+ * @return whether the get was successful or not.
+ */
+ bool get_nth(guint index, Glib::ValueBase& value);
+ _IGNORE(g_value_array_get_nth)
+
+ _WRAP_METHOD_DOCS_ONLY(g_value_array_append)
+ Glib::ValueArray& append(const Glib::ValueBase& value);
+
+ _WRAP_METHOD_DOCS_ONLY(g_value_array_prepend)
+ Glib::ValueArray& prepend(const Glib::ValueBase& value);
+
+ _WRAP_METHOD_DOCS_ONLY(g_value_array_insert)
+ Glib::ValueArray& insert(guint index, const Glib::ValueBase& value);
+
+ _WRAP_METHOD_DOCS_ONLY(g_value_array_remove)
+ Glib::ValueArray& remove(guint index);
+
+ _WRAP_METHOD_DOCS_ONLY(g_value_array_sort)
+ Glib::ValueArray& sort(const SlotCompare& compare_func);
+ _IGNORE(g_value_array_sort_with_data)
+};
+
+} //namespace Glib
namespace Glib
{
-/****************** VariantBase ***********************************/
-
VariantBase::VariantBase(GVariant* castitem, bool make_a_copy /* = false */)
{
if (castitem)
gobject_ = castitem;
}
-VariantBase::operator bool() const
-{
- return gobj();
-}
-
-void
-VariantBase::init(const GVariant* cobject, bool take_a_reference)
-{
- if (gobject_)
- g_variant_unref(gobject_);
-
- gobject_ = const_cast<GVariant*>(cobject);
- if (take_a_reference)
- g_variant_ref(gobject_);
-}
-
-bool VariantBase::operator==(const VariantBase& other) const
-{
- return equal(other);
-}
-
-bool VariantBase::operator!=(const VariantBase& other) const
-{
- return !equal(other);
-}
-
void
VariantBase::get_normal_form(VariantBase& result) const
{
return true;
}
-/****************** VariantStringBase ***********************************/
-
VariantStringBase::VariantStringBase() : VariantBase()
{
}
output.init(result);
}
-/****************** VariantContainerBase ***********************************/
-
VariantContainerBase::VariantContainerBase() : VariantBase()
{
}
/****************** Specializations ***********************************/
+_DEPRECATE_IFDEF_START
+VariantBase::operator const void*() const
+{
+ return gobj() ? GINT_TO_POINTER(1) : nullptr;
+}
+_DEPRECATE_IFDEF_END
+
+VariantBase::operator bool() const
+{
+ return gobj() != nullptr;
+}
+
+void
+VariantBase::init(const GVariant* cobject, bool take_a_reference)
+{
+ if (gobject_)
+ g_variant_unref(gobject_);
+
+ gobject_ = const_cast<GVariant*>(cobject);
+ if (take_a_reference)
+ g_variant_ref(gobject_);
+}
+
/*--------------------Variant<VariantBase>---------------------*/
Variant<VariantBase>::Variant() : VariantContainerBase()
return convert_const_gchar_ptr_to_ustring(g_variant_get_string(gobject_, nullptr));
}
+// Variant<Glib::ustring> makes sense for multiple types.
+// See http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-string
+template <>
+Variant<Glib::ustring>
+VariantBase::cast_dynamic<Variant<Glib::ustring>>(const VariantBase& v)
+{
+ if (!v.gobj())
+ {
+ return Variant<Glib::ustring>();
+ }
+
+ const VariantType vtype = v.get_type();
+ if (vtype.equal(VARIANT_TYPE_STRING) || vtype.equal(VARIANT_TYPE_OBJECT_PATH) ||
+ vtype.equal(VARIANT_TYPE_SIGNATURE))
+ {
+ return Variant<Glib::ustring>(const_cast<GVariant*>(v.gobj()), true);
+ }
+ else
+ {
+ // std::cerr << "vtype=" << v.get_type_string() << std::endl;
+ throw std::bad_cast();
+ }
+}
+
/*--------------------Variant<Glib::DBusObjectPathString>---------------------*/
Variant<Glib::DBusObjectPathString>::Variant() : VariantStringBase()
return result;
}
+// Variant<std::string> makes sense for multiple types.
+// See http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-string
+template <>
+Variant<std::string>
+VariantBase::cast_dynamic<Variant<std::string>>(const VariantBase& v)
+{
+ if (!v.gobj())
+ {
+ return Variant<std::string>();
+ }
+
+ const VariantType vtype = v.get_type();
+ if (vtype.equal(VARIANT_TYPE_STRING) || vtype.equal(VARIANT_TYPE_BYTESTRING) ||
+ vtype.equal(VARIANT_TYPE_OBJECT_PATH) || vtype.equal(VARIANT_TYPE_SIGNATURE))
+ {
+ return Variant<std::string>(const_cast<GVariant*>(v.gobj()), true);
+ }
+ else
+ {
+ // std::cerr << "vtype=" << v.get_type_string() << std::endl;
+ throw std::bad_cast();
+ }
+}
+
std::string
Variant<std::string>::get() const
{
return VariantContainerBase::get_iter(variant_type());
}
+/*---------------------Value<Glib::VariantBase>---------------------*/
+
+void Value<VariantBase>::set(CppType data)
+{
+ set_variant(data.gobj());
+}
+
+Value<VariantBase>::CppType Value<VariantBase>::get() const
+{
+ return CppType(get_variant(), true);
+}
+
} // namespace Glib
#include <tuple>
#include <stdexcept>
#include <typeinfo>
+#include <cstddef>
namespace Glib
{
g_variant_get, g_variant_get_va)
public:
+_DEPRECATE_IFDEF_START
+ /** This typedef is just to make it more obvious that
+ * our operator const void* should be used like operator bool().
+ *
+ * @deprecated Use the explicit operator bool() instead.
+ */
+ using BoolExpr = const void*;
+
+ /** Test whether the Variant has an underlying instance.
+ *
+ * Mimics usage of pointers:
+ * @code
+ * if (variant)
+ * do_something();
+ * @endcode
+ *
+ * @deprecated Use the explicit operator bool() instead.
+ *
+ * @newin{2,36}
+ */
+ operator BoolExpr() const;
+_DEPRECATE_IFDEF_END
+
/** Test whether the Variant has an underlying instance.
*
* @newin{2,50}
_WRAP_METHOD(GVariantClass classify() const, g_variant_classify)
_WRAP_METHOD(gsize get_size() const, g_variant_get_size)
+ _WRAP_METHOD(gconstpointer get_data(), g_variant_get_data, deprecated "Use the const version instead.")
_WRAP_METHOD(gconstpointer get_data() const, g_variant_get_data, newin "2,46")
_WRAP_METHOD(Glib::RefPtr<const Glib::Bytes> get_data_as_bytes() const, g_variant_get_data_as_bytes, newin "2,46")
_WRAP_METHOD(void store(gpointer data) const, g_variant_store)
*/
_WRAP_METHOD(bool equal(const VariantBase& other) const, g_variant_equal)
- /** Checks if @a *this and @a other have the same type and value.
- *
- * @newin{2,58}
- *
- * @param other The Variant to compare with.
- * @return <tt>true</tt> if @a *this and @a other are equal.
- */
- bool operator==(const VariantBase& other) const;
-
- /** Checks if @a *this and @a other have the same type and value.
- *
- * @newin{2,58}
- *
- * @param other The Variant to compare with.
- * @return <tt>true</tt> if @a *this and @a other are not equal.
- */
- bool operator!=(const VariantBase& other) const;
-
- /** Ordering relational operators.
- * These are explicitly deleted to prevent the compiler from generating
- * error messages containing long lists of operators that can't be used.
- */
- bool operator<(const VariantBase& other) const = delete;
-
- /// See operator<().
- bool operator<=(const VariantBase& other) const = delete;
-
- /// See operator<().
- bool operator>(const VariantBase& other) const = delete;
-
- /// See operator<().
- bool operator>=(const VariantBase& other) const = delete;
-
/** Gets a VariantBase instance that has the same value as this variant and
* is trusted to be in normal form.
*
*/
bool is_castable_to(const VariantType& supertype) const;
#endif //DOXYGEN_SHOULD_SKIP_THIS
+
+private:
+ /** Relational operators are deleted to prevent invalid conversion
+ * to const void*.
+ */
+ bool operator<(const VariantBase& src) const;
+
+ /// See operator<().
+ bool operator<=(const VariantBase& src) const;
+
+ /// See operator<().
+ bool operator>(const VariantBase& src) const;
+
+ /// See operator<().
+ bool operator>=(const VariantBase& src) const;
+
+ /// See operator<().
+ bool operator==(const VariantBase& src) const;
+
+ /// See operator<().
+ bool operator!=(const VariantBase& src) const;
};
template<class V_CastTo>
_IGNORE(g_variant_get_string, g_variant_dup_string)
};
+//TODO: When we can break ABI, remove this template specialization.
+template<>
+Variant<Glib::ustring> VariantBase::cast_dynamic< Variant<Glib::ustring> >(const VariantBase& v);
+
/** Specialization of Variant containing a Glib::DBusObjectPathString,
* for variants of type object path.
* @newin{2,54}
_IGNORE(g_variant_get_bytestring, g_variant_dup_bytestring)
};
+//TODO: When we can break ABI, remove this template specialization.
+template<>
+Variant<std::string> VariantBase::cast_dynamic< Variant<std::string> >(const VariantBase& v);
+
/** Specialization of Variant containing a dictionary entry. See also
* Variant< std::map<K, V> >.
* @newin{2,28}
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace detail
{
+// std::index_sequence and std::index_sequence_for are new in C++14,
+// but this version of glibmm requires only C++11.
+// The following code replaces std::index_sequence and std::index_sequence_for
+// until we can require C++14 support.
+// See https://bugzilla.gnome.org/show_bug.cgi?id=787648
+
+ /// Class template integer_sequence
+ template<typename T, T... Idx>
+ struct integer_sequence
+ {
+ typedef T value_type;
+ static constexpr std::size_t size() { return sizeof...(Idx); }
+ };
+
+ // Concatenates two integer_sequences.
+ template<typename Iseq1, typename Iseq2> struct iseq_cat;
+
+ template<typename T, std::size_t... Ind1, std::size_t... Ind2>
+ struct iseq_cat<integer_sequence<T, Ind1...>, integer_sequence<T, Ind2...>>
+ {
+ using type = integer_sequence<T, Ind1..., (Ind2 + sizeof...(Ind1))...>;
+ };
+
+ // Builds an integer_sequence<T, 0, 1, 2, ..., Num-1>.
+ template<typename T, std::size_t Num>
+ struct make_intseq
+ : iseq_cat<typename make_intseq<T, Num / 2>::type,
+ typename make_intseq<T, Num - Num / 2>::type>
+ { };
+
+ template<typename T>
+ struct make_intseq<T, 1>
+ {
+ typedef integer_sequence<T, 0> type;
+ };
+
+ template<typename T>
+ struct make_intseq<T, 0>
+ {
+ typedef integer_sequence<T> type;
+ };
+
+ /// Alias template make_integer_sequence
+ template<typename T, T Num>
+ using make_integer_sequence = typename make_intseq<T, Num>::type;
+
+ /// Alias template index_sequence
+ template<std::size_t... Idx>
+ using index_sequence = integer_sequence<std::size_t, Idx...>;
+
+ /// Alias template make_index_sequence
+ template<std::size_t Num>
+ using make_index_sequence = make_integer_sequence<std::size_t, Num>;
+
+ /// Alias template index_sequence_for
+ template<typename... Types>
+ using index_sequence_for = make_index_sequence<sizeof...(Types)>;
+
+// End of code that replaces std::index_sequence and std::index_sequence_for
+
template <class Tuple, std::size_t... Is>
void expand_tuple(std::vector<VariantBase> &variants, const Tuple & t,
- std::index_sequence<Is...>)
+ detail::index_sequence<Is...>)
{
using swallow = int[]; // ensures left to right order
auto expander = [&variants](const VariantBase &variant) -> int
{
// create a vector containing all tuple values as variants
std::vector<Glib::VariantBase> variants;
- detail::expand_tuple(variants, data, std::index_sequence_for<Types...>{});
+ detail::expand_tuple(variants, data, detail::index_sequence_for<Types...>{});
using var_ptr = GVariant*;
var_ptr* const var_array = new var_ptr[sizeof... (Types)];
{
// swallows any argument
template <class T>
-constexpr int any_arg(T&& arg)
+constexpr int any_arg(T&& /* arg */)
{
- (void)arg;
return 0;
}
template <class Tuple, std::size_t... Is>
-void assign_tuple(std::vector<VariantBase> &variants, Tuple & t, std::index_sequence<Is...>)
+void assign_tuple(std::vector<VariantBase> &variants, Tuple & t, detail::index_sequence<Is...>)
{
int i = 0;
using swallow = int[]; // ensures left to right order
return i++;
};
(void)swallow{(expander(get_child_variant<Types>(i)))...};
- detail::assign_tuple(variants, data, std::index_sequence_for<Types...>{});
+ detail::assign_tuple(variants, data, detail::index_sequence_for<Types...>{});
return data;
}
return VariantContainerBase::get_iter(type);
}
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+// This is needed so Glib::VariantBase can be used with
+// Glib::Value and _WRAP_PROPERTY in Gio::Action and elsewhere.
+template <>
+class Value<Glib::VariantBase> : public ValueBase_Variant
+{
+public:
+ using CppType = Glib::VariantBase;
+
+ void set(CppType data);
+ CppType get() const;
+};
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
} // namespace Glib
namespace Glib
{
-VariantIter::VariantIter(const VariantContainerBase& variant)
+VariantIter::VariantIter(const VariantBase& variant)
: gobject_(g_variant_iter_new(const_cast<GVariant*>(variant.gobj())))
{
}
//because g_iter_value_get_next_value() both gets a value and changes the iterator.
//GtkTextIter allows us to go forward and then separately get the current value.
/** VariantIter - An opaque data structure used to iterate through
- * VariantContainerBase containers such as arrays.
+ * VariantBase containers such as arrays.
* @newin{2,28}
*/
class VariantIter
_CLASS_OPAQUE_COPYABLE(VariantIter, GVariantIter, NONE, g_variant_iter_copy, g_variant_iter_free)
_IGNORE(g_variant_iter_copy, g_variant_iter_free)
public:
- explicit VariantIter(const VariantContainerBase& variant);
+ //TODO: The variant parameter should be a VariantContainerBase.
+ explicit VariantIter(const VariantBase& variant);
_WRAP_METHOD(gsize init(const VariantContainerBase& value), g_variant_iter_init)
return result;
}
+// Glib::Value<Glib::VariantType>
+GType Value<VariantType>::value_type()
+{
+ // The type function is *not* called g_variant_type_get_type().
+ // Use the macro in order to avoid using the non-standard function name here.
+ return G_TYPE_VARIANT_TYPE;
+}
+
+void Value<VariantType>::set(const CppType& data)
+{
+ set_boxed(data.gobj());
+}
+
+Value<VariantType>::CppType Value<VariantType>::get() const
+{
+ return Glib::wrap(static_cast<CType>(get_boxed()), true);
+}
+
} // namespace GLib
#include <glibmmconfig.h>
#include <glib-object.h> //For gsize
+#include <glibmm/value.h>
#include <string>
#include <vector>
_WRAP_METHOD(static VariantType create_dict_entry(const VariantType& key, const VariantType& value), g_variant_type_new_dict_entry)
- _WRAP_METHOD(gsize get_string_length() const, g_variant_type_get_string_length)
- dnl// wrapped by hand, because g_variant_type_peek_string does not return a nul-terminated C string.
+ //TODO: Use something instead of gsize?
+ _WRAP_METHOD(gsize _get_string_length() const, g_variant_type_get_string_length)
+ dnl wrapped by hand, because g_variant_type_peek_string does not return a C string.
_WRAP_METHOD_DOCS_ONLY(g_variant_type_peek_string)
std::string get_string() const;
_IGNORE(g_variant_type_dup_string)
// g_variant_type_value() because they don't do that already.
#m4 _CONVERSION(`const GVariantType*',`VariantType',`Glib::wrap(const_cast<GVariantType*>($3), true)')
_WRAP_METHOD(VariantType element() const, g_variant_type_element)
+ _WRAP_METHOD(VariantType first() const, g_variant_type_first, deprecated "Use get_item_types() instead.")
+ _WRAP_METHOD(VariantType next () const, g_variant_type_next, deprecated "Use get_item_types() instead.")
_WRAP_METHOD(gsize n_items() const, g_variant_type_n_items)
_WRAP_METHOD(VariantType key() const, g_variant_type_key)
_WRAP_METHOD(VariantType value() const, g_variant_type_value)
* @return The item types of this %VariantType, or an empty vector.
*/
std::vector<VariantType> get_item_types() const;
- _IGNORE(g_variant_type_first, g_variant_type_next)
// This function is part of unexposed API in gvarianttypeinfo.{h,c} for an
// also unexposed GVariantTypeInfo structure of glib.
extern const VariantType VARIANT_TYPE_BYTESTRING_ARRAY;
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+// This is needed so Glib::VariantType can be used with
+// Glib::Value and _WRAP_PROPERTY in Gio::Action and elsewhere.
+template <>
+class Value<Glib::VariantType> : public ValueBase_Boxed
+{
+public:
+ using CppType = Glib::VariantType;
+ using CType = GVariantType*;
+ static GType value_type();
+
+ void set(const CppType& data);
+ CppType get() const;
+};
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
} // namespace Glib
giomm_ioerror_and_iodbuserror/test \
giomm_memoryinputstream/test \
giomm_simple/test \
- giomm_stream_vfuncs/test \
giomm_asyncresult_sourceobject/test \
giomm_tls_client/test \
giomm_listmodel/test \
glibmm_interface_move/test \
glibmm_mainloop/test \
glibmm_nodetree/test \
- glibmm_object/test \
glibmm_object_move/test \
- glibmm_objectbase/test \
glibmm_objectbase_move/test \
glibmm_ustring_compose/test \
glibmm_ustring_format/test \
glibmm_value/test \
+ glibmm_valuearray/test \
glibmm_variant/test \
glibmm_vector/test \
glibmm_bool_vector/test \
+ glibmm_bool_arrayhandle/test \
glibmm_null_vectorutils/test \
+ glibmm_null_containerhandle/test \
glibmm_refptr/test \
glibmm_refptr_sigc_bind/test \
- glibmm_bytearray/test \
- glibmm_ustring_make_valid/test
+ glibmm_weakref/test \
+ glibmm_bytearray/test
TESTS = $(check_PROGRAMS)
giomm_simple_test_SOURCES = giomm_simple/main.cc
giomm_simple_test_LDADD = $(giomm_ldadd)
-giomm_stream_vfuncs_test_SOURCES = giomm_stream_vfuncs/main.cc
-giomm_stream_vfuncs_test_LDADD = $(giomm_ldadd)
-
giomm_asyncresult_sourceobject_test_SOURCES = giomm_asyncresult_sourceobject/main.cc
giomm_asyncresult_sourceobject_test_LDADD = $(giomm_ldadd)
glibmm_interface_move_test_SOURCES = glibmm_interface_move/main.cc
glibmm_mainloop_test_SOURCES = glibmm_mainloop/main.cc
glibmm_nodetree_test_SOURCES = glibmm_nodetree/main.cc
-glibmm_object_test_SOURCES = glibmm_object/main.cc \
- glibmm_object/test_derived_object.h
-glibmm_object_move_test_SOURCES = glibmm_object_move/main.cc \
- glibmm_object/test_derived_object.h
-glibmm_objectbase_test_SOURCES = glibmm_objectbase/main.cc \
- glibmm_objectbase/test_derived_objectbase.h \
- glibmm_object/test_derived_object.h
-glibmm_objectbase_move_test_SOURCES = glibmm_objectbase_move/main.cc \
- glibmm_objectbase/test_derived_objectbase.h \
- glibmm_object/test_derived_object.h
+glibmm_object_move_test_SOURCES = glibmm_object_move/main.cc
+glibmm_objectbase_move_test_SOURCES = glibmm_objectbase_move/main.cc
glibmm_ustring_compose_test_SOURCES = glibmm_ustring_compose/main.cc
glibmm_ustring_format_test_SOURCES = glibmm_ustring_format/main.cc
-glibmm_value_test_SOURCES = glibmm_value/main.cc
+glibmm_value_test_SOURCES = glibmm_value/glibmm_value.cc glibmm_value/main.cc
+glibmm_valuearray_test_SOURCES = glibmm_valuearray/main.cc
glibmm_variant_test_SOURCES = glibmm_variant/main.cc
glibmm_vector_test_SOURCES = glibmm_vector/main.cc
glibmm_vector_test_LDADD = $(giomm_ldadd)
glibmm_bool_vector_test_SOURCES = glibmm_bool_vector/main.cc
+glibmm_bool_arrayhandle_test_SOURCES = glibmm_bool_arrayhandle/main.cc
glibmm_null_vectorutils_test_SOURCES = glibmm_null_vectorutils/main.cc
glibmm_null_vectorutils_test_LDADD = $(giomm_ldadd)
+glibmm_null_containerhandle_test_SOURCES = glibmm_null_containerhandle/main.cc
+glibmm_null_containerhandle_test_LDADD = $(giomm_ldadd)
glibmm_refptr_test_SOURCES = glibmm_refptr/main.cc
glibmm_refptr_sigc_bind_test_SOURCES = glibmm_refptr_sigc_bind/main.cc
+glibmm_weakref_test_SOURCES = glibmm_weakref/main.cc
+glibmm_weakref_test_LDADD = $(giomm_ldadd)
glibmm_bytearray_test_SOURCES = glibmm_bytearray/main.cc
-glibmm_ustring_make_valid_test_SOURCES = glibmm_ustring_make_valid/main.cc
#include <giomm.h>
#include <iostream>
+#include <typeinfo>
void
on_read_async(const Glib::RefPtr<Gio::AsyncResult>& result)
exit(EXIT_FAILURE);
}
- if (!g_async_result_get_source_object(result->gobj()))
+ auto cobj = g_async_result_get_source_object(result->gobj());
+ if (!cobj)
{
std::cerr << G_STRFUNC << ": g_async_result_get_source_object() failed." << std::endl;
exit(EXIT_FAILURE);
}
+ // Show why Glib::wrap(cobj) can't be used in Gio::AsyncResult::get_source_object_base().
+ // cppobjbase is not a Glib::Object*, it's a Gio::File* which is a Glib::Interface*.
+ std::cout << "GType name: " << G_OBJECT_TYPE_NAME(cobj) << std::endl;
+ auto cppobjbase = Glib::wrap_auto(cobj); // Glib::ObjectBase::_get_current_wrapper(cobj);
+ if (cppobjbase)
+ {
+ std::cout << "C++ type name: " << typeid(*cppobjbase).name() << std::endl;
+ auto cppobj = dynamic_cast<Glib::Object*>(cppobjbase); // Part of Glib::wrap(GObject*, bool)
+ auto cppiface = dynamic_cast<Glib::Interface*>(cppobjbase);
+ std::cout << "dynamic_cast<Glib::Object*>: " << cppobj << std::endl;
+ std::cout << "dynamic_cast<Glib::Interface*>: " << cppiface << std::endl;
+ }
+
if (!result->get_source_object_base())
{
std::cerr << G_STRFUNC << ": result->get_source_object_base() failed." << std::endl;
{
auto store = Gio::ListStore<Gio::MenuItem>::create();
auto item = Gio::MenuItem::create("", "");
- std::weak_ptr<Gio::MenuItem> weakref_item = item;
+ auto weakref_item = Glib::WeakRef<Gio::MenuItem>(item);
// Remove an item from an empty list.
store->remove(0);
store.reset();
item.reset();
- if (weakref_item.lock())
+ if (weakref_item)
{
result = EXIT_FAILURE;
std::cerr << "test_store_boundaries(), 10: weakref_item is not null" << std::endl;
const std::size_t n_items = 10;
std::vector<Glib::RefPtr<Gio::MenuItem>> items;
- std::vector<std::weak_ptr<Gio::MenuItem>> weakref_items;
+ std::vector<Glib::WeakRef<Gio::MenuItem>> weakref_items;
for (std::size_t i = 0; i < n_items; ++i)
{
items.push_back(Gio::MenuItem::create("", ""));
- weakref_items.emplace_back(items[i]);
+ weakref_items.push_back(Glib::WeakRef<Gio::MenuItem>(items[i]));
store->append(items[i]);
}
check_store_refcounts_n_items(2, store, n_items);
- if (store->get_item(3).get() != items[3].get())
+ if (store->get_item(3).operator->() != items[3].operator->())
{
result = EXIT_FAILURE;
std::cerr << "test_store_refcounts(), 3: get_item(3) != items[3]" << std::endl;
for (std::size_t i = 0; i < n_items; ++i)
{
items[i].reset();
+ if (!weakref_items[i])
+ {
+ result = EXIT_FAILURE;
+ std::cerr << "test_store_refcounts(), 4: weakref_items[" << i << "] is null" << std::endl;
+ }
}
store->remove(4);
+ if (weakref_items[4])
+ {
+ result = EXIT_FAILURE;
+ std::cerr << "test_store_refcounts(), 5: weakref_items[4] is not null" << std::endl;
+ }
check_store_refcounts_n_items(6, store, n_items-1);
store.reset();
for (std::size_t i = 0; i < n_items; ++i)
{
- if (weakref_items[i].lock())
+ if (weakref_items[i])
{
result = EXIT_FAILURE;
std::cerr << "test_store_refcounts(), 7: weakref_items[" << i << "] is not null" << std::endl;
int compare_items1(const Glib::RefPtr<const Glib::Object>& a,
const Glib::RefPtr<const Glib::Object>& b)
{
- const auto action_a = std::dynamic_pointer_cast<const Gio::SimpleAction>(a);
- const auto action_b = std::dynamic_pointer_cast<const Gio::SimpleAction>(b);
+ const auto action_a = Glib::RefPtr<const Gio::SimpleAction>::cast_dynamic(a);
+ const auto action_b = Glib::RefPtr<const Gio::SimpleAction>::cast_dynamic(b);
if (!action_a || !action_b)
{
result = EXIT_FAILURE;
result = EXIT_FAILURE;
std::cerr << "test_store_sorted1(), 2: i=" << i << ", items are not equal" << std::endl;
}
- if (a.get() == b.get())
+ if (a.operator->() == b.operator->())
{
result = EXIT_FAILURE;
std::cerr << "test_store_sorted1(), 3: i=" << i << ", items are the same" << std::endl;
if (i > 0)
{
auto c = store->get_item(i * 2 - 1);
- if (c.get() == a.get() || c.get() == b.get())
+ if (c.operator->() == a.operator->() || c.operator->() == b.operator->())
{
result = EXIT_FAILURE;
std::cerr << "test_store_sorted1(), 4: i=" << i << ", items are the same" << std::endl;
class MyObject : public Glib::Object
{
protected:
- explicit MyObject(int id) : m_id(id) {}
+ MyObject(int id) : m_id(id) {}
public:
static Glib::RefPtr<MyObject> create(int id)
{
- return Glib::make_refptr_for_instance<MyObject>(new MyObject(id));
+ return Glib::RefPtr<MyObject>(new MyObject(id));
}
int get_id() const { return m_id; }
result = EXIT_FAILURE;
std::cerr << "test_store_sorted2(), 2: i=" << i << ", items are not equal" << std::endl;
}
- if (a.get() == b.get())
+ if (a.operator->() == b.operator->())
{
result = EXIT_FAILURE;
std::cerr << "test_store_sorted2(), 3: i=" << i << ", items are the same" << std::endl;
if (i > 0)
{
auto c = store->get_item(i * 2 - 1);
- if (c.get() == a.get() || c.get() == b.get())
+ if (c.operator->() == a.operator->() || c.operator->() == b.operator->())
{
result = EXIT_FAILURE;
std::cerr << "test_store_sorted2(), 4: i=" << i << ", items are the same" << std::endl;
+++ /dev/null
-/* Copyright (C) 2016 The giomm Development Team
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include <giomm.h>
-#include <iostream>
-#include <string>
-#include <cstdlib>
-
-// A simple custom stream that base64 encodes data.
-// Do not copy it to your code, because it's very slow.
-class Base64OutputStream : public Gio::FilterOutputStream
-{
-public:
- unsigned get_column_width() const { return column_width; }
- void set_column_width(unsigned cw) { column_width = cw; }
- static Glib::RefPtr<Base64OutputStream> create(const Glib::RefPtr<OutputStream>& base_stream)
- {
- return Glib::make_refptr_for_instance<Base64OutputStream>(new Base64OutputStream(base_stream));
- }
-
-protected:
- explicit Base64OutputStream(const Glib::RefPtr<Gio::OutputStream>& base_stream)
- : Gio::FilterOutputStream(base_stream), column(0), bit_count(0), bit_buffer(0), column_width(72) {}
-
- gssize write_vfunc(const void* buffer, gsize count, const Glib::RefPtr<Gio::Cancellable>& cancellable) override
- {
- char const *byte = (char const *) buffer;
- for (unsigned i = 0; i < count; ++i, ++byte)
- {
- // kindergarten implementation, because the object is not performance :)
- bit_buffer <<= 8;
- bit_buffer |= (*byte & 0xff);
- bit_count += 8;
-
- if (bit_count == 24)
- {
- clear_pending(); // TODO why is this necessary to avoid an outstanding op. exception?
- flush(cancellable);
- set_pending();
- bit_count = 0;
- }
-
- if (cancellable && cancellable->is_cancelled())
- throw Gio::Error(Gio::Error::CANCELLED, "Operation cancelled");
- }
- return count;
- }
-
- bool flush_vfunc(const Glib::RefPtr<Gio::Cancellable>& cancellable) override
- {
- if (bit_count != 24)
- return true;
- char to_write[5];
- gsize len = 4;
-
- for (unsigned i=0; i<4; ++i)
- {
- unsigned index = (bit_buffer & (0x3f<<(i*6))) >> (i*6);
- to_write[3-i] = base64_encode_str[index];
- }
- column += 4;
- // Yes, I know this is completely wrong.
- if (column >= column_width)
- {
- column = 0;
- to_write[4] = '\n';
- ++len;
- }
-
- get_base_stream()->write(&to_write, len, cancellable);
-
- bit_count = 0;
- bit_buffer = 0;
-
- return true;
- }
-
- bool close_vfunc(const Glib::RefPtr<Gio::Cancellable>& cancellable) override
- {
- char to_write[5] = "====";
- //get any last bytes (1 or 2) out of the buffer
- switch (bit_count)
- {
- case 16:
- bit_buffer <<= 2; //pad to make 18 bits
- to_write[0] = base64_encode_str[(bit_buffer & (0x3f << 12)) >> 12];
- to_write[1] = base64_encode_str[(bit_buffer & (0x3f << 6)) >> 6];
- to_write[2] = base64_encode_str[bit_buffer & 0x3f];
- break;
-
- case 8:
- bit_buffer <<= 4; //pad to make 12 bits
- to_write[0] = base64_encode_str[(bit_buffer & (0x3f << 6)) >> 6];
- to_write[1] = base64_encode_str[bit_buffer & 0x3f];
- break;
- }
-
- if (bit_count > 0)
- {
- get_base_stream()->write(&to_write, 5, cancellable);
- }
- else
- {
- // null terminate output
- get_base_stream()->write("", 1, cancellable);
- }
- if (get_close_base_stream())
- get_base_stream()->close(cancellable);
-
- return true;
- }
-
-private:
- static char const *const base64_encode_str;
- unsigned column;
- unsigned bit_count;
- unsigned bit_buffer;
- unsigned column_width;
-};
-
-char const *const Base64OutputStream::base64_encode_str = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-
-int main(int, char**)
-{
- Glib::init();
- Gio::init();
-
- try
- {
- char result[256];
- Glib::RefPtr<Gio::MemoryOutputStream> memory_chunk = Gio::MemoryOutputStream::create(result, 256, nullptr, nullptr);
- Glib::RefPtr<Base64OutputStream> base64 = Base64OutputStream::create(memory_chunk);
-
- std::string data = "Custom GIO streams are cool!";
-
- base64->set_close_base_stream(true);
- base64->write(data);
- base64->close();
-
- const std::string base64_should_be("Q3VzdG9tIEdJTyBzdHJlYW1zIGFyZSBjb29sIQ==");
- std::cout << "Original data: " << data << std::endl;
- std::cout << "base64-encoded data: " << result << std::endl;
- std::cout << "base64 should be: " << base64_should_be << std::endl;
- if (base64_should_be != result)
- {
- std::cout << "Not correct!" << std::endl;
- return EXIT_FAILURE;
- }
- }
- catch (const Gio::Error& e)
- {
- std::cout << "Gio error: " << e.what() << std::endl;
- return EXIT_FAILURE;
- }
-
- return EXIT_SUCCESS;
-}
<< std::endl;
auto socket = Gio::Socket::create(
- first_inet_address->get_family(), Gio::Socket::Type::STREAM, Gio::Socket::Protocol::TCP);
+ first_inet_address->get_family(), Gio::SOCKET_TYPE_STREAM, Gio::SOCKET_PROTOCOL_TCP);
auto address = Gio::InetSocketAddress::create(first_inet_address, 443);
<< address->get_port() << "." << std::endl;
}
- auto conn = std::dynamic_pointer_cast<Gio::TcpConnection>(Gio::SocketConnection::create(socket));
+ auto conn = Glib::RefPtr<Gio::TcpConnection>::cast_dynamic(Gio::SocketConnection::create(socket));
if (!conn || !conn->is_connected())
{
{
auto tls_connection = Gio::TlsClientConnection::create(conn, address);
- tls_connection->signal_accept_certificate().connect(sigc::ptr_fun(&on_accept_certificate), false);
+ tls_connection->signal_accept_certificate().connect(sigc::ptr_fun(&on_accept_certificate));
tls_connection->handshake();
--- /dev/null
+/* Copyright (C) 2011 The glibmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+#include <cstdlib>
+#include <ctime>
+
+#include <iostream>
+
+#include <glibmm.h>
+
+// Use this line if you want debug output:
+// std::ostream& ostr = std::cout;
+
+// This seems nicer and more useful than putting an ifdef around the use of std::cout:
+std::stringstream debug;
+std::ostream& ostr = debug;
+
+const unsigned int magic_limit(5);
+
+void
+setup_rand()
+{
+ static bool setup(false);
+
+ if (!setup)
+ {
+ std::srand(std::time(nullptr));
+ setup = true;
+ }
+}
+
+gboolean*
+c_get_bool_array()
+{
+ gboolean* array(static_cast<gboolean*>(g_malloc((magic_limit + 1) * sizeof(gboolean))));
+
+ setup_rand();
+ for (unsigned int iter(0); iter < magic_limit; ++iter)
+ {
+ array[iter] = std::rand() % 2 ? TRUE : FALSE;
+ }
+ array[magic_limit] = FALSE;
+ return array;
+}
+
+void
+c_print_bool_array(gboolean* array)
+{
+ for (unsigned int iter(0); iter < magic_limit; ++iter)
+ {
+ ostr << iter << ": " << (array[iter] ? "TRUE" : "FALSE") << "\n";
+ }
+}
+
+Glib::ArrayHandle<bool>
+cxx_get_bool_array()
+{
+ return Glib::ArrayHandle<bool>(c_get_bool_array(), magic_limit, Glib::OWNERSHIP_SHALLOW);
+}
+
+void
+cxx_print_bool_array(const Glib::ArrayHandle<bool>& array)
+{
+ c_print_bool_array(const_cast<gboolean*>(array.data()));
+}
+
+int
+main()
+{
+ Glib::init();
+
+ std::vector<bool> v(cxx_get_bool_array());
+ std::list<bool> l(cxx_get_bool_array());
+ std::deque<bool> d(cxx_get_bool_array());
+
+ ostr << "vector:\n";
+ cxx_print_bool_array(v);
+ ostr << "list:\n";
+ cxx_print_bool_array(l);
+ ostr << "deque:\n";
+ cxx_print_bool_array(d);
+
+ return EXIT_SUCCESS;
+}
date.subtract_days(1);
date.add_years(1);
- ostr << "The date a year and a month from yesterday will be: " << date.get_month_as_int() << "/"
+ ostr << "The date a year and a month from yesterday will be: " << date.get_month() << "/"
<< (int)date.get_day() << "/" << date.get_year() << "." << std::endl;
Glib::Date copy_date(date);
assigned_date = copy_date;
- ostr << "The copied date is: " << copy_date.get_month_as_int() << "/" << (int)copy_date.get_day() << "/"
+ ostr << "The copied date is: " << copy_date.get_month() << "/" << (int)copy_date.get_day() << "/"
<< copy_date.get_year() << "." << std::endl;
return EXIT_SUCCESS;
protected:
using CppClassType = TestInterface_Class;
- TestInterface() : Glib::Interface(derived_interface_class_.init()), i_(0) {}
+ TestInterface() : Glib::Interface(derived_interface_class_.init()) {}
public:
// A real application would never make the constructor public.
// A real application would never make the constructor public.
// It would instead have a protected constructor and a public create() method.
- explicit DerivedObject(int i)
+ DerivedObject(int i)
: Glib::ObjectBase(nullptr),
Glib::Object(Glib::ConstructParams(derived_object_class_.init())),
i_(i)
int
main()
{
+ std::list<std::string> alma;
std::string tstring, cstring;
type_nodetree_string* root;
type_nodetree_string* node;
g_assert(root->depth() == 1);
g_assert(root->get_max_height() == 4);
g_assert(node_G->first_child()->next_sibling()->depth() == 4);
- g_assert(root->node_count(type_nodetree_string::TraverseFlags::LEAVES) == 7);
- g_assert(root->node_count(type_nodetree_string::TraverseFlags::NON_LEAVES) == 4);
- g_assert(root->node_count(type_nodetree_string::TraverseFlags::ALL) == 11);
+ g_assert(root->node_count(type_nodetree_string::TRAVERSE_LEAVES) == 7);
+ g_assert(root->node_count(type_nodetree_string::TRAVERSE_NON_LEAVES) == 4);
+ g_assert(root->node_count(type_nodetree_string::TRAVERSE_ALL) == 11);
g_assert(node_F->get_max_height() == 3);
g_assert(node_G->child_count() == 4);
- g_assert(root->find_child("F", type_nodetree_string::TraverseFlags::ALL) == node_F);
+ g_assert(root->find_child("F", type_nodetree_string::TRAVERSE_ALL) == node_F);
g_assert(
- root->find("I", type_nodetree_string::TraverseType::LEVEL_ORDER, type_nodetree_string::TraverseFlags::NON_LEAVES) == NULL);
+ root->find("I", Glib::TRAVERSE_LEVEL_ORDER, type_nodetree_string::TRAVERSE_NON_LEAVES) == NULL);
g_assert(
- root->find("J", type_nodetree_string::TraverseType::IN_ORDER, type_nodetree_string::TraverseFlags::LEAVES) == node_J);
+ root->find("J", Glib::TRAVERSE_IN_ORDER, type_nodetree_string::TRAVERSE_LEAVES) == node_J);
for (guint i = 0; i < node_B->child_count(); i++)
{
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::PRE_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_PRE_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == "ABCDEFGHIJK");
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::POST_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_POST_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == "CDEBHIJKGFA");
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::IN_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_IN_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == "CBDEAHGIJKF");
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::LEVEL_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_LEVEL_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == "ABFCDEGHIJK");
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::LEVEL_ORDER, type_nodetree_string::TraverseFlags::LEAVES, -1);
+ Glib::TRAVERSE_LEVEL_ORDER, type_nodetree_string::TRAVERSE_LEAVES, -1);
g_assert(tstring == "CDEHIJK");
tstring.clear();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::PRE_ORDER, type_nodetree_string::TraverseFlags::NON_LEAVES, -1);
+ Glib::TRAVERSE_PRE_ORDER, type_nodetree_string::TRAVERSE_NON_LEAVES, -1);
g_assert(tstring == "ABFG");
tstring.clear();
node_G->reverse_children();
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::LEVEL_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_LEVEL_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == "ABFEDCGKJIH");
tstring.clear();
node = new type_nodetree_string(*root); // A deep copy.
- g_assert(root->node_count(type_nodetree_string::TraverseFlags::ALL) ==
- node->node_count(type_nodetree_string::TraverseFlags::ALL));
+ g_assert(root->node_count(type_nodetree_string::TRAVERSE_ALL) ==
+ node->node_count(type_nodetree_string::TRAVERSE_ALL));
g_assert(root->get_max_height() == node->get_max_height());
root->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(tstring)),
- type_nodetree_string::TraverseType::IN_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_IN_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
node->traverse(sigc::bind(sigc::ptr_fun(node_build_string), std::ref(cstring)),
- type_nodetree_string::TraverseType::IN_ORDER, type_nodetree_string::TraverseFlags::ALL, -1);
+ Glib::TRAVERSE_IN_ORDER, type_nodetree_string::TRAVERSE_ALL, -1);
g_assert(tstring == cstring);
delete node;
node = node->first_child()->next_sibling();
}
g_assert(root->get_max_height() > 100);
- g_assert(root->node_count(type_nodetree_string::TraverseFlags::ALL) == 1 + 2048);
+ g_assert(root->node_count(type_nodetree_string::TRAVERSE_ALL) == 1 + 2048);
delete root;
--- /dev/null
+/* Copyright (C) 2011 The gtkmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <glibmm/arrayhandle.h>
+#include <glibmm/listhandle.h>
+#include <glibmm/slisthandle.h>
+
+#include <giomm/credentials.h>
+#include <giomm/init.h>
+
+int
+main()
+{
+ Gio::init();
+ using CrePtr = Glib::RefPtr<Gio::Credentials>;
+
+ std::vector<CrePtr> v1(Glib::ArrayHandle<CrePtr>(nullptr, Glib::OWNERSHIP_DEEP));
+ std::vector<CrePtr> v2(Glib::ArrayHandle<CrePtr>(nullptr, 5, Glib::OWNERSHIP_DEEP));
+ std::vector<CrePtr> v3(Glib::ListHandle<CrePtr>(nullptr, Glib::OWNERSHIP_DEEP));
+ std::vector<CrePtr> v4(Glib::SListHandle<CrePtr>(nullptr, Glib::OWNERSHIP_DEEP));
+ std::vector<bool> v5(Glib::ArrayHandle<bool>(nullptr, Glib::OWNERSHIP_DEEP));
+ std::vector<bool> v6(Glib::ArrayHandle<bool>(nullptr, 5, Glib::OWNERSHIP_DEEP));
+
+ if (v1.empty() && v2.empty() && v3.empty() && v4.empty() && v5.empty() && v6.empty())
+ {
+ return 0;
+ }
+ return 1;
+}
+++ /dev/null
-#include "test_derived_object.h"
-#include <glibmm.h>
-#include <iostream>
-#include <stdlib.h>
-
-static void
-test_object()
-{
- GObject* gobject = G_OBJECT(g_object_new(TEST_TYPE_DERIVED, nullptr));
- DerivedObject derived(gobject, 5);
- // std::cout << "debug: gobj(): " << derived.gobj() << std::endl;
- g_assert(derived.gobj() == gobject);
-}
-
-int
-main(int, char**)
-{
- Glib::init();
-
- test_object();
-
- return EXIT_SUCCESS;
-}
+++ /dev/null
-#ifndef _GLIBMM_TEST_DERIVED_OBJECT_H
-#define _GLIBMM_TEST_DERIVED_OBJECT_H
-
-#include <glibmm.h>
-
-// A basic derived GObject, just to test Glib::Object.
-typedef struct
-{
- GObject parent;
-} TestDerived;
-
-typedef struct
-{
- GObjectClass parent;
-} TestDerivedClass;
-
-#define TEST_TYPE_DERIVED (test_derived_get_type())
-#define TEST_DERIVED(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), TEST_TYPE_DERIVED, TestDerived))
-#define TEST_DERIVED_CLASS(cls) \
- (G_TYPE_CHECK_CLASS_CAST((cls), TEST_TYPE_DERIVED, TestDerivedClass))
-#define TEST_DERIVED_GET_CLASS(obj) \
- (G_TYPE_INSTANCE_GET_CLASS((obj), TEST_TYPE_DERIVED, TestDerivedClass))
-
-static void
-test_derived_class_init(TestDerivedClass*)
-{
-}
-static void
-test_derived_init(TestDerived*)
-{
-}
-
-G_DEFINE_TYPE(TestDerived, test_derived, G_TYPE_OBJECT)
-
-class DerivedObject : public Glib::Object
-{
-public:
- // A real application would never make the constructor public.
- // It would instead have a protected constructor and a public create() method.
- DerivedObject(GObject* gobject, int i) : Glib::Object(gobject), i_(i) {}
-
- DerivedObject(const DerivedObject& src) = delete;
- DerivedObject& operator=(const DerivedObject& src) = delete;
-
- DerivedObject(DerivedObject&& src) noexcept : Glib::Object(std::move(src)), i_(std::move(src.i_))
- {
- }
-
- DerivedObject& operator=(DerivedObject&& src) noexcept
- {
- Glib::Object::operator=(std::move(src));
- i_ = std::move(src.i_);
-
- return *this;
- }
-
- int i_;
-};
-
-#endif // _GLIBMM_TEST_DERIVED_OBJECT_H
-#include "../glibmm_object/test_derived_object.h"
#include <glibmm.h>
#include <iostream>
#include <stdlib.h>
+// A basic derived GObject, just to test Glib::Object.
+typedef struct
+{
+ GObject parent;
+} TestDerived;
+
+typedef struct
+{
+ GObjectClass parent;
+} TestDerivedClass;
+
+#define TEST_TYPE_DERIVED (test_derived_get_type())
+#define TEST_DERIVED(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), TEST_TYPE_DERIVED, TestDerived))
+#define TEST_DERIVED_CLASS(cls) \
+ (G_TYPE_CHECK_CLASS_CAST((cls), TEST_TYPE_DERIVED, TestDerivedClass))
+#define TEST_DERIVED_GET_CLASS(obj) \
+ (G_TYPE_INSTANCE_GET_CLASS((obj), TEST_TYPE_DERIVED, TestDerivedClass))
+
+static void
+test_derived_class_init(TestDerivedClass*)
+{
+}
+static void
+test_derived_init(TestDerived*)
+{
+}
+
+G_DEFINE_TYPE(TestDerived, test_derived, G_TYPE_OBJECT)
+
+class DerivedObject : public Glib::Object
+{
+public:
+ // A real application would never make the constructor public.
+ // It would instead have a protected constructor and a public create() method.
+ DerivedObject(GObject* gobject, int i) : Glib::Object(gobject), i_(i) {}
+
+ DerivedObject(const DerivedObject& src) = delete;
+ DerivedObject& operator=(const DerivedObject& src) = delete;
+
+ DerivedObject(DerivedObject&& src) noexcept : Glib::Object(std::move(src)), i_(std::move(src.i_))
+ {
+ }
+
+ DerivedObject& operator=(DerivedObject&& src) noexcept
+ {
+ Glib::Object::operator=(std::move(src));
+ i_ = std::move(src.i_);
+
+ return *this;
+ }
+
+ int i_;
+};
+
static void
test_object_move_constructor()
{
+++ /dev/null
-#include "test_derived_objectbase.h"
-#include "../glibmm_object/test_derived_object.h"
-#include <glibmm.h>
-#include <iostream>
-#include <stdlib.h>
-
-static void
-test_objectbase()
-{
- GObject* gobject = G_OBJECT(g_object_new(TEST_TYPE_DERIVED, nullptr));
- DerivedObjectBase derived(gobject, 5);
- // std::cout << "debug: gobj(): " << derived.gobj() << std::endl;
- g_assert(derived.gobj() == gobject);
-}
-
-int
-main(int, char**)
-{
- Glib::init();
-
- test_objectbase();
-
- return EXIT_SUCCESS;
-}
+++ /dev/null
-#ifndef _GLIBMM_TEST_DERIVED_OBJECTBASE_H
-#define _GLIBMM_TEST_DERIVED_OBJECTBASE_H
-
-#include <glibmm.h>
-
-class DerivedObjectBase : public Glib::ObjectBase
-{
-public:
- // A real application would never make the constructor public.
- // It would instead have a protected constructor and a public create() method.
- DerivedObjectBase(GObject* gobject, int i) : Glib::ObjectBase(nullptr), i_(i)
- {
- Glib::ObjectBase::initialize(gobject);
- }
-
- DerivedObjectBase(const DerivedObjectBase& src) = delete;
- DerivedObjectBase& operator=(const DerivedObjectBase& src) = delete;
-
- DerivedObjectBase(DerivedObjectBase&& src) noexcept : Glib::ObjectBase(std::move(src)),
- i_(std::move(src.i_))
- {
- ObjectBase::initialize_move(src.gobject_, &src);
- }
-
- DerivedObjectBase& operator=(DerivedObjectBase&& src) noexcept
- {
- Glib::ObjectBase::operator=(std::move(src));
- i_ = std::move(src.i_);
-
- return *this;
- }
-
- int i_;
-};
-
-#endif // _GLIBMM_TEST_DERIVED_OBJECTBASE_H
-#include "../glibmm_objectbase/test_derived_objectbase.h"
-#include "../glibmm_object/test_derived_object.h"
#include <glibmm.h>
#include <iostream>
#include <stdlib.h>
+// A basic derived GObject, just to test Glib::ObjectBase.
+typedef struct
+{
+ GObject parent;
+} TestDerived;
+
+typedef struct
+{
+ GObjectClass parent;
+} TestDerivedClass;
+
+#define TEST_TYPE_DERIVED (test_derived_get_type())
+#define TEST_DERIVED(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), TEST_TYPE_DERIVED, TestDerived))
+#define TEST_DERIVED_CLASS(cls) \
+ (G_TYPE_CHECK_CLASS_CAST((cls), TEST_TYPE_DERIVED, TestDerivedClass))
+#define TEST_DERIVED_GET_CLASS(obj) \
+ (G_TYPE_INSTANCE_GET_CLASS((obj), TEST_TYPE_DERIVED, TestDerivedClass))
+
+static void
+test_derived_class_init(TestDerivedClass*)
+{
+}
+static void
+test_derived_init(TestDerived*)
+{
+}
+
+G_DEFINE_TYPE(TestDerived, test_derived, G_TYPE_OBJECT)
+
+class DerivedObjectBase : public Glib::ObjectBase
+{
+public:
+ // A real application would never make the constructor public.
+ // It would instead have a protected constructor and a public create() method.
+ DerivedObjectBase(GObject* gobject, int i) : Glib::ObjectBase(nullptr), i_(i)
+ {
+ Glib::ObjectBase::initialize(gobject);
+ }
+
+ DerivedObjectBase(const DerivedObjectBase& src) = delete;
+ DerivedObjectBase& operator=(const DerivedObjectBase& src) = delete;
+
+ DerivedObjectBase(DerivedObjectBase&& src) noexcept : Glib::ObjectBase(std::move(src)),
+ i_(std::move(src.i_))
+ {
+ ObjectBase::initialize_move(src.gobject_, &src);
+ }
+
+ DerivedObjectBase& operator=(DerivedObjectBase&& src) noexcept
+ {
+ Glib::ObjectBase::operator=(std::move(src));
+ i_ = std::move(src.i_);
+
+ return *this;
+ }
+
+ int i_;
+};
+
static void
test_objectbase_move_constructor()
{
Glib::RefPtr<Something> refSomething(new Something());
g_assert_cmpint(refSomething->ref_count(), ==, 1);
g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+
+ // Test the get() method:
+ g_assert_cmpint(refSomething.get()->ref_count(), ==, 1);
+ refSomething.reset();
+ g_assert(refSomething.get() == nullptr);
}
static void
g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
{
- //The reference count should not change,
- //because we only take and release a single reference:
Glib::RefPtr<Something> refSomething2(refSomething);
- g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething2->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->ref_count(), ==, 2);
+ g_assert_cmpint(refSomething2->ref_count(), ==, 2);
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 2);
}
// Test the refcount after other references should have been released
// when other RefPtrs went out of scope:
g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 2);
}
static void
g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
{
- //The reference count should not change,
- //because we only take and release a single reference:
Glib::RefPtr<Something> refSomething2 = refSomething;
- g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething2->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->ref_count(), ==, 2);
+ g_assert_cmpint(refSomething2->ref_count(), ==, 2);
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 2);
}
// Test the refcount after other references should have been released
// when other RefPtrs went out of scope:
g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 2);
}
static Glib::RefPtr<Something>
static Glib::RefPtr<Something> something_to_get;
// Reinitialize it each time:
- something_to_get = Glib::make_refptr_for_instance<Something>(new Something());
+ something_to_get = Glib::RefPtr<Something>(new Something());
return something_to_get;
}
test_refptr_with_parent_copy_constructor()
{
// We use get_something() because test_refptr_with_parent_move_constructor() does.
- //The reference count should not change,
- //because we only take and release a single reference:
Glib::RefPtr<Something> refSomething = get_something();
- g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->ref_count(), ==, 2); // 1 here and 1 inside get_something()
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 2);
{
Parent parent(refSomething);
g_assert(!parent.was_constructed_via_move_constructor());
g_assert(parent.was_constructed_via_copy_constructor());
g_assert_cmpint(
- parent.something_ref_count(), ==, 1);
- g_assert_cmpint(parent.something_max_ref_count(), ==, 1);
+ parent.something_ref_count(), ==, 3); // 1 here, 1 in parent, and 1 inside get_something()
+ g_assert_cmpint(parent.something_max_ref_count(), ==, 3);
}
// Test the refcount after other references should have been released
// when other RefPtrs went out of scope:
- g_assert_cmpint(refSomething->ref_count(), ==, 1);
- g_assert_cmpint(refSomething->max_ref_count(), ==, 1);
+ g_assert_cmpint(refSomething->ref_count(), ==, 2); // 1 here and 1 inside get_something()
+ g_assert_cmpint(refSomething->max_ref_count(), ==, 3);
}
static void
Parent parent(get_something());
g_assert(parent.was_constructed_via_move_constructor());
g_assert(!parent.was_constructed_via_copy_constructor());
- g_assert_cmpint(parent.something_ref_count(), ==, 1);
- g_assert_cmpint(parent.something_max_ref_count(), ==, 1);
+ g_assert_cmpint(parent.something_ref_count(), ==, 2); // 1 in parent and 1 inside get_something()
+ g_assert_cmpint(parent.something_max_ref_count(), ==, 2);
}
static void
#include <glibmm.h>
-#include <iomanip>
#include <iostream>
int
main(int, char**)
{
- // Don't use the user's preferred locale. The decimal delimiter may be ','
- // instead of the expected '.'.
- Glib::set_init_to_users_preferred_locale(false);
-
Glib::init();
char carr[10] = "Užduotys";
// This threw an exception before we added a ustring::FormatStream::stream(char*) overload.
Glib::ustring::format(cptr);
- // Test substitution of various types and I/O manipulators
- Glib::ustring expected("The meaning of life is 42, or with 2 decimal places, 42.00.");
- auto the = "The";
- std::string meaning("meaning");
- Glib::ustring life("life");
- auto number = 42.0;
- auto places = 2;
- auto actual = Glib::ustring::format(the, ' ', meaning, " of ", life, " is ",
- number,
- ", or with ", places, " decimal places, ",
- std::fixed, std::setprecision(places), number,
- '.');
-
- if (actual != expected)
- {
- std::cerr << "expected (" << expected.size() << "):\n" << expected << "\n\n"
- << "actual (" << actual .size() << "):\n" << actual << "\n";
-
- return EXIT_FAILURE;
- }
-
return EXIT_SUCCESS;
}
+++ /dev/null
-#include <iostream>
-#include <glibmm.h>
-
-int
-main()
-{
- Glib::init();
-
- // 0-1: bad character
- const char not_utf8[] = { '\x80',
- // 1-4: good three bytes (one character)
- '\xef', '\x80', '\x80',
- // 4-5: bad character
- '\xef',
- // 5-6: bad character
- '\x80',
- // 6-7: good character
- 'a',
- // 7-8: bad character
- '\0',
- // 8-9: good character
- 'd',
- // 9-10: bad character
- '\x80',
- // 10-13: good three bytes (one character)
- '\xef', '\x80', '\x80',
- // 13-15: two bad characters
- '\xef', '\x80'
- };
-
- const char fixed_utf8[] = { '\xef', '\xbf', '\xbd',
- '\xef', '\x80', '\x80',
- '\xef', '\xbf', '\xbd',
- '\xef', '\xbf', '\xbd',
- 'a',
- '\xef', '\xbf', '\xbd',
- 'd',
- '\xef', '\xbf', '\xbd',
- '\xef', '\x80', '\x80',
- '\xef', '\xbf', '\xbd',
- '\xef', '\xbf', '\xbd'
- };
-
- // const char repl_character[] = {'\xef', '\xbf', '\xbd'};
- const Glib::ustring s(not_utf8, not_utf8 + sizeof not_utf8);
- g_assert(s.validate() == false);
-
- const Glib::ustring good_one = s.make_valid();
- g_assert(s.validate() == false); // we make a copy
- g_assert(good_one.validate()); // this one is good!
-
- const Glib::ustring correct_output(fixed_utf8,
- fixed_utf8 + sizeof fixed_utf8);
- g_assert(correct_output.validate());
- g_assert(correct_output == good_one);
-
- return EXIT_SUCCESS;
-}
--- /dev/null
+
+#include <glibmm.h>
+
+struct Foo
+{
+ int bar;
+};
+
+namespace Gtk
+{
+class Widget;
+}
+
+void
+some_method()
+{
+ // custom copyable
+ Glib::Value<Foo> value_foo;
+
+ // custom pointer
+ Glib::Value<Foo*> value_foo_pointer;
+ Glib::Value<const Foo*> value_foo_const_pointer;
+
+ // Glib::Object pointer
+ Glib::Value<Gtk::Widget*> value_widget_pointer;
+ Glib::Value<const Gtk::Widget*> value_widget_const_pointer;
+}
+
+// Glib::Object RefPtr<>
+
+// template Glib::Value< Glib::RefPtr<Gdk::Pixbuf> >;
+// template Glib::Value< Glib::RefPtr<const Gdk::Pixbuf> >;
-#include "../glibmm_object/test_derived_object.h"
-#include <glibmm.h>
-#include <cassert>
-
-struct Foo
-{
- int bar = 1;
-};
-
-namespace Gtk
-{
-
-class Widget {
-};
-}
+#include <glibmm.h>
-void
-test()
+int
+main(int, char**)
{
- {
- Foo foo;
-
- // custom copyable
- Glib::Value<Foo> value;
- value.init(Glib::Value<Foo>::value_type()); // TODO: Avoid this step?
- value.set(foo);
-
- const auto v = value.get();
- assert(v.bar == 1);
- }
-
- {
- Foo foo;
-
- // custom pointer
- Glib::Value<Foo*> value;
- value.init(Glib::Value<Foo*>::value_type()); // TODO: Avoid this step?
- value.set(&foo);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- Foo foo;
-
- Glib::Value<const Foo*> value;
- value.init(Glib::Value<const Foo*>::value_type()); // TODO: Avoid this step?
- value.set(&foo);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- Gtk::Widget widget;
-
- // Glib::Object pointer
- Glib::Value<Gtk::Widget*> value;
- value.init(Glib::Value<Gtk::Widget*>::value_type()); // TODO: Avoid this step?
- value.set(&widget);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- Gtk::Widget widget;
-
- Glib::Value<const Gtk::Widget*> value;
- value.init(Glib::Value<const Gtk::Widget*>::value_type()); // TODO: Avoid this step?
- value.set(&widget);
-
- const auto v = value.get();
- assert(v);
- }
-
- Glib::init();
-
- // TODO: Put this test, of internal stuff, somewhere else.
- static_assert(Glib::Traits::HasGetBaseType<DerivedObject, GType()>::value,
- "DerivedObject has no get_base_type().");
-
- // RefPtr to Glib::ObjectBase-derived type:
- {
- GObject* gobject = G_OBJECT(g_object_new(TEST_TYPE_DERIVED, nullptr));
- auto derived = Glib::make_refptr_for_instance(new DerivedObject(gobject, 5));
-
- using ValueType = Glib::Value<Glib::RefPtr<DerivedObject>>;
- ValueType value;
- value.init(ValueType::value_type()); // TODO: Avoid this step?
-
- // Check that value_type() returns the type of the underlying GObjectBase,
- // not a custom GType for the Glib::RefPtr:
- assert(ValueType::value_type() == DerivedObject::get_base_type());
-
- value.set(derived);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- GObject* gobject = G_OBJECT(g_object_new(TEST_TYPE_DERIVED, nullptr));
- auto derived = Glib::make_refptr_for_instance(new DerivedObject(gobject, 5));
-
- using ValueType = Glib::Value<Glib::RefPtr<const DerivedObject>>;
- ValueType value;
- value.init(ValueType::value_type()); // TODO: Avoid this step?
-
- // Check that value_type() returns the type of the underlying GObjectBase,
- // not a custom GType for the Glib::RefPtr:
- assert(ValueType::value_type() == DerivedObject::get_base_type());
-
- value.set(derived);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- auto foo = std::make_shared<Foo>();
-
- // custom pointer
- Glib::Value<std::shared_ptr<Foo>> value;
- value.init(Glib::Value<std::shared_ptr<Foo>>::value_type()); // TODO: Avoid this step?
- value.set(foo);
-
- const auto v = value.get();
- assert(v);
- }
-
- {
- auto foo = std::make_shared<Foo>();
-
- Glib::Value<std::shared_ptr<const Foo>> value;
- value.init(Glib::Value<std::shared_ptr<const Foo>>::value_type()); // TODO: Avoid this step?
- value.set(foo);
-
- const auto v = value.get();
- assert(v);
- }
-}
-
-// Glib::Object RefPtr<>
-
-// template Glib::Value< Glib::RefPtr<Gdk::Pixbuf> >;
-// template Glib::Value< Glib::RefPtr<const Gdk::Pixbuf> >;
-//
-
-int main() {
- test();
-
return EXIT_SUCCESS;
}
--- /dev/null
+// Glib::ValueArray is deprecated, but let's keep the test.
+// The recommended replacement is std::vector<> which requires no test here.
+#undef GLIBMM_DISABLE_DEPRECATED
+
+#include <glibmm.h>
+#include <iostream>
+
+#ifdef GLIBMM_DISABLE_DEPRECATED
+int
+main(int, char**)
+{
+ // If glibmm is configured with --disable-deprecated-api, GLIBMM_DISABLE_DEPRECATED
+ // is defined in glibmm.h (actually in glibmmconfig.h). The undef at the start of
+ // this file has no effect.
+ return 77; // Tell automake's test harness to skip this test.
+}
+
+#else
+
+// Use this line if you want debug output:
+// std::ostream& ostr = std::cout;
+
+// This seems nicer and more useful than putting an ifdef around the use of ostr:
+std::stringstream debug;
+std::ostream& ostr = debug;
+
+int
+on_compare(const Glib::ValueBase& v1, const Glib::ValueBase& v2)
+{
+ const Glib::Value<int>& intVal1 = static_cast<const Glib::Value<int>&>(v1);
+ const Glib::Value<int>& intVal2 = static_cast<const Glib::Value<int>&>(v2);
+
+ int int1 = intVal1.get();
+ int int2 = intVal2.get();
+
+ if (int1 < int2)
+ return -1;
+ else if (int1 == int2)
+ return EXIT_SUCCESS;
+ else
+ return 1;
+}
+
+int
+main(int, char**)
+{
+ const int VALUES_COUNT = 10;
+
+ Glib::init();
+
+ Glib::Value<int> values[VALUES_COUNT];
+ Glib::ValueArray array;
+
+ for (int i = 0; i < VALUES_COUNT; i++)
+ {
+ values[i].init(Glib::Value<int>::value_type());
+ values[i].set(i + 1); // (i + 1) ==> Set to natural counting numbers.
+ array.prepend(values[i]);
+ }
+
+ ostr << "Array members before sorting:" << std::endl;
+
+ for (int i = 0; i < VALUES_COUNT; i++)
+ {
+ Glib::ValueBase value;
+
+ if (!array.get_nth(i, value))
+ {
+ std::cerr << "Error getting element " << i << " of value array." << std::endl;
+ return EXIT_FAILURE;
+ break;
+ }
+
+ auto int_val = static_cast<Glib::Value<int>&>(value);
+ ostr << int_val.get() << " ";
+ }
+ ostr << std::endl; // End of line for list of array elements.
+
+ // Sort array and remove last element:
+ array.sort(sigc::ptr_fun(&on_compare)).remove(VALUES_COUNT - 1);
+
+ ostr << "Array members after sorting without last element:" << std::endl;
+
+ for (int i = 0; i < VALUES_COUNT - 1; i++)
+ {
+ Glib::ValueBase value;
+
+ if (!array.get_nth(i, value))
+ {
+ std::cerr << "Error getting element " << i << " of value array." << std::endl;
+ return EXIT_FAILURE;
+ break;
+ }
+
+ auto int_val = static_cast<Glib::Value<int>&>(value);
+ ostr << int_val.get() << " ";
+ }
+ ostr << std::endl; // End of line for list of array elements.
+
+ return EXIT_SUCCESS;
+}
+#endif // GLIBMM_DISABLE_DEPRECATED
ostr << "Index of first map entry: " << child0.first << std::endl;
result_ok &= child0.first == 4;
auto extracted_tuple = child0.second;
+#if __cplusplus > 201103L // C++14 or higher
auto q3 = std::get<guint16>(extracted_tuple);
auto s3 = std::get<Glib::ustring>(extracted_tuple);
auto b3 = std::get<bool>(extracted_tuple);
+#else // C++11
+ auto q3 = std::get<0>(extracted_tuple);
+ auto s3 = std::get<1>(extracted_tuple);
+ auto b3 = std::get<2>(extracted_tuple);
+#endif
ostr << "Extracted tuple1 from map: (" << q3 << ", " << s3 << ", " << b3 << ")" << std::endl;
result_ok &= q3 == q1 && s3 == s1 && b3 == b1;
// Extract from a tuple.
auto q4 = tuple2_variant.get_child<guint16>(0);
auto s4 = tuple2_variant.get_child_variant<Glib::ustring>(1).get();
+#if __cplusplus > 201103L // C++14 or higher
auto b4 = std::get<bool>(tuple2_variant.get());
+#else // C++11
+ auto b4 = std::get<2>(tuple2_variant.get());
+#endif
ostr << "Extracted tuple2: (" << q4 << ", " << s4 << ", " << b4 << ")" << std::endl;
result_ok &= q4 == q2 && s4 == s2 && b4 == b2;
return result_ok;
}
-bool test_comparison()
-{
- bool result_ok = true;
-
- std::vector<int> int_vector1 = { 1, 2, 3, 4, 5, 6, 7, 8 };
- std::vector<int> int_vector2 = { 1, 2, 3, 4, 5, 6, 7 };
-
- auto int_variant1 = Glib::Variant<std::vector<int>>::create(int_vector1);
- auto int_variant2 = Glib::Variant<std::vector<int>>::create(int_vector2);
- auto int_variant3 = Glib::Variant<std::vector<int>>::create(int_vector1);
-
- // Equality and inequality operators
- ostr << "int_variant1 == int_variant2 (0): " << (int_variant1 == int_variant2) << std::endl;
- result_ok &= !(int_variant1 == int_variant2);
- ostr << "int_variant1 != int_variant2 (1): " << (int_variant1 != int_variant2) << std::endl;
- result_ok &= (int_variant1 != int_variant2);
-
- ostr << "int_variant1 == int_variant3 (1): " << (int_variant1 == int_variant3) << std::endl;
- result_ok &= (int_variant1 == int_variant3);
- ostr << "int_variant1 != int_variant3 (0): " << (int_variant1 != int_variant3) << std::endl;
- result_ok &= !(int_variant1 != int_variant3);
-
-#if 0
- // Less than (activate if operator<() exists)
- ostr << "int_variant2 < int_variant1 (1): " << (int_variant2 < int_variant1) << std::endl;
- result_ok &= (int_variant2 < int_variant1);
- ostr << "int_variant1 < int_variant3 (0): " << (int_variant1 < int_variant3) << std::endl;
- result_ok &= !(int_variant1 < int_variant3);
-#endif
- return result_ok;
-}
-
} // anonymous namespace
int
bool result_ok = test_tuple();
result_ok &= test_object_path();
- result_ok &= test_comparison();
return result_ok ? EXIT_SUCCESS : EXIT_FAILURE;
}
struct WarnCatcher
{
- explicit WarnCatcher(const std::string& domain)
+ WarnCatcher(const std::string& domain)
: m_domain(domain), m_old_flags(g_log_set_fatal_mask(m_domain.c_str(), get_log_flags()))
{
}
--- /dev/null
+/* Copyright (C) 2015 The glibmm Development Team
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <cstring>
+#include <giomm.h> //There is no class derived from Glib::Object in glibmm
+#include <glibmm.h>
+#include <iostream>
+#include <utility> // std::move
+
+int
+main(int, char**)
+{
+ Glib::init();
+ bool success = true;
+
+ // A Glib::WeakRef cannot be created from a Glib::RefPtr<Glib::Bytes>,
+ // because Glib::Bytes is not derived from Glib::ObjectBase.
+ // const int bdata = 1234;
+ // Glib::RefPtr<Glib::Bytes> bytes = Glib::Bytes::create(&bdata, sizeof bdata);
+ // Glib::WeakRef<Glib::Bytes> weakbytes = bytes; // does not compile
+
+ // Gio::MemoryInputStream
+ Glib::RefPtr<Gio::MemoryInputStream> memstream1 = Gio::MemoryInputStream::create();
+ const char data[] = "Some arbitrary data";
+ memstream1->add_data(data, sizeof data, Gio::MemoryInputStream::SlotDestroyData());
+
+ // Downcast copy, followed by upcast.
+ Glib::WeakRef<Gio::MemoryInputStream> weakmemstream1 = memstream1;
+ Glib::WeakRef<Gio::InputStream> weakstream1 = weakmemstream1;
+ Glib::WeakRef<Gio::MemoryInputStream> weakmemstream2 =
+ Glib::WeakRef<Gio::MemoryInputStream>::cast_dynamic(weakstream1);
+ Glib::RefPtr<Gio::MemoryInputStream> memstream2 = weakmemstream2.get();
+ if (memstream2)
+ {
+ char buffer[200];
+ gsize bytes_read = 0;
+ try
+ {
+ memstream2->read_all(buffer, sizeof buffer, bytes_read);
+ std::cout << buffer << std::endl;
+ success &= std::strcmp(buffer, data) == 0;
+ }
+ catch (const Glib::Error& ex)
+ {
+ std::cout << "Error reading from memory stream: " << ex.what() << std::endl;
+ success = false;
+ }
+ }
+ else
+ {
+ std::cout << "!memstream2" << std::endl;
+ success = false;
+ }
+
+ // Move construction.
+ Glib::WeakRef<Gio::MemoryInputStream> weakmemstream3(std::move(weakmemstream1));
+ if (weakmemstream1.get() || !weakmemstream3.get())
+ {
+ success = false;
+ if (weakmemstream1.get())
+ std::cout << "weakmemstream1 || !weakmemstream3: weakmemstream1" << std::endl;
+ if (!weakmemstream3.get())
+ std::cout << "weakmemstream1 || !weakmemstream3: !weakmemstream3" << std::endl;
+ }
+ else
+ {
+ // Move assignment.
+ weakmemstream2 = std::move(weakmemstream3);
+ if (!weakmemstream2 || weakmemstream3)
+ {
+ success = false;
+ if (!weakmemstream2.get())
+ std::cout << "!weakmemstream2 || weakmemstream3: !weakmemstream2" << std::endl;
+ if (weakmemstream3.get())
+ std::cout << "!weakmemstream2 || weakmemstream3: weakmemstream3" << std::endl;
+ }
+ else
+ {
+ // Downcast move, followed by upcast.
+ weakstream1 = std::move(weakmemstream2);
+ weakmemstream1 = Glib::WeakRef<Gio::MemoryInputStream>::cast_dynamic(weakstream1);
+ if (weakmemstream2 || !weakmemstream1)
+ {
+ success = false;
+ if (weakmemstream2)
+ std::cout << "weakmemstream2 || !weakmemstream1: weakmemstream2" << std::endl;
+ if (!weakmemstream1)
+ std::cout << "weakmemstream2 || !weakmemstream1: !weakmemstream1" << std::endl;
+ }
+ }
+ }
+
+ // Gio::SimpleAction
+ Glib::RefPtr<Gio::SimpleAction> action1 = Gio::SimpleAction::create("Action1");
+
+ Glib::ustring name = action1->get_name();
+ std::cout << "The name is '" << name << "'." << std::endl;
+ success &= name == "Action1";
+
+ Glib::WeakRef<Gio::SimpleAction> weakaction1 = action1;
+ Glib::WeakRef<Gio::SimpleAction> weakaction2 = weakaction1;
+
+ // A second RefPtr
+ Glib::RefPtr<Gio::SimpleAction> action2 = weakaction1.get();
+ if (action2)
+ {
+ name = action2->get_name();
+ std::cout << "The name is '" << name << "'." << std::endl;
+ success &= name == "Action1";
+ }
+ else
+ {
+ std::cout << "!action2" << std::endl;
+ success = false;
+ }
+
+ weakaction1.reset();
+ if (weakaction1.get())
+ {
+ std::cout << "weakaction1" << std::endl;
+ success = false;
+ }
+
+ action2 = weakaction2.get();
+ if (action2)
+ {
+ name = action2->get_name();
+ std::cout << "The name is '" << name << "'." << std::endl;
+ success &= name == "Action1";
+ }
+ else
+ {
+ std::cout << "!action2" << std::endl;
+ success = false;
+ }
+
+ // Reset one of the RefPtrs. One remains.
+ action1.reset();
+ action2 = weakaction2.get();
+ if (action2)
+ {
+ name = action2->get_name();
+ std::cout << "The name is '" << name << "'." << std::endl;
+ success &= name == "Action1";
+ }
+ else
+ {
+ std::cout << "!action2" << std::endl;
+ success = false;
+ }
+
+ // Reset the other RefPtr as well.
+ action2.reset();
+ if (weakaction2.get())
+ {
+ std::cout << "weakaction2" << std::endl;
+ success = false;
+ }
+
+ return success ? EXIT_SUCCESS : EXIT_FAILURE;
+}
dist_noinst_SCRIPTS = enum.pl
noinst_PROGRAMS = extra_defs_gen/generate_defs_glib extra_defs_gen/generate_defs_gio
-lib_LTLIBRARIES = extra_defs_gen/libglibmm_generate_extra_defs-2.60.la
+lib_LTLIBRARIES = extra_defs_gen/libglibmm_generate_extra_defs-2.4.la
extradefs_includedir = $(includedir)/$(GLIBMM_MODULE_NAME)/glibmm_generate_extra_defs
extradefs_include_HEADERS = extra_defs_gen/generate_extra_defs.h
extradefs_ldflags = -no-undefined -version-info $(LIBGLIBMM_SO_VERSION)
-extra_defs_gen_libglibmm_generate_extra_defs_2_60_la_SOURCES = extra_defs_gen/generate_extra_defs.cc
-extra_defs_gen_libglibmm_generate_extra_defs_2_60_la_LDFLAGS = $(extradefs_ldflags)
-extra_defs_gen_libglibmm_generate_extra_defs_2_60_la_LIBADD = $(GLIBMM_LIBS)
+extra_defs_gen_libglibmm_generate_extra_defs_2_4_la_SOURCES = extra_defs_gen/generate_extra_defs.cc
+extra_defs_gen_libglibmm_generate_extra_defs_2_4_la_LDFLAGS = $(extradefs_ldflags)
+extra_defs_gen_libglibmm_generate_extra_defs_2_4_la_LIBADD = $(GLIBMM_LIBS)
extra_defs_gen_generate_defs_glib_SOURCES = extra_defs_gen/generate_defs_glib.cc
extra_defs_gen_generate_defs_glib_LDADD = $(GLIBMM_LIBS) $(lib_LTLIBRARIES)
# Regenerate all glibmm's docs.xml and .defs files
+cd "$(dirname "$0")"
+
./glib_generate_docs.sh
./glib_generate_enums.sh
./glib_generate_extra_defs.sh
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. Also the script assumes that it resides in the
-# tools/gen_scripts directory and the XML file will be placed in glib/src.
+# The script assumes that it resides in the tools/gen_scripts directory and
+# the XML file will be placed in gio/src.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/gio/src"
+out_dir="$root_dir/gio/src"
-PARAMS="--with-properties --no-recursion"
-for dir in "$PREFIX"/glib/gio; do
- PARAMS="$PARAMS -s $dir"
+params="--with-properties --no-recursion"
+for dir in "$source_prefix/gio" "$build_prefix/gio"; do
+ params="$params -s $dir"
done
+# Exclude $build_prefix/gio/xdp-dbus.c.
+params="$params -x $build_prefix/gio/xdp-dbus.c"
-DOCEXTRACT_TO_XML_PY="$JHBUILD_SOURCES/glibmm/tools/defs_gen/docextract_to_xml.py"
-$DOCEXTRACT_TO_XML_PY $PARAMS > "$OUT_DIR"/gio_docs.xml
+"$gen_docs" $params > "$out_dir/gio_docs.xml"
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. The script assumes that it resides in the
-# tools/gen_scripts directory and the defs file will be placed in gio/src.
+# The script assumes that it resides in the tools/gen_scripts directory and
+# the defs file will be placed in gio/src.
# To update the gio_enums.defs file:
# 1. ./gio_generate_enums.sh
# 3. ./gio_generate_enums.sh --make-patch
# 4. Like step 2 when updating only the gio_enums.defs file.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES/glib"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/gio/src"
-OUT_FILE=gio_enums.defs
-OUT_DIR_FILE="$OUT_DIR"/$OUT_FILE
+out_dir="$root_dir/gio/src"
+out_file=gio_enums.defs
+out_dir_file="$out_dir"/$out_file
shopt -s extglob # Enable extended pattern matching
+shopt -s nullglob # Skip a filename pattern that matches no file
if [ $# -eq 0 ]
then
- ENUM_PL="$JHBUILD_SOURCES/glibmm/tools/enum.pl"
# Process files whose names end with .h, but not with private.h.
- $ENUM_PL "$PREFIX"/gio/!(*private).h > "$OUT_DIR_FILE"
+ # Exclude $build_prefix/gio/xdp-dbus.h.
+ "$gen_enums" "$source_prefix"/gio/!(*private).h "$build_prefix"/gio/!(*private|xdp-dbus).h > "$out_dir_file"
# patch version 2.7.5 does not like directory names.
- cd "$OUT_DIR"
- PATCH_OPTIONS="--backup --version-control=simple --suffix=.orig"
- patch $PATCH_OPTIONS $OUT_FILE $OUT_FILE.patch
+ cd "$out_dir"
+ patch_options="--backup --version-control=simple --suffix=.orig"
+ patch $patch_options $out_file $out_file.patch
elif [ "$1" = "--make-patch" ]
then
- diff --unified=5 "$OUT_DIR_FILE".orig "$OUT_DIR_FILE" > "$OUT_DIR_FILE".patch
+ diff --unified=5 "$out_dir_file".orig "$out_dir_file" > "$out_dir_file".patch
else
echo "Usage: $0 [--make-patch]"
exit 1
# 3. ./gio_generate_extra_defs.sh --make-patch
# 4. Like step 2 when updating only the gio_signals.defs file.
-ROOT_DIR="$(dirname "$0")/../.."
-GEN_DIR="$ROOT_DIR/tools/extra_defs_gen"
-OUT_DIR="$ROOT_DIR/gio/src"
-OUT_FILE=gio_signals.defs
-OUT_DIR_FILE="$OUT_DIR"/$OUT_FILE
+source "$(dirname "$0")/init_generate.sh"
+
+out_dir="$root_dir/gio/src"
+out_file=gio_signals.defs
+out_dir_file="$out_dir"/$out_file
if [ $# -eq 0 ]
then
- "$GEN_DIR"/generate_defs_gio > "$OUT_DIR_FILE"
+ "$extra_defs_gen_dir"/generate_defs_gio > "$out_dir_file"
# patch version 2.7.5 does not like directory names.
- cd "$OUT_DIR"
- PATCH_OPTIONS="--backup --version-control=simple --suffix=.orig"
- patch $PATCH_OPTIONS $OUT_FILE $OUT_FILE.patch
+ cd "$out_dir"
+ patch_options="--backup --version-control=simple --suffix=.orig"
+ patch $patch_options $out_file $out_file.patch
elif [ "$1" = "--make-patch" ]
then
- diff --unified=5 "$OUT_DIR_FILE".orig "$OUT_DIR_FILE" > "$OUT_DIR_FILE".patch
+ diff --unified=5 "$out_dir_file".orig "$out_dir_file" > "$out_dir_file".patch
else
echo "Usage: $0 [--make-patch]"
exit 1
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. The script assumes that it resides in the
-# tools/gen_scripts directory and the defs file will be placed in glib/src.
+# The script assumes that it resides in the tools/gen_scripts directory and
+# the defs file will be placed in gio/src.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES/glib"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/gio/src"
+out_dir="$root_dir/gio/src"
shopt -s extglob # Enable extended pattern matching
-H2DEF_PY="$JHBUILD_SOURCES/glibmm/tools/defs_gen/h2def.py"
+shopt -s nullglob # Skip a filename pattern that matches no file
# Process files whose names end with .h, but not with private.h.
-$H2DEF_PY "$PREFIX"/gio/!(*private).h > "$OUT_DIR"/gio_methods.defs
-#patch "$OUT_DIR"/gio_methods.defs "$OUT_DIR"/gio_methods.defs.patch
+# Exclude $build_prefix/gio/xdp-dbus.h.
+"$gen_methods" "$source_prefix"/gio/!(*private).h "$build_prefix"/gio/!(*private|xdp-dbus).h > "$out_dir"/gio_methods.defs
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. The script assumes that it resides in the
-# tools/gen_scripts directory and the XML file will be placed in glib/src.
+# The script assumes that it resides in the tools/gen_scripts directory and
+# the XML file will be placed in glib/src.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/glib/src"
+out_dir="$root_dir/glib/src"
-PARAMS="--with-properties --no-recursion"
-for dir in "$PREFIX"/glib/{glib,glib/deprecated,gmodule,gobject,gthread}; do
- PARAMS="$PARAMS -s $dir"
+params="--with-properties --no-recursion"
+for dir in "$source_prefix"/{glib,glib/deprecated,gmodule,gobject,gthread} \
+ "$build_prefix"/{glib,gmodule,gobject,gthread}; do
+ params="$params -s $dir"
done
-DOCEXTRACT_TO_XML_PY="$JHBUILD_SOURCES/glibmm/tools/defs_gen/docextract_to_xml.py"
-$DOCEXTRACT_TO_XML_PY $PARAMS > "$OUT_DIR/glib_docs.xml"
+"$gen_docs" $params > "$out_dir/glib_docs.xml"
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. The script assumes that it resides in the
-# tools/gen_scripts directory and the defs files will be placed in glib/src.
+# The script assumes that it resides in the tools/gen_scripts directory and
+# the defs files will be placed in glib/src.
# To update the g[lib|module|object]_enums.defs files:
# 1. ./glib_generate_enums.sh
# 3. ./glib_generate_enums.sh --make-patch
# 4. Like step 2 when updating only the g[lib|module|object]_enums.defs files.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES/glib"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/glib/src"
+out_dir="$root_dir/glib/src"
shopt -s extglob # Enable extended pattern matching
+shopt -s nullglob # Skip a filename pattern that matches no file
if [ $# -eq 0 ]
then
- ENUM_PL="$JHBUILD_SOURCES/glibmm/tools/enum.pl"
# Process files whose names end with .h, but not with private.h.
- $ENUM_PL "$PREFIX"/glib/!(*private).h "$PREFIX"/glib/deprecated/!(*private).h > "$OUT_DIR"/glib_enums.defs
- $ENUM_PL "$PREFIX"/gmodule/!(*private).h > "$OUT_DIR"/gmodule_enums.defs
- $ENUM_PL "$PREFIX"/gobject/!(*private).h > "$OUT_DIR"/gobject_enums.defs
+ "$gen_enums" "$source_prefix"/glib/!(*private).h "$source_prefix"/glib/deprecated/!(*private).h \
+ "$build_prefix"/glib/!(*private).h "$build_prefix"/glib/deprecated/!(*private).h > "$out_dir"/glib_enums.defs
+ "$gen_enums" "$source_prefix"/gmodule/!(*private).h "$build_prefix"/gmodule/!(*private).h > "$out_dir"/gmodule_enums.defs
+ "$gen_enums" "$source_prefix"/gobject/!(*private).h "$build_prefix"/gobject/!(*private).h > "$out_dir"/gobject_enums.defs
# patch version 2.7.5 does not like directory names.
- cd "$OUT_DIR"
- PATCH_OPTIONS="--backup --version-control=simple --suffix=.orig"
- patch $PATCH_OPTIONS glib_enums.defs glib_enums.defs.patch
+ cd "$out_dir"
+ patch_options="--backup --version-control=simple --suffix=.orig"
+ patch $patch_options glib_enums.defs glib_enums.defs.patch
elif [ "$1" = "--make-patch" ]
then
- OUT_DIR_FILE="$OUT_DIR"/glib_enums.defs
- diff --unified=5 "$OUT_DIR_FILE".orig "$OUT_DIR_FILE" > "$OUT_DIR_FILE".patch
+ out_dir_file="$out_dir"/glib_enums.defs
+ diff --unified=5 "$out_dir_file".orig "$out_dir_file" > "$out_dir_file".patch
else
echo "Usage: $0 [--make-patch]"
exit 1
# This script assumes that it resides in the tools/gen_scripts directory and
# the defs file will be placed in glib/src.
-ROOT_DIR="$(dirname "$0")/../.."
-GEN_DIR="../extra_defs_gen"
-OUT_DIR="$ROOT_DIR/glib/src"
+source "$(dirname "$0")/init_generate.sh"
-"$GEN_DIR"/generate_defs_glib > "$OUT_DIR"/glib_signals.defs
+out_dir="$root_dir/glib/src"
+
+"$extra_defs_gen_dir"/generate_defs_glib > "$out_dir"/glib_signals.defs
#!/bin/bash
-# Note that JHBUILD_SOURCES should be defined to contain the path to the root
-# of the jhbuild sources. The script assumes it resides in the
-# tools/gen_scripts directory and the defs files will be placed in glib/src.
+# The script assumes it resides in the tools/gen_scripts directory and
+# the defs files will be placed in glib/src.
# To update the g[lib|module|object]_functions.defs files:
# 1. ./glib_generate_methods.sh
# 3. ./glib_generate_methods.sh --make-patch
# 4. Like step 2 when updating only the g[lib|module|object]_functions.defs files.
-if [ -z "$JHBUILD_SOURCES" ]; then
- echo -e "JHBUILD_SOURCES must contain the path to the jhbuild sources."
- exit 1;
-fi
+source "$(dirname "$0")/init_generate.sh"
-PREFIX="$JHBUILD_SOURCES/glib"
-ROOT_DIR="$(dirname "$0")/../.."
-OUT_DIR="$ROOT_DIR/glib/src"
+out_dir="$root_dir/glib/src"
shopt -s extglob # Enable extended pattern matching
+shopt -s nullglob # Skip a filename pattern that matches no file
if [ $# -eq 0 ]
then
- H2DEF_PY="$JHBUILD_SOURCES/glibmm/tools/defs_gen/h2def.py"
# Process files whose names end with .h, but not with private.h.
- $H2DEF_PY "$PREFIX"/glib/!(*private).h "$PREFIX"/glib/deprecated/!(*private).h > "$OUT_DIR"/glib_functions.defs
- $H2DEF_PY "$PREFIX"/gmodule/!(*private).h > "$OUT_DIR"/gmodule_functions.defs
- $H2DEF_PY "$PREFIX"/gobject/!(*private).h > "$OUT_DIR"/gobject_functions.defs
+ "$gen_methods" "$source_prefix"/glib/!(*private).h "$source_prefix"/glib/deprecated/!(*private).h \
+ "$build_prefix"/glib/!(*private).h "$build_prefix"/glib/deprecated/!(*private).h > "$out_dir"/glib_functions.defs
+ "$gen_methods" "$source_prefix"/gmodule/!(*private).h "$build_prefix"/gmodule/!(*private).h > "$out_dir"/gmodule_functions.defs
+ "$gen_methods" "$source_prefix"/gobject/!(*private).h "$build_prefix"/gobject/!(*private).h > "$out_dir"/gobject_functions.defs
# patch version 2.7.5 does not like directory names.
- cd "$OUT_DIR"
- PATCH_OPTIONS="--backup --version-control=simple --suffix=.orig"
- patch $PATCH_OPTIONS glib_functions.defs glib_functions.defs.patch
+ cd "$out_dir"
+ patch_options="--backup --version-control=simple --suffix=.orig"
+ patch $patch_options glib_functions.defs glib_functions.defs.patch
elif [ "$1" = "--make-patch" ]
then
- OUT_DIR_FILE="$OUT_DIR"/glib_functions.defs
- diff --unified=5 "$OUT_DIR_FILE".orig "$OUT_DIR_FILE" > "$OUT_DIR_FILE".patch
+ out_dir_file="$out_dir"/glib_functions.defs
+ diff --unified=5 "$out_dir_file".orig "$out_dir_file" > "$out_dir_file".patch
else
echo "Usage: $0 [--make-patch]"
exit 1
--- /dev/null
+#!/bin/bash
+
+# This file is part of glibmm-2.4.
+# Initializes some variables for the scripts that generate docs and defs files.
+# Not intented to be called directly from the command line.
+
+# Global environment variables:
+# GMMPROC_GEN_SOURCE_DIR Top directory where source files are searched for.
+# Default value: $(dirname "$0")/../../..
+# i.e. 3 levels above this file.
+# GMMPROC_GEN_BUILD_DIR Top directory where built files are searched for.
+# Default value: $GMMPROC_GEN_SOURCE_DIR
+#
+# If you use jhbuild, you can set these environment variables equal to jhbuild's
+# configuration variables checkoutroot and buildroot, respectively.
+# Usually you can leave GMMPROC_GEN_SOURCE_DIR undefined.
+# If you have set buildroot=None, GMMPROC_GEN_BUILD_DIR can also be undefined.
+
+# Root directory of glibmm-2.4 source files.
+root_dir="$(dirname "$0")/../.."
+
+# Where to search for source files.
+if [ -z "$GMMPROC_GEN_SOURCE_DIR" ]; then
+ GMMPROC_GEN_SOURCE_DIR="$root_dir/.."
+fi
+
+# Where to search for built files.
+if [ -z "$GMMPROC_GEN_BUILD_DIR" ]; then
+ GMMPROC_GEN_BUILD_DIR="$GMMPROC_GEN_SOURCE_DIR"
+fi
+
+# Scripts in glibmm-2.4. These are source files.
+gen_docs="$GMMPROC_GEN_SOURCE_DIR/glibmm-2.4/tools/defs_gen/docextract_to_xml.py"
+gen_methods="$GMMPROC_GEN_SOURCE_DIR/glibmm-2.4/tools/defs_gen/h2def.py"
+gen_enums="$GMMPROC_GEN_SOURCE_DIR/glibmm-2.4/tools/enum.pl"
+
+# Where to find executables that generate extra defs (signals and properties).
+# glibmm-2.4 is built with autotools.
+# autotools support, but don't require, non-source-dir builds.
+extra_defs_gen_dir="$GMMPROC_GEN_BUILD_DIR/glibmm-2.4/tools/extra_defs_gen"
+
+source_prefix="$GMMPROC_GEN_SOURCE_DIR/glib"
+build_prefix="$GMMPROC_GEN_BUILD_DIR/glib"
+if [ "$build_prefix" == "$source_prefix" ]; then
+ # glib is built with meson, which requires non-source-dir builds.
+ # This is what jhbuild does, if neccesary, to force non-source-dir builds.
+ build_prefix="$build_prefix/build"
+fi
_PUSH(SECTION_CC)
Glib::RefPtr<`'__CPPNAME__`'> __CPPNAME__`'::create(`'$2`')
{
- return Glib::make_refptr_for_instance<`'__CPPNAME__`'>( new __CPPNAME__`'(`'$3`') );
+ return Glib::RefPtr<`'__CPPNAME__`'>( new __CPPNAME__`'(`'$3`') );
}
_POP()
Glib::RefPtr<__NAMESPACE__::__CPPNAME__> wrap(__REAL_CNAME__`'* object, bool take_copy)
{
- return Glib::make_refptr_for_instance<__NAMESPACE__::__CPPNAME__>( dynamic_cast<__NAMESPACE__::__CPPNAME__*> (Glib::wrap_auto ((GObject*)(object), take_copy)) );
+ return Glib::RefPtr<__NAMESPACE__::__CPPNAME__>( dynamic_cast<__NAMESPACE__::__CPPNAME__*> (Glib::wrap_auto ((GObject*)(object), take_copy)) );
//We use dynamic_cast<> in case of multiple inheritance.
}
Glib::RefPtr<__NAMESPACE__::__CPPNAME__> wrap(__CNAME__`'* object, bool take_copy)
{
- return Glib::make_refptr_for_instance<__NAMESPACE__::__CPPNAME__>( dynamic_cast<__NAMESPACE__::__CPPNAME__*> (Glib::wrap_auto_interface<__NAMESPACE__::__CPPNAME__> ((GObject*)(object), take_copy)) );
+ return Glib::RefPtr<__NAMESPACE__::__CPPNAME__>( dynamic_cast<__NAMESPACE__::__CPPNAME__*> (Glib::wrap_auto_interface<__NAMESPACE__::__CPPNAME__> ((GObject*)(object), take_copy)) );
//We use dynamic_cast<> in case of multiple inheritance.
}
-dnl $Id$
-
dnl
dnl _CLASS_OPAQUE_REFCOUNTED(Coverage, PangoCoverage, pango_coverage_new, pango_coverage_ref, pango_coverage_unref)
dnl
define(`__OPAQUE_FUNC_NEW',`$3')
define(`__OPAQUE_FUNC_REF',`$4')
define(`__OPAQUE_FUNC_UNREF',`$5')
+undefine(`__OPAQUE_FUNC_GTYPE__')
_POP()
_SECTION(SECTION_CLASS2)
')dnl End of _CLASS_OPAQUE_REFCOUNTED.
+dnl _IS_REFCOUNTED_BOXEDTYPE(gtype_func)
+dnl
+dnl Generates a *_get_type() function and a Glib::Value specialization.
+dnl A Glib::Value specialization is required, if the C++ class is used in
+dnl _WRAP_PROPERTY. The C class must have been registered in the GType system
+dnl with g_boxed_type_register_static().
+dnl
+dnl Optional parameter gtype_func:
+dnl 1. If not defined or an empty string, _GET_TYPE_FUNC() generates the
+dnl function name from the name of the C type, e.g.
+dnl GSettingsSchema -> g_settings_schema_get_type
+dnl 2. If anything else, it's assumed to be the name of the *_get_type() function.
+dnl
+define(`_IS_REFCOUNTED_BOXEDTYPE',`dnl
+_PUSH()
+dnl Define this macro to be tested for later.
+define(`__OPAQUE_FUNC_GTYPE__',`$1')
+_POP()
+')
dnl
dnl _END_CLASS_OPAQUE_REFCOUNTED()
namespace Glib
{
- /** A Glib::wrap() method for this object.
- *
- * @param object The C instance.
- * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
- * @result A C++ instance that wraps this C instance.
- *
- * @relates __NAMESPACE__::__CPPNAME__
- */
- Glib::RefPtr<__NAMESPACE__::__CPPNAME__> wrap(__CNAME__* object, bool take_copy = false);
+/** A Glib::wrap() method for this object.
+ *
+ * @param object The C instance.
+ * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
+ * @result A C++ instance that wraps this C instance.
+ *
+ * @relates __NAMESPACE__::__CPPNAME__
+ */
+Glib::RefPtr<__NAMESPACE__::__CPPNAME__> wrap(__CNAME__* object, bool take_copy = false);
+ifdef(`__OPAQUE_FUNC_GTYPE__',`dnl
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
+template <>
+class Value<Glib::RefPtr<__NAMESPACE__::__CPPNAME__>> : public Glib::Value_RefPtrBoxed<__NAMESPACE__::__CPPNAME__>
+{
+public:
+ CppType get() const { return Glib::wrap(static_cast<__CNAME__*>(get_boxed()), true); }
+};
+#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+
+')dnl endif __OPAQUE_FUNC_GTYPE__
} // namespace Glib
_SECTION(SECTION_SRC_GENERATED)
__OPAQUE_FUNC_REF`'(object);
// See the comment at the top of this file, if you want to know why the cast works.
- return Glib::make_refptr_for_instance<__NAMESPACE__::__CPPNAME__>(reinterpret_cast<__NAMESPACE__::__CPPNAME__*>(object));
+ return Glib::RefPtr<__NAMESPACE__::__CPPNAME__>(reinterpret_cast<__NAMESPACE__::__CPPNAME__*>(object));
}
} // namespace Glib
dnl
dnl The implementation:
dnl
+ifdef(`__OPAQUE_FUNC_GTYPE__',`dnl
+// static
+GType __CPPNAME__::get_type()
+{
+ifelse(__OPAQUE_FUNC_GTYPE__,,`dnl
+ return _GET_TYPE_FUNC(__CNAME__);
+',`dnl
+ return __OPAQUE_FUNC_GTYPE__`'();
+')dnl
+}
+')dnl endif __OPAQUE_FUNC_GTYPE__
ifelse(__OPAQUE_FUNC_NEW,NONE,`dnl
',`dnl else
// static
Glib::RefPtr<__CPPNAME__> __CPPNAME__::create()
{
// See the comment at the top of this file, if you want to know why the cast works.
- return Glib::make_refptr_for_instance<__CPPNAME__>(reinterpret_cast<__CPPNAME__*>(__OPAQUE_FUNC_NEW`'()));
+ return Glib::RefPtr<__CPPNAME__>(reinterpret_cast<__CPPNAME__*>(__OPAQUE_FUNC_NEW`'()));
}
-')dnl endif __OPAQUE_FUNC_NEW
+')dnl endif __OPAQUE_FUNC_NEW
void __CPPNAME__::reference() const
{
// See the comment at the top of this file, if you want to know why the cast works.
using BaseObjectType = __CNAME__;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
+ifdef(`__OPAQUE_FUNC_GTYPE__',`dnl
+ /** Get the GType for this class, for use with the underlying GObject type system.
+ */
+ static GType get_type() G_GNUC_CONST;
+
+')dnl endif __OPAQUE_FUNC_GTYPE__
ifelse(__OPAQUE_FUNC_NEW,NONE,`dnl
',`dnl else
static Glib::RefPtr<__CPPNAME__> create();
+dnl $Id$
+
#
# Define a hashing for names
#
define(`__ARG3__',`$`'3')
-
-# _CONV_ENUM(namespace, enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of namespace+enum_name.
define(`_CONV_ENUM',`dnl
-pushdef(`C_ENUM_NAME', `m4_ifelse(`$3',,`$1$2',`$3')')
-_CONVERSION(`C_ENUM_NAME', `$2', static_cast<$2>(__ARG3__))
-_CONVERSION(`C_ENUM_NAME', `$1::$2', static_cast<$1::$2>(__ARG3__))
-_CONVERSION(`$2', `C_ENUM_NAME', static_cast<C_ENUM_NAME>(__ARG3__))
-_CONVERSION(`$1::$2', `C_ENUM_NAME', static_cast<C_ENUM_NAME>(__ARG3__))
-popdef(`C_ENUM_NAME')
-')dnl
-
-# _CONV_INCLASS_ENUM(namespace, class_name, enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of namespace+class_name+enum_name.
-define(`_CONV_INCLASS_ENUM',`dnl
-pushdef(`C_ENUM_NAME', `m4_ifelse(`$4',,`$1$2$3',`$4')')
-_CONVERSION(`C_ENUM_NAME', `$3', static_cast<$3>(__ARG3__))
-_CONVERSION(`C_ENUM_NAME', `$2::$3', static_cast<$2::$3>(__ARG3__))
-_CONVERSION(`C_ENUM_NAME', `$1::$2::$3', static_cast<$1::$2::$3>(__ARG3__))
-_CONVERSION(`$3', `C_ENUM_NAME', static_cast<C_ENUM_NAME>(__ARG3__))
-_CONVERSION(`$2::$3', `C_ENUM_NAME', static_cast<C_ENUM_NAME>(__ARG3__))
-_CONVERSION(`$1::$2::$3', `C_ENUM_NAME', static_cast<C_ENUM_NAME>(__ARG3__))
-popdef(`C_ENUM_NAME')
+_CONVERSION(`$1$2', `$2', (($2)(__ARG3__)))
+_CONVERSION(`$1$2', `$1::$2', (($1::$2)(__ARG3__)))
+_CONVERSION(`$2', `$1$2', (($1$2)(__ARG3__)))
+_CONVERSION(`$1::$2', `$1$2', (($1$2)(__ARG3__)))
')dnl
# e.g. Glib::RefPtr<Gdk::Something> to GdkSomething*
-dnl
-dnl Gio C names have prefix 'G' or 'GDBus' but C++ namespace Gio ot Gio::DBus
-dnl
-# _CONV_GIO_ENUM(enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of G+enum_name.
-define(`_CONV_GIO_ENUM',`dnl
-_CONV_ENUM(`Gio',`$1',`m4_ifelse(`$2',,`G$1',`$2')')
-')dnl
-
-# _CONV_GIO_DBUS_ENUM(enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of GDBus+enum_name.
-define(`_CONV_GIO_DBUS_ENUM',`dnl
-_CONV_ENUM(`Gio::DBus',`$1',`m4_ifelse(`$2',,`GDBus$1',`$2')')
-')dnl
-
-# _CONV_GIO_INCLASS_ENUM(class_name, enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of G+class_name+enum_name.
-define(`_CONV_GIO_INCLASS_ENUM',`dnl
-_CONV_INCLASS_ENUM(`Gio',`$1',`$2',`m4_ifelse(`$3',,`G$1$2',`$3')')
-')dnl
-
-# _CONV_GIO_DBUS_INCLASS_ENUM(class_name, enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of GDBus+class_name+enum_name.
-define(`_CONV_GIO_DBUS_INCLASS_ENUM',`dnl
-_CONV_INCLASS_ENUM(`Gio::DBus',`$1',`$2',`m4_ifelse(`$3',,`GDBus$1$2',`$3')')
-')dnl
-
-_CONV_GIO_INCLASS_ENUM(AppInfo,CreateFlags)
-_CONV_GIO_INCLASS_ENUM(Application,Flags)
-_CONV_GIO_ENUM(AskPasswordFlags)
-_CONV_GIO_ENUM(BusType)
-_CONV_GIO_INCLASS_ENUM(Converter,Flags)
-_CONV_GIO_INCLASS_ENUM(Converter,Result)
-_CONV_GIO_INCLASS_ENUM(Credentials,Type)
-_CONV_GIO_ENUM(DataStreamByteOrder)
-_CONV_GIO_ENUM(DataStreamNewlineType)
-_CONV_GIO_DBUS_ENUM(CallFlags)
-_CONV_GIO_DBUS_ENUM(CapabilityFlags)
-_CONV_GIO_DBUS_INCLASS_ENUM(InterfaceSkeleton,Flags)
-_CONV_GIO_DBUS_INCLASS_ENUM(Message,ByteOrder)
-_CONV_GIO_DBUS_ENUM(MessageFlags)
-_CONV_GIO_DBUS_ENUM(MessageHeaderField)
-_CONV_GIO_DBUS_ENUM(MessageType)
-_CONV_GIO_DBUS_ENUM(ProxyFlags)
-_CONV_GIO_DBUS_ENUM(SendMessageFlags)
-_CONV_GIO_DBUS_INCLASS_ENUM(Server,Flags)
-_CONV_GIO_INCLASS_ENUM(Drive,StartFlags)
-_CONV_GIO_INCLASS_ENUM(Drive,StartStopType)
-_CONV_GIO_INCLASS_ENUM(Emblem,Origin)
-_CONV_GIO_INCLASS_ENUM(FileAttributeInfo,Flags)
-_CONV_GIO_ENUM(FileAttributeStatus)
-_CONV_GIO_ENUM(FileAttributeType)
-_CONV_GIO_INCLASS_ENUM(FileCopy,Flags)
-_CONV_GIO_INCLASS_ENUM(FileCreate,Flags)
-_CONV_GIO_INCLASS_ENUM(FileMonitor,Event)
-_CONV_GIO_INCLASS_ENUM(FileMonitor,Flags)
-_CONV_GIO_ENUM(FileQueryInfoFlags)
-_CONV_GIO_ENUM(FileType)
-_CONV_GIO_INCLASS_ENUM(Mount,MountFlags)
-_CONV_GIO_ENUM(MountOperationResult)
-_CONV_GIO_INCLASS_ENUM(Mount,UnmountFlags)
-_CONV_GIO_ENUM(NetworkConnectivity)
-_CONV_GIO_INCLASS_ENUM(Notification,Priority)
-_CONV_GIO_INCLASS_ENUM(OutputStream,SpliceFlags)
-_CONV_GIO_ENUM(PasswordSave)
-_CONV_GIO_INCLASS_ENUM(Resolver,RecordType)
-_CONV_GIO_INCLASS_ENUM(Resource,Flags)
-_CONV_GIO_INCLASS_ENUM(Resource,LookupFlags)
-_CONV_GIO_INCLASS_ENUM(Settings,BindFlags)
-_CONV_GIO_ENUM(SocketClientEvent)
-_CONV_GIO_ENUM(SocketFamily)
-_CONV_GIO_INCLASS_ENUM(Socket,MsgFlags)
-_CONV_GIO_INCLASS_ENUM(Socket,Protocol)
-_CONV_GIO_INCLASS_ENUM(Socket,Type)
-_CONV_GIO_ENUM(TlsCertificateFlags)
-_CONV_GIO_ENUM(TlsCertificateRequestFlags)
-_CONV_GIO_INCLASS_ENUM(TlsDatabase,VerifyFlags)
-_CONV_GIO_INCLASS_ENUM(TlsDatabase,LookupFlags)
-_CONV_GIO_ENUM(TlsInteractionResult)
-_CONV_GIO_INCLASS_ENUM(TlsPassword,Flags)
-_CONV_GIO_ENUM(TlsRehandshakeMode)
-_CONV_GIO_INCLASS_ENUM(UnixSocketAddress,Type)
-_CONV_GIO_ENUM(ZlibCompressorFormat)
+_CONV_ENUM(G,AppInfoCreateFlags)
+_CONV_ENUM(G,ApplicationFlags)
+_CONV_ENUM(G,AskPasswordFlags)
+_CONV_ENUM(G,BusType)
+_CONV_ENUM(G,ConverterFlags)
+_CONV_ENUM(G,ConverterResult)
+_CONV_ENUM(G,CredentialsType)
+_CONV_ENUM(G,DataStreamByteOrder)
+_CONV_ENUM(G,DataStreamNewlineType)
+_CONV_ENUM(GDBus,CallFlags)
+_CONV_ENUM(GDBus,CapabilityFlags)
+_CONV_ENUM(GDBus, InterfaceSkeletonFlags)
+_CONV_ENUM(GDBus,MessageFlags)
+_CONV_ENUM(GDBus,MessageHeaderField)
+_CONV_ENUM(GDBus,MessageType)
+_CONV_ENUM(GDBus,ProxyFlags)
+_CONV_ENUM(GDBus,ConnectionFlags)
+_CONV_ENUM(GDBus,SendMessageFlags)
+_CONV_ENUM(GDBus,ServerFlags)
+_CONV_ENUM(G,DriveStartFlags)
+_CONV_ENUM(G,DriveStartFlags)
+_CONV_ENUM(G,DriveStartStopType)
+_CONV_ENUM(G,EmblemOrigin)
+_CONV_ENUM(G,FileAttributeInfoFlags)
+_CONV_ENUM(G,FileAttributeStatus)
+_CONV_ENUM(G,FileAttributeType)
+_CONV_ENUM(G,FileCopyFlags)
+_CONV_ENUM(G,FileCreateFlags)
+_CONV_ENUM(G,FileMonitorEvent)
+_CONV_ENUM(G,FileMonitorFlags)
+_CONV_ENUM(G,FileQueryInfoFlags)
+_CONV_ENUM(G,FileType)
+_CONV_ENUM(G,MountMountFlags)
+_CONV_ENUM(G,MountOperationResult)
+_CONV_ENUM(G,MountUnmountFlags)
+_CONV_ENUM(G,NetworkConnectivity)
+_CONV_ENUM(G,NotificationPriority)
+_CONV_ENUM(G,OutputStreamSpliceFlags)
+_CONV_ENUM(G,PasswordSave)
+_CONV_ENUM(G,ResolverRecordType)
+_CONV_ENUM(G,ResourceFlags)
+_CONV_ENUM(G,ResourceLookupFlags)
+_CONV_ENUM(G,SettingsBindFlags)
+_CONV_ENUM(G,SocketClientEvent)
+_CONV_ENUM(G,SocketFamily)
+_CONV_ENUM(G,SocketMsgFlags)
+_CONV_ENUM(G,SocketProtocol)
+_CONV_ENUM(G,SocketType)
+_CONV_ENUM(G,TlsCertificateFlags)
+_CONV_ENUM(G,TlsCertificateRequestFlags)
+_CONV_ENUM(G,TlsDatabaseVerifyFlags)
+_CONV_ENUM(G,TlsDatabaseLookupFlags)
+_CONV_ENUM(G,TlsInteractionResult)
+_CONV_ENUM(G,TlsPasswordFlags)
+_CONV_ENUM(G,TlsRehandshakeMode)
+_CONV_ENUM(G,UnixSocketAddressType)
+_CONV_ENUM(G,ZlibCompressorFormat)
# Action
_CONVERSION(`GAction*',`Glib::RefPtr<Action>',`Glib::wrap($3)')
_CONVERSION(`const Glib::RefPtr<AppInfo>&',`GAppInfo*',__CONVERT_REFPTR_TO_P)
_CONVERSION(`Glib::RefPtr<AppInfo>',`GAppInfo*',__CONVERT_REFPTR_TO_P)
_CONVERSION(`GAppInfo*',`const Glib::RefPtr<AppInfo>&',`Glib::wrap($3)')
-_CONVERSION(`const std::vector<Glib::RefPtr<Gio::File>>&',`GList*',`Glib::ListHandler<Glib::RefPtr<Gio::File>>::vector_to_list($3).data()')
+_CONVERSION(`const Glib::ListHandle< Glib::RefPtr<Gio::File> >&',`GList*',`$3.data()')
# Application
_CONVERSION(`GApplication*',`Glib::RefPtr<Application>',`Glib::wrap($3)')
_CONVERSION(`const Glib::RefPtr<InputStream>&',`GInputStream*',__CONVERT_CONST_REFPTR_TO_P)
_CONVERSION(`const Glib::RefPtr<Gio::InputStream>&',`GInputStream*',__CONVERT_CONST_REFPTR_TO_P)
_CONVERSION(`GInputStream*',`Glib::RefPtr<InputStream>',`Glib::wrap($3)')
-_CONVERSION(`GInputStream*',`Glib::RefPtr<Gio::InputStream>',`Glib::wrap($3)')
# MenuAttributeIter
_CONVERSION(`GMenuAttributeIter*',`Glib::RefPtr<MenuAttributeIter>',`Glib::wrap($3)')
# MenuItem
_CONVERSION(`GMenuItem*',`Glib::RefPtr<MenuItem>',`Glib::wrap($3)')
-_CONVERSION(`const Glib::RefPtr<const MenuItem>&',`GMenuItem*',__CONVERT_CONST_REFPTR_TO_P)
+_CONVERSION(`const Glib::RefPtr<MenuItem>&',`GMenuItem*',__CONVERT_CONST_REFPTR_TO_P)
# Mount
_CONVERSION(`GMount*',`Glib::RefPtr<Mount>',`Glib::wrap($3)')
#Settings
_CONVERSION(`GSettings*',`Glib::RefPtr<Settings>',`Glib::wrap($3)')
-_CONVERSION(`const std::vector<Glib::ustring>&',`const gchar*-const*',`Glib::ArrayHandler<Glib::ustring>::vector_to_array($3).data()')
+_CONVERSION(`const Glib::StringArrayHandle&',`const gchar*-const*',`($3).data()')
_CONVERSION(`const Glib::RefPtr<SettingsBackend>&',`GSettingsBackend*',__CONVERT_REFPTR_TO_P)
_CONVERSION(`GSettingsSchemaKey*',`Glib::RefPtr<SettingsSchemaKey>',`Glib::wrap($3)')
dnl
dnl Glib C names have prefix 'G' but C++ namespace Glib
dnl
-# _CONV_GLIB_ENUM(enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of G+enum_name.
define(`_CONV_GLIB_ENUM',`dnl
-_CONV_ENUM(`Glib',`$1',`m4_ifelse(`$2',,`G$1',`$2')')
-')dnl
-
-# _CONV_GLIB_INCLASS_ENUM(class_name, enum_name[, C_enum_name])
-# Specify C_enum_name, if it's not the concatenation of G+class_name+enum_name.
-define(`_CONV_GLIB_INCLASS_ENUM',`dnl
-_CONV_INCLASS_ENUM(`Glib',`$1',`$2',`m4_ifelse(`$3',,`G$1$2',`$3')')
+_CONVERSION(`G$1', `$1', (($1)(__ARG3__)))
+_CONVERSION(`G$1', `Glib::$1', ((Glib::$1)(__ARG3__)))
+_CONVERSION(`$1', `G$1', ((G$1)(__ARG3__)))
+_CONVERSION(`Glib::$1', `G$1', ((G$1)(__ARG3__)))
')dnl
_EQUAL(gchar,char)
dnl # These are for fixmegtkconst
_CONVERSION(`const guchar*',`guchar*',`const_cast<guchar*>($3)',`$3')
-_CONV_GLIB_INCLASS_ENUM(Binding,Flags)
+_CONV_GLIB_ENUM(BindingFlags)
_CONV_GLIB_ENUM(IOCondition)
_CONV_GLIB_ENUM(IOFlags)
_CONV_GLIB_ENUM(IOStatus)
-_CONV_GLIB_INCLASS_ENUM(KeyFile,Flags)
+_CONV_GLIB_ENUM(KeyFileFlags)
_CONV_GLIB_ENUM(OptionArg)
-_CONV_GLIB_INCLASS_ENUM(Regex,CompileFlags)
-_CONV_GLIB_INCLASS_ENUM(Regex,MatchFlags)
+_CONV_GLIB_ENUM(RegexCompileFlags)
+_CONV_GLIB_ENUM(RegexMatchFlags)
_CONV_GLIB_ENUM(SeekType)
_CONV_GLIB_ENUM(TimeType)
_CONVERSION(`const Glib::ustring&',`const char*',`$3.c_str()')
_CONVERSION(`const Glib::ustring&', `const guchar*', `(($2)$3.c_str())')
_CONVERSION(`const std::string&',`const char*',`$3.c_str()')
+_CONVERSION(`std::string',`const char*',`$3.c_str()')
_CONVERSION(`const Glib::ustring&',`gchar*',`const_cast<gchar*>($3.c_str())')
+_CONVERSION(`gchar*',`Glib::ustring',__GCHARP_TO_USTRING)
_CONVERSION(`const-gchar*',`Glib::ustring',__GCHARP_TO_USTRING)
_CONVERSION(`const-guchar*',`Glib::ustring',__GCHARP_TO_USTRING)
_CONVERSION(`const gchar*',`Glib::ustring',__GCHARP_TO_USTRING)
_CONVERSION(`const char*',`const-gchar*',`$3')
_CONVERSION(`const-gchar*',`const char*',`$3')
_CONVERSION(`const char*',`const std::string&',__GCHARP_TO_STDSTRING)
+_CONVERSION(`char*',`std::string',__GCHARP_TO_STDSTRING)
+_CONVERSION(`std::string', `char*', `g_strdup(($3).c_str())')
+_CONVERSION(`const std::string&', `char*', `g_strdup(($3).c_str())')
+_CONVERSION(`Glib::ustring', `char*', `g_strdup(($3).c_str())')
_CONVERSION(`return-gchar*',`Glib::ustring',`Glib::convert_return_gchar_ptr_to_ustring($3)')
_CONVERSION(`return-gchar*',`std::string',`Glib::convert_return_gchar_ptr_to_stdstring($3)')
dnl
-dnl _ENUM(cpp_type, c_type, value_suffix, `element_list', `no_gtype', `conv_to_int',
-dnl $1 $2 $3 $4 $5 $6
-dnl in_class, `optional_refdoc_comment', 'deprecated')
-dnl $7 $8 $9
+dnl _ENUM(cpp_type, c_type, value_suffix, `element_list', `gtype_func', `optional_refdoc_comment', 'deprecated')
+dnl $1 $2 $3 $4 $5 $6 $7
dnl
m4_define(`_ENUM',`dnl
_PUSH()
m4_define(`__ENUM_CPPNAME__',`$1')
m4_define(`__ENUM_CNAME__',`$2')
-m4_define(`__ENUM_CLASS_CPPNAME__',m4_ifelse($7,0,,`__CPPNAME__::')`__ENUM_CPPNAME__')
-m4_define(`__ENUM_INDENT1__',m4_ifelse($7,0,,` '))
-m4_define(`__ENUM_INDENT2__',__ENUM_INDENT1__`'m4_ifelse($6,,,` '))
-m4_define(`__ENUM_VALUE_BASE__',`Glib::Value_$3<__NAMESPACE__::__ENUM_CLASS_CPPNAME__>')
+m4_define(`__ENUM_VALUE_BASE__',`Glib::Value_$3<__NAMESPACE__::__ENUM_CPPNAME__>')
_POP()
dnl
m4_define(`__DOCGROUP_'__MODULE_CANONICAL__`_ENUMS__')dnl
/** @addtogroup '__MODULE_CANONICAL__`Enums __MODULE_CANONICAL__ Enums and Flags */
-__ENUM_INDENT1__')`'dnl endif
+')dnl endif
dnl
dnl
-ifelse(`$9',,,`_DEPRECATE_IFDEF_START'`'__ENUM_INDENT1__)`'dnl The expansion of _DEPRECATE_IFDEF_START ends with a newline
-ifelse($6,,,`/** Wrapper for enum __ENUM_CPPNAME__.
-__ENUM_INDENT1__ * __ENUM_CPPNAME__ enumerators are scoped and can be implicitly converted to int.
-__ENUM_INDENT1__ * The scope is __NAMESPACE__::__ENUM_CLASS_CPPNAME__::
-__ENUM_INDENT1__ *
-__ENUM_INDENT1__ * @ingroup __MODULE_CANONICAL__`'Enums
-__ENUM_INDENT1__ */
-__ENUM_INDENT1__`'class __ENUM_CPPNAME__`'_Wrapper final
-__ENUM_INDENT1__{
-__ENUM_INDENT1__`'public:
-__ENUM_INDENT2__')`'dnl endif conv_to_int
-/** $8
-__ENUM_INDENT2__ *
-__ENUM_INDENT2__ * @ingroup __MODULE_CANONICAL__`'Enums
-m4_ifelse($3,`Flags',`dnl
-__ENUM_INDENT2__ * @par Bitwise operators:
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__ operator|(__ENUM_CLASS_CPPNAME__, __ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__ operator&(__ENUM_CLASS_CPPNAME__, __ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__ operator^(__ENUM_CLASS_CPPNAME__, __ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__ operator~(__ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__& operator|=(__ENUM_CLASS_CPPNAME__&, __ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__& operator&=(__ENUM_CLASS_CPPNAME__&, __ENUM_CLASS_CPPNAME__)</tt><br>
-__ENUM_INDENT2__ * <tt>__ENUM_CLASS_CPPNAME__& operator^=(__ENUM_CLASS_CPPNAME__&, __ENUM_CLASS_CPPNAME__)</tt><br>
+ifelse(`$7',,,`_DEPRECATE_IFDEF_START')`'dnl The expansion of _DEPRECATE_IFDEF_START ends with a newline
+/** $6
+ *
+ * @ingroup __MODULE_CANONICAL__`'Enums
+m4_ifelse($3,Flags,`dnl
+ * @par Bitwise operators:
+ * <tt>%__ENUM_CPPNAME__ operator|(__ENUM_CPPNAME__, __ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__ operator&(__ENUM_CPPNAME__, __ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__ operator^(__ENUM_CPPNAME__, __ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__ operator~(__ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__& operator|=(__ENUM_CPPNAME__&, __ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__& operator&=(__ENUM_CPPNAME__&, __ENUM_CPPNAME__)</tt><br>
+ * <tt>%__ENUM_CPPNAME__& operator^=(__ENUM_CPPNAME__&, __ENUM_CPPNAME__)</tt><br>
')dnl endif
-__ENUM_INDENT2__ */
-__ENUM_INDENT2__`'enum ifelse($6,,`class ',)`'__ENUM_CPPNAME__
-__ENUM_INDENT2__{
+ */
+enum __ENUM_CPPNAME__
+{
$4
-__ENUM_INDENT2__};
-ifelse($6,,,`__ENUM_INDENT2__`'#ifndef DOXYGEN_SHOULD_SKIP_THIS
-__ENUM_INDENT2__`'__ENUM_CPPNAME__`'_Wrapper`'() = delete;
-__ENUM_INDENT2__`'#endif
-__ENUM_INDENT1__};
-__ENUM_INDENT1__/** __ENUM_CPPNAME__ enumerators are scoped by the wrapper class
-__ENUM_INDENT1__ * and can be implicitly converted to int.
-__ENUM_INDENT1__ *
-__ENUM_INDENT1__ * @ingroup __MODULE_CANONICAL__`'Enums
-__ENUM_INDENT1__ */
-__ENUM_INDENT1__`'using __ENUM_CPPNAME__ = __ENUM_CPPNAME__`'_Wrapper::__ENUM_CPPNAME__;
-')`'dnl endif conv_to_int
-m4_ifelse($3,`Flags',`dnl
-m4_ifelse($7,0,,`dnl in_class
-_PUSH(SECTION_HEADER3)
-__NAMESPACE_BEGIN__
-ifelse(`$9',,,`_DEPRECATE_IFDEF_START')`'dnl
-')dnl endif
+};
+m4_ifelse($3,Flags,`dnl
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__ operator|(__ENUM_CLASS_CPPNAME__ lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }
+inline __ENUM_CPPNAME__ operator|(__ENUM_CPPNAME__ lhs, __ENUM_CPPNAME__ rhs)
+ { return static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__ operator&(__ENUM_CLASS_CPPNAME__ lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }
+inline __ENUM_CPPNAME__ operator&(__ENUM_CPPNAME__ lhs, __ENUM_CPPNAME__ rhs)
+ { return static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__ operator^(__ENUM_CLASS_CPPNAME__ lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }
+inline __ENUM_CPPNAME__ operator^(__ENUM_CPPNAME__ lhs, __ENUM_CPPNAME__ rhs)
+ { return static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__ operator~(__ENUM_CLASS_CPPNAME__ flags)
- { return static_cast<__ENUM_CLASS_CPPNAME__>(~static_cast<unsigned>(flags)); }
+inline __ENUM_CPPNAME__ operator~(__ENUM_CPPNAME__ flags)
+ { return static_cast<__ENUM_CPPNAME__>(~static_cast<unsigned>(flags)); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__& operator|=(__ENUM_CLASS_CPPNAME__& lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return (lhs = static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }
+inline __ENUM_CPPNAME__& operator|=(__ENUM_CPPNAME__& lhs, __ENUM_CPPNAME__ rhs)
+ { return (lhs = static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__& operator&=(__ENUM_CLASS_CPPNAME__& lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return (lhs = static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }
+inline __ENUM_CPPNAME__& operator&=(__ENUM_CPPNAME__& lhs, __ENUM_CPPNAME__ rhs)
+ { return (lhs = static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }
/** @ingroup __MODULE_CANONICAL__`'Enums */
-inline __ENUM_CLASS_CPPNAME__& operator^=(__ENUM_CLASS_CPPNAME__& lhs, __ENUM_CLASS_CPPNAME__ rhs)
- { return (lhs = static_cast<__ENUM_CLASS_CPPNAME__>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }
-m4_ifelse($7,0,,`dnl in_class
-ifelse(`$9',,,`_DEPRECATE_IFDEF_END')`'dnl
-__NAMESPACE_END__
-_POP()
-')dnl endif
+inline __ENUM_CPPNAME__& operator^=(__ENUM_CPPNAME__& lhs, __ENUM_CPPNAME__ rhs)
+ { return (lhs = static_cast<__ENUM_CPPNAME__>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }
')dnl endif Flags
+ifelse(`$7',,,`_DEPRECATE_IFDEF_END')`'dnl The expansion of _DEPRECATE_IFDEF_END ends with a newline
-ifelse(`$9',,,`_DEPRECATE_IFDEF_END')`'dnl The expansion of _DEPRECATE_IFDEF_END ends with a newline
-
-m4_ifelse($5,`NO_GTYPE',,`dnl else
-m4_ifelse($7,0,`dnl not in_class
+m4_ifelse(`$5',`NO_GTYPE',,`dnl else
__NAMESPACE_END__
-',`dnl else
-_PUSH(SECTION_HEADER3)
-')dnl endif
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
-ifelse(`$9',,,`_DEPRECATE_IFDEF_START')`'dnl
+ifelse(`$7',,,`_DEPRECATE_IFDEF_START')`'dnl
template <>
-class Value<__NAMESPACE__::__ENUM_CLASS_CPPNAME__> : public __ENUM_VALUE_BASE__
+class Value<__NAMESPACE__::__ENUM_CPPNAME__> : public __ENUM_VALUE_BASE__
{
public:
static GType value_type() G_GNUC_CONST;
};
-ifelse(`$9',,,`_DEPRECATE_IFDEF_END')`'dnl
+ifelse(`$7',,,`_DEPRECATE_IFDEF_END')`'dnl
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
-m4_ifelse($7,0,`dnl not in_class
__NAMESPACE_BEGIN__
-',`dnl else
-_POP()
-')dnl endif
_PUSH(SECTION_SRC_GENERATED)
-ifelse(`$9',,,`_DEPRECATE_IFDEF_START')`'dnl
+ifelse(`$7',,,`_DEPRECATE_IFDEF_START')`'dnl
// static
-GType Glib::Value<__NAMESPACE__::__ENUM_CLASS_CPPNAME__>::value_type()
+GType Glib::Value<__NAMESPACE__::__ENUM_CPPNAME__>::value_type()
{
+m4_ifelse(`$5',,`dnl
return _GET_TYPE_FUNC(__ENUM_CNAME__);
+',`dnl
+ return `$5()';
+')dnl
}
-ifelse(`$9',,,`_DEPRECATE_IFDEF_END')`'dnl
+ifelse(`$7',,,`_DEPRECATE_IFDEF_END')`'dnl
_POP()
')dnl endif !NO_GTYPE
dnl
-dnl _GERROR(cpp_type, c_type, domain, `element_list', `no_gtype', `class_docs', `enum_docs', 'deprecated')
-dnl $1 $2 $3 $4 $5 $6 $7 $8
+dnl _GERROR(cpp_type, c_type, domain, `element_list', `gtype_func', `class_docs', `enum_docs', 'deprecated')
+dnl $1 $2 $3 $4 $5 $6 $7 $8
dnl
m4_define(`_GERROR',`dnl
};
ifelse(`$8',,,`_DEPRECATE_IFDEF_END')`'dnl The expansion of _DEPRECATE_IFDEF_END ends with a newline
-m4_ifelse($5,`NO_GTYPE',,`dnl else
+m4_ifelse(`$5',`NO_GTYPE',,`dnl else
__NAMESPACE_END__
#ifndef DOXYGEN_SHOULD_SKIP_THIS
throw __NAMESPACE__::__CPPNAME__`'(gobject);
}
-m4_ifelse($5,`NO_GTYPE',,`dnl else
+m4_ifelse(`$5',`NO_GTYPE',,`dnl else
// static
GType Glib::Value<__NAMESPACE__::__CPPNAME__::Code>::value_type()
{
+m4_ifelse(`$5',,`dnl
return _GET_TYPE_FUNC(__CNAME__);
+',`dnl
+ return `$5()';
+')dnl
}
')dnl endif !NO_GTYPE
')dnl
',dnl If the C function returns non-void:
dnl Store the return if there are C output parameters.
-`ifelse(`$6',,` return ',` auto retvalue = ')_CONVERT($4,`$3',`$2`'(ifelse(`$9',1,const_cast<__CNAME__*>(gobj()),gobj())`'ifelse(`$7',,,`, ')$7)');
+`ifelse(`$6',,` return ',` `$3' retvalue = ')_CONVERT($4,`$3',`$2`'(ifelse(`$9',1,const_cast<__CNAME__*>(gobj()),gobj())`'ifelse(`$7',,,`, ')$7)');
dnl Insert the initializations for the C output parameters
ifelse(`$8',,,`$8
')dnl
ifelse(`$6',,,`$6
')`'dnl
ifelse(`$16',,dnl If no C++ output parameter is specified:
-` ifelse(`$3',void,,`auto retvalue = ')_CONVERT($4,`$3',`$2`'(ifelse(`$9',1,const_cast<__CNAME__*>(gobj()),gobj())`'ifelse(`$7',,,`, ')$7)');
+` ifelse(`$3',void,,``$3' retvalue = ')_CONVERT($4,`$3',`$2`'(ifelse(`$9',1,const_cast<__CNAME__*>(gobj()),gobj())`'ifelse(`$7',,,`, ')$7)');
'dnl
,dnl A C++ output parameter is specified:
` _INITIALIZE($17,$4,`$16',`$2`'(ifelse(`$9',1,const_cast<__CNAME__*>(gobj()),gobj())`'ifelse(`$7',,,`, ')$7)',$21);
` ifelse(`$3',void,,dnl
dnl Returns non-void:
dnl Store the return if there are C output parameters
-ifelse(`$6',,`return ',`auto retval = '))_CONVERT($4,`$3',`$2`'($7)');'dnl
+ifelse(`$6',,`return ',``$3' retval = '))_CONVERT($4,`$3',`$2`'($7)');'dnl
dnl A C++ output parameter is specified so initialize it from C return
,` _INITIALIZE($14,$4,`$13',`$2`'($7)',$18);'dnl
)
ifelse(`$6',,,`$6
')`'dnl
ifelse(`$13',,dnl If no C++ output parameter is specified:
- ifelse(`$3',void,,`auto retvalue = ')_CONVERT($4,`$3',`$2`'($7)');dnl
+ ifelse(`$3',void,,``$3' retvalue = ')_CONVERT($4,`$3',`$2`'($7)');dnl
dnl A C++ output parameter is specified:
,` _INITIALIZE($14,$4,`$13',`$2`'($7)',$18);'dnl
)dnl
')dnl
ifelse($13,,`dnl no detail_name
$10
- Glib::SignalProxy<$5`'($6)> signal_$4`'();
+ Glib::SignalProxy< $5`'_COMMA_PREFIX($6) > signal_$4`'();
',dnl detail_name
$14,0,`dnl
$10
- Glib::SignalProxyDetailed<$5`'($6)> signal_$4`'(const Glib::ustring& $13 = Glib::ustring());
+ Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) > signal_$4`'(const Glib::ustring& $13 = Glib::ustring());
',`dnl detail_name and two_signal_methods
$10
- Glib::SignalProxy<$5`'($6)> signal_$4`'();
+ Glib::SignalProxy< $5`'_COMMA_PREFIX($6) > signal_$4`'();
$10
- Glib::SignalProxyDetailed<$5`'($6)> signal_$4`'(const Glib::ustring& $13);
+ Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) > signal_$4`'(const Glib::ustring& $13);
')dnl end detail_name
ifelse(`$9',,,`_DEPRECATE_IFDEF_END
')dnl
static $2 __CPPNAME__`'_signal_$4_callback`'(__CNAME__`'* self, _COMMA_SUFFIX($3)`'void* data)
{
using namespace __NAMESPACE__;
- using SlotType = sigc::slot<$5`'($6)>;
+ using SlotType = sigc::slot< $5`'_COMMA_PREFIX($6) >;
auto obj = dynamic_cast<__CPPNAME__*>(Glib::ObjectBase::_get_current_wrapper((GObject*) self));
// Do not try to call a signal on a disassociated wrapper.
static $2 __CPPNAME__`'_signal_$4_notify_callback`'(__CNAME__`'* self, _COMMA_SUFFIX($3)`' void* data)
{
using namespace __NAMESPACE__;
- using SlotType = sigc::slot<void($6)>;
+ using SlotType = sigc::slot< void`'_COMMA_PREFIX($6) >;
auto obj = dynamic_cast<__CPPNAME__*>(Glib::ObjectBase::_get_current_wrapper((GObject*) self));
// Do not try to call a signal on a disassociated wrapper.
ifelse(`$9',,,`_DEPRECATE_IFDEF_START
')dnl
ifelse($13,,`dnl no detail_name
-Glib::SignalProxy<$5`'($6)> __CPPNAME__::signal_$4`'()
+Glib::SignalProxy< $5`'_COMMA_PREFIX($6) > __CPPNAME__::signal_$4`'()
{
- return Glib::SignalProxy<$5`'($6) >(this, &__CPPNAME__`'_signal_$4_info);
+ return Glib::SignalProxy< $5`'_COMMA_PREFIX($6) >(this, &__CPPNAME__`'_signal_$4_info);
}
',dnl detail_name
$14,0,`dnl
-Glib::SignalProxyDetailed<$5`'($6)> __CPPNAME__::signal_$4`'(const Glib::ustring& $13)
+Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) > __CPPNAME__::signal_$4`'(const Glib::ustring& $13)
{
- return Glib::SignalProxyDetailed<$5`'($6)>(this, &__CPPNAME__`'_signal_$4_info, $13);
+ return Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) >(this, &__CPPNAME__`'_signal_$4_info, $13);
}
',`dnl detail_name and two_signal_methods
-Glib::SignalProxy<$5`'($6)> __CPPNAME__::signal_$4`'()
+Glib::SignalProxy< $5`'_COMMA_PREFIX($6) > __CPPNAME__::signal_$4`'()
{
- return Glib::SignalProxy<$5`'($6)>(this, &__CPPNAME__`'_signal_$4_info);
+ return Glib::SignalProxy< $5`'_COMMA_PREFIX($6) >(this, &__CPPNAME__`'_signal_$4_info);
}
-Glib::SignalProxyDetailed<$5`'($6)> __CPPNAME__::signal_$4`'(const Glib::ustring& $13)
+Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) > __CPPNAME__::signal_$4`'(const Glib::ustring& $13)
{
- return Glib::SignalProxyDetailed<$5`'($6)>(this, &__CPPNAME__`'_signal_$4_info, $13);
+ return Glib::SignalProxyDetailedAnyType< $5`'_COMMA_PREFIX($6) >(this, &__CPPNAME__`'_signal_$4_info, $13);
}
')dnl end detail_name
ifelse(`$9',,,`_DEPRECATE_IFDEF_END
# due to imperfections in the C docs, and it's difficult to get the C docs
# corrected, correct docs can be added to the docs_override.xml file.
- if (scalar @docs_param_names != scalar @c_param_names)
- {
- print STDERR "DocsParser.pm: Warning, $$obj_function{name}\n" .
- " Incompatible parameter lists in the docs.xml file and the methods.defs file.\n";
- }
-
# Skip first param if this is a signal.
if ($$obj_function{name} =~ /\w+::/)
{
# Skip the last param if it's an error output param.
if (scalar @docs_param_names && $docs_param_names[-1] eq "error")
{
- # If the number of parameters in @docs_param_names is not greater than
- # the number of parameters in the _WRAP macro, the parameter called "error"
- # is probably not an error output parameter.
- if (!defined($objCppfunc) || scalar @docs_param_names > scalar @{$$objCppfunc{param_names}})
- {
- pop(@docs_param_names);
- pop(@c_param_names);
- }
+ pop(@docs_param_names);
+ pop(@c_param_names);
}
my $cpp_param_names;
{
$out_param_index = $$param_mappings{OUT};
}
- if (scalar @docs_param_names != scalar @$cpp_param_names)
- {
- print STDERR "DocsParser.pm: Warning, $$obj_function{name}\n" .
- " Incompatible parameter lists in the docs.xml file and the _WRAP macro.\n";
- }
}
my %param_name_mappings; # C name -> C++ name
my $cxx_name = (($module eq "G") ? "" : (ucfirst(lc($module)) . "::")) . $name;
- print "DocsParser.pm: Assuming the enumerator $c_name shall become $cxx_name.\n";
-
+ #print "DocsParser.pm: Assuming the enumerator $c_name shall become $cxx_name.\n";
return $cxx_name;
}
# string module;
# string c_type;
#
-# string array elem_short_names;
# string array elem_names;
# string array elem_values;
# string c_prefix;
$$self{flags} = 0;
$$self{c_prefix} = "";
- $$self{elem_short_names} = [];
$$self{elem_names} = [];
$$self{elem_values} = [];
}
# this should never happen
- warn if(scalar(@{$$self{elem_short_names}}) != scalar(@{$$self{elem_values}}));
warn if(scalar(@{$$self{elem_names}}) != scalar(@{$$self{elem_values}}));
return $self;
{
my ($self, $value) = @_;
- my $elem_short_names = [];
my $elem_names = [];
my $elem_values = [];
my $common_prefix = undef;
# and handles triples like '("dq-token", "MY_SCANNER_DQ_TOKEN", "'"'").
foreach (split_enum_tokens($value))
{
- if (/^"(\S+)" "(\S+)" "(.+)"$/)
+ if (/^"\S+" "(\S+)" "(.+)"$/)
{
- my ($nick_name, $name, $value) = ($1, $2, $3);
+ my ($name, $value) = ($1, $2);
# detect whether there is module prefix common to all names, e.g. GTK_
my $prefix = $1 if ($name =~ /^([^_]+_)/);
$common_prefix = "";
}
- # enum.pl generates nick names from the C names of the enum constants.
- # A nick name consists of the trailing part of the enum name.
- # The leading part which is common for each constant of an enum type
- # has been removed. The remaining part is then tranform to lowercase
- # and hyphens.
- # Transform the nick name with lowercase letters and hyphens
- # back to a short name with uppercase letters and underscores.
- # The short names are suitable for 'enum class' definitions.
- $nick_name =~ tr/a-z-/A-Z_/;
- push(@$elem_short_names, $nick_name);
push(@$elem_names, $name);
push(@$elem_values, $value);
}
$$self{c_prefix} = $common_prefix;
}
- $$self{elem_short_names} = $elem_short_names;
$$self{elem_names} = $elem_names;
$$self{elem_values} = $elem_values;
}
-sub beautify_values($$)
+sub beautify_values($)
{
- my ($self, $use_short_names) = @_;
+ my ($self) = @_;
return if($$self{flags});
- my $elem_names = $use_short_names ? $$self{elem_short_names} : $$self{elem_names};
+ my $elem_names = $$self{elem_names};
my $elem_values = $$self{elem_values};
my $num_elements = scalar(@$elem_values);
sub build_element_list($$$$)
{
- my ($self, $use_short_names, $ref_subst_in, $ref_subst_out, $indent) = @_;
+ my ($self, $ref_subst_in, $ref_subst_out, $indent) = @_;
- my $elem_names = $use_short_names ? $$self{elem_short_names} : $$self{elem_names};
+ my $elem_names = $$self{elem_names};
my $elem_values = $$self{elem_values};
my $num_elements = scalar(@$elem_names);
return $elements;
}
-# The name prefix is defined by: $name_prefix . $short_name eq $name
-# I.e. what shall be chopped off the name to get the short name.
-sub get_name_prefix($)
-{
- my ($self) = @_;
-
- my $name = ${$$self{elem_names}}[0];
- my $short_name = ${$$self{elem_short_names}}[0];
- my $prefix_length = length($name) - length($short_name);
-
- return substr($name, 0, $prefix_length);
-}
-
sub dump($)
{
my ($self) = @_;
# but possibly spaces between the multiple ">>".
# Quoted strings are not detected. If a quoted string exists in a function
# prototype, it's probably as part of a default value, inside ("x") or {"y"}.
- #
+ #
my @str = ();
foreach (split(/(\bconst\b|[,=&*>]|<.*?>|{.*?}|\(.*?\)|\s+)/, $line))
{
}
# void output_wrap_enum($filename, $line_num, $cpp_type, $c_type,
-# $comment, $ref_subst_in, $ref_subst_out, $no_gtype, $conv_to_int,
-# $in_class, $deprecated, $deprecation_docs, $newin)
-sub output_wrap_enum($$$$$$$$$$$$$$)
+# $comment, $ref_subst_in, $ref_subst_out, $gtype_func,
+# $deprecated, $deprecation_docs, $newin)
+sub output_wrap_enum($$$$$$$$$$$$)
{
my ($self, $filename, $line_num, $cpp_type, $c_type,
- $comment, $ref_subst_in, $ref_subst_out, $no_gtype, $conv_to_int,
- $in_class, $deprecated, $deprecation_docs, $newin) = @_;
+ $comment, $ref_subst_in, $ref_subst_out, $gtype_func,
+ $deprecated, $deprecation_docs, $newin) = @_;
my $objEnum = GtkDefs::lookup_enum($c_type);
if(!$objEnum)
return;
}
- $objEnum->beautify_values(1);
+ $objEnum->beautify_values();
- my $indent = " ";
- $indent .= " " if ($in_class);
- $indent .= " " if ($conv_to_int);
- my $elements = $objEnum->build_element_list(1, $ref_subst_in, $ref_subst_out, $indent);
+ my $elements = $objEnum->build_element_list($ref_subst_in, $ref_subst_out, " ");
add_m4_quotes(\$elements);
if(!$elements)
return;
}
- # Chop off the name prefix in the documentation.
- my $name_prefix = $objEnum->get_name_prefix();
- unshift(@$ref_subst_in, "^$name_prefix");
- unshift(@$ref_subst_out, "");
+ my $value_suffix = "Enum";
+ $value_suffix = "Flags" if($$objEnum{flags});
# Get the enum documentation from the parsed docs.
- $indent = substr($indent, 1); # Remove one blank
my $enum_docs = DocsParser::lookup_enum_documentation("$c_type", "$cpp_type",
- $indent, $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin);
+ " ", $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin);
# Merge the passed in comment to the existing enum documentation.
- $comment .= "\n$indent* $enum_docs" if $enum_docs ne "";
-
- my $value_suffix = "Enum";
- $value_suffix = "Flags" if ($$objEnum{flags});
+ $comment .= "\n * " . $enum_docs if $enum_docs ne "";
- my $str = sprintf("_ENUM(%s,%s,%s,\`%s\',\`%s\',\`%s\',%d,\`%s\',\`%s\')dnl\n",
+ my $str = sprintf("_ENUM(%s,%s,%s,\`%s\',\`%s\',\`%s\',\`%s\')dnl\n",
$cpp_type,
$c_type,
$value_suffix,
$elements,
- $no_gtype,
- $conv_to_int,
- $in_class,
+ $gtype_func,
$comment,
$deprecated
);
+
$self->append($str);
}
-sub output_wrap_enum_docs_only($$$$$$$$$$$$)
+sub output_wrap_enum_docs_only($$$$$$$$$$$)
{
my ($self, $filename, $line_num, $module_canonical, $cpp_type, $c_type,
- $comment, $ref_subst_in, $ref_subst_out, $in_class, $deprecation_docs, $newin) = @_;
+ $comment, $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin) = @_;
- my $objEnum = GtkDefs::lookup_enum($c_type);
- if(!$objEnum)
- {
- $self->output_wrap_failed($c_type, "enum defs lookup failed.");
- return;
- }
- # Chop off the name prefix in the documentation.
- my $name_prefix = $objEnum->get_name_prefix();
- unshift(@$ref_subst_in, "^$name_prefix");
- unshift(@$ref_subst_out, "");
-
- # Get the enum documentation from the parsed docs.
- my $indent = " ";
- $indent .= " " if ($in_class);
+ # Get the existing enum description from the parsed docs.
my $enum_docs = DocsParser::lookup_enum_documentation("$c_type", "$cpp_type",
- $indent, $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin);
+ " ", $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin);
if($enum_docs eq "")
{
}
# Include the enum docs in the module's enum docs group.
- $enum_docs .= "\n$indent*\n$indent* \@ingroup ${module_canonical}Enums";
+ $enum_docs .= "\n *\n * \@ingroup ${module_canonical}Enums";
# Merge the passed in comment to the existing enum documentation.
- $comment = "/** " . $comment . "\n$indent* " . $enum_docs . "\n$indent*/\n";
+ $comment = "/** " . $comment . "\n * " . $enum_docs . "\n */\n";
$self->append($comment);
}
# void output_wrap_gerror($filename, $line_num, $cpp_type, $c_type, $domain,
-# $class_docs, $ref_subst_in, $ref_subst_out, $no_gtype,
+# $class_docs, $ref_subst_in, $ref_subst_out, $gtype_func,
# $deprecated, $deprecation_docs, $newin)
sub output_wrap_gerror($$$$$$$$$$$$$)
{
my ($self, $filename, $line_num, $cpp_type, $c_type, $domain,
- $class_docs, $ref_subst_in, $ref_subst_out, $no_gtype,
+ $class_docs, $ref_subst_in, $ref_subst_out, $gtype_func,
$deprecated, $deprecation_docs, $newin) = @_;
my $objDefsParser = $$self{objDefsParser};
# Shouldn't happen, and if it does, I'd like to know that.
warn if($$objEnum{flags});
- $objEnum->beautify_values(0);
+ $objEnum->beautify_values();
# cut off the module prefix, e.g. GDK_
my $prefix = $domain;
unshift(@$ref_subst_in, "^${prefix}_");
unshift(@$ref_subst_out, "");
- my $elements = $objEnum->build_element_list(0, $ref_subst_in, $ref_subst_out, " ");
+ my $elements = $objEnum->build_element_list($ref_subst_in, $ref_subst_out, " ");
add_m4_quotes(\$elements);
# Get the enum documentation from the parsed docs.
# Prevent Doxygen from auto-linking to a class called Exception.
$class_docs =~ s/([^%])(Exception class)/$1%$2/g;
- my $str = sprintf("_GERROR(%s,%s,%s,\`%s\',%s,\`%s\',\`%s\',\`%s\')dnl\n",
+ my $str = sprintf("_GERROR(%s,%s,%s,\`%s\',\`%s\',\`%s\',\`%s\',\`%s\')dnl\n",
$cpp_type,
$c_type,
$domain,
$elements,
- $no_gtype,
+ $gtype_func,
$class_docs,
$enum_docs,
$deprecated
my $str = "";
# Move to the first "(":
- while (scalar(@tokens))
- {
- my $t = $self->extract_token();
- last if ($t eq "(");
- }
+ while ( scalar(@tokens) )
+ {
+ my $t = $self->extract_token();
+ last if ($t eq "(");
+ }
- my $filename = $$self{filename};
- my $line_num = $$self{line_num};
+ # TODO: Don't count "(" and ")" within double quotes.
+ # There may be .hg files with unpaired quotes that generate correct
+ # .h and .cc files. Don't want to break such code yet.
+ # See also TODO in string_split_commas().
# Concatenate until the corresponding ")":
- while (scalar(@tokens) and $filename eq $$self{filename})
- {
- my $t = $self->extract_token();
- $in_quotes = !$in_quotes if ($t eq '"');
- # Don't count "(" and ")" within double quotes.
- if (!$in_quotes)
+ while ( scalar(@tokens) )
{
+ my $t = $self->extract_token();
+ $in_quotes = !$in_quotes if ($t eq '"');
$level++ if ($t eq "(");
$level-- if ($t eq ")");
- return $str if (!$level); # Found matching ")"
+
+ if (!$level)
+ {
+ $self->error("End of gmmproc directive within a quoted string.\n") if $in_quotes;
+ return $str;
+ }
+ $str .= $t;
}
- $str .= $t;
- }
- # No matching ")" found.
- my $quote_text = $in_quotes ? " in a quoted string" : "";
- die "$filename:$line_num: *** End of file$quote_text in a gmmproc macro. ***\n";
+ return "";
}
########################################
### breaks up a string by commas (smart)
-# @strings string_split_commas($string)
-sub string_split_commas($)
+# @strings string_split_commas($string [, $ignore_quotes])
+sub string_split_commas($;$)
{
- my ($in) = @_;
+ my ($in, $ignore_quotes) = @_;
+ $ignore_quotes = 2 unless defined $ignore_quotes;
my @out;
my $level = 0;
my $in_quotes = 0;
next if ($t eq "");
- $in_quotes = !$in_quotes if ($t eq '"');
+ # TODO: Delete the test for scalar(@out) >= $ignore_quotes when we can stop accepting
+ # .hg files with unpaired quotes, such as _WRAP_PROPERTY("text_column, int).
+ # See also TODO in extract_bracketed_text().
+ $in_quotes = !$in_quotes if ($t eq '"' and scalar(@out) >= $ignore_quotes);
if (!$in_quotes)
{
$level++ if ($t eq "(" or $t eq "<" or $t eq "{");
}
# The "slot_callback" option tells gmmproc the name of the
# callback function that should be passed to the C function if the
- # method has a slot. The name can contain a namespace prefix.
- elsif($argRef =~ /^slot_callback\s+([:\w]+)/)
+ # method has a slot.
+ elsif($argRef =~ /^slot_callback\s+(\w+)/)
{
$$objCppfunc{slot_callback} = $1;
}
my $line_num = $$self{line_num};
my $str = $self->extract_bracketed_text();
- my @args = string_split_commas($str);
+ my @args = string_split_commas($str, 1);
my $entity_type = "method";
my @subst_in = [];
my @subst_out = [];
- my $no_gtype = "";
- my $conv_to_int = "";
+ my $gtype_func = "";
my $argDeprecated = "";
my $deprecation_docs = "";
my $newin = "";
+ # $gtype_func:
+ # 1. If an empty string, the M4 macro _ENUM or _GERROR calls _GET_TYPE_FUNC()
+ # that generates the function name from the name of the C type, e.g.
+ # GFileAttributeType -> g_file_attribute_type_get_type
+ # 2. If NO_GTYPE, no call to a *_get_type() function and no Glib::Value
+ # specialization is generated for the enum type.
+ # 3. If anything else, it's assumed to be the name of the *_get_type() function
+ # to generate a call to.
+
# Build a list of custom substitutions, and recognize some flags too.
foreach (@args)
{
if ($arg eq "NO_GTYPE")
{
- $no_gtype = $arg;
+ $gtype_func = "NO_GTYPE";
}
- elsif (!$is_gerror and $arg eq "CONV_TO_INT")
+ elsif ($arg =~ /^gtype_func\s+(\w+)/)
{
- $conv_to_int = $arg;
+ $gtype_func = $1;
}
elsif ($arg =~ /^s#([^#]+)#([^#]*)#$/)
{
$newin = string_unquote(string_trim($1));
}
}
- return ($cpp_type, $c_type, $domain, \@subst_in, \@subst_out, $no_gtype,
- $conv_to_int, $argDeprecated, $deprecation_docs, $newin);
+ return ($cpp_type, $c_type, $domain, \@subst_in, \@subst_out, $gtype_func,
+ $argDeprecated, $deprecation_docs, $newin);
}
-# void on_wrap_enum()
-# _WRAP_ENUM(cpp_type, c_type [,NO_GTYPE] [,CONV_TO_INT] [,s#regexpr#subst#]*)
-# Optional arguments:
-# NO_GTYPE Don't generate code for a specialization of the template
-# Glib::Value_Enum or Glib::Value_Flags.
-# Necessary, if the C type enum is not registered as a GType.
-# CONV_TO_INT "Convertible to int" Generate a plain enum (not an enum class)
-# within a class. Such an enum is scoped like an enum class,
-# and it can be implicitly converted to int like a plain enum.
-# s#regexpr#subst# Zero or more substitutions in names of enum constants, e.g. s#^DATE_##.
-#
-# _WRAP_ENUM can be located either in a class or outside all classes.
-# When located in a class, and Value specialization shall be generated or it's
-# a Flags type (i.e. bitwise operators shall be generated), then the following
-# requirements must be fulfilled:
-# 1. _WRAP_ENUM must be located in the public part of the class.
-# 2. The class must contain a class macro (_CLASS_GENERIC, _CLASS_GOBJECT,
-# _CLASS_GTKOBJECT, etc.) before _WRAP_ENUM.
-#
sub on_wrap_enum($)
{
my ($self) = @_;
my $comment = $self->extract_preceding_documentation();
# get the arguments
- my ($cpp_type, $c_type, undef, $ref_subst_in, $ref_subst_out, $no_gtype, $conv_to_int,
+ my ($cpp_type, $c_type, undef, $ref_subst_in, $ref_subst_out, $gtype_func,
$argDeprecated, $deprecation_docs, $newin) = $self->on_wrap_any_enum(0);
$$self{objOutputter}->output_wrap_enum(
$$self{filename}, $$self{line_num}, $cpp_type, $c_type,
- $comment, $ref_subst_in, $ref_subst_out, $no_gtype, $conv_to_int,
- $$self{in_class}, $argDeprecated, $deprecation_docs, $newin);
+ $comment, $ref_subst_in, $ref_subst_out, $gtype_func,
+ $argDeprecated, $deprecation_docs, $newin);
}
sub on_wrap_enum_docs_only($)
my $comment = $self->extract_preceding_documentation();
# get the arguments
- my ($cpp_type, $c_type, undef, $ref_subst_in, $ref_subst_out, undef, undef,
+ my ($cpp_type, $c_type, undef, $ref_subst_in, $ref_subst_out, undef,
$argDeprecated, $deprecation_docs, $newin) = $self->on_wrap_any_enum(0);
# Get the module name so the enum docs can be included in the module's
$$self{objOutputter}->output_wrap_enum_docs_only(
$$self{filename}, $$self{line_num}, $module_canonical, $cpp_type, $c_type,
- $comment, $ref_subst_in, $ref_subst_out, $$self{in_class}, $deprecation_docs, $newin);
+ $comment, $ref_subst_in, $ref_subst_out, $deprecation_docs, $newin);
}
sub on_wrap_gerror($)
my $class_docs = $self->extract_preceding_documentation();
# get the arguments
- my ($cpp_type, $c_type, $domain, $ref_subst_in, $ref_subst_out, $no_gtype, undef,
+ my ($cpp_type, $c_type, $domain, $ref_subst_in, $ref_subst_out, $gtype_func,
$argDeprecated, $deprecation_docs, $newin) = $self->on_wrap_any_enum(1);
$$self{objOutputter}->output_wrap_gerror(
$$self{filename}, $$self{line_num}, $cpp_type, $c_type, $domain,
- $class_docs, $ref_subst_in, $ref_subst_out, $no_gtype,
+ $class_docs, $ref_subst_in, $ref_subst_out, $gtype_func,
$argDeprecated, $deprecation_docs, $newin);
}
# files that it depends on.
# Example: In glibmm, go to directory glibmm, and run
-# tools/test_scripts/testheaders.sh -I glib glibmm-2.60 gio # compile glibmm/gio/giomm/*.h
-# tools/test_scripts/testheaders.sh glibmm-2.60 glib gio # compile glibmm/glib/glibmm/*.h and glibmm/gio/giomm/*.h
-# tools/test_scripts/testheaders.sh -I glib -I gio glibmm-2.60 glib/glibmm/ustring.h # compile glibmm/glib/glibmm/ustring.h
+# tools/test_scripts/testheaders.sh -I glib glibmm-2.4 gio # compile glibmm/gio/giomm/*.h
+# tools/test_scripts/testheaders.sh glibmm-2.4 glib gio # compile glibmm/glib/glibmm/*.h and glibmm/gio/giomm/*.h
+# tools/test_scripts/testheaders.sh -I glib -I gio glibmm-2.4 glib/glibmm/ustring.h # compile glibmm/glib/glibmm/ustring.h
# Usage: testheaders.sh [-I<dir>]... <pkg> [<dir> | <file>]...
# -I<dir> is added to the g++ command.
exit 1
}
-extra_gcc_args=-std=c++17
-
# Search for directories to include in CFLAGS.
idirs=""
while [ $# -gt 0 ]
for headerfile in $i/${i}mm/*.h
do
echo "=== $headerfile"
- g++ -c -x c++ $extra_gcc_args -o /dev/null $headerfile $CFLAGS
+ g++ -c -x c++ -std=c++11 -o /dev/null $headerfile $CFLAGS
done
else
echo "=== $i"
- g++ -c -x c++ $extra_gcc_args -o /dev/null $i $CFLAGS
+ g++ -c -x c++ -std=c++11 -o /dev/null $i $CFLAGS
fi
done
projects / platform / upstream / glibmm.git / commitdiff