gobject-introspection 3.3.8 → 3.3.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/ext/gobject-introspection/extconf.rb +4 -4
- data/ext/gobject-introspection/gobject_introspection.def +2 -1
- data/ext/gobject-introspection/rb-gi-arg-info.c +33 -1
- data/ext/gobject-introspection/rb-gi-argument.c +384 -3291
- data/ext/gobject-introspection/rb-gi-arguments-in.c +2229 -0
- data/ext/gobject-introspection/rb-gi-arguments-out.c +929 -0
- data/ext/gobject-introspection/rb-gi-arguments.c +850 -0
- data/ext/gobject-introspection/rb-gi-array-type.c +54 -0
- data/ext/gobject-introspection/rb-gi-callback.c +242 -0
- data/ext/gobject-introspection/rb-gi-conversions.h +0 -43
- data/ext/gobject-introspection/rb-gi-direction.c +36 -0
- data/ext/gobject-introspection/rb-gi-field-info.c +172 -81
- data/ext/gobject-introspection/rb-gi-function-info.c +15 -1404
- data/ext/gobject-introspection/rb-gi-private-arg-info.h +24 -0
- data/ext/gobject-introspection/rb-gi-private-arguments-in.h +26 -0
- data/ext/gobject-introspection/rb-gi-private-arguments-out.h +28 -0
- data/ext/gobject-introspection/rb-gi-private-arguments.h +107 -0
- data/ext/gobject-introspection/rb-gi-private-array-type.h +26 -0
- data/ext/gobject-introspection/rb-gi-private-callback.h +41 -0
- data/ext/gobject-introspection/rb-gi-private-direction.h +24 -0
- data/ext/gobject-introspection/rb-gi-private-transfer.h +24 -0
- data/ext/gobject-introspection/rb-gi-private.h +11 -5
- data/ext/gobject-introspection/rb-gi-struct-info.c +2 -0
- data/ext/gobject-introspection/rb-gi-transfer.c +36 -0
- data/ext/gobject-introspection/rb-gi-type-info.c +1 -13
- data/ext/gobject-introspection/rb-gobject-introspection.c +4 -1
- data/ext/gobject-introspection/rb-gobject-introspection.h +5 -23
- data/lib/gobject-introspection/arg-info.rb +2 -0
- data/lib/gobject-introspection/callable-info.rb +1 -1
- data/lib/gobject-introspection/loader.rb +0 -39
- data/lib/gobject-introspection/type-tag.rb +39 -2
- metadata +21 -5
@@ -0,0 +1,850 @@
|
|
1
|
+
/* -*- c-file-style: "ruby"; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright (C) 2012-2019 Ruby-GNOME Project Team
|
4
|
+
*
|
5
|
+
* This library is free software; you can redistribute it and/or
|
6
|
+
* modify it under the terms of the GNU Lesser General Public
|
7
|
+
* License as published by the Free Software Foundation; either
|
8
|
+
* version 2.1 of the License, or (at your option) any later version.
|
9
|
+
*
|
10
|
+
* This library is distributed in the hope that it will be useful,
|
11
|
+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
12
|
+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
13
|
+
* Lesser General Public License for more details.
|
14
|
+
*
|
15
|
+
* You should have received a copy of the GNU Lesser General Public
|
16
|
+
* License along with this library; if not, write to the Free Software
|
17
|
+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
18
|
+
* MA 02110-1301 USA
|
19
|
+
*/
|
20
|
+
|
21
|
+
#include "rb-gi-private.h"
|
22
|
+
|
23
|
+
static gboolean
|
24
|
+
rb_gi_arg_info_may_be_null(GIArgInfo *arg_info)
|
25
|
+
{
|
26
|
+
#if GI_CHECK_VERSION(1, 42, 0)
|
27
|
+
return g_arg_info_may_be_null(arg_info);
|
28
|
+
#else
|
29
|
+
/*
|
30
|
+
GObject Introspection < 1.42 doesn't support "(nullable)" yet.
|
31
|
+
So, we assume that all argument may be NULL. It's danger but
|
32
|
+
convenient.
|
33
|
+
*/
|
34
|
+
return TRUE;
|
35
|
+
#endif
|
36
|
+
}
|
37
|
+
|
38
|
+
static gboolean
|
39
|
+
rb_gi_is_registered_type(GIInfoType type)
|
40
|
+
{
|
41
|
+
switch (type) {
|
42
|
+
case GI_INFO_TYPE_STRUCT:
|
43
|
+
case GI_INFO_TYPE_BOXED:
|
44
|
+
case GI_INFO_TYPE_ENUM:
|
45
|
+
case GI_INFO_TYPE_FLAGS:
|
46
|
+
case GI_INFO_TYPE_OBJECT:
|
47
|
+
case GI_INFO_TYPE_INTERFACE:
|
48
|
+
case GI_INFO_TYPE_UNION:
|
49
|
+
return TRUE;
|
50
|
+
default:
|
51
|
+
return FALSE;
|
52
|
+
}
|
53
|
+
}
|
54
|
+
|
55
|
+
static void
|
56
|
+
rb_gi_arg_metadata_type_init(RBGIArgMetadataType *type,
|
57
|
+
GITypeInfo *type_info)
|
58
|
+
{
|
59
|
+
type->info = type_info;
|
60
|
+
type->tag = GI_TYPE_TAG_VOID;
|
61
|
+
type->interface_info = NULL;
|
62
|
+
type->interface_type = GI_INFO_TYPE_INVALID;
|
63
|
+
type->interface_gtype = G_TYPE_INVALID;
|
64
|
+
|
65
|
+
if (type->info) {
|
66
|
+
type->tag = g_type_info_get_tag(type->info);
|
67
|
+
}
|
68
|
+
if (type->tag == GI_TYPE_TAG_INTERFACE) {
|
69
|
+
type->interface_info = g_type_info_get_interface(type_info);
|
70
|
+
type->interface_type = g_base_info_get_type(type->interface_info);
|
71
|
+
if (rb_gi_is_registered_type(type->interface_type)) {
|
72
|
+
type->interface_gtype =
|
73
|
+
g_registered_type_info_get_g_type(type->interface_info);
|
74
|
+
}
|
75
|
+
}
|
76
|
+
}
|
77
|
+
|
78
|
+
static void
|
79
|
+
rb_gi_arg_metadata_type_clear(RBGIArgMetadataType *type)
|
80
|
+
{
|
81
|
+
if (type->interface_info) {
|
82
|
+
g_base_info_unref(type->interface_info);
|
83
|
+
}
|
84
|
+
if (type->info) {
|
85
|
+
g_base_info_unref(type->info);
|
86
|
+
}
|
87
|
+
}
|
88
|
+
|
89
|
+
static RBGIArgMetadata *
|
90
|
+
rb_gi_arg_metadata_new(GICallableInfo *callable_info, gint i)
|
91
|
+
{
|
92
|
+
RBGIArgMetadata *metadata;
|
93
|
+
GIArgInfo *arg_info;
|
94
|
+
GITypeInfo *type_info;
|
95
|
+
|
96
|
+
metadata = ALLOC(RBGIArgMetadata);
|
97
|
+
metadata->callable_info = callable_info;
|
98
|
+
arg_info = &(metadata->arg_info);
|
99
|
+
g_callable_info_load_arg(callable_info, i, arg_info);
|
100
|
+
metadata->name = g_base_info_get_name(arg_info);
|
101
|
+
type_info = g_arg_info_get_type(arg_info);
|
102
|
+
rb_gi_arg_metadata_type_init(&(metadata->type), type_info);
|
103
|
+
rb_gi_arg_metadata_type_init(&(metadata->element_type), NULL);
|
104
|
+
rb_gi_arg_metadata_type_init(&(metadata->key_type), NULL);
|
105
|
+
rb_gi_arg_metadata_type_init(&(metadata->value_type), NULL);
|
106
|
+
metadata->scope_type = g_arg_info_get_scope(arg_info);
|
107
|
+
metadata->direction = g_arg_info_get_direction(arg_info);
|
108
|
+
metadata->transfer = g_arg_info_get_ownership_transfer(arg_info);
|
109
|
+
metadata->array_type = GI_ARRAY_TYPE_C;
|
110
|
+
metadata->callback_p = (metadata->scope_type != GI_SCOPE_TYPE_INVALID);
|
111
|
+
metadata->closure_p = FALSE;
|
112
|
+
metadata->destroy_p = FALSE;
|
113
|
+
metadata->interface_p = (metadata->type.tag == GI_TYPE_TAG_INTERFACE);
|
114
|
+
metadata->array_p = (metadata->type.tag == GI_TYPE_TAG_ARRAY);
|
115
|
+
metadata->array_length_p = FALSE;
|
116
|
+
metadata->may_be_null_p = rb_gi_arg_info_may_be_null(arg_info);
|
117
|
+
metadata->pointer_p = g_type_info_is_pointer(type_info);
|
118
|
+
metadata->caller_allocates_p = g_arg_info_is_caller_allocates(arg_info);
|
119
|
+
metadata->zero_terminated_p = FALSE;
|
120
|
+
metadata->output_buffer_p = rb_gi_arg_info_is_output_buffer(arg_info);
|
121
|
+
metadata->index = i;
|
122
|
+
metadata->in_arg_index = -1;
|
123
|
+
metadata->closure_in_arg_index = -1;
|
124
|
+
metadata->destroy_in_arg_index = -1;
|
125
|
+
metadata->rb_arg_index = -1;
|
126
|
+
metadata->out_arg_index = -1;
|
127
|
+
metadata->in_arg = NULL;
|
128
|
+
metadata->out_arg = NULL;
|
129
|
+
metadata->rb_arg = Qnil;
|
130
|
+
metadata->array_metadata = NULL;
|
131
|
+
metadata->array_length_metadata = NULL;
|
132
|
+
metadata->array_length_arg = NULL;
|
133
|
+
metadata->free_func = NULL;
|
134
|
+
metadata->free_func_data = NULL;
|
135
|
+
|
136
|
+
switch (metadata->type.tag) {
|
137
|
+
case GI_TYPE_TAG_ARRAY:
|
138
|
+
metadata->zero_terminated_p =
|
139
|
+
g_type_info_is_zero_terminated(type_info);
|
140
|
+
metadata->array_type = g_type_info_get_array_type(type_info);
|
141
|
+
rb_gi_arg_metadata_type_init(&(metadata->element_type),
|
142
|
+
g_type_info_get_param_type(type_info, 0));
|
143
|
+
break;
|
144
|
+
case GI_TYPE_TAG_GLIST:
|
145
|
+
case GI_TYPE_TAG_GSLIST:
|
146
|
+
rb_gi_arg_metadata_type_init(&(metadata->element_type),
|
147
|
+
g_type_info_get_param_type(type_info, 0));
|
148
|
+
break;
|
149
|
+
case GI_TYPE_TAG_GHASH:
|
150
|
+
rb_gi_arg_metadata_type_init(&(metadata->key_type),
|
151
|
+
g_type_info_get_param_type(type_info, 0));
|
152
|
+
rb_gi_arg_metadata_type_init(&(metadata->value_type),
|
153
|
+
g_type_info_get_param_type(type_info, 1));
|
154
|
+
break;
|
155
|
+
default:
|
156
|
+
break;
|
157
|
+
}
|
158
|
+
|
159
|
+
return metadata;
|
160
|
+
}
|
161
|
+
|
162
|
+
static void
|
163
|
+
rb_gi_arg_metadata_free(RBGIArgMetadata *metadata)
|
164
|
+
{
|
165
|
+
rb_gi_arg_metadata_type_clear(&(metadata->value_type));
|
166
|
+
rb_gi_arg_metadata_type_clear(&(metadata->key_type));
|
167
|
+
rb_gi_arg_metadata_type_clear(&(metadata->element_type));
|
168
|
+
rb_gi_arg_metadata_type_clear(&(metadata->type));
|
169
|
+
xfree(metadata);
|
170
|
+
}
|
171
|
+
|
172
|
+
static void
|
173
|
+
rb_gi_arguments_allocate(RBGIArguments *args)
|
174
|
+
{
|
175
|
+
gint i, n_args;
|
176
|
+
|
177
|
+
n_args = g_callable_info_get_n_args(args->info);
|
178
|
+
for (i = 0; i < n_args; i++) {
|
179
|
+
GIArgument argument = {0};
|
180
|
+
RBGIArgMetadata *metadata;
|
181
|
+
GIDirection direction;
|
182
|
+
|
183
|
+
metadata = rb_gi_arg_metadata_new(args->info, i);
|
184
|
+
|
185
|
+
direction = metadata->direction;
|
186
|
+
if (direction == GI_DIRECTION_IN || direction == GI_DIRECTION_INOUT) {
|
187
|
+
metadata->in_arg_index = args->in_args->len;
|
188
|
+
g_array_append_val(args->in_args, argument);
|
189
|
+
}
|
190
|
+
if (direction == GI_DIRECTION_OUT || direction == GI_DIRECTION_INOUT) {
|
191
|
+
metadata->out_arg_index = args->out_args->len;
|
192
|
+
g_array_append_val(args->out_args, argument);
|
193
|
+
}
|
194
|
+
|
195
|
+
g_ptr_array_add(args->metadata, metadata);
|
196
|
+
}
|
197
|
+
|
198
|
+
for (i = 0; i < n_args; i++) {
|
199
|
+
RBGIArgMetadata *metadata;
|
200
|
+
GIDirection direction;
|
201
|
+
|
202
|
+
metadata = g_ptr_array_index(args->metadata, i);
|
203
|
+
direction = metadata->direction;
|
204
|
+
if (direction == GI_DIRECTION_IN || direction == GI_DIRECTION_INOUT) {
|
205
|
+
metadata->in_arg = &g_array_index(args->in_args,
|
206
|
+
GIArgument,
|
207
|
+
metadata->in_arg_index);
|
208
|
+
}
|
209
|
+
if (direction == GI_DIRECTION_OUT || direction == GI_DIRECTION_INOUT) {
|
210
|
+
metadata->out_arg = &g_array_index(args->out_args,
|
211
|
+
GIArgument,
|
212
|
+
metadata->out_arg_index);
|
213
|
+
}
|
214
|
+
}
|
215
|
+
}
|
216
|
+
|
217
|
+
static void
|
218
|
+
rb_gi_arguments_fill_metadata_callback(RBGIArguments *args)
|
219
|
+
{
|
220
|
+
GPtrArray *metadata = args->metadata;
|
221
|
+
guint i;
|
222
|
+
|
223
|
+
for (i = 0; i < metadata->len; i++) {
|
224
|
+
RBGIArgMetadata *callback_metadata;
|
225
|
+
GIArgInfo *arg_info;
|
226
|
+
gint closure_index;
|
227
|
+
gint destroy_index;
|
228
|
+
|
229
|
+
callback_metadata = g_ptr_array_index(metadata, i);
|
230
|
+
|
231
|
+
arg_info = &(callback_metadata->arg_info);
|
232
|
+
closure_index = g_arg_info_get_closure(arg_info);
|
233
|
+
if (closure_index != -1) {
|
234
|
+
RBGIArgMetadata *closure_metadata;
|
235
|
+
closure_metadata = g_ptr_array_index(metadata, closure_index);
|
236
|
+
closure_metadata->closure_p = TRUE;
|
237
|
+
callback_metadata->closure_in_arg_index =
|
238
|
+
closure_metadata->in_arg_index;
|
239
|
+
}
|
240
|
+
|
241
|
+
destroy_index = g_arg_info_get_destroy(arg_info);
|
242
|
+
if (destroy_index != -1) {
|
243
|
+
RBGIArgMetadata *destroy_metadata;
|
244
|
+
destroy_metadata = g_ptr_array_index(args->metadata, destroy_index);
|
245
|
+
destroy_metadata->destroy_p = TRUE;
|
246
|
+
callback_metadata->destroy_in_arg_index =
|
247
|
+
destroy_metadata->in_arg_index;
|
248
|
+
}
|
249
|
+
}
|
250
|
+
}
|
251
|
+
|
252
|
+
static void
|
253
|
+
rb_gi_arguments_fill_metadata_array(RBGIArguments *args)
|
254
|
+
{
|
255
|
+
GPtrArray *metadata = args->metadata;
|
256
|
+
guint i;
|
257
|
+
|
258
|
+
for (i = 0; i < metadata->len; i++) {
|
259
|
+
RBGIArgMetadata *array_metadata;
|
260
|
+
RBGIArgMetadata *array_length_metadata;
|
261
|
+
GITypeInfo *type_info;
|
262
|
+
gint array_length_index = -1;
|
263
|
+
|
264
|
+
array_metadata = g_ptr_array_index(metadata, i);
|
265
|
+
type_info = array_metadata->type.info;
|
266
|
+
if (!array_metadata->array_p) {
|
267
|
+
continue;
|
268
|
+
}
|
269
|
+
|
270
|
+
array_length_index = g_type_info_get_array_length(type_info);
|
271
|
+
if (array_length_index == -1) {
|
272
|
+
continue;
|
273
|
+
}
|
274
|
+
|
275
|
+
array_length_metadata = g_ptr_array_index(metadata, array_length_index);
|
276
|
+
array_length_metadata->array_length_p = TRUE;
|
277
|
+
array_length_metadata->rb_arg_index = -1;
|
278
|
+
array_length_metadata->array_metadata = array_metadata;
|
279
|
+
array_metadata->array_length_metadata = array_length_metadata;
|
280
|
+
if (array_length_metadata->in_arg) {
|
281
|
+
array_metadata->array_length_arg = array_length_metadata->in_arg;
|
282
|
+
} else {
|
283
|
+
array_metadata->array_length_arg = array_length_metadata->out_arg;
|
284
|
+
}
|
285
|
+
}
|
286
|
+
}
|
287
|
+
|
288
|
+
static void
|
289
|
+
rb_gi_arguments_fill_metadata_array_from_callable_info(RBGIArguments *args)
|
290
|
+
{
|
291
|
+
GICallbackInfo *info = args->info;
|
292
|
+
GPtrArray *metadata = args->metadata;
|
293
|
+
GITypeInfo return_type_info;
|
294
|
+
RBGIArgMetadata *array_length_metadata;
|
295
|
+
gint array_length_index = -1;
|
296
|
+
|
297
|
+
g_callable_info_load_return_type(info, &return_type_info);
|
298
|
+
if (g_type_info_get_tag(&return_type_info) != GI_TYPE_TAG_ARRAY) {
|
299
|
+
return;
|
300
|
+
}
|
301
|
+
|
302
|
+
array_length_index = g_type_info_get_array_length(&return_type_info);
|
303
|
+
if (array_length_index == -1) {
|
304
|
+
return;
|
305
|
+
}
|
306
|
+
|
307
|
+
array_length_metadata = g_ptr_array_index(metadata, array_length_index);
|
308
|
+
array_length_metadata->array_length_p = TRUE;
|
309
|
+
array_length_metadata->rb_arg_index = -1;
|
310
|
+
}
|
311
|
+
|
312
|
+
static void
|
313
|
+
rb_gi_arguments_fill_metadata_rb_arg_index(RBGIArguments *args)
|
314
|
+
{
|
315
|
+
guint i;
|
316
|
+
gint rb_arg_index = 0;
|
317
|
+
|
318
|
+
for (i = 0; i < args->metadata->len; i++) {
|
319
|
+
RBGIArgMetadata *metadata;
|
320
|
+
|
321
|
+
metadata = g_ptr_array_index(args->metadata, i);
|
322
|
+
|
323
|
+
if (metadata->callback_p) {
|
324
|
+
continue;
|
325
|
+
}
|
326
|
+
|
327
|
+
if (metadata->closure_p) {
|
328
|
+
continue;
|
329
|
+
}
|
330
|
+
|
331
|
+
if (metadata->destroy_p) {
|
332
|
+
continue;
|
333
|
+
}
|
334
|
+
|
335
|
+
if (metadata->array_length_p) {
|
336
|
+
continue;
|
337
|
+
}
|
338
|
+
|
339
|
+
if (metadata->in_arg_index == -1 &&
|
340
|
+
!metadata->output_buffer_p) {
|
341
|
+
continue;
|
342
|
+
}
|
343
|
+
|
344
|
+
metadata->rb_arg_index = rb_arg_index;
|
345
|
+
if (RARRAY_LEN(args->rb_args) > metadata->rb_arg_index) {
|
346
|
+
metadata->rb_arg =
|
347
|
+
RARRAY_AREF(args->rb_args, metadata->rb_arg_index);
|
348
|
+
}
|
349
|
+
rb_arg_index++;
|
350
|
+
}
|
351
|
+
}
|
352
|
+
|
353
|
+
static void
|
354
|
+
rb_gi_arguments_fill_metadata(RBGIArguments *args)
|
355
|
+
{
|
356
|
+
rb_gi_arguments_fill_metadata_callback(args);
|
357
|
+
rb_gi_arguments_fill_metadata_array(args);
|
358
|
+
rb_gi_arguments_fill_metadata_array_from_callable_info(args);
|
359
|
+
if (args->rb_mode_p) {
|
360
|
+
rb_gi_arguments_fill_metadata_rb_arg_index(args);
|
361
|
+
}
|
362
|
+
}
|
363
|
+
|
364
|
+
static void
|
365
|
+
rb_gi_arguments_fill_rb_args(RBGIArguments *args)
|
366
|
+
{
|
367
|
+
rb_gi_arguments_in_init(args);
|
368
|
+
rb_gi_arguments_out_init(args);
|
369
|
+
}
|
370
|
+
|
371
|
+
static void
|
372
|
+
rb_gi_arguments_fill_raw_args(RBGIArguments *args)
|
373
|
+
{
|
374
|
+
guint i;
|
375
|
+
|
376
|
+
for (i = 0; i < args->metadata->len; i++) {
|
377
|
+
RBGIArgMetadata *metadata;
|
378
|
+
|
379
|
+
metadata = g_ptr_array_index(args->metadata, i);
|
380
|
+
if (metadata->direction == GI_DIRECTION_INOUT) {
|
381
|
+
GIArgument *argument = &g_array_index(args->in_args,
|
382
|
+
GIArgument,
|
383
|
+
metadata->in_arg_index);
|
384
|
+
argument->v_pointer = *((gpointer *)(args->raw_args[i]));
|
385
|
+
}
|
386
|
+
}
|
387
|
+
|
388
|
+
rb_gi_arguments_in_init(args);
|
389
|
+
rb_gi_arguments_out_init(args);
|
390
|
+
}
|
391
|
+
|
392
|
+
static void
|
393
|
+
rb_gi_arguments_metadata_free(gpointer data)
|
394
|
+
{
|
395
|
+
RBGIArgMetadata *metadata = data;
|
396
|
+
if (metadata->scope_type == GI_SCOPE_TYPE_ASYNC ||
|
397
|
+
metadata->scope_type == GI_SCOPE_TYPE_NOTIFIED) {
|
398
|
+
return;
|
399
|
+
}
|
400
|
+
rb_gi_arg_metadata_free(metadata);
|
401
|
+
}
|
402
|
+
|
403
|
+
static gboolean
|
404
|
+
rb_gi_arguments_gobject_based_p(RBGIArguments *args)
|
405
|
+
{
|
406
|
+
GIBaseInfo *container_info;
|
407
|
+
GIRegisteredTypeInfo *registered_type_info;
|
408
|
+
|
409
|
+
container_info = g_base_info_get_container(args->info);
|
410
|
+
if (g_base_info_get_type(container_info) != GI_INFO_TYPE_STRUCT) {
|
411
|
+
return TRUE;
|
412
|
+
}
|
413
|
+
|
414
|
+
registered_type_info = (GIRegisteredTypeInfo *)container_info;
|
415
|
+
if (g_registered_type_info_get_type_init(registered_type_info)) {
|
416
|
+
return TRUE;
|
417
|
+
}
|
418
|
+
|
419
|
+
return FALSE;
|
420
|
+
}
|
421
|
+
|
422
|
+
void
|
423
|
+
rb_gi_arguments_init(RBGIArguments *args,
|
424
|
+
GICallableInfo *info,
|
425
|
+
VALUE rb_receiver,
|
426
|
+
VALUE rb_args,
|
427
|
+
void **raw_args)
|
428
|
+
{
|
429
|
+
args->info = info;
|
430
|
+
args->namespace = g_base_info_get_namespace(info);
|
431
|
+
if (GI_IS_FUNCTION_INFO(info)) {
|
432
|
+
args->name = g_function_info_get_symbol((GIFunctionInfo *)info);
|
433
|
+
} else {
|
434
|
+
args->name = g_base_info_get_name(info);
|
435
|
+
}
|
436
|
+
args->rb_receiver = rb_receiver;
|
437
|
+
args->receiver_type_class = NULL;
|
438
|
+
args->rb_args = rb_args;
|
439
|
+
args->raw_args = raw_args;
|
440
|
+
args->in_args = g_array_new(FALSE, FALSE, sizeof(GIArgument));
|
441
|
+
args->out_args = g_array_new(FALSE, FALSE, sizeof(GIArgument));
|
442
|
+
args->metadata =
|
443
|
+
g_ptr_array_new_with_free_func(rb_gi_arguments_metadata_free);
|
444
|
+
args->rb_mode_p = !(NIL_P(rb_args));
|
445
|
+
|
446
|
+
if (!NIL_P(rb_receiver)) {
|
447
|
+
GIArgument receiver;
|
448
|
+
VALUE rb_receiver_class;
|
449
|
+
rb_receiver_class = rb_class_of(rb_receiver);
|
450
|
+
if (rb_gi_arguments_gobject_based_p(args) ||
|
451
|
+
rb_respond_to(rb_receiver_class, rb_intern("gtype"))) {
|
452
|
+
receiver.v_pointer = RVAL2GOBJ(rb_receiver);
|
453
|
+
} else if (RVAL2CBOOL(rb_obj_is_kind_of(rb_receiver, rb_cClass)) &&
|
454
|
+
rb_respond_to(rb_receiver, rb_intern("gtype"))) {
|
455
|
+
args->receiver_type_class =
|
456
|
+
g_type_class_ref(CLASS2GTYPE(rb_receiver));
|
457
|
+
receiver.v_pointer = args->receiver_type_class;
|
458
|
+
} else {
|
459
|
+
receiver.v_pointer = rb_gi_struct_get_raw(rb_receiver, G_TYPE_NONE);
|
460
|
+
}
|
461
|
+
if (receiver.v_pointer) {
|
462
|
+
g_array_append_val(args->in_args, receiver);
|
463
|
+
}
|
464
|
+
}
|
465
|
+
|
466
|
+
rb_gi_arguments_allocate(args);
|
467
|
+
rb_gi_arguments_fill_metadata(args);
|
468
|
+
if (args->rb_mode_p) {
|
469
|
+
rb_gi_arguments_fill_rb_args(args);
|
470
|
+
} else {
|
471
|
+
rb_gi_arguments_fill_raw_args(args);
|
472
|
+
}
|
473
|
+
}
|
474
|
+
|
475
|
+
void
|
476
|
+
rb_gi_arguments_clear(RBGIArguments *args)
|
477
|
+
{
|
478
|
+
rb_gi_arguments_in_clear(args);
|
479
|
+
rb_gi_arguments_out_clear(args);
|
480
|
+
|
481
|
+
if (args->receiver_type_class) {
|
482
|
+
g_type_class_unref(args->receiver_type_class);
|
483
|
+
}
|
484
|
+
g_array_unref(args->in_args);
|
485
|
+
g_array_unref(args->out_args);
|
486
|
+
g_ptr_array_unref(args->metadata);
|
487
|
+
}
|
488
|
+
|
489
|
+
VALUE
|
490
|
+
rb_gi_arguments_get_rb_return_value(RBGIArguments *args,
|
491
|
+
GIArgument *return_value)
|
492
|
+
{
|
493
|
+
/* TODO */
|
494
|
+
VALUE rb_return_value = GI_RETURN_ARGUMENT2RVAL(args->info,
|
495
|
+
return_value,
|
496
|
+
args->in_args,
|
497
|
+
args->out_args,
|
498
|
+
args->metadata);
|
499
|
+
return rb_return_value;
|
500
|
+
}
|
501
|
+
|
502
|
+
VALUE
|
503
|
+
rb_gi_arguments_get_rb_out_args(RBGIArguments *args)
|
504
|
+
{
|
505
|
+
return rb_gi_arguments_out_to_ruby(args);
|
506
|
+
}
|
507
|
+
|
508
|
+
static void
|
509
|
+
rb_gi_arguments_fill_raw_result_interface(RBGIArguments *args,
|
510
|
+
VALUE rb_result,
|
511
|
+
gpointer raw_result,
|
512
|
+
GITypeInfo *type_info,
|
513
|
+
G_GNUC_UNUSED GITransfer transfer /* TODO */,
|
514
|
+
gboolean is_return_value)
|
515
|
+
{
|
516
|
+
GIBaseInfo *interface_info;
|
517
|
+
GIInfoType interface_type;
|
518
|
+
GIFFIReturnValue *ffi_return_value = raw_result;
|
519
|
+
|
520
|
+
interface_info = g_type_info_get_interface(type_info);
|
521
|
+
interface_type = g_base_info_get_type(interface_info);
|
522
|
+
|
523
|
+
switch (interface_type) {
|
524
|
+
case GI_INFO_TYPE_INVALID:
|
525
|
+
case GI_INFO_TYPE_FUNCTION:
|
526
|
+
case GI_INFO_TYPE_CALLBACK:
|
527
|
+
case GI_INFO_TYPE_STRUCT:
|
528
|
+
case GI_INFO_TYPE_BOXED:
|
529
|
+
rb_raise(rb_eNotImpError,
|
530
|
+
"TODO: %s::%s: out raw result(interface)[%s]: <%s>",
|
531
|
+
args->namespace,
|
532
|
+
args->name,
|
533
|
+
g_info_type_to_string(interface_type),
|
534
|
+
g_base_info_get_name(interface_info));
|
535
|
+
break;
|
536
|
+
case GI_INFO_TYPE_ENUM:
|
537
|
+
{
|
538
|
+
gint32 value;
|
539
|
+
GType gtype = g_registered_type_info_get_g_type(interface_info);
|
540
|
+
if (gtype == G_TYPE_NONE) {
|
541
|
+
value = NUM2INT(rb_result);
|
542
|
+
} else {
|
543
|
+
value = RVAL2GENUM(rb_result, gtype);
|
544
|
+
}
|
545
|
+
if (is_return_value) {
|
546
|
+
ffi_return_value->v_ulong = value;
|
547
|
+
} else {
|
548
|
+
*((gint *)raw_result) = value;
|
549
|
+
}
|
550
|
+
}
|
551
|
+
break;
|
552
|
+
case GI_INFO_TYPE_FLAGS:
|
553
|
+
case GI_INFO_TYPE_OBJECT:
|
554
|
+
case GI_INFO_TYPE_INTERFACE:
|
555
|
+
case GI_INFO_TYPE_CONSTANT:
|
556
|
+
rb_raise(rb_eNotImpError,
|
557
|
+
"TODO: %s::%s: out raw result(interface)[%s]: <%s>",
|
558
|
+
g_base_info_get_namespace(args->info),
|
559
|
+
g_base_info_get_name(args->info),
|
560
|
+
g_info_type_to_string(interface_type),
|
561
|
+
g_base_info_get_name(interface_info));
|
562
|
+
break;
|
563
|
+
case GI_INFO_TYPE_INVALID_0:
|
564
|
+
g_assert_not_reached();
|
565
|
+
break;
|
566
|
+
case GI_INFO_TYPE_UNION:
|
567
|
+
case GI_INFO_TYPE_VALUE:
|
568
|
+
case GI_INFO_TYPE_SIGNAL:
|
569
|
+
case GI_INFO_TYPE_VFUNC:
|
570
|
+
case GI_INFO_TYPE_PROPERTY:
|
571
|
+
case GI_INFO_TYPE_FIELD:
|
572
|
+
case GI_INFO_TYPE_ARG:
|
573
|
+
case GI_INFO_TYPE_TYPE:
|
574
|
+
case GI_INFO_TYPE_UNRESOLVED:
|
575
|
+
default:
|
576
|
+
rb_raise(rb_eNotImpError,
|
577
|
+
"TODO: %s::%s: out raw result(interface)[%s]: <%s>",
|
578
|
+
g_base_info_get_namespace(args->info),
|
579
|
+
g_base_info_get_name(args->info),
|
580
|
+
g_info_type_to_string(interface_type),
|
581
|
+
g_base_info_get_name(interface_info));
|
582
|
+
break;
|
583
|
+
}
|
584
|
+
|
585
|
+
g_base_info_unref(interface_info);
|
586
|
+
}
|
587
|
+
|
588
|
+
/*
|
589
|
+
We need to cast from different type for return value. (We don't
|
590
|
+
need it for out arguments.) Because of libffi specification:
|
591
|
+
|
592
|
+
https://github.com/libffi/libffi/blob/master/doc/libffi.texi#L190
|
593
|
+
|
594
|
+
@var{rvalue} is a pointer to a chunk of memory that will hold the
|
595
|
+
result of the function call. This must be large enough to hold the
|
596
|
+
result, no smaller than the system register size (generally 32 or 64
|
597
|
+
bits), and must be suitably aligned; it is the caller's responsibility
|
598
|
+
to ensure this. If @var{cif} declares that the function returns
|
599
|
+
@code{void} (using @code{ffi_type_void}), then @var{rvalue} is
|
600
|
+
ignored.
|
601
|
+
|
602
|
+
https://github.com/libffi/libffi/blob/master/doc/libffi.texi#L198
|
603
|
+
|
604
|
+
In most situations, @samp{libffi} will handle promotion according to
|
605
|
+
the ABI. However, for historical reasons, there is a special case
|
606
|
+
with return values that must be handled by your code. In particular,
|
607
|
+
for integral (not @code{struct}) types that are narrower than the
|
608
|
+
system register size, the return value will be widened by
|
609
|
+
@samp{libffi}. @samp{libffi} provides a type, @code{ffi_arg}, that
|
610
|
+
can be used as the return type. For example, if the CIF was defined
|
611
|
+
with a return type of @code{char}, @samp{libffi} will try to store a
|
612
|
+
full @code{ffi_arg} into the return value.
|
613
|
+
|
614
|
+
See also:
|
615
|
+
* https://github.com/ruby-gnome/ruby-gnome/issues/758#issuecomment-243149237
|
616
|
+
* https://github.com/libffi/libffi/pull/216
|
617
|
+
|
618
|
+
This ffi_return_value case implementation is based on
|
619
|
+
gi_type_info_extract_ffi_return_value().
|
620
|
+
*/
|
621
|
+
static void
|
622
|
+
rb_gi_arguments_fill_raw_result(RBGIArguments *args,
|
623
|
+
VALUE rb_result,
|
624
|
+
gpointer raw_result,
|
625
|
+
GITypeInfo *type_info,
|
626
|
+
GITransfer transfer,
|
627
|
+
gboolean is_return_value)
|
628
|
+
{
|
629
|
+
GIFFIReturnValue *ffi_return_value = raw_result;
|
630
|
+
GITypeTag type_tag;
|
631
|
+
|
632
|
+
type_tag = g_type_info_get_tag(type_info);
|
633
|
+
switch (type_tag) {
|
634
|
+
case GI_TYPE_TAG_VOID:
|
635
|
+
g_assert_not_reached();
|
636
|
+
break;
|
637
|
+
case GI_TYPE_TAG_BOOLEAN:
|
638
|
+
if (is_return_value) {
|
639
|
+
ffi_return_value->v_ulong = RVAL2CBOOL(rb_result);
|
640
|
+
} else {
|
641
|
+
*((gboolean *)raw_result) = RVAL2CBOOL(rb_result);
|
642
|
+
}
|
643
|
+
break;
|
644
|
+
case GI_TYPE_TAG_INT8:
|
645
|
+
if (is_return_value) {
|
646
|
+
ffi_return_value->v_long = NUM2CHR(rb_result);
|
647
|
+
} else {
|
648
|
+
*((gint8 *)raw_result) = NUM2CHR(rb_result);
|
649
|
+
}
|
650
|
+
break;
|
651
|
+
case GI_TYPE_TAG_UINT8:
|
652
|
+
if (is_return_value) {
|
653
|
+
ffi_return_value->v_ulong = (guint8)NUM2CHR(rb_result);
|
654
|
+
} else {
|
655
|
+
*((guint8 *)raw_result) = (guint8)NUM2CHR(rb_result);
|
656
|
+
}
|
657
|
+
break;
|
658
|
+
case GI_TYPE_TAG_INT16:
|
659
|
+
if (is_return_value) {
|
660
|
+
ffi_return_value->v_long = NUM2SHORT(rb_result);
|
661
|
+
} else {
|
662
|
+
*((gint16 *)raw_result) = NUM2SHORT(rb_result);
|
663
|
+
}
|
664
|
+
break;
|
665
|
+
case GI_TYPE_TAG_UINT16:
|
666
|
+
if (is_return_value) {
|
667
|
+
ffi_return_value->v_ulong = NUM2USHORT(rb_result);
|
668
|
+
} else {
|
669
|
+
*((guint16 *)raw_result) = NUM2USHORT(rb_result);
|
670
|
+
}
|
671
|
+
break;
|
672
|
+
case GI_TYPE_TAG_INT32:
|
673
|
+
if (is_return_value) {
|
674
|
+
ffi_return_value->v_long = NUM2INT(rb_result);
|
675
|
+
} else {
|
676
|
+
*((gint32 *)raw_result) = NUM2INT(rb_result);
|
677
|
+
}
|
678
|
+
break;
|
679
|
+
case GI_TYPE_TAG_UINT32:
|
680
|
+
if (is_return_value) {
|
681
|
+
ffi_return_value->v_ulong = NUM2UINT(rb_result);
|
682
|
+
} else {
|
683
|
+
*((guint32 *)raw_result) = NUM2UINT(rb_result);
|
684
|
+
}
|
685
|
+
break;
|
686
|
+
case GI_TYPE_TAG_INT64:
|
687
|
+
*((gint64 *)raw_result) = NUM2LL(rb_result);
|
688
|
+
break;
|
689
|
+
case GI_TYPE_TAG_UINT64:
|
690
|
+
*((guint64 *)raw_result) = NUM2ULL(rb_result);
|
691
|
+
break;
|
692
|
+
case GI_TYPE_TAG_FLOAT:
|
693
|
+
*((gfloat *)raw_result) = NUM2DBL(rb_result);
|
694
|
+
break;
|
695
|
+
case GI_TYPE_TAG_DOUBLE:
|
696
|
+
*((gdouble *)raw_result) = NUM2DBL(rb_result);
|
697
|
+
break;
|
698
|
+
case GI_TYPE_TAG_GTYPE:
|
699
|
+
if (is_return_value) {
|
700
|
+
ffi_return_value->v_ulong = rbgobj_gtype_from_ruby(rb_result);
|
701
|
+
} else {
|
702
|
+
*((gsize *)raw_result) = rbgobj_gtype_from_ruby(rb_result);
|
703
|
+
}
|
704
|
+
break;
|
705
|
+
case GI_TYPE_TAG_UTF8:
|
706
|
+
if (is_return_value) {
|
707
|
+
ffi_return_value->v_ulong =
|
708
|
+
(gulong)RVAL2CSTR_ACCEPT_SYMBOL(rb_result);
|
709
|
+
} else {
|
710
|
+
*((gchar **)raw_result) =
|
711
|
+
(gchar *)RVAL2CSTR_ACCEPT_SYMBOL(rb_result);
|
712
|
+
}
|
713
|
+
break;
|
714
|
+
case GI_TYPE_TAG_FILENAME:
|
715
|
+
rb_raise(rb_eNotImpError,
|
716
|
+
"TODO: %s::%s: out raw result(%s)",
|
717
|
+
args->namespace,
|
718
|
+
args->name,
|
719
|
+
g_type_tag_to_string(type_tag));
|
720
|
+
/* if (is_return_value) { */
|
721
|
+
/* ffi_return_value->v_ulong = */
|
722
|
+
/* (gulong)rbg_filename_from_ruby(rb_result); */
|
723
|
+
/* } else { */
|
724
|
+
/* *((gchar **)raw_result) = */
|
725
|
+
/* (gchar *)rbg_filename_from_ruby(rb_result); */
|
726
|
+
/* } */
|
727
|
+
/* free */
|
728
|
+
break;
|
729
|
+
case GI_TYPE_TAG_ARRAY:
|
730
|
+
rb_raise(rb_eNotImpError,
|
731
|
+
"TODO: %s::%s: out raw result(%s)",
|
732
|
+
args->namespace,
|
733
|
+
args->name,
|
734
|
+
g_type_tag_to_string(type_tag));
|
735
|
+
/* if (is_return_value) { */
|
736
|
+
/* ffi_return_value->v_ulong = (gulong)(argument.v_pointer); */
|
737
|
+
/* } else { */
|
738
|
+
/* *((gpointer *)raw_result) = argument.v_pointer; */
|
739
|
+
/* } */
|
740
|
+
break;
|
741
|
+
case GI_TYPE_TAG_INTERFACE:
|
742
|
+
rb_gi_arguments_fill_raw_result_interface(args,
|
743
|
+
rb_result,
|
744
|
+
raw_result,
|
745
|
+
type_info,
|
746
|
+
transfer,
|
747
|
+
is_return_value);
|
748
|
+
break;
|
749
|
+
case GI_TYPE_TAG_GLIST:
|
750
|
+
case GI_TYPE_TAG_GSLIST:
|
751
|
+
case GI_TYPE_TAG_GHASH:
|
752
|
+
rb_raise(rb_eNotImpError,
|
753
|
+
"TODO: %s::%s: out raw result(%s)",
|
754
|
+
args->namespace,
|
755
|
+
args->name,
|
756
|
+
g_type_tag_to_string(type_tag));
|
757
|
+
/* if (is_return_value) { */
|
758
|
+
/* ffi_return_value->v_ulong = (gulong)(argument.v_pointer); */
|
759
|
+
/* } else { */
|
760
|
+
/* *((gpointer *)raw_result) = argument.v_pointer; */
|
761
|
+
/* } */
|
762
|
+
break;
|
763
|
+
case GI_TYPE_TAG_ERROR:
|
764
|
+
rb_raise(rb_eNotImpError,
|
765
|
+
"TODO: %s::%s: out raw result(%s)",
|
766
|
+
args->namespace,
|
767
|
+
args->name,
|
768
|
+
g_type_tag_to_string(type_tag));
|
769
|
+
/* if (is_return_value) { */
|
770
|
+
/* ffi_return_value->v_ulong = (gulong)(argument.v_pointer); */
|
771
|
+
/* } else { */
|
772
|
+
/* *((GError **)raw_result) = argument.v_pointer; */
|
773
|
+
/* } */
|
774
|
+
break;
|
775
|
+
case GI_TYPE_TAG_UNICHAR:
|
776
|
+
if (is_return_value) {
|
777
|
+
ffi_return_value->v_ulong = NUM2UINT(rb_result);
|
778
|
+
} else {
|
779
|
+
*((gunichar *)raw_result) = NUM2UINT(rb_result);
|
780
|
+
}
|
781
|
+
break;
|
782
|
+
default:
|
783
|
+
g_assert_not_reached();
|
784
|
+
break;
|
785
|
+
}
|
786
|
+
}
|
787
|
+
|
788
|
+
void
|
789
|
+
rb_gi_arguments_fill_raw_results(RBGIArguments *args,
|
790
|
+
VALUE rb_results,
|
791
|
+
gpointer raw_return_value)
|
792
|
+
{
|
793
|
+
int i_rb_result = 0;
|
794
|
+
guint i;
|
795
|
+
GITypeInfo *return_type_info;
|
796
|
+
GITypeTag return_type_tag;
|
797
|
+
|
798
|
+
return_type_info = g_callable_info_get_return_type(args->info);
|
799
|
+
return_type_tag = g_type_info_get_tag(return_type_info);
|
800
|
+
if (return_type_tag != GI_TYPE_TAG_VOID) {
|
801
|
+
GITransfer transfer;
|
802
|
+
transfer = g_callable_info_get_caller_owns(args->info);
|
803
|
+
if (args->out_args->len == 0) {
|
804
|
+
VALUE rb_return_value = rb_results;
|
805
|
+
rb_gi_arguments_fill_raw_result(args,
|
806
|
+
rb_return_value,
|
807
|
+
raw_return_value,
|
808
|
+
return_type_info,
|
809
|
+
transfer,
|
810
|
+
TRUE);
|
811
|
+
} else {
|
812
|
+
rb_gi_arguments_fill_raw_result(args,
|
813
|
+
RARRAY_AREF(rb_results, i_rb_result),
|
814
|
+
raw_return_value,
|
815
|
+
return_type_info,
|
816
|
+
transfer,
|
817
|
+
TRUE);
|
818
|
+
i_rb_result++;
|
819
|
+
}
|
820
|
+
}
|
821
|
+
g_base_info_unref(return_type_info);
|
822
|
+
|
823
|
+
for (i = 0; i < args->metadata->len; i++) {
|
824
|
+
RBGIArgMetadata *metadata;
|
825
|
+
GIArgument *argument;
|
826
|
+
GITypeInfo *type_info;
|
827
|
+
GITransfer transfer;
|
828
|
+
|
829
|
+
metadata = g_ptr_array_index(args->metadata, i);
|
830
|
+
|
831
|
+
/* TODO: support GI_DIRECTION_INOUT */
|
832
|
+
if (metadata->direction != GI_DIRECTION_OUT) {
|
833
|
+
continue;
|
834
|
+
}
|
835
|
+
|
836
|
+
argument = &g_array_index(args->out_args,
|
837
|
+
GIArgument,
|
838
|
+
metadata->out_arg_index);
|
839
|
+
type_info = g_arg_info_get_type(&(metadata->arg_info));
|
840
|
+
transfer = g_arg_info_get_ownership_transfer(&(metadata->arg_info));
|
841
|
+
rb_gi_arguments_fill_raw_result(args,
|
842
|
+
RARRAY_AREF(rb_results, i_rb_result),
|
843
|
+
argument->v_pointer,
|
844
|
+
return_type_info,
|
845
|
+
transfer,
|
846
|
+
FALSE);
|
847
|
+
i_rb_result++;
|
848
|
+
g_base_info_unref(type_info);
|
849
|
+
}
|
850
|
+
}
|