dbus-gtype-specialized.c File Reference

SECTION:dbus-gtype-specialized : Specialized GTypes : Unstable

Specialized gtypes are basically a way to allow the definition of recursive GTypes. It allows the definition of 'containers' which is basically a user defined structure capabale of holding other data and a set of functions defining how to access that structure. Containers come in 3 flavors: collections, maps and structs.

A collection is a container that holds an ordered set of items, all of which must be the same type.

A map is a container that holds a set of key/value pairs. The keys have one type, and the values another.

A struct is a container that holds a fixed number of members, each member having a predefined type.

A specialization is a GType detailing a particular container with particular types (a type specialization).

Functions are provided for constructing and manipulating specializations.

This documentation needs splitting into two pages, one for defining new containers and using existing containers. I expect most users to only do the latter. I also need to add some examples.