c++-gtk-utils
c++-gtk-utils library

This is a lightweight library containing a number of classes and functions for programming GTK+ programs using C++ in POSIX (unix-like) environments, where the user does not want to use a full-on wrapper such as gtkmm or wxWidgets, or is concerned about exception safety or thread safety of the wrapper and their documentation.

The latest version in the 2.2 series of the library is version 2.2.14.1, and can be downloaded from http://sourceforge.net/projects/cxx-gtk-utils/files/cxx-gtk-utils/2.2.14.1/c++-gtk-utils-2.2.14.1.tar.gz/download .

This 2.2 series of the library is only for use with C++0x/11/14. If using gcc, gcc-4.6 or later is required. In addition, it will compile with clang-3.4 or later. If using gcc-4.4, gcc-4.5 or clang-3.3 with C++0x/11, use the 2.0 series of this library. The 1.2 series of the library is available for use with C++98/03 and earlier versions of gcc or clang, and can also be compiled under C++0x/11/14.

If using gcc-4.6 or 4.7.0 user code must be compiled with the -std=c++0x compiler flag. gcc-4.7.1 onwards accepts either the -std=c++0x or -std=c++11 compiler flag, as does clang-3.4. For those compilers which support it, user code can also be compiled with the -std=c++1y and -std=c++14 flags.

The library can be separately built (and parallel-installed) for both GTK+2 and GTK+3, and parallel installations can be separately queried for when configuring user programs for compilation, by means of c++-gtk-utils-2-2.2.pc (for GTK+2) and c++-gtk-utils-3-2.2.pc (for GTK+3). There is also an option to compile the library without GTK+ support, so only requiring glib. See GTK versions for further details.

It provides the following:

  • Functions to make single instance programs, where restarting will bring up the existing instance (Cgu::prog_present). This is an optional inclusion - it will only be compiled into the library if dbus-glib >= 0.70 or glib >= 2.26 is installed.
  • Functions for connecting a Callback object and a unix file descriptor to the main loop, with provision for automatic disconnection (Cgu::start_iowatch()).
  • A class encapsulating anonymous unix pipes (Cgu::PipeFifo), and for synchronising between processes when setting up (Cgu::SyncPipe).
  • A class for reassembling UTF-8 strings sent over pipes and sockets so they form complete valid UTF-8 characters suitable for GTK+ widgets (Cgu::Utf8::Reassembler).
  • Functions to enable std::tuple objects to be expanded into their component elements in order to pass those elements to functions as arguments on function calls (Cgu::tuple_apply()).
  • A utility adaptor to create a functor to execute a class member function on items contained by standard containers, equivalent to std::ptr_fun() for ordinary functions (Cgu::MemFun::make()).
Note
1. Certain parts of this library would (if compiled for windows with a suitable build system) work under windows without cygwin, such as the classes for managing object lifetime and memory management (including the locked shared pointer class as that uses glib atomic functions by default), the iostreams for GIO, the iostreams for file descriptors as regards their use with winsock sockets (with changes to the headers), the utf8 utilities, the text print manager and the callback/closure classes, including the callback posting function for inter-thread communication. (The thread-safe signal/emitter classes could not be used under windows without rewriting the mutex locking to use GMutex or windows critical sections.)
2. This library is released under the GNU Lesser General Public License version 2.1. Where a header file or template file in the library provides a templated class or function or inline function or macro, the licence is modified to provide an exception for the template, inline function or macro in the following terms: 'However, it is not intended that the object code of a program whose source code instantiates a template from this file or uses macros or inline functions (of any length) should by reason only of that instantiation or use be subject to the restrictions of use in the GNU Lesser General Public License. With that in mind, the words "and macros, inline functions and instantiations of templates (of any length)" shall be treated as substituted for the words "and small macros and small inline functions (ten lines or less in length)" in the fourth paragraph of section 5 of that licence. This does not affect any other reason why object code may be subject to the restrictions in that licence (nor for the avoidance of doubt does it affect the application of section 2 of that licence to modifications of the source code in this file).'
3. The library is placed in the Cgu namespace, but if the --with-cgu-using-directive configuration option is passed to ./configure, a 'using namespace Cgu' directive is placed in each of the library headers to maintain source compatibility with versions of the library prior to version 1.2.0. See Namespace Cgu for further details.
4. The library may be configured, with the --with-glib-memory-slices-compat or --with-glib-memory-slices-no-compat configuration options, so that where objects from the library are constructed on free store, they are constructed in memory allocated with glib memory slices. See Memory allocation for further details.
5. The library can be separately built and parallel-installed for both GTK+2 (version >= 2.10) and GTK+3 (version >= 2.90.0), and parallel installations can be separately queried for when configuring user programs for compilation by means of c++-gtk-utils-2-2.2.pc (for GTK+2) and c++-gtk-utils-3-2.2.pc (for GTK+3). There is also an option to compile the library without GTK+ support, so only requiring glib. See GTK versions for further details.
6. The ChangeLog can be viewed at: http://cxx-gtk-utils.sourceforge.net/2.2/ChangeLog
7. The current files in git can be viewed at: http://sourceforge.net/p/cxx-gtk-utils/git/ci/master/tree/ , and can be obtained with:
git clone git://git.code.sf.net/p/cxx-gtk-utils/git
Then run './bootstrap-gtk2.sh', './bootstrap-gtk3.sh', '.configure' and 'make docs' for a complete distribution, or clone the remote repository directly over the top of the latest release for the 2.2 series.
8. There is a mailing list concerning the use or development of the library at http://lists.sourceforge.net/lists/listinfo/cxx-gtk-utils-general/

The author can be contacted at: cvine -at- users -dot- sourceforge -dot- net