mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-07-31 22:23:39 +02:00
add reserved fundamental ids for gtk types (for transition time). added
Fri May 5 01:15:48 2000 Tim Janik <timj@gtk.org> * gtype.h: add reserved fundamental ids for gtk types (for transition time). added G_TYPE_FUNDAMENTAL_MAX for gtk. Mon Apr 17 20:45:50 2000 Tim Janik <timj@gtk.org> * glib-gobject.c (g_object_base_class_finalize): oops, don't unset n_params prior to destructing them. Tue Apr 11 04:28:10 2000 Tim Janik <timj@gtk.org> * fixed a couple of bugs in the initial parameter/object implementations, after getting beast running on GObject and GValue. Fri Apr 7 04:27:49 2000 Tim Janik <timj@gtk.org> * glib-gobject.[hc]: completed parameter set/get implementations, along with asyncronous parameter changed notification queue. Sun Apr 2 04:54:36 2000 Tim Janik <timj@gtk.org> * glib-gobject.[hc]: GObject implementation, that is facilities for setting/getting quarked data and reference counting. * glib-gparamspecs.[hc]: first actuall parameter implementations for GLib, so far we have: char, uchar, bool, int, uint, long, ulong, enum, flags, float, double, string and object. each of these GParamSpecs is a new instantiatable type in its own respect, so the .c file derives 13 new types from G_TYPE_PARAM and defines over 50 (*2) conversion facilities. * glib-gvaluecollector.h: generic varargs handling stubs for GParamSpecs, private header file (does get installed for inclusion into user code though). * glib-gvalue.[hc]: GValue functionality implementation. * glib-gparam.[hc]: basis GParamSpec implementation for the virtual base type G_TYPE_PARAM. * glib-genums.[hc]: enum/flags type implementation, based on bseenum.[hc]. * glib-extra.[hc]: GLib additions, including 1.3 compatibility routines and various other functions, from string manipulation over list manipulation up to a unix signal GSource. * glib-gtype.[hc]: GLib Type System implementation, heavily based on BSE's dynamic type system.
This commit is contained in:
304
gobject/gtype.h
Normal file
304
gobject/gtype.h
Normal file
@@ -0,0 +1,304 @@
|
||||
/* GObject - GLib Type, Object, Parameter and Signal Library
|
||||
* Copyright (C) 1998, 1999, 2000 Tim Janik and Red Hat, Inc.
|
||||
*
|
||||
* 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 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, write to the
|
||||
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
||||
* Boston, MA 02111-1307, USA.
|
||||
*/
|
||||
#ifndef __G_TYPE_H__
|
||||
#define __G_TYPE_H__
|
||||
|
||||
extern const char *g_log_domain_gobject;
|
||||
#include <glib.h>
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif /* __cplusplus */
|
||||
|
||||
|
||||
/* Basic Type Macros
|
||||
*/
|
||||
#define G_TYPE_FUNDAMENTAL(type) ((type) & 0xff)
|
||||
#define G_TYPE_FUNDAMENTAL_MAX (0xff)
|
||||
#define G_TYPE_DERIVE_ID(ptype, branch_seqno) (G_TYPE_FUNDAMENTAL (ptype) | ((branch_seqno) << 8))
|
||||
#define G_TYPE_BRANCH_SEQNO(type) ((type) >> 8)
|
||||
#define G_TYPE_FUNDAMENTAL_LAST ((GType) _g_type_fundamental_last)
|
||||
|
||||
|
||||
/* predefined fundamental and derived types
|
||||
*/
|
||||
typedef enum /*< skip >*/
|
||||
{
|
||||
/* standard types, introduced by g_type_init() */
|
||||
G_TYPE_INVALID,
|
||||
G_TYPE_NONE,
|
||||
G_TYPE_INTERFACE,
|
||||
|
||||
/* GLib type ids */
|
||||
G_TYPE_ENUM,
|
||||
G_TYPE_FLAGS,
|
||||
G_TYPE_PARAM,
|
||||
G_TYPE_OBJECT,
|
||||
|
||||
/* reserved type ids, mail gtk-devel-list@redhat.com for reservations */
|
||||
G_TYPE_BSE_PROCEDURE,
|
||||
G_TYPE_GLE_GOBJECT,
|
||||
|
||||
/* the following reserved ids should vanish soon */
|
||||
G_TYPE_GTK_CHAR,
|
||||
G_TYPE_GTK_UCHAR,
|
||||
G_TYPE_GTK_BOOL,
|
||||
G_TYPE_GTK_INT,
|
||||
G_TYPE_GTK_UINT,
|
||||
G_TYPE_GTK_LONG,
|
||||
G_TYPE_GTK_ULONG,
|
||||
G_TYPE_GTK_FLOAT,
|
||||
G_TYPE_GTK_DOUBLE,
|
||||
G_TYPE_GTK_STRING,
|
||||
G_TYPE_GTK_BOXED,
|
||||
G_TYPE_GTK_POINTER,
|
||||
G_TYPE_GTK_SIGNAL,
|
||||
|
||||
G_TYPE_LAST_RESERVED_FUNDAMENTAL,
|
||||
|
||||
/* derived type ids */
|
||||
G_TYPE_PARAM_CHAR = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 1),
|
||||
G_TYPE_PARAM_UCHAR = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 2),
|
||||
G_TYPE_PARAM_BOOL = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 3),
|
||||
G_TYPE_PARAM_INT = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 4),
|
||||
G_TYPE_PARAM_UINT = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 5),
|
||||
G_TYPE_PARAM_LONG = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 6),
|
||||
G_TYPE_PARAM_ULONG = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 7),
|
||||
G_TYPE_PARAM_ENUM = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 8),
|
||||
G_TYPE_PARAM_FLAGS = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 9),
|
||||
G_TYPE_PARAM_FLOAT = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 10),
|
||||
G_TYPE_PARAM_DOUBLE = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 11),
|
||||
G_TYPE_PARAM_STRING = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 12),
|
||||
G_TYPE_PARAM_OBJECT = G_TYPE_DERIVE_ID (G_TYPE_PARAM, 13)
|
||||
} GTypeFundamentals;
|
||||
|
||||
|
||||
/* Type Checking Macros
|
||||
*/
|
||||
#define G_TYPE_IS_INTERFACE(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_INTERFACE)
|
||||
#define G_TYPE_IS_CLASSED(type) (g_type_check_flags ((type), G_TYPE_FLAG_CLASSED))
|
||||
#define G_TYPE_IS_INSTANTIATABLE(type) (g_type_check_flags ((type), G_TYPE_FLAG_INSTANTIATABLE))
|
||||
#define G_TYPE_IS_DERIVABLE(type) (g_type_check_flags ((type), G_TYPE_FLAG_DERIVABLE))
|
||||
#define G_TYPE_IS_DEEP_DERIVABLE(type) (g_type_check_flags ((type), G_TYPE_FLAG_DEEP_DERIVABLE))
|
||||
#define G_TYPE_IS_PARAM(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_PARAM)
|
||||
|
||||
|
||||
/* Typedefs
|
||||
*/
|
||||
typedef guint32 GType;
|
||||
typedef struct _GParam GParam;
|
||||
typedef struct _GTypePlugin GTypePlugin;
|
||||
typedef struct _GTypePluginVTable GTypePluginVTable;
|
||||
typedef struct _GTypeClass GTypeClass;
|
||||
typedef struct _GTypeInterface GTypeInterface;
|
||||
typedef struct _GTypeInstance GTypeInstance;
|
||||
typedef struct _GTypeInfo GTypeInfo;
|
||||
typedef struct _GTypeFundamentalInfo GTypeFundamentalInfo;
|
||||
typedef struct _GInterfaceInfo GInterfaceInfo;
|
||||
|
||||
|
||||
/* Basic Type Structures
|
||||
*/
|
||||
struct _GTypeClass
|
||||
{
|
||||
GType g_type;
|
||||
};
|
||||
struct _GTypeInstance
|
||||
{
|
||||
GTypeClass *g_class;
|
||||
};
|
||||
struct _GTypeInterface
|
||||
{
|
||||
GType g_type; /* iface type */
|
||||
GType g_instance_type;
|
||||
};
|
||||
|
||||
|
||||
/* Casts, Checks And Convenience Macros For Structured Types
|
||||
*/
|
||||
#define G_TYPE_CHECK_INSTANCE_CAST(instance, g_type, c_type) (_G_TYPE_CIC ((instance), (g_type), c_type))
|
||||
#define G_TYPE_CHECK_CLASS_CAST(g_class, g_type, c_type) (_G_TYPE_CCC ((g_class), (g_type), c_type))
|
||||
#define G_TYPE_CHECK_INSTANCE_TYPE(instance, g_type) (_G_TYPE_CIT ((instance), (g_type)))
|
||||
#define G_TYPE_CHECK_CLASS_TYPE(g_class, g_type) (_G_TYPE_CCT ((g_class), (g_type)))
|
||||
#define G_TYPE_INSTANCE_GET_CLASS(instance, g_type, c_type) (_G_TYPE_IGC ((instance), c_type))
|
||||
#define G_TYPE_FROM_INSTANCE(instance) (G_TYPE_FROM_CLASS (((GTypeInstance*) (instance))->g_class))
|
||||
#define G_TYPE_FROM_CLASS(g_class) (((GTypeClass*) (g_class))->g_type)
|
||||
|
||||
|
||||
/* --- prototypes --- */
|
||||
void g_type_init (void);
|
||||
gchar* g_type_name (GType type);
|
||||
GQuark g_type_qname (GType type);
|
||||
GType g_type_from_name (const gchar *name);
|
||||
GType g_type_parent (GType type);
|
||||
GType g_type_next_base (GType type,
|
||||
GType base_type);
|
||||
gboolean g_type_is_a (GType type,
|
||||
GType is_a_type);
|
||||
gboolean g_type_conforms_to (GType type,
|
||||
GType iface_type);
|
||||
guint g_type_fundamental_branch_last (GType type);
|
||||
gpointer g_type_class_ref (GType type);
|
||||
gpointer g_type_class_peek (GType type);
|
||||
void g_type_class_unref (gpointer g_class);
|
||||
gpointer g_type_class_peek_parent (gpointer g_class);
|
||||
gpointer g_type_interface_peek (gpointer instance_class,
|
||||
GType iface_type);
|
||||
/* g_free() the returned arrays */
|
||||
GType* g_type_children (GType type,
|
||||
guint *n_children);
|
||||
GType* g_type_interfaces (GType type,
|
||||
guint *n_interfaces);
|
||||
/* per-type *static* data */
|
||||
void g_type_set_qdata (GType type,
|
||||
GQuark quark,
|
||||
gpointer data);
|
||||
gpointer g_type_get_qdata (GType type,
|
||||
GQuark quark);
|
||||
|
||||
|
||||
/* --- type registration --- */
|
||||
typedef void (*GBaseInitFunc) (gpointer g_class);
|
||||
typedef void (*GBaseFinalizeFunc) (gpointer g_class);
|
||||
typedef void (*GClassInitFunc) (gpointer g_class,
|
||||
gpointer class_data);
|
||||
typedef void (*GClassFinalizeFunc) (gpointer g_class,
|
||||
gpointer class_data);
|
||||
typedef void (*GInstanceInitFunc) (GTypeInstance *instance,
|
||||
gpointer g_class);
|
||||
typedef void (*GInterfaceInitFunc) (gpointer g_iface,
|
||||
gpointer iface_data);
|
||||
typedef void (*GInterfaceFinalizeFunc) (gpointer g_iface,
|
||||
gpointer iface_data);
|
||||
typedef gchar* (*GTypeParamCollector) (GParam *param,
|
||||
guint n_bytes,
|
||||
guint8 *bytes);
|
||||
typedef void (*GTypePluginRef) (GTypePlugin *plugin);
|
||||
typedef void (*GTypePluginUnRef) (GTypePlugin *plugin);
|
||||
typedef void (*GTypePluginFillTypeInfo) (GTypePlugin *plugin,
|
||||
GType g_type,
|
||||
GTypeInfo *info);
|
||||
typedef void (*GTypePluginFillInterfaceInfo) (GTypePlugin *plugin,
|
||||
GType interface_type,
|
||||
GType instance_type,
|
||||
GInterfaceInfo *info);
|
||||
struct _GTypePlugin
|
||||
{
|
||||
GTypePluginVTable *vtable;
|
||||
};
|
||||
struct _GTypePluginVTable
|
||||
{
|
||||
GTypePluginRef plugin_ref;
|
||||
GTypePluginUnRef plugin_unref;
|
||||
GTypePluginFillTypeInfo complete_type_info;
|
||||
GTypePluginFillInterfaceInfo complete_interface_info;
|
||||
};
|
||||
typedef enum /*< skip >*/
|
||||
{
|
||||
G_TYPE_FLAG_CLASSED = (1 << 0),
|
||||
G_TYPE_FLAG_INSTANTIATABLE = (1 << 1),
|
||||
G_TYPE_FLAG_DERIVABLE = (1 << 2),
|
||||
G_TYPE_FLAG_DEEP_DERIVABLE = (1 << 3)
|
||||
} GTypeFlags;
|
||||
struct _GTypeInfo
|
||||
{
|
||||
/* interface types, classed types, instantiated types */
|
||||
guint16 class_size;
|
||||
|
||||
GBaseInitFunc base_init;
|
||||
GBaseFinalizeFunc base_finalize;
|
||||
|
||||
/* classed types, instantiated types */
|
||||
GClassInitFunc class_init;
|
||||
GClassFinalizeFunc class_finalize;
|
||||
gconstpointer class_data;
|
||||
|
||||
/* instantiated types */
|
||||
guint16 instance_size;
|
||||
guint16 n_preallocs;
|
||||
GInstanceInitFunc instance_init;
|
||||
};
|
||||
struct _GTypeFundamentalInfo
|
||||
{
|
||||
GTypeFlags type_flags;
|
||||
guint n_collect_bytes;
|
||||
GTypeParamCollector param_collector;
|
||||
};
|
||||
struct _GInterfaceInfo
|
||||
{
|
||||
GInterfaceInitFunc interface_init;
|
||||
GInterfaceFinalizeFunc interface_finalize;
|
||||
gpointer interface_data;
|
||||
};
|
||||
GType g_type_register_static (GType parent_type,
|
||||
const gchar *type_name,
|
||||
const GTypeInfo *info);
|
||||
GType g_type_register_dynamic (GType parent_type,
|
||||
const gchar *type_name,
|
||||
GTypePlugin *plugin);
|
||||
GType g_type_register_fundamental (GType type_id,
|
||||
const gchar *type_name,
|
||||
const GTypeFundamentalInfo *finfo,
|
||||
const GTypeInfo *info);
|
||||
void g_type_add_interface_static (GType instance_type,
|
||||
GType interface_type,
|
||||
GInterfaceInfo *info);
|
||||
void g_type_add_interface_dynamic (GType instance_type,
|
||||
GType interface_type,
|
||||
GTypePlugin *plugin);
|
||||
|
||||
|
||||
/* --- implementation details --- */
|
||||
gboolean g_type_class_is_a (GTypeClass *g_class,
|
||||
GType is_a_type);
|
||||
GTypeClass* g_type_check_class_cast (GTypeClass *g_class,
|
||||
GType is_a_type);
|
||||
GTypeInstance* g_type_check_instance_cast (GTypeInstance *instance,
|
||||
GType iface_type);
|
||||
gboolean g_type_instance_conforms_to (GTypeInstance *instance,
|
||||
GType iface_type);
|
||||
gboolean g_type_check_flags (GType type,
|
||||
GTypeFlags flags);
|
||||
gboolean g_type_is_dynamic (GType type,
|
||||
GTypeFlags flags);
|
||||
GTypeInstance* g_type_create_instance (GType type);
|
||||
void g_type_free_instance (GTypeInstance *instance);
|
||||
|
||||
#ifndef G_DISABLE_CAST_CHECKS
|
||||
# define _G_TYPE_CIC(ip, gt, ct) \
|
||||
((ct*) g_type_check_instance_cast ((GTypeInstance*) ip, gt))
|
||||
# define _G_TYPE_CCC(cp, gt, ct) \
|
||||
((ct*) g_type_check_class_cast ((GTypeClass*) cp, gt))
|
||||
#else /* G_DISABLE_CAST_CHECKS */
|
||||
# define _G_TYPE_CIC(ip, gt, ct) ((ct*) ip)
|
||||
# define _G_TYPE_CCC(cp, gt, ct) ((ct*) cp)
|
||||
#endif /* G_DISABLE_CAST_CHECKS */
|
||||
#define _G_TYPE_IGC(ip, ct) ((ct*) (((GTypeInstance*) ip)->g_class))
|
||||
#define _G_TYPE_CIT(ip, gt) (g_type_instance_conforms_to ((GTypeInstance*) ip, gt))
|
||||
#define _G_TYPE_CCT(cp, gt) (g_type_class_is_a ((GTypeClass*) cp, gt))
|
||||
extern GType _g_type_fundamental_last;
|
||||
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif /* __cplusplus */
|
||||
|
||||
#endif /* __G_TYPE_H__ */
|
Reference in New Issue
Block a user