luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 15:06:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

[gtypelib.h] Document SimpleTypeBlob more

Browse Source
This commit is contained in:
Colin Walters 2009-11-04 11:43:13 -05:00
parent 6b5a358371
commit 8ba5a13d17
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
gtypelib.h
View File

@ -303,6 +303,20 @@ typedef struct {
* @offset: Offset relative to header->types that points to a TypeBlob.
* Unlike other offsets, this is in words (ie 32bit units) rather
* than bytes.
*
* The SimpleTypeBlob is the general purpose "reference to a type" construct, used
* in method parameters, returns, callback definitions, fields, constants, etc.
* It's actually just a 32 bit integer which you can see from the union definition.
* This is for efficiency reasons, since there are so many references to types.
*
* SimpleTypeBlob is divided into two cases; first, if "reserved" and "reserved2", the
* type tag for a basic type is embedded in the "tag" bits. This allows e.g.
* GI_TYPE_TAG_UTF8, GI_TYPE_TAG_INT and the like to be embedded directly without
* taking up extra space.
*
* References to "interfaces" (objects, interfaces) are more complicated; In this case,
* the integer is actually an offset into the directory (see above). Because the header
* is larger than 2^8=256 bits, all offsets will have one of the upper 24 bits set.
*/
typedef union
{