1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/*
* peas-object-module.h
* This file is part of libpeas
*
* Copyright (C) 2003 Marco Pesenti Gritti
* Copyright (C) 2003, 2004 Christian Persch
* Copyright (C) 2005-2007 Paolo Maggi
* Copyright (C) 2008 Jesse van den Kieboom
*
* libpeas 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.1 of the License, or (at your option) any later version.
*
* libpeas 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*/
#pragma once
#if !defined (LIBPEAS_INSIDE) && !defined (LIBPEAS_COMPILATION)
# error "Only <libpeas.h> can be included directly."
#endif
#include <glib-object.h>
#include <gmodule.h>
#include "peas-version-macros.h"
G_BEGIN_DECLS
#define PEAS_TYPE_OBJECT_MODULE (peas_object_module_get_type ())
PEAS_AVAILABLE_IN_ALL
G_DECLARE_DERIVABLE_TYPE (PeasObjectModule, peas_object_module, PEAS, OBJECT_MODULE, GTypeModule)
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
/**
* PeasFactoryFunc:
* @n_parameters: The number of paramteters.
* @parameters: (array length=n_parameters): The parameters.
* @user_data: Optional data to be passed to the function, or %NULL.
*
* A #PeasFactoryFunc is a factory function which will instanciate a new
* extension of a given type. [ctor@GObject.Object.newv] is such a function.
*
* It is used with [method@ObjectModule.register_extension_factory].
*
* Returns: (transfer full): The created object.
*/
typedef GObject *(*PeasFactoryFunc) (guint n_parameters,
GParameter *parameters,
gpointer user_data);
G_GNUC_END_IGNORE_DEPRECATIONS
/**
* PeasObjectModuleClass:
* @parent_class: The parent class.
*
* The class structure for #PeasObjectModule.
*/
struct _PeasObjectModuleClass
{
GTypeModuleClass parent_class;
/*< private >*/
gpointer _reserved[8];
};
PEAS_AVAILABLE_IN_ALL
PeasObjectModule *peas_object_module_new (const char *module_name,
const char *path,
gboolean resident);
PEAS_AVAILABLE_IN_ALL
PeasObjectModule *peas_object_module_new_full (const char *module_name,
const char *path,
gboolean resident,
gboolean local_linkage);
PEAS_AVAILABLE_IN_ALL
PeasObjectModule *peas_object_module_new_embedded (const char *module_name,
const char *symbol);
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
PEAS_AVAILABLE_IN_ALL
GObject *peas_object_module_create_object (PeasObjectModule *module,
GType exten_type,
guint n_parameters,
GParameter *parameters);
G_GNUC_END_IGNORE_DEPRECATIONS
PEAS_AVAILABLE_IN_ALL
gboolean peas_object_module_provides_object (PeasObjectModule *module,
GType exten_type);
PEAS_AVAILABLE_IN_ALL
const char *peas_object_module_get_path (PeasObjectModule *module);
PEAS_AVAILABLE_IN_ALL
const char *peas_object_module_get_module_name (PeasObjectModule *module);
PEAS_AVAILABLE_IN_ALL
const char *peas_object_module_get_symbol (PeasObjectModule *module);
PEAS_AVAILABLE_IN_ALL
GModule *peas_object_module_get_library (PeasObjectModule *module);
PEAS_AVAILABLE_IN_ALL
void peas_object_module_register_extension_factory (PeasObjectModule *module,
GType exten_type,
PeasFactoryFunc factory_func,
gpointer user_data,
GDestroyNotify destroy_func);
PEAS_AVAILABLE_IN_ALL
void peas_object_module_register_extension_type (PeasObjectModule *module,
GType exten_type,
GType impl_type);
G_END_DECLS
|
