mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-26 23:46:15 +01:00
7eb69d279d
By shifting responsibility for ensuring that the lifetime of a `GIRepository` always exceeds the lifetime of any of its `GIBaseInfo`s to the user. Keeping a weak ref from each `GIBaseInfo` to its `GIRepository` would be too expensive (`GIBaseInfo`s are supposed to be cheap to create and destroy, as they are used within function calls in language bindings). Signed-off-by: Philip Withnall <pwithnall@gnome.org> Fixes: #3234
261 lines
6.7 KiB
C
261 lines
6.7 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
||
* GObject introspection: Private headers
|
||
*
|
||
* Copyright (C) 2010 Johan Dahlin
|
||
*
|
||
* SPDX-License-Identifier: LGPL-2.1-or-later
|
||
*
|
||
* 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.
|
||
*/
|
||
|
||
#pragma once
|
||
|
||
#include <ffi.h>
|
||
#include <glib.h>
|
||
|
||
#define __GIREPOSITORY_H_INSIDE__
|
||
|
||
#include <girepository/gibaseinfo.h>
|
||
#include <girepository/girepository.h>
|
||
#include <girepository/gitypelib.h>
|
||
|
||
/* FIXME: For now, GIRealInfo is a compatibility define. This will eventually
|
||
* be removed. */
|
||
typedef struct _GIBaseInfo GIRealInfo;
|
||
|
||
/*
|
||
* We just use one structure for all of the info object
|
||
* types; in general, we should be reading data directly
|
||
* from the typelib, and not having computed data in
|
||
* per-type structures.
|
||
*/
|
||
struct _GIBaseInfo
|
||
{
|
||
/*< private >*/
|
||
GTypeInstance parent_instance;
|
||
gatomicrefcount ref_count;
|
||
|
||
/* @repository is never reffed, as that would lead to a refcount cycle with the repository */
|
||
GIRepository *repository;
|
||
/* @container is reffed if the GIBaseInfo is heap-allocated, but not reffed if it’s stack-allocated */
|
||
GIBaseInfo *container;
|
||
|
||
GITypelib *typelib;
|
||
uint32_t offset;
|
||
|
||
uint32_t type_is_embedded : 1; /* Used by GITypeInfo */
|
||
};
|
||
|
||
/* Subtypes */
|
||
struct _GICallableInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_callable_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIFunctionInfo
|
||
{
|
||
GICallableInfo parent;
|
||
};
|
||
|
||
void gi_function_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GICallbackInfo
|
||
{
|
||
GICallableInfo parent;
|
||
};
|
||
|
||
void gi_callback_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIRegisteredTypeInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_registered_type_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIStructInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_struct_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIUnionInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_union_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIEnumInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_enum_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIFlagsInfo
|
||
{
|
||
GIEnumInfo parent;
|
||
};
|
||
|
||
void gi_flags_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIObjectInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_object_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIInterfaceInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_interface_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIBoxedInfo
|
||
{
|
||
GIRegisteredTypeInfo parent;
|
||
};
|
||
|
||
void gi_boxed_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIConstantInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_constant_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIValueInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_value_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GISignalInfo
|
||
{
|
||
GICallableInfo parent;
|
||
};
|
||
|
||
void gi_signal_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIVFuncInfo
|
||
{
|
||
GICallableInfo parent;
|
||
};
|
||
|
||
void gi_vfunc_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIPropertyInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_property_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIFieldInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_field_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIArgInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_arg_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GITypeInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
};
|
||
|
||
void gi_type_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
struct _GIUnresolvedInfo
|
||
{
|
||
GIBaseInfo parent;
|
||
|
||
const char *name;
|
||
const char *namespace;
|
||
};
|
||
|
||
void gi_unresolved_info_class_init (gpointer g_class,
|
||
gpointer class_data);
|
||
|
||
void gi_info_init (GIRealInfo *info,
|
||
GType type,
|
||
GIRepository *repository,
|
||
GIBaseInfo *container,
|
||
GITypelib *typelib,
|
||
uint32_t offset);
|
||
|
||
GIBaseInfo * gi_info_from_entry (GIRepository *repository,
|
||
GITypelib *typelib,
|
||
uint16_t index);
|
||
|
||
GIBaseInfo * gi_info_new_full (GIInfoType type,
|
||
GIRepository *repository,
|
||
GIBaseInfo *container,
|
||
GITypelib *typelib,
|
||
uint32_t offset);
|
||
|
||
GITypeInfo * gi_type_info_new (GIBaseInfo *container,
|
||
GITypelib *typelib,
|
||
uint32_t offset);
|
||
|
||
void gi_type_info_init (GITypeInfo *info,
|
||
GIBaseInfo *container,
|
||
GITypelib *typelib,
|
||
uint32_t offset);
|
||
|
||
GIFunctionInfo * gi_base_info_find_method (GIBaseInfo *base,
|
||
uint32_t offset,
|
||
uint16_t n_methods,
|
||
const char *name);
|
||
|
||
GIVFuncInfo * gi_base_info_find_vfunc (GIRealInfo *rinfo,
|
||
uint32_t offset,
|
||
uint16_t n_vfuncs,
|
||
const char *name);
|