gobject/gtype.h

   1 /* GObject - GLib Type, Object, Parameter and Signal Library
   2  * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc.
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General
  15  * Public License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19 #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION)
  20 #error "Only <glib-object.h> can be included directly."
  21 #endif
  22
  23 #ifndef __G_TYPE_H__
  24 #define __G_TYPE_H__
  25
  26 #include        <glib.h>
  27
  28 G_BEGIN_DECLS
  29
  30 /* Basic Type Macros
  31  */
  32 #define G_TYPE_FUNDAMENTAL(type)        (g_type_fundamental (type))
  33 #define G_TYPE_FUNDAMENTAL_MAX          (255 << G_TYPE_FUNDAMENTAL_SHIFT)
  34
  35 /* Constant fundamental types,
  36  * introduced by g_type_init().
  37  */
  38 #define G_TYPE_INVALID                  G_TYPE_MAKE_FUNDAMENTAL (0)
  39 #define G_TYPE_NONE                     G_TYPE_MAKE_FUNDAMENTAL (1)
  40 #define G_TYPE_INTERFACE                G_TYPE_MAKE_FUNDAMENTAL (2)
  41 #define G_TYPE_CHAR                     G_TYPE_MAKE_FUNDAMENTAL (3)
  42 #define G_TYPE_UCHAR                    G_TYPE_MAKE_FUNDAMENTAL (4)
  43 #define G_TYPE_BOOLEAN                  G_TYPE_MAKE_FUNDAMENTAL (5)
  44 #define G_TYPE_INT                      G_TYPE_MAKE_FUNDAMENTAL (6)
  45 #define G_TYPE_UINT                     G_TYPE_MAKE_FUNDAMENTAL (7)
  46 #define G_TYPE_LONG                     G_TYPE_MAKE_FUNDAMENTAL (8)
  47 #define G_TYPE_ULONG                    G_TYPE_MAKE_FUNDAMENTAL (9)
  48 #define G_TYPE_INT64                    G_TYPE_MAKE_FUNDAMENTAL (10)
  49 #define G_TYPE_UINT64                   G_TYPE_MAKE_FUNDAMENTAL (11)
  50 #define G_TYPE_ENUM                     G_TYPE_MAKE_FUNDAMENTAL (12)
  51 #define G_TYPE_FLAGS                    G_TYPE_MAKE_FUNDAMENTAL (13)
  52 #define G_TYPE_FLOAT                    G_TYPE_MAKE_FUNDAMENTAL (14)
  53 #define G_TYPE_DOUBLE                   G_TYPE_MAKE_FUNDAMENTAL (15)
  54 #define G_TYPE_STRING                   G_TYPE_MAKE_FUNDAMENTAL (16)
  55 #define G_TYPE_POINTER                  G_TYPE_MAKE_FUNDAMENTAL (17)
  56 #define G_TYPE_BOXED                    G_TYPE_MAKE_FUNDAMENTAL (18)
  57 #define G_TYPE_PARAM                    G_TYPE_MAKE_FUNDAMENTAL (19)
  58 #define G_TYPE_OBJECT                   G_TYPE_MAKE_FUNDAMENTAL (20)
  59
  60
  61 /* Reserved fundamental type numbers to create new fundamental
  62  * type IDs with G_TYPE_MAKE_FUNDAMENTAL().
  63  * Send email to gtk-devel-list@redhat.com for reservations.
  64  */
  65 #define G_TYPE_FUNDAMENTAL_SHIFT        (2)
  66 #define G_TYPE_MAKE_FUNDAMENTAL(x)      ((GType) ((x) << G_TYPE_FUNDAMENTAL_SHIFT))
  67 #define G_TYPE_RESERVED_GLIB_FIRST      (21)
  68 #define G_TYPE_RESERVED_GLIB_LAST       (31)
  69 #define G_TYPE_RESERVED_BSE_FIRST       (32)
  70 #define G_TYPE_RESERVED_BSE_LAST        (48)
  71 #define G_TYPE_RESERVED_USER_FIRST      (49)
  72
  73
  74 /* Type Checking Macros
  75  */
  76 #define G_TYPE_IS_FUNDAMENTAL(type)             ((type) <= G_TYPE_FUNDAMENTAL_MAX)
  77 #define G_TYPE_IS_DERIVED(type)                 ((type) > G_TYPE_FUNDAMENTAL_MAX)
  78 #define G_TYPE_IS_INTERFACE(type)               (G_TYPE_FUNDAMENTAL (type) == G_TYPE_INTERFACE)
  79 #define G_TYPE_IS_CLASSED(type)                 (g_type_test_flags ((type), G_TYPE_FLAG_CLASSED))
  80 #define G_TYPE_IS_INSTANTIATABLE(type)          (g_type_test_flags ((type), G_TYPE_FLAG_INSTANTIATABLE))
  81 #define G_TYPE_IS_DERIVABLE(type)               (g_type_test_flags ((type), G_TYPE_FLAG_DERIVABLE))
  82 #define G_TYPE_IS_DEEP_DERIVABLE(type)          (g_type_test_flags ((type), G_TYPE_FLAG_DEEP_DERIVABLE))
  83 #define G_TYPE_IS_ABSTRACT(type)                (g_type_test_flags ((type), G_TYPE_FLAG_ABSTRACT))
  84 #define G_TYPE_IS_VALUE_ABSTRACT(type)          (g_type_test_flags ((type), G_TYPE_FLAG_VALUE_ABSTRACT))
  85 #define G_TYPE_IS_VALUE_TYPE(type)              (g_type_check_is_value_type (type))
  86 #define G_TYPE_HAS_VALUE_TABLE(type)            (g_type_value_table_peek (type) != NULL)
  87
  88
  89 /* Typedefs
  90  */
  91 #if     GLIB_SIZEOF_LONG == GLIB_SIZEOF_SIZE_T
  92 typedef gulong                          GType;
  93 #else   /* hm, shouldn't happen? */
  94 typedef gsize                           GType;
  95 #endif
  96 typedef struct _GValue                  GValue;
  97 typedef union  _GTypeCValue             GTypeCValue;
  98 typedef struct _GTypePlugin             GTypePlugin;
  99 typedef struct _GTypeClass              GTypeClass;
 100 typedef struct _GTypeInterface          GTypeInterface;
 101 typedef struct _GTypeInstance           GTypeInstance;
 102 typedef struct _GTypeInfo               GTypeInfo;
 103 typedef struct _GTypeFundamentalInfo    GTypeFundamentalInfo;
 104 typedef struct _GInterfaceInfo          GInterfaceInfo;
 105 typedef struct _GTypeValueTable         GTypeValueTable;
 106 typedef struct _GTypeQuery              GTypeQuery;
 107
 108
 109 /* Basic Type Structures
 110  */
 111 struct _GTypeClass
 112 {
 113   /*< private >*/
 114   GType g_type;
 115 };
 116 struct _GTypeInstance
 117 {
 118   /*< private >*/
 119   GTypeClass *g_class;
 120 };
 121 struct _GTypeInterface
 122 {
 123   /*< private >*/
 124   GType g_type;         /* iface type */
 125   GType g_instance_type;
 126 };
 127 struct _GTypeQuery
 128 {
 129   GType         type;
 130   const gchar  *type_name;
 131   guint         class_size;
 132   guint         instance_size;
 133 };
 134
 135
 136 /* Casts, checks and accessors for structured types
 137  * usage of these macros is reserved to type implementations only
 138  */
 139 /*< protected >*/
 140 #define G_TYPE_CHECK_INSTANCE(instance)                         (_G_TYPE_CHI ((GTypeInstance*) (instance)))
 141 #define G_TYPE_CHECK_INSTANCE_CAST(instance, g_type, c_type)    (_G_TYPE_CIC ((instance), (g_type), c_type))
 142 #define G_TYPE_CHECK_INSTANCE_TYPE(instance, g_type)            (_G_TYPE_CIT ((instance), (g_type)))
 143 #define G_TYPE_INSTANCE_GET_CLASS(instance, g_type, c_type)     (_G_TYPE_IGC ((instance), (g_type), c_type))
 144 #define G_TYPE_INSTANCE_GET_INTERFACE(instance, g_type, c_type) (_G_TYPE_IGI ((instance), (g_type), c_type))
 145 #define G_TYPE_CHECK_CLASS_CAST(g_class, g_type, c_type)        (_G_TYPE_CCC ((g_class), (g_type), c_type))
 146 #define G_TYPE_CHECK_CLASS_TYPE(g_class, g_type)                (_G_TYPE_CCT ((g_class), (g_type)))
 147 #define G_TYPE_CHECK_VALUE(value)                               (_G_TYPE_CHV ((value)))
 148 #define G_TYPE_CHECK_VALUE_TYPE(value, g_type)                  (_G_TYPE_CVH ((value), (g_type)))
 149 #define G_TYPE_FROM_INSTANCE(instance)                          (G_TYPE_FROM_CLASS (((GTypeInstance*) (instance))->g_class))
 150 #define G_TYPE_FROM_CLASS(g_class)                              (((GTypeClass*) (g_class))->g_type)
 151 #define G_TYPE_FROM_INTERFACE(g_iface)                          (((GTypeInterface*) (g_iface))->g_type)
 152
 153 #define G_TYPE_INSTANCE_GET_PRIVATE(instance, g_type, c_type)   ((c_type*) g_type_instance_get_private ((GTypeInstance*) (instance), (g_type)))
 154
 155
 156 /* debug flags for g_type_init_with_debug_flags() */
 157 typedef enum    /*< skip >*/
 158 {
 159   G_TYPE_DEBUG_NONE     = 0,
 160   G_TYPE_DEBUG_OBJECTS  = 1 << 0,
 161   G_TYPE_DEBUG_SIGNALS  = 1 << 1,
 162   G_TYPE_DEBUG_MASK     = 0x03
 163 } GTypeDebugFlags;
 164
 165
 166 /* --- prototypes --- */
 167 void                  g_type_init                    (void);
 168 void                  g_type_init_with_debug_flags   (GTypeDebugFlags  debug_flags);
 169 G_CONST_RETURN gchar* g_type_name                    (GType            type);
 170 GQuark                g_type_qname                   (GType            type);
 171 GType                 g_type_from_name               (const gchar     *name);
 172 GType                 g_type_parent                  (GType            type);
 173 guint                 g_type_depth                   (GType            type);
 174 GType                 g_type_next_base               (GType            leaf_type,
 175                                                       GType            root_type);
 176 gboolean              g_type_is_a                    (GType            type,
 177                                                       GType            is_a_type);
 178 gpointer              g_type_class_ref               (GType            type);
 179 gpointer              g_type_class_peek              (GType            type);
 180 gpointer              g_type_class_peek_static       (GType            type);
 181 void                  g_type_class_unref             (gpointer         g_class);
 182 gpointer              g_type_class_peek_parent       (gpointer         g_class);
 183 gpointer              g_type_interface_peek          (gpointer         instance_class,
 184                                                       GType            iface_type);
 185 gpointer              g_type_interface_peek_parent   (gpointer         g_iface);
 186
 187 gpointer              g_type_default_interface_ref   (GType            g_type);
 188 gpointer              g_type_default_interface_peek  (GType            g_type);
 189 void                  g_type_default_interface_unref (gpointer         g_iface);
 190
 191 /* g_free() the returned arrays */
 192 GType*                g_type_children                (GType            type,
 193                                                       guint           *n_children);
 194 GType*                g_type_interfaces              (GType            type,
 195                                                       guint           *n_interfaces);
 196
 197 /* per-type _static_ data */
 198 void                  g_type_set_qdata               (GType            type,
 199                                                       GQuark           quark,
 200                                                       gpointer         data);
 201 gpointer              g_type_get_qdata               (GType            type,
 202                                                       GQuark           quark);
 203 void                  g_type_query                   (GType            type,
 204                                                       GTypeQuery      *query);
 205
 206
 207 /* --- type registration --- */
 208 typedef void   (*GBaseInitFunc)              (gpointer         g_class);
 209 typedef void   (*GBaseFinalizeFunc)          (gpointer         g_class);
 210 typedef void   (*GClassInitFunc)             (gpointer         g_class,
 211                                               gpointer         class_data);
 212 typedef void   (*GClassFinalizeFunc)         (gpointer         g_class,
 213                                               gpointer         class_data);
 214 typedef void   (*GInstanceInitFunc)          (GTypeInstance   *instance,
 215                                               gpointer         g_class);
 216 typedef void   (*GInterfaceInitFunc)         (gpointer         g_iface,
 217                                               gpointer         iface_data);
 218 typedef void   (*GInterfaceFinalizeFunc)     (gpointer         g_iface,
 219                                               gpointer         iface_data);
 220 typedef gboolean (*GTypeClassCacheFunc)      (gpointer         cache_data,
 221                                               GTypeClass      *g_class);
 222 typedef void     (*GTypeInterfaceCheckFunc)  (gpointer         check_data,
 223                                               gpointer         g_iface);
 224 typedef enum    /*< skip >*/
 225 {
 226   G_TYPE_FLAG_CLASSED           = (1 << 0),
 227   G_TYPE_FLAG_INSTANTIATABLE    = (1 << 1),
 228   G_TYPE_FLAG_DERIVABLE         = (1 << 2),
 229   G_TYPE_FLAG_DEEP_DERIVABLE    = (1 << 3)
 230 } GTypeFundamentalFlags;
 231 typedef enum    /*< skip >*/
 232 {
 233   G_TYPE_FLAG_ABSTRACT          = (1 << 4),
 234   G_TYPE_FLAG_VALUE_ABSTRACT    = (1 << 5)
 235 } GTypeFlags;
 236 struct _GTypeInfo
 237 {
 238   /* interface types, classed types, instantiated types */
 239   guint16                class_size;
 240
 241   GBaseInitFunc          base_init;
 242   GBaseFinalizeFunc      base_finalize;
 243
 244   /* interface types, classed types, instantiated types */
 245   GClassInitFunc         class_init;
 246   GClassFinalizeFunc     class_finalize;
 247   gconstpointer          class_data;
 248
 249   /* instantiated types */
 250   guint16                instance_size;
 251   guint16                n_preallocs;
 252   GInstanceInitFunc      instance_init;
 253
 254   /* value handling */
 255   const GTypeValueTable *value_table;
 256 };
 257 struct _GTypeFundamentalInfo
 258 {
 259   GTypeFundamentalFlags  type_flags;
 260 };
 261 struct _GInterfaceInfo
 262 {
 263   GInterfaceInitFunc     interface_init;
 264   GInterfaceFinalizeFunc interface_finalize;
 265   gpointer               interface_data;
 266 };
 267 struct _GTypeValueTable
 268 {
 269   void     (*value_init)         (GValue       *value);
 270   void     (*value_free)         (GValue       *value);
 271   void     (*value_copy)         (const GValue *src_value,
 272                                   GValue       *dest_value);
 273   /* varargs functionality (optional) */
 274   gpointer (*value_peek_pointer) (const GValue *value);
 275   gchar     *collect_format;
 276   gchar*   (*collect_value)      (GValue       *value,
 277                                   guint         n_collect_values,
 278                                   GTypeCValue  *collect_values,
 279                                   guint         collect_flags);
 280   gchar     *lcopy_format;
 281   gchar*   (*lcopy_value)        (const GValue *value,
 282                                   guint         n_collect_values,
 283                                   GTypeCValue  *collect_values,
 284                                   guint         collect_flags);
 285 };
 286 GType g_type_register_static            (GType                       parent_type,
 287                                          const gchar                *type_name,
 288                                          const GTypeInfo            *info,
 289                                          GTypeFlags                  flags);
 290 GType g_type_register_static_simple     (GType                       parent_type,
 291                                          const gchar                *type_name,
 292                                          guint                       class_size,
 293                                          GClassInitFunc              class_init,
 294                                          guint                       instance_size,
 295                                          GInstanceInitFunc           instance_init,
 296                                          GTypeFlags                  flags);
 297
 298 GType g_type_register_dynamic           (GType                       parent_type,
 299                                          const gchar                *type_name,
 300                                          GTypePlugin                *plugin,
 301                                          GTypeFlags                  flags);
 302 GType g_type_register_fundamental       (GType                       type_id,
 303                                          const gchar                *type_name,
 304                                          const GTypeInfo            *info,
 305                                          const GTypeFundamentalInfo *finfo,
 306                                          GTypeFlags                  flags);
 307 void  g_type_add_interface_static       (GType                       instance_type,
 308                                          GType                       interface_type,
 309                                          const GInterfaceInfo       *info);
 310 void  g_type_add_interface_dynamic      (GType                       instance_type,
 311                                          GType                       interface_type,
 312                                          GTypePlugin                *plugin);
 313 void  g_type_interface_add_prerequisite (GType                       interface_type,
 314                                          GType                       prerequisite_type);
 315 GType*g_type_interface_prerequisites    (GType                       interface_type,
 316                                          guint                      *n_prerequisites);
 317 void     g_type_class_add_private       (gpointer                    g_class,
 318                                          gsize                       private_size);
 319 gpointer g_type_instance_get_private    (GTypeInstance              *instance,
 320                                          GType                       private_type);
 321
 322
 323 /* --- GType boilerplate --- */
 324 /* convenience macros for type implementations, which for a type GtkGadget will:
 325  * - prototype: static void     gtk_gadget_class_init (GtkGadgetClass *klass);
 326  * - prototype: static void     gtk_gadget_init       (GtkGadget      *self);
 327  * - define:    static gpointer gtk_gadget_parent_class = NULL;
 328  *   gtk_gadget_parent_class is initialized prior to calling gtk_gadget_class_init()
 329  * - implement: GType           gtk_gadget_get_type (void) { ... }
 330  * - support custom code in gtk_gadget_get_type() after the type is registered.
 331  *
 332  * macro arguments: TypeName, type_name, TYPE_PARENT, CODE
 333  * example: G_DEFINE_TYPE_WITH_CODE (GtkGadget, gtk_gadget, GTK_TYPE_WIDGET,
 334  *                                   g_print ("GtkGadget-id: %lu\n", g_define_type_id));
 335  */
 336 #define G_DEFINE_TYPE(TN, t_n, T_P)                         G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, {})
 337 #define G_DEFINE_TYPE_WITH_CODE(TN, t_n, T_P, _C_)          _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, 0) {_C_;} _G_DEFINE_TYPE_EXTENDED_END()
 338 #define G_DEFINE_ABSTRACT_TYPE(TN, t_n, T_P)                G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, G_TYPE_FLAG_ABSTRACT, {})
 339 #define G_DEFINE_ABSTRACT_TYPE_WITH_CODE(TN, t_n, T_P, _C_) _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, G_TYPE_FLAG_ABSTRACT) {_C_;} _G_DEFINE_TYPE_EXTENDED_END()
 340 #define G_DEFINE_TYPE_EXTENDED(TN, t_n, T_P, _f_, _C_)      _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, _f_) {_C_;} _G_DEFINE_TYPE_EXTENDED_END()
 341
 342 /* convenience macro to ease interface addition in the CODE
 343  * section of G_DEFINE_TYPE_WITH_CODE() (this macro relies on
 344  * the g_define_type_id present within G_DEFINE_TYPE_WITH_CODE()).
 345  * usage example:
 346  * G_DEFINE_TYPE_WITH_CODE (GtkTreeStore, gtk_tree_store, G_TYPE_OBJECT,
 347  *                          G_IMPLEMENT_INTERFACE (GTK_TYPE_TREE_MODEL,
 348  *                                                 gtk_tree_store_tree_model_init));
 349  */
 350 #define G_IMPLEMENT_INTERFACE(TYPE_IFACE, iface_init)       { \
 351   const GInterfaceInfo g_implement_interface_info = { \
 352     (GInterfaceInitFunc) iface_init, NULL, NULL \
 353   }; \
 354   g_type_add_interface_static (g_define_type_id, TYPE_IFACE, &g_implement_interface_info); \
 355 }
 356
 357 #define _G_DEFINE_TYPE_EXTENDED_BEGIN(TypeName, type_name, TYPE_PARENT, flags) \
 358 \
 359 static void     type_name##_init              (TypeName        *self); \
 360 static void     type_name##_class_init        (TypeName##Class *klass); \
 361 static gpointer type_name##_parent_class = NULL; \
 362 static void     type_name##_class_intern_init (gpointer klass) \
 363 { \
 364   type_name##_parent_class = g_type_class_peek_parent (klass); \
 365   type_name##_class_init ((TypeName##Class*) klass); \
 366 } \
 367 \
 368 GType \
 369 type_name##_get_type (void) \
 370 { \
 371   static GType g_define_type_id = 0; \
 372   if (G_UNLIKELY (g_define_type_id == 0)) \
 373     { \
 374       g_define_type_id = \
 375         g_type_register_static_simple (TYPE_PARENT, \
 376                                        g_intern_static_string (#TypeName), \
 377                                        sizeof (TypeName##Class), \
 378                                        (GClassInitFunc)type_name##_class_intern_init, \
 379                                        sizeof (TypeName), \
 380                                        (GInstanceInitFunc)type_name##_init, \
 381                                        (GTypeFlags) flags); \
 382       { /* custom code follows */
 383 #define _G_DEFINE_TYPE_EXTENDED_END()   \
 384         /* following custom code */     \
 385       }                                 \
 386     }                                   \
 387   return g_define_type_id;              \
 388 } /* closes type_name##_get_type() */
 389
 390
 391 /* --- protected (for fundamental type implementations) --- */
 392 GTypePlugin*     g_type_get_plugin              (GType               type);
 393 GTypePlugin*     g_type_interface_get_plugin    (GType               instance_type,
 394                                                  GType               interface_type);
 395 GType            g_type_fundamental_next        (void);
 396 GType            g_type_fundamental             (GType               type_id);
 397 GTypeInstance*   g_type_create_instance         (GType               type);
 398 void             g_type_free_instance           (GTypeInstance      *instance);
 399
 400 void             g_type_add_class_cache_func    (gpointer            cache_data,
 401                                                  GTypeClassCacheFunc cache_func);
 402 void             g_type_remove_class_cache_func (gpointer            cache_data,
 403                                                  GTypeClassCacheFunc cache_func);
 404 void             g_type_class_unref_uncached    (gpointer            g_class);
 405
 406 void             g_type_add_interface_check     (gpointer                check_data,
 407                                                  GTypeInterfaceCheckFunc check_func);
 408 void             g_type_remove_interface_check  (gpointer                check_data,
 409                                                  GTypeInterfaceCheckFunc check_func);
 410
 411 GTypeValueTable* g_type_value_table_peek        (GType               type);
 412
 413
 414 /*< private >*/
 415 gboolean         g_type_check_instance          (GTypeInstance      *instance) G_GNUC_PURE;
 416 GTypeInstance*   g_type_check_instance_cast     (GTypeInstance      *instance,
 417                                                  GType               iface_type);
 418 gboolean         g_type_check_instance_is_a     (GTypeInstance      *instance,
 419                                                  GType               iface_type) G_GNUC_PURE;
 420 GTypeClass*      g_type_check_class_cast        (GTypeClass         *g_class,
 421                                                  GType               is_a_type);
 422 gboolean         g_type_check_class_is_a        (GTypeClass         *g_class,
 423                                                  GType               is_a_type) G_GNUC_PURE;
 424 gboolean         g_type_check_is_value_type     (GType               type) G_GNUC_CONST;
 425 gboolean         g_type_check_value             (GValue             *value) G_GNUC_PURE;
 426 gboolean         g_type_check_value_holds       (GValue             *value,
 427                                                  GType               type) G_GNUC_PURE;
 428 gboolean         g_type_test_flags              (GType               type,
 429                                                  guint               flags) G_GNUC_CONST;
 430
 431
 432 /* --- debugging functions --- */
 433 G_CONST_RETURN gchar* g_type_name_from_instance (GTypeInstance  *instance);
 434 G_CONST_RETURN gchar* g_type_name_from_class    (GTypeClass     *g_class);
 435
 436
 437 /* --- internal functions --- */
 438 G_GNUC_INTERNAL void    g_value_c_init          (void); /* sync with gvalue.c */
 439 G_GNUC_INTERNAL void    g_value_types_init      (void); /* sync with gvaluetypes.c */
 440 G_GNUC_INTERNAL void    g_enum_types_init       (void); /* sync with genums.c */
 441 G_GNUC_INTERNAL void    g_param_type_init       (void); /* sync with gparam.c */
 442 G_GNUC_INTERNAL void    g_boxed_type_init       (void); /* sync with gboxed.c */
 443 G_GNUC_INTERNAL void    g_object_type_init      (void); /* sync with gobject.c */
 444 G_GNUC_INTERNAL void    g_param_spec_types_init (void); /* sync with gparamspecs.c */
 445 G_GNUC_INTERNAL void    g_value_transforms_init (void); /* sync with gvaluetransform.c */
 446 G_GNUC_INTERNAL void    g_signal_init           (void); /* sync with gsignal.c */
 447
 448
 449 /* --- implementation bits --- */
 450 #ifndef G_DISABLE_CAST_CHECKS
 451 #  define _G_TYPE_CIC(ip, gt, ct) \
 452     ((ct*) g_type_check_instance_cast ((GTypeInstance*) ip, gt))
 453 #  define _G_TYPE_CCC(cp, gt, ct) \
 454     ((ct*) g_type_check_class_cast ((GTypeClass*) cp, gt))
 455 #else /* G_DISABLE_CAST_CHECKS */
 456 #  define _G_TYPE_CIC(ip, gt, ct)       ((ct*) ip)
 457 #  define _G_TYPE_CCC(cp, gt, ct)       ((ct*) cp)
 458 #endif /* G_DISABLE_CAST_CHECKS */
 459 #define _G_TYPE_CHI(ip)                 (g_type_check_instance ((GTypeInstance*) ip))
 460 #define _G_TYPE_CHV(vl)                 (g_type_check_value ((GValue*) vl))
 461 #define _G_TYPE_IGC(ip, gt, ct)         ((ct*) (((GTypeInstance*) ip)->g_class))
 462 #define _G_TYPE_IGI(ip, gt, ct)         ((ct*) g_type_interface_peek (((GTypeInstance*) ip)->g_class, gt))
 463 #ifdef  __GNUC__
 464 #  define _G_TYPE_CIT(ip, gt)             (G_GNUC_EXTENSION ({ \
 465   GTypeInstance *__inst = (GTypeInstance*) ip; GType __t = gt; gboolean __r; \
 466   if (__inst && __inst->g_class && __inst->g_class->g_type == __t) \
 467     __r = TRUE; \
 468   else \
 469     __r = g_type_check_instance_is_a (__inst, __t); \
 470   __r; \
 471 }))
 472 #  define _G_TYPE_CCT(cp, gt)             (G_GNUC_EXTENSION ({ \
 473   GTypeClass *__class = (GTypeClass*) cp; GType __t = gt; gboolean __r; \
 474   if (__class && __class->g_type == __t) \
 475     __r = TRUE; \
 476   else \
 477     __r = g_type_check_class_is_a (__class, __t); \
 478   __r; \
 479 }))
 480 #  define _G_TYPE_CVH(vl, gt)             (G_GNUC_EXTENSION ({ \
 481   GValue *__val = (GValue*) vl; GType __t = gt; gboolean __r; \
 482   if (__val && __val->g_type == __t) \
 483     __r = TRUE; \
 484   else \
 485     __r = g_type_check_value_holds (__val, __t); \
 486   __r; \
 487 }))
 488 #else  /* !__GNUC__ */
 489 #  define _G_TYPE_CIT(ip, gt)             (g_type_check_instance_is_a ((GTypeInstance*) ip, gt))
 490 #  define _G_TYPE_CCT(cp, gt)             (g_type_check_class_is_a ((GTypeClass*) cp, gt))
 491 #  define _G_TYPE_CVH(vl, gt)             (g_type_check_value_holds ((GValue*) vl, gt))
 492 #endif /* !__GNUC__ */
 493 #define G_TYPE_FLAG_RESERVED_ID_BIT     ((GType) (1 << 0))
 494 extern GTypeDebugFlags                  _g_type_debug_flags;
 495
 496 G_END_DECLS
 497
 498 #endif /* __G_TYPE_H__ */