mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-10-31 03:26:19 +01:00
a458c66cbf
In g_irepository_get_object_gtype_interfaces(), returning the address of the first GIBaseInfo* does not work reliably, because the GIBaseInfos are not necessarily stored contiguously. So the second and subsequent ones might be garbage. Instead, return the address of the array of GIBaseInfo pointers. Add a test that verifies the functionality, as well. This is unfortunately an API and ABI break.
251 lines
7.9 KiB
C
251 lines
7.9 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
|
* GObject introspection: Repository
|
|
*
|
|
* Copyright (C) 2005 Matthias Clasen
|
|
* Copyright (C) 2008,2009 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_IREPOSITORY_H__
|
|
#define __G_IREPOSITORY_H__
|
|
|
|
#include <glib-object.h>
|
|
#include <gmodule.h>
|
|
|
|
#define __GIREPOSITORY_H_INSIDE__
|
|
|
|
#include <giarginfo.h>
|
|
#include <gibaseinfo.h>
|
|
#include <gicallableinfo.h>
|
|
#include <giconstantinfo.h>
|
|
#include <gienuminfo.h>
|
|
#include <gifieldinfo.h>
|
|
#include <gifunctioninfo.h>
|
|
#include <giinterfaceinfo.h>
|
|
#include <giobjectinfo.h>
|
|
#include <gipropertyinfo.h>
|
|
#include <giregisteredtypeinfo.h>
|
|
#include <gisignalinfo.h>
|
|
#include <gistructinfo.h>
|
|
#include <gitypeinfo.h>
|
|
#include <gitypelib.h>
|
|
#include <gitypes.h>
|
|
#include <giunioninfo.h>
|
|
#include <giversionmacros.h>
|
|
#include <givfuncinfo.h>
|
|
#include <giversion.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_IREPOSITORY (g_irepository_get_type ())
|
|
#define G_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_IREPOSITORY, GIRepository))
|
|
#define G_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), G_TYPE_IREPOSITORY, GIRepositoryClass))
|
|
#define G_IS_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_IREPOSITORY))
|
|
#define G_IS_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), G_TYPE_IREPOSITORY))
|
|
#define G_IREPOSITORY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), G_TYPE_IREPOSITORY, GIRepositoryClass))
|
|
|
|
/**
|
|
* GIRepository:
|
|
*
|
|
* The GIRepository structure contains private data and should only be
|
|
* accessed using the provided API.
|
|
*/
|
|
typedef struct _GIRepository GIRepository;
|
|
typedef struct _GIRepositoryClass GIRepositoryClass;
|
|
typedef struct _GIRepositoryPrivate GIRepositoryPrivate;
|
|
|
|
struct _GIRepository
|
|
{
|
|
/*< private >*/
|
|
GObject parent;
|
|
GIRepositoryPrivate *priv;
|
|
};
|
|
|
|
struct _GIRepositoryClass
|
|
{
|
|
/*< private >*/
|
|
GObjectClass parent;
|
|
};
|
|
|
|
/**
|
|
* GIRepositoryLoadFlags:
|
|
* @G_IREPOSITORY_LOAD_FLAG_LAZY: Lazily load the typelib.
|
|
*
|
|
* Flags that control how a typelib is loaded.
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_IREPOSITORY_LOAD_FLAG_LAZY = 1 << 0
|
|
} GIRepositoryLoadFlags;
|
|
|
|
/* Repository */
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GType g_irepository_get_type (void) G_GNUC_CONST;
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIRepository *g_irepository_get_default (void);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
void g_irepository_prepend_search_path (const char *directory);
|
|
|
|
GI_AVAILABLE_IN_1_36
|
|
void g_irepository_prepend_library_path (const char *directory);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GSList * g_irepository_get_search_path (void);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
const char * g_irepository_load_typelib (GIRepository *repository,
|
|
GITypelib *typelib,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gboolean g_irepository_is_registered (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *version);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_find_by_name (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *name);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GList * g_irepository_enumerate_versions (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GITypelib * g_irepository_require (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *version,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GITypelib * g_irepository_require_private (GIRepository *repository,
|
|
const gchar *typelib_dir,
|
|
const gchar *namespace_,
|
|
const gchar *version,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_1_44
|
|
gchar ** g_irepository_get_immediate_dependencies (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gchar ** g_irepository_get_dependencies (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gchar ** g_irepository_get_loaded_namespaces (GIRepository *repository);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_find_by_gtype (GIRepository *repository,
|
|
GType gtype);
|
|
|
|
GI_AVAILABLE_IN_1_60
|
|
void g_irepository_get_object_gtype_interfaces (GIRepository *repository,
|
|
GType gtype,
|
|
guint *n_interfaces_out,
|
|
GIInterfaceInfo ***interfaces_out);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gint g_irepository_get_n_infos (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_get_info (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
gint index);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIEnumInfo * g_irepository_find_by_error_domain (GIRepository *repository,
|
|
GQuark domain);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_typelib_path (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_shared_library (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_c_prefix (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_version (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GOptionGroup * g_irepository_get_option_group (void);
|
|
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gboolean g_irepository_dump (const char *arg, GError **error);
|
|
|
|
/**
|
|
* GIRepositoryError:
|
|
* @G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND: the typelib could not be found.
|
|
* @G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH: the namespace does not match the
|
|
* requested namespace.
|
|
* @G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT: the version of the
|
|
* typelib does not match the requested version.
|
|
* @G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND: the library used by the typelib
|
|
* could not be found.
|
|
*
|
|
* An error code used with #G_IREPOSITORY_ERROR in a #GError returned
|
|
* from a #GIRepository routine.
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND,
|
|
G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH,
|
|
G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT,
|
|
G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND
|
|
} GIRepositoryError;
|
|
|
|
/**
|
|
* G_IREPOSITORY_ERROR:
|
|
*
|
|
* Error domain for #GIRepository. Errors in this domain will be from the
|
|
* #GIRepositoryError enumeration. See #GError for more information on
|
|
* error domains.
|
|
*/
|
|
#define G_IREPOSITORY_ERROR (g_irepository_error_quark ())
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GQuark g_irepository_error_quark (void);
|
|
|
|
|
|
/* Global utility functions */
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
void gi_cclosure_marshal_generic (GClosure *closure,
|
|
GValue *return_gvalue,
|
|
guint n_param_values,
|
|
const GValue *param_values,
|
|
gpointer invocation_hint,
|
|
gpointer marshal_data);
|
|
|
|
G_END_DECLS
|
|
|
|
|
|
#endif /* __G_IREPOSITORY_H__ */
|
|
|