Coverage Report

Created: 2025-01-28 06:43

/usr/local/include/glib-2.0/glib/gmacros.h
Line
Count
Source (jump to first uncovered line)
1
/* GLIB - Library of useful routines for C programming
2
 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
3
 *
4
 * SPDX-License-Identifier: LGPL-2.1-or-later
5
 *
6
 * This library is free software; you can redistribute it and/or
7
 * modify it under the terms of the GNU Lesser General Public
8
 * License as published by the Free Software Foundation; either
9
 * version 2.1 of the License, or (at your option) any later version.
10
 *
11
 * This library is distributed in the hope that it will be useful,
12
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14
 * Lesser General Public License for more details.
15
 *
16
 * You should have received a copy of the GNU Lesser General Public
17
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
18
 */
19
20
/*
21
 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
22
 * file for a list of people on the GLib Team.  See the ChangeLog
23
 * files for a list of changes.  These files are distributed with
24
 * GLib at ftp://ftp.gtk.org/pub/gtk/.
25
 */
26
27
/* This file must not include any other glib header file and must thus
28
 * not refer to variables from glibconfig.h
29
 */
30
31
#ifndef __G_MACROS_H__
32
#define __G_MACROS_H__
33
34
#if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
35
#error "Only <glib.h> can be included directly."
36
#endif
37
38
/* We include stddef.h to get the system's definition of NULL
39
 */
40
#include <stddef.h>
41
42
/*
43
 * Note: Clang (but not clang-cl) defines __GNUC__ and __GNUC_MINOR__.
44
 * Both Clang 11.1 on current Arch Linux and Apple's Clang 12.0 define
45
 * __GNUC__ = 4 and __GNUC_MINOR__ = 2. So G_GNUC_CHECK_VERSION(4, 2) on
46
 * current Clang will be 1.
47
 */
48
#ifdef __GNUC__
49
#define G_GNUC_CHECK_VERSION(major, minor) \
50
    ((__GNUC__ > (major)) || \
51
     ((__GNUC__ == (major)) && \
52
      (__GNUC_MINOR__ >= (minor))))
53
#else
54
#define G_GNUC_CHECK_VERSION(major, minor) 0
55
#endif
56
57
/* Here we provide G_GNUC_EXTENSION as an alias for __extension__,
58
 * where this is valid. This allows for warningless compilation of
59
 * "long long" types even in the presence of '-ansi -pedantic'. 
60
 */
61
#if G_GNUC_CHECK_VERSION(2, 8)
62
#define G_GNUC_EXTENSION __extension__
63
#else
64
#define G_GNUC_EXTENSION
65
#endif
66
67
#if !defined (__cplusplus)
68
69
# undef G_CXX_STD_VERSION
70
# define G_CXX_STD_CHECK_VERSION(version) (0)
71
72
# if defined (__STDC_VERSION__)
73
#  define G_C_STD_VERSION __STDC_VERSION__
74
# else
75
#  define G_C_STD_VERSION 199000L
76
# endif /* defined (__STDC_VERSION__) */
77
78
# define G_C_STD_CHECK_VERSION(version) ( \
79
  ((version) >= 199000L && (version) <= G_C_STD_VERSION) || \
80
  ((version) == 89 && G_C_STD_VERSION >= 199000L) || \
81
  ((version) == 90 && G_C_STD_VERSION >= 199000L) || \
82
  ((version) == 99 && G_C_STD_VERSION >= 199901L) || \
83
  ((version) == 11 && G_C_STD_VERSION >= 201112L) || \
84
  ((version) == 17 && G_C_STD_VERSION >= 201710L) || \
85
  0)
86
87
#else /* defined (__cplusplus) */
88
89
# undef G_C_STD_VERSION
90
# define G_C_STD_CHECK_VERSION(version) (0)
91
92
# if defined (_MSVC_LANG)
93
#  define G_CXX_STD_VERSION (_MSVC_LANG > __cplusplus ? _MSVC_LANG : __cplusplus)
94
# else
95
#  define G_CXX_STD_VERSION __cplusplus
96
# endif /* defined(_MSVC_LANG) */
97
98
# define G_CXX_STD_CHECK_VERSION(version) ( \
99
  ((version) >= 199711L && (version) <= G_CXX_STD_VERSION) || \
100
  ((version) == 98 && G_CXX_STD_VERSION >= 199711L) || \
101
  ((version) == 03 && G_CXX_STD_VERSION >= 199711L) || \
102
  ((version) == 11 && G_CXX_STD_VERSION >= 201103L) || \
103
  ((version) == 14 && G_CXX_STD_VERSION >= 201402L) || \
104
  ((version) == 17 && G_CXX_STD_VERSION >= 201703L) || \
105
  ((version) == 20 && G_CXX_STD_VERSION >= 202002L) || \
106
  0)
107
108
#endif /* !defined (__cplusplus) */
109
110
/* Every compiler that we target supports inlining, but some of them may
111
 * complain about it if we don't say "__inline".  If we have C99, or if
112
 * we are using C++, then we can use "inline" directly.
113
 * Otherwise, we say "__inline" to avoid the warning.
114
 * Unfortunately Visual Studio does not define __STDC_VERSION__ (if not
115
 * using /std:cXX) so we need to check whether we are on Visual Studio 2013
116
 * or earlier to see whether we need to say "__inline" in C mode.
117
 */
118
#define G_CAN_INLINE
119
#ifdef G_C_STD_VERSION
120
# ifdef _MSC_VER
121
#  if (_MSC_VER < 1900)
122
#   define G_INLINE_DEFINE_NEEDED
123
#  endif
124
# elif !G_C_STD_CHECK_VERSION (99)
125
#  define G_INLINE_DEFINE_NEEDED
126
# endif
127
#endif
128
129
#ifdef G_INLINE_DEFINE_NEEDED
130
# undef inline
131
# define inline __inline
132
#endif
133
134
#undef G_INLINE_DEFINE_NEEDED
135
136
/**
137
 * G_INLINE_FUNC:
138
 *
139
 * This macro used to be used to conditionally define inline functions
140
 * in a compatible way before this feature was supported in all
141
 * compilers.  These days, GLib requires inlining support from the
142
 * compiler, so your GLib-using programs can safely assume that the
143
 * "inline" keyword works properly.
144
 *
145
 * Never use this macro anymore.  Just say "static inline".
146
 *
147
 * Deprecated: 2.48: Use "static inline" instead
148
 */
149
150
/* For historical reasons we need to continue to support those who
151
 * define G_IMPLEMENT_INLINES to mean "don't implement this here".
152
 */
153
#ifdef G_IMPLEMENT_INLINES
154
#  define G_INLINE_FUNC extern GLIB_DEPRECATED_MACRO_IN_2_48_FOR(static inline)
155
#  undef  G_CAN_INLINE
156
#else
157
#  define G_INLINE_FUNC static inline GLIB_DEPRECATED_MACRO_IN_2_48_FOR(static inline)
158
#endif /* G_IMPLEMENT_INLINES */
159
160
/*
161
 * Attribute support detection. Works on clang and GCC >= 5
162
 * https://clang.llvm.org/docs/LanguageExtensions.html#has-attribute
163
 * https://gcc.gnu.org/onlinedocs/cpp/_005f_005fhas_005fattribute.html
164
 */
165
166
#ifdef __has_attribute
167
#define g_macro__has_attribute __has_attribute
168
#else
169
170
/*
171
 * Fallback for GCC < 5 and other compilers not supporting __has_attribute.
172
 */
173
#define g_macro__has_attribute(x) g_macro__has_attribute_##x
174
175
#define g_macro__has_attribute___alloc_size__ G_GNUC_CHECK_VERSION (4, 3)
176
#define g_macro__has_attribute___always_inline__ G_GNUC_CHECK_VERSION (2, 0)
177
#define g_macro__has_attribute___const__ G_GNUC_CHECK_VERSION (2, 4)
178
#define g_macro__has_attribute___deprecated__ G_GNUC_CHECK_VERSION (3, 1)
179
#define g_macro__has_attribute___format__ G_GNUC_CHECK_VERSION (2, 4)
180
#define g_macro__has_attribute___format_arg__ G_GNUC_CHECK_VERSION (2, 4)
181
#define g_macro__has_attribute___malloc__ G_GNUC_CHECK_VERSION (2, 96)
182
#define g_macro__has_attribute___no_instrument_function__ G_GNUC_CHECK_VERSION (2, 4)
183
#define g_macro__has_attribute___noinline__ G_GNUC_CHECK_VERSION (2, 96)
184
#define g_macro__has_attribute___noreturn__ (G_GNUC_CHECK_VERSION (2, 8) || (0x5110 <= __SUNPRO_C))
185
#define g_macro__has_attribute___pure__ G_GNUC_CHECK_VERSION (2, 96)
186
#define g_macro__has_attribute___sentinel__ G_GNUC_CHECK_VERSION (4, 0)
187
#define g_macro__has_attribute___unused__ G_GNUC_CHECK_VERSION (2, 4)
188
#define g_macro__has_attribute___weak__ G_GNUC_CHECK_VERSION (2, 8)
189
#define g_macro__has_attribute_cleanup G_GNUC_CHECK_VERSION (3, 3)
190
#define g_macro__has_attribute_fallthrough G_GNUC_CHECK_VERSION (6, 0)
191
#define g_macro__has_attribute_may_alias G_GNUC_CHECK_VERSION (3, 3)
192
#define g_macro__has_attribute_warn_unused_result G_GNUC_CHECK_VERSION (3, 4)
193
#define g_macro__has_attribute_no_sanitize_address 0
194
#define g_macro__has_attribute_ifunc 0
195
196
#endif
197
198
/* Provide macros to feature the GCC function attribute.
199
 */
200
201
/**
202
 * G_GNUC_PURE:
203
 *
204
 * Expands to the GNU C `pure` function attribute if the compiler is gcc.
205
 * Declaring a function as `pure` enables better optimization of calls to
206
 * the function. A `pure` function has no effects except its return value
207
 * and the return value depends only on the parameters and/or global
208
 * variables.
209
 *
210
 * Place the attribute after the declaration, just before the semicolon.
211
 *
212
 * |[<!-- language="C" -->
213
 * gboolean g_type_check_value (const GValue *value) G_GNUC_PURE;
214
 * ]|
215
 *
216
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-pure-function-attribute) for more details.
217
 */
218
219
/**
220
 * G_GNUC_MALLOC:
221
 *
222
 * Expands to the
223
 * [GNU C `malloc` function attribute](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-functions-that-behave-like-malloc)
224
 * if the compiler is gcc.
225
 * Declaring a function as `malloc` enables better optimization of the function,
226
 * but must only be done if the allocation behaviour of the function is fully
227
 * understood, otherwise miscompilation can result.
228
 *
229
 * A function can have the `malloc` attribute if it returns a pointer which is
230
 * guaranteed to not alias with any other pointer valid when the function
231
 * returns, and moreover no pointers to valid objects occur in any storage
232
 * addressed by the returned pointer.
233
 *
234
 * In practice, this means that `G_GNUC_MALLOC` can be used with any function
235
 * which returns unallocated or zeroed-out memory, but not with functions which
236
 * return initialised structures containing other pointers, or with functions
237
 * that reallocate memory. This definition changed in GLib 2.58 to match the
238
 * stricter definition introduced around GCC 5.
239
 *
240
 * Place the attribute after the declaration, just before the semicolon.
241
 *
242
 * |[<!-- language="C" -->
243
 * gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1);
244
 * ]|
245
 *
246
 * See the
247
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-functions-that-behave-like-malloc)
248
 * for more details.
249
 *
250
 * Since: 2.6
251
 */
252
253
/**
254
 * G_GNUC_NO_INLINE:
255
 *
256
 * Expands to the GNU C `noinline` function attribute if the compiler is gcc.
257
 * If the compiler is not gcc, this macro expands to nothing.
258
 *
259
 * Declaring a function as `noinline` prevents the function from being
260
 * considered for inlining.
261
 *
262
 * This macro is provided for retro-compatibility and will be eventually
263
 * deprecated, but %G_NO_INLINE should be used instead.
264
 *
265
 * The attribute may be placed before the declaration or definition,
266
 * right before the `static` keyword.
267
 *
268
 * |[<!-- language="C" -->
269
 * G_GNUC_NO_INLINE
270
 * static int
271
 * do_not_inline_this (void)
272
 * {
273
 *   ...
274
 * }
275
 * ]|
276
 *
277
 * See the
278
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-noinline-function-attribute)
279
 * for more details.
280
 *
281
 * See also: %G_NO_INLINE, %G_ALWAYS_INLINE.
282
 *
283
 * Since: 2.58
284
 */
285
286
#if g_macro__has_attribute(__pure__)
287
#define G_GNUC_PURE __attribute__((__pure__))
288
#else
289
#define G_GNUC_PURE
290
#endif
291
292
#if g_macro__has_attribute(__malloc__)
293
#define G_GNUC_MALLOC __attribute__ ((__malloc__))
294
#else
295
#define G_GNUC_MALLOC
296
#endif
297
298
#if g_macro__has_attribute(__noinline__)
299
#define G_GNUC_NO_INLINE __attribute__ ((__noinline__)) \
300
  GLIB_AVAILABLE_MACRO_IN_2_58
301
#else
302
#define G_GNUC_NO_INLINE \
303
  GLIB_AVAILABLE_MACRO_IN_2_58
304
#endif
305
306
/**
307
 * G_GNUC_NULL_TERMINATED:
308
 *
309
 * Expands to the GNU C `sentinel` function attribute if the compiler is gcc.
310
 * This function attribute only applies to variadic functions and instructs
311
 * the compiler to check that the argument list is terminated with an
312
 * explicit %NULL.
313
 *
314
 * Place the attribute after the declaration, just before the semicolon.
315
 *
316
 * |[<!-- language="C" -->
317
 * gchar *g_strconcat (const gchar *string1,
318
 *                     ...) G_GNUC_NULL_TERMINATED;
319
 * ]|
320
 *
321
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-sentinel-function-attribute) for more details.
322
 *
323
 * Since: 2.8
324
 */
325
#if g_macro__has_attribute(__sentinel__)
326
#define G_GNUC_NULL_TERMINATED __attribute__((__sentinel__))
327
#else
328
#define G_GNUC_NULL_TERMINATED
329
#endif
330
331
/*
332
 * Clang feature detection: http://clang.llvm.org/docs/LanguageExtensions.html
333
 * These are not available on GCC, but since the pre-processor doesn't do
334
 * operator short-circuiting, we can't use it in a statement or we'll get:
335
 *
336
 * error: missing binary operator before token "("
337
 *
338
 * So we define it to 0 to satisfy the pre-processor.
339
 */
340
341
#ifdef __has_feature
342
#define g_macro__has_feature __has_feature
343
#else
344
#define g_macro__has_feature(x) 0
345
#endif
346
347
#ifdef __has_builtin
348
#define g_macro__has_builtin __has_builtin
349
#else
350
#define g_macro__has_builtin(x) 0
351
#endif
352
353
#ifdef __has_extension
354
#define g_macro__has_extension __has_extension
355
#else
356
#define g_macro__has_extension(x) 0
357
#endif
358
359
/**
360
 * G_GNUC_ALLOC_SIZE:
361
 * @x: the index of the argument specifying the allocation size
362
 *
363
 * Expands to the GNU C `alloc_size` function attribute if the compiler
364
 * is a new enough gcc. This attribute tells the compiler that the
365
 * function returns a pointer to memory of a size that is specified
366
 * by the @xth function parameter.
367
 *
368
 * Place the attribute after the function declaration, just before the
369
 * semicolon.
370
 *
371
 * |[<!-- language="C" -->
372
 * gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1);
373
 * ]|
374
 *
375
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details.
376
 *
377
 * Since: 2.18
378
 */
379
380
/**
381
 * G_GNUC_ALLOC_SIZE2:
382
 * @x: the index of the argument specifying one factor of the allocation size
383
 * @y: the index of the argument specifying the second factor of the allocation size
384
 *
385
 * Expands to the GNU C `alloc_size` function attribute if the compiler is a
386
 * new enough gcc. This attribute tells the compiler that the function returns
387
 * a pointer to memory of a size that is specified by the product of two
388
 * function parameters.
389
 *
390
 * Place the attribute after the function declaration, just before the
391
 * semicolon.
392
 *
393
 * |[<!-- language="C" -->
394
 * gpointer g_malloc_n (gsize n_blocks,
395
 *                      gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1, 2);
396
 * ]|
397
 *
398
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details.
399
 *
400
 * Since: 2.18
401
 */
402
#if g_macro__has_attribute(__alloc_size__)
403
#define G_GNUC_ALLOC_SIZE(x) __attribute__((__alloc_size__(x)))
404
#define G_GNUC_ALLOC_SIZE2(x,y) __attribute__((__alloc_size__(x,y)))
405
#else
406
#define G_GNUC_ALLOC_SIZE(x)
407
#define G_GNUC_ALLOC_SIZE2(x,y)
408
#endif
409
410
/**
411
 * G_GNUC_PRINTF:
412
 * @format_idx: the index of the argument corresponding to the
413
 *     format string (the arguments are numbered from 1)
414
 * @arg_idx: the index of the first of the format arguments, or 0 if
415
 *     there are no format arguments
416
 *
417
 * Expands to the GNU C `format` function attribute if the compiler is gcc.
418
 * This is used for declaring functions which take a variable number of
419
 * arguments, with the same syntax as `printf()`. It allows the compiler
420
 * to type-check the arguments passed to the function.
421
 *
422
 * Place the attribute after the function declaration, just before the
423
 * semicolon.
424
 *
425
 * See the
426
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288)
427
 * for more details.
428
 *
429
 * |[<!-- language="C" -->
430
 * gint g_snprintf (gchar  *string,
431
 *                  gulong       n,
432
 *                  gchar const *format,
433
 *                  ...) G_GNUC_PRINTF (3, 4);
434
 * ]|
435
 */
436
437
/**
438
 * G_GNUC_SCANF:
439
 * @format_idx: the index of the argument corresponding to
440
 *     the format string (the arguments are numbered from 1)
441
 * @arg_idx: the index of the first of the format arguments, or 0 if
442
 *     there are no format arguments
443
 *
444
 * Expands to the GNU C `format` function attribute if the compiler is gcc.
445
 * This is used for declaring functions which take a variable number of
446
 * arguments, with the same syntax as `scanf()`. It allows the compiler
447
 * to type-check the arguments passed to the function.
448
 *
449
 * |[<!-- language="C" -->
450
 * int my_scanf (MyStream *stream,
451
 *               const char *format,
452
 *               ...) G_GNUC_SCANF (2, 3);
453
 * int my_vscanf (MyStream *stream,
454
 *                const char *format,
455
 *                va_list ap) G_GNUC_SCANF (2, 0);
456
 * ]|
457
 *
458
 * See the
459
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288)
460
 * for details.
461
 */
462
463
/**
464
 * G_GNUC_STRFTIME:
465
 * @format_idx: the index of the argument corresponding to
466
 *     the format string (the arguments are numbered from 1)
467
 *
468
 * Expands to the GNU C `strftime` format function attribute if the compiler
469
 * is gcc. This is used for declaring functions which take a format argument
470
 * which is passed to `strftime()` or an API implementing its formats. It allows
471
 * the compiler check the format passed to the function.
472
 *
473
 * |[<!-- language="C" -->
474
 * gsize my_strftime (MyBuffer *buffer,
475
 *                    const char *format,
476
 *                    const struct tm *tm) G_GNUC_STRFTIME (2);
477
 * ]|
478
 *
479
 * See the
480
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288)
481
 * for details.
482
 *
483
 * Since: 2.60
484
 */
485
486
/**
487
 * G_GNUC_FORMAT:
488
 * @arg_idx: the index of the argument
489
 *
490
 * Expands to the GNU C `format_arg` function attribute if the compiler
491
 * is gcc. This function attribute specifies that a function takes a
492
 * format string for a `printf()`, `scanf()`, `strftime()` or `strfmon()` style
493
 * function and modifies it, so that the result can be passed to a `printf()`,
494
 * `scanf()`, `strftime()` or `strfmon()` style function (with the remaining
495
 * arguments to the format function the same as they would have been
496
 * for the unmodified string).
497
 *
498
 * Place the attribute after the function declaration, just before the
499
 * semicolon.
500
 *
501
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-nonliteral-1) for more details.
502
 *
503
 * |[<!-- language="C" -->
504
 * gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2);
505
 * ]|
506
 */
507
508
/**
509
 * G_GNUC_NORETURN:
510
 *
511
 * Expands to the GNU C `noreturn` function attribute if the compiler is gcc.
512
 * It is used for declaring functions which never return. It enables
513
 * optimization of the function, and avoids possible compiler warnings.
514
 *
515
 * Since 2.68, it is recommended that code uses %G_NORETURN instead of
516
 * %G_GNUC_NORETURN, as that works on more platforms and compilers (in
517
 * particular, MSVC and C++11) than %G_GNUC_NORETURN, which works with GCC and
518
 * Clang only. %G_GNUC_NORETURN continues to work, so has not been deprecated
519
 * yet.
520
 *
521
 * Place the attribute after the declaration, just before the semicolon.
522
 *
523
 * |[<!-- language="C" -->
524
 * void g_abort (void) G_GNUC_NORETURN;
525
 * ]|
526
 *
527
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-noreturn-function-attribute) for more details.
528
 */
529
530
/**
531
 * G_GNUC_CONST:
532
 *
533
 * Expands to the GNU C `const` function attribute if the compiler is gcc.
534
 * Declaring a function as `const` enables better optimization of calls to
535
 * the function. A `const` function doesn't examine any values except its
536
 * parameters, and has no effects except its return value.
537
 *
538
 * Place the attribute after the declaration, just before the semicolon.
539
 *
540
 * |[<!-- language="C" -->
541
 * gchar g_ascii_tolower (gchar c) G_GNUC_CONST;
542
 * ]|
543
 *
544
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-const-function-attribute) for more details.
545
 *
546
 * A function that has pointer arguments and examines the data pointed to
547
 * must not be declared `const`. Likewise, a function that calls a non-`const`
548
 * function usually must not be `const`. It doesn't make sense for a `const`
549
 * function to return `void`.
550
 */
551
552
/**
553
 * G_GNUC_UNUSED:
554
 *
555
 * Expands to the GNU C `unused` function attribute if the compiler is gcc.
556
 * It is used for declaring functions and arguments which may never be used.
557
 * It avoids possible compiler warnings.
558
 *
559
 * For functions, place the attribute after the declaration, just before the
560
 * semicolon. For arguments, place the attribute at the beginning of the
561
 * argument declaration.
562
 *
563
 * |[<!-- language="C" -->
564
 * void my_unused_function (G_GNUC_UNUSED gint unused_argument,
565
 *                          gint other_argument) G_GNUC_UNUSED;
566
 * ]|
567
 *
568
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-unused-function-attribute) for more details.
569
 */
570
571
/**
572
 * G_GNUC_NO_INSTRUMENT:
573
 *
574
 * Expands to the GNU C `no_instrument_function` function attribute if the
575
 * compiler is gcc. Functions with this attribute will not be instrumented
576
 * for profiling, when the compiler is called with the
577
 * `-finstrument-functions` option.
578
 *
579
 * Place the attribute after the declaration, just before the semicolon.
580
 *
581
 * |[<!-- language="C" -->
582
 * int do_uninteresting_things (void) G_GNUC_NO_INSTRUMENT;
583
 * ]|
584
 *
585
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-no_005finstrument_005ffunction-function-attribute) for more details.
586
 */
587
588
#if g_macro__has_attribute(__format__)
589
590
#if !defined (__clang__) && G_GNUC_CHECK_VERSION (4, 4)
591
#define G_GNUC_PRINTF( format_idx, arg_idx )    \
592
  __attribute__((__format__ (gnu_printf, format_idx, arg_idx)))
593
#define G_GNUC_SCANF( format_idx, arg_idx )     \
594
  __attribute__((__format__ (gnu_scanf, format_idx, arg_idx)))
595
#define G_GNUC_STRFTIME( format_idx )    \
596
  __attribute__((__format__ (gnu_strftime, format_idx, 0))) \
597
  GLIB_AVAILABLE_MACRO_IN_2_60
598
#else
599
#define G_GNUC_PRINTF( format_idx, arg_idx )    \
600
  __attribute__((__format__ (__printf__, format_idx, arg_idx)))
601
#define G_GNUC_SCANF( format_idx, arg_idx )     \
602
  __attribute__((__format__ (__scanf__, format_idx, arg_idx)))
603
#define G_GNUC_STRFTIME( format_idx )    \
604
  __attribute__((__format__ (__strftime__, format_idx, 0))) \
605
  GLIB_AVAILABLE_MACRO_IN_2_60
606
#endif
607
608
#else
609
610
#define G_GNUC_PRINTF( format_idx, arg_idx )
611
#define G_GNUC_SCANF( format_idx, arg_idx )
612
#define G_GNUC_STRFTIME( format_idx ) \
613
  GLIB_AVAILABLE_MACRO_IN_2_60
614
615
#endif
616
617
#if g_macro__has_attribute(__format_arg__)
618
#define G_GNUC_FORMAT(arg_idx) \
619
  __attribute__ ((__format_arg__ (arg_idx)))
620
#else
621
#define G_GNUC_FORMAT( arg_idx )
622
#endif
623
624
#if g_macro__has_attribute(__noreturn__)
625
#define G_GNUC_NORETURN \
626
  __attribute__ ((__noreturn__))
627
#else
628
/* NOTE: MSVC has __declspec(noreturn) but unlike GCC __attribute__,
629
 * __declspec can only be placed at the start of the function prototype
630
 * and not at the end, so we can't use it without breaking API.
631
 */
632
#define G_GNUC_NORETURN
633
#endif
634
635
#if g_macro__has_attribute(__const__)
636
#define G_GNUC_CONST \
637
  __attribute__ ((__const__))
638
#else
639
#define G_GNUC_CONST
640
#endif
641
642
#if g_macro__has_attribute(__unused__)
643
#define G_GNUC_UNUSED \
644
  __attribute__ ((__unused__))
645
#else
646
#define G_GNUC_UNUSED
647
#endif
648
649
#if g_macro__has_attribute(__no_instrument_function__)
650
#define G_GNUC_NO_INSTRUMENT \
651
  __attribute__ ((__no_instrument_function__))
652
#else
653
#define G_GNUC_NO_INSTRUMENT
654
#endif
655
656
/**
657
 * G_GNUC_FALLTHROUGH:
658
 *
659
 * Expands to the GNU C `fallthrough` statement attribute if the compiler supports it.
660
 * This allows declaring case statement to explicitly fall through in switch
661
 * statements. To enable this feature, use `-Wimplicit-fallthrough` during
662
 * compilation.
663
 *
664
 * Put the attribute right before the case statement you want to fall through
665
 * to.
666
 *
667
 * |[<!-- language="C" -->
668
 * switch (foo)
669
 *   {
670
 *     case 1:
671
 *       g_message ("it's 1");
672
 *       G_GNUC_FALLTHROUGH;
673
 *     case 2:
674
 *       g_message ("it's either 1 or 2");
675
 *       break;
676
 *   }
677
 * ]|
678
 *
679
 *
680
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Statement-Attributes.html#index-fallthrough-statement-attribute) for more details.
681
 *
682
 * Since: 2.60
683
 */
684
#if g_macro__has_attribute(fallthrough)
685
#define G_GNUC_FALLTHROUGH __attribute__((fallthrough)) \
686
  GLIB_AVAILABLE_MACRO_IN_2_60
687
#else
688
#define G_GNUC_FALLTHROUGH \
689
  GLIB_AVAILABLE_MACRO_IN_2_60
690
#endif
691
692
/**
693
 * G_GNUC_DEPRECATED:
694
 *
695
 * Expands to the GNU C `deprecated` attribute if the compiler is gcc.
696
 * It can be used to mark `typedef`s, variables and functions as deprecated.
697
 * When called with the `-Wdeprecated-declarations` option,
698
 * gcc will generate warnings when deprecated interfaces are used.
699
 *
700
 * Place the attribute after the declaration, just before the semicolon.
701
 *
702
 * |[<!-- language="C" -->
703
 * int my_mistake (void) G_GNUC_DEPRECATED;
704
 * ]|
705
 *
706
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-deprecated-function-attribute) for more details.
707
 *
708
 * Since: 2.2
709
 */
710
#if g_macro__has_attribute(__deprecated__)
711
#define G_GNUC_DEPRECATED __attribute__((__deprecated__))
712
#else
713
#define G_GNUC_DEPRECATED
714
#endif /* __GNUC__ */
715
716
/**
717
 * G_GNUC_DEPRECATED_FOR:
718
 * @f: the intended replacement for the deprecated symbol,
719
 *     such as the name of a function
720
 *
721
 * Like %G_GNUC_DEPRECATED, but names the intended replacement for the
722
 * deprecated symbol if the version of gcc in use is new enough to support
723
 * custom deprecation messages.
724
 *
725
 * Place the attribute after the declaration, just before the semicolon.
726
 *
727
 * |[<!-- language="C" -->
728
 * int my_mistake (void) G_GNUC_DEPRECATED_FOR(my_replacement);
729
 * ]|
730
 *
731
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-deprecated-function-attribute) for more details.
732
 *
733
 * Note that if @f is a macro, it will be expanded in the warning message.
734
 * You can enclose it in quotes to prevent this. (The quotes will show up
735
 * in the warning, but it's better than showing the macro expansion.)
736
 *
737
 * Since: 2.26
738
 */
739
#if G_GNUC_CHECK_VERSION(4, 5) || defined(__clang__)
740
#define G_GNUC_DEPRECATED_FOR(f)                        \
741
  __attribute__((deprecated("Use " #f " instead")))     \
742
  GLIB_AVAILABLE_MACRO_IN_2_26
743
#else
744
#define G_GNUC_DEPRECATED_FOR(f)      G_GNUC_DEPRECATED \
745
  GLIB_AVAILABLE_MACRO_IN_2_26
746
#endif /* __GNUC__ */
747
748
#ifdef __ICC
749
#define G_GNUC_BEGIN_IGNORE_DEPRECATIONS                \
750
  _Pragma ("warning (push)")                            \
751
  _Pragma ("warning (disable:1478)")
752
#define G_GNUC_END_IGNORE_DEPRECATIONS      \
753
  _Pragma ("warning (pop)")
754
#elif G_GNUC_CHECK_VERSION(4, 6)
755
#define G_GNUC_BEGIN_IGNORE_DEPRECATIONS    \
756
  _Pragma ("GCC diagnostic push")     \
757
  _Pragma ("GCC diagnostic ignored \"-Wdeprecated-declarations\"")
758
#define G_GNUC_END_IGNORE_DEPRECATIONS      \
759
  _Pragma ("GCC diagnostic pop")
760
#elif defined (_MSC_VER) && (_MSC_VER >= 1500) && !defined (__clang__)
761
#define G_GNUC_BEGIN_IGNORE_DEPRECATIONS    \
762
  __pragma (warning (push))  \
763
  __pragma (warning (disable : 4996))
764
#define G_GNUC_END_IGNORE_DEPRECATIONS      \
765
  __pragma (warning (pop))
766
#elif defined (__clang__)
767
#define G_GNUC_BEGIN_IGNORE_DEPRECATIONS \
768
  _Pragma("clang diagnostic push") \
769
  _Pragma("clang diagnostic ignored \"-Wdeprecated-declarations\"")
770
#define G_GNUC_END_IGNORE_DEPRECATIONS \
771
  _Pragma("clang diagnostic pop")
772
#else
773
#define G_GNUC_BEGIN_IGNORE_DEPRECATIONS
774
#define G_GNUC_END_IGNORE_DEPRECATIONS
775
#define GLIB_CANNOT_IGNORE_DEPRECATIONS
776
#endif
777
778
/**
779
 * G_GNUC_MAY_ALIAS:
780
 *
781
 * Expands to the GNU C `may_alias` type attribute if the compiler is gcc.
782
 * Types with this attribute will not be subjected to type-based alias
783
 * analysis, but are assumed to alias with any other type, just like `char`.
784
 *
785
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Type-Attributes.html#index-may_005falias-type-attribute) for details.
786
 *
787
 * Since: 2.14
788
 */
789
#if g_macro__has_attribute(may_alias)
790
#define G_GNUC_MAY_ALIAS __attribute__((may_alias))
791
#else
792
#define G_GNUC_MAY_ALIAS
793
#endif
794
795
/**
796
 * G_GNUC_WARN_UNUSED_RESULT:
797
 *
798
 * Expands to the GNU C `warn_unused_result` function attribute if the compiler
799
 * is gcc. This function attribute makes the compiler emit a warning if the
800
 * result of a function call is ignored.
801
 *
802
 * Place the attribute after the declaration, just before the semicolon.
803
 *
804
 * |[<!-- language="C" -->
805
 * GList *g_list_append (GList *list,
806
 *                       gpointer data) G_GNUC_WARN_UNUSED_RESULT;
807
 * ]|
808
 *
809
 * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-warn_005funused_005fresult-function-attribute) for more details.
810
 *
811
 * Since: 2.10
812
 */
813
#if g_macro__has_attribute(warn_unused_result)
814
#define G_GNUC_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
815
#else
816
#define G_GNUC_WARN_UNUSED_RESULT
817
#endif /* __GNUC__ */
818
819
/**
820
 * G_GNUC_FUNCTION:
821
 *
822
 * Expands to "" on all modern compilers, and to  __FUNCTION__ on gcc
823
 * version 2.x. Don't use it.
824
 *
825
 * Deprecated: 2.16: Use G_STRFUNC() instead
826
 */
827
828
/**
829
 * G_GNUC_PRETTY_FUNCTION:
830
 *
831
 * Expands to "" on all modern compilers, and to __PRETTY_FUNCTION__
832
 * on gcc version 2.x. Don't use it.
833
 *
834
 * Deprecated: 2.16: Use G_STRFUNC() instead
835
 */
836
837
/* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with
838
 * macros, so we can refer to them as strings unconditionally.
839
 * usage not-recommended since gcc-3.0
840
 *
841
 * Mark them as deprecated since 2.26, since that’s when version macros were
842
 * introduced.
843
 */
844
#if defined (__GNUC__) && (__GNUC__ < 3)
845
#define G_GNUC_FUNCTION         __FUNCTION__ GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC)
846
#define G_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__ GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC)
847
#else   /* !__GNUC__ */
848
#define G_GNUC_FUNCTION         "" GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC)
849
#define G_GNUC_PRETTY_FUNCTION  "" GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC)
850
#endif  /* !__GNUC__ */
851
852
#if g_macro__has_feature(attribute_analyzer_noreturn) && defined(__clang_analyzer__)
853
#define G_ANALYZER_ANALYZING 1
854
#define G_ANALYZER_NORETURN __attribute__((analyzer_noreturn))
855
#elif defined(__COVERITY__)
856
#define G_ANALYZER_ANALYZING 1
857
#define G_ANALYZER_NORETURN __attribute__((noreturn))
858
#else
859
#define G_ANALYZER_ANALYZING 0
860
#define G_ANALYZER_NORETURN
861
#endif
862
863
#define G_STRINGIFY(macro_or_string)  G_STRINGIFY_ARG (macro_or_string)
864
#define G_STRINGIFY_ARG(contents) #contents
865
866
#define G_PASTE_ARGS(identifier1,identifier2) identifier1 ## identifier2
867
#define G_PASTE(identifier1,identifier2)      G_PASTE_ARGS (identifier1, identifier2)
868
869
#ifndef __GI_SCANNER__ /* The static assert macro really confuses the introspection parser */
870
#if G_CXX_STD_CHECK_VERSION (11)
871
#define G_STATIC_ASSERT(expr) static_assert (expr, "Expression evaluates to false")
872
#elif (G_C_STD_CHECK_VERSION (11) || \
873
     g_macro__has_feature(c_static_assert) || g_macro__has_extension(c_static_assert))
874
#define G_STATIC_ASSERT(expr) _Static_assert (expr, "Expression evaluates to false")
875
#else
876
#ifdef __COUNTER__
877
#define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __COUNTER__)[(expr) ? 1 : -1] G_GNUC_UNUSED
878
#else
879
#define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __LINE__)[(expr) ? 1 : -1] G_GNUC_UNUSED
880
#endif
881
#endif /* G_CXX_STD_CHECK_VERSION (11) */
882
#define G_STATIC_ASSERT_EXPR(expr) ((void) sizeof (char[(expr) ? 1 : -1]))
883
#else /* __GI_SCANNER__ */
884
#define G_STATIC_ASSERT(expr) static int G_PASTE (_GStaticAssertGiScannerNoop, __LINE__) G_GNUC_UNUSED
885
#define G_STATIC_ASSERT_EXPR(expr) static int G_PASTE (_GStaticAssertGiScannerNoop, __LINE__) G_GNUC_UNUSED
886
#endif /* __GI_SCANNER__ */
887
888
/* Provide a string identifying the current code position */
889
#if defined (__GNUC__) && (__GNUC__ < 3) && !defined (G_CXX_STD_VERSION)
890
#define G_STRLOC  __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()"
891
#else
892
#define G_STRLOC  __FILE__ ":" G_STRINGIFY (__LINE__)
893
#endif
894
895
/* Provide a string identifying the current function, non-concatenatable */
896
#if defined (__GNUC__) && defined (G_CXX_STD_VERSION)
897
#define G_STRFUNC     ((const char*) (__PRETTY_FUNCTION__))
898
#elif G_C_STD_CHECK_VERSION (99)
899
#define G_STRFUNC     ((const char*) (__func__))
900
#elif defined (__GNUC__) || (defined(_MSC_VER) && (_MSC_VER > 1300))
901
#define G_STRFUNC     ((const char*) (__FUNCTION__))
902
#else
903
#define G_STRFUNC     ((const char*) ("???"))
904
#endif
905
906
/* Guard C code in headers, while including them from C++ */
907
#ifdef  G_CXX_STD_VERSION
908
#define G_BEGIN_DECLS  extern "C" {
909
#define G_END_DECLS    }
910
#else
911
#define G_BEGIN_DECLS
912
#define G_END_DECLS
913
#endif
914
915
/* Provide definitions for some commonly used macros.
916
 *  Some of them are only provided if they haven't already
917
 *  been defined. It is assumed that if they are already
918
 *  defined then the current definition is correct.
919
 */
920
#ifndef NULL
921
#  if G_CXX_STD_CHECK_VERSION (11)
922
#    define NULL (nullptr)
923
#  elif defined (G_CXX_STD_VERSION)
924
#    define NULL (0L)
925
#  else
926
#    define NULL ((void*) 0)
927
#  endif /* G_CXX_STD_CHECK_VERSION (11) */
928
#endif
929
930
#ifndef FALSE
931
149
#define FALSE (0)
932
#endif
933
934
#ifndef TRUE
935
#define TRUE  (!FALSE)
936
#endif
937
938
#undef  MAX
939
#define MAX(a, b)  (((a) > (b)) ? (a) : (b))
940
941
#undef  MIN
942
#define MIN(a, b)  (((a) < (b)) ? (a) : (b))
943
944
#undef  ABS
945
#define ABS(a)     (((a) < 0) ? -(a) : (a))
946
947
#undef  CLAMP
948
#define CLAMP(x, low, high)  (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
949
950
#define G_APPROX_VALUE(a, b, epsilon) \
951
  (((a) > (b) ? (a) - (b) : (b) - (a)) < (epsilon))
952
953
/* Count the number of elements in an array. The array must be defined
954
 * as such; using this with a dynamically allocated array will give
955
 * incorrect results.
956
 */
957
#define G_N_ELEMENTS(arr)   (sizeof (arr) / sizeof ((arr)[0]))
958
959
/* Macros by analogy to GINT_TO_POINTER, GPOINTER_TO_INT
960
 */
961
#define GPOINTER_TO_SIZE(p) ((gsize) (p))
962
#define GSIZE_TO_POINTER(s) ((gpointer) (guintptr) (gsize) (s))
963
964
/* Provide convenience macros for handling structure
965
 * fields through their offsets.
966
 */
967
968
#if G_GNUC_CHECK_VERSION(4, 0) || defined(_MSC_VER)
969
#define G_STRUCT_OFFSET(struct_type, member) \
970
      ((glong) offsetof (struct_type, member))
971
#else
972
#define G_STRUCT_OFFSET(struct_type, member)  \
973
      ((glong) ((guint8*) &((struct_type*) 0)->member))
974
#endif
975
976
#define G_STRUCT_MEMBER_P(struct_p, struct_offset)   \
977
    ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset)))
978
#define G_STRUCT_MEMBER(member_type, struct_p, struct_offset)   \
979
    (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset)))
980
981
/* Provide simple macro statement wrappers:
982
 *   G_STMT_START { statements; } G_STMT_END;
983
 * This can be used as a single statement, like:
984
 *   if (x) G_STMT_START { ... } G_STMT_END; else ...
985
 * This intentionally does not use compiler extensions like GCC's '({...})' to
986
 * avoid portability issue or side effects when compiled with different compilers.
987
 * MSVC complains about "while(0)": C4127: "Conditional expression is constant",
988
 * so we use __pragma to avoid the warning since the use here is intentional.
989
 */
990
#if !(defined (G_STMT_START) && defined (G_STMT_END))
991
#define G_STMT_START  do
992
#if defined (_MSC_VER) && (_MSC_VER >= 1500)
993
#define G_STMT_END \
994
    __pragma(warning(push)) \
995
    __pragma(warning(disable:4127)) \
996
    while(0) \
997
    __pragma(warning(pop))
998
#else
999
#define G_STMT_END    while (0)
1000
#endif
1001
#endif
1002
1003
/* Provide G_ALIGNOF alignment macro.
1004
 *
1005
 * Note we cannot use the gcc __alignof__ operator here, as that returns the
1006
 * preferred alignment rather than the minimal alignment. See
1007
 * https://gitlab.gnome.org/GNOME/glib/merge_requests/538/diffs#note_390790.
1008
 */
1009
1010
/**
1011
 * G_ALIGNOF
1012
 * @type: a type-name
1013
 *
1014
 * Return the minimal alignment required by the platform ABI for values of the given
1015
 * type. The address of a variable or struct member of the given type must always be
1016
 * a multiple of this alignment. For example, most platforms require int variables
1017
 * to be aligned at a 4-byte boundary, so `G_ALIGNOF (int)` is 4 on most platforms.
1018
 *
1019
 * Note this is not necessarily the same as the value returned by GCC’s
1020
 * `__alignof__` operator, which returns the preferred alignment for a type.
1021
 * The preferred alignment may be a stricter alignment than the minimal
1022
 * alignment.
1023
 *
1024
 * Since: 2.60
1025
 */
1026
#if G_C_STD_CHECK_VERSION (11)
1027
#define G_ALIGNOF(type) _Alignof (type) \
1028
  GLIB_AVAILABLE_MACRO_IN_2_60
1029
#else
1030
#define G_ALIGNOF(type) (G_STRUCT_OFFSET (struct { char a; type b; }, b)) \
1031
  GLIB_AVAILABLE_MACRO_IN_2_60
1032
#endif
1033
1034
/**
1035
 * G_CONST_RETURN:
1036
 *
1037
 * If %G_DISABLE_CONST_RETURNS is defined, this macro expands
1038
 * to nothing. By default, the macro expands to const. The macro
1039
 * can be used in place of const for functions that return a value
1040
 * that should not be modified. The purpose of this macro is to allow
1041
 * us to turn on const for returned constant strings by default, while
1042
 * allowing programmers who find that annoying to turn it off. This macro
1043
 * should only be used for return values and for "out" parameters, it
1044
 * doesn't make sense for "in" parameters.
1045
 *
1046
 * Deprecated: 2.30: API providers should replace all existing uses with
1047
 * const and API consumers should adjust their code accordingly
1048
 */
1049
#ifdef G_DISABLE_CONST_RETURNS
1050
#define G_CONST_RETURN GLIB_DEPRECATED_MACRO_IN_2_30_FOR(const)
1051
#else
1052
#define G_CONST_RETURN const GLIB_DEPRECATED_MACRO_IN_2_30_FOR(const)
1053
#endif
1054
1055
/**
1056
 * G_NORETURN:
1057
 *
1058
 * Expands to the GNU C or MSVC `noreturn` function attribute depending on
1059
 * the compiler. It is used for declaring functions which never return.
1060
 * Enables optimization of the function, and avoids possible compiler warnings.
1061
 *
1062
 * Note that %G_NORETURN supersedes the previous %G_GNUC_NORETURN macro, which
1063
 * will eventually be deprecated. %G_NORETURN supports more platforms.
1064
 *
1065
 * Place the attribute before the function declaration as follows:
1066
 *
1067
 * |[<!-- language="C" -->
1068
 * G_NORETURN void g_abort (void);
1069
 * ]|
1070
 *
1071
 * Since: 2.68
1072
 */
1073
/* Note: We can’t annotate this with GLIB_AVAILABLE_MACRO_IN_2_68 because it’s
1074
 * used within the GLib headers in function declarations which are always
1075
 * evaluated when a header is included. This results in warnings in third party
1076
 * code which includes glib.h, even if the third party code doesn’t use the new
1077
 * macro itself. */
1078
#if G_CXX_STD_CHECK_VERSION (11)
1079
  /* Use ISO C++11 syntax when the compiler supports it.  */
1080
# define G_NORETURN [[noreturn]]
1081
#elif g_macro__has_attribute(__noreturn__)
1082
  /* For compatibility with G_NORETURN_FUNCPTR on clang, use
1083
     __attribute__((__noreturn__)), not _Noreturn.  */
1084
# define G_NORETURN __attribute__ ((__noreturn__))
1085
#elif defined (_MSC_VER) && (1200 <= _MSC_VER)
1086
  /* Use MSVC specific syntax.  */
1087
# define G_NORETURN __declspec (noreturn)
1088
  /* Use ISO C11 syntax when the compiler supports it.  */
1089
#elif G_C_STD_CHECK_VERSION (11)
1090
# define G_NORETURN _Noreturn
1091
#else
1092
# define G_NORETURN /* empty */
1093
#endif
1094
1095
/**
1096
 * G_NORETURN_FUNCPTR:
1097
 *
1098
 * Expands to the GNU C or MSVC `noreturn` function attribute depending on
1099
 * the compiler. It is used for declaring function pointers which never return.
1100
 * Enables optimization of the function, and avoids possible compiler warnings.
1101
 *
1102
 * Place the attribute before the function declaration as follows:
1103
 *
1104
 * |[<!-- language="C" -->
1105
 * G_NORETURN_FUNCPTR void (*funcptr) (void);
1106
 * ]|
1107
 *
1108
 * Note that if the function is not a function pointer, you can simply use
1109
 * the %G_NORETURN macro as follows:
1110
 *
1111
 * |[<!-- language="C" -->
1112
 * G_NORETURN void g_abort (void);
1113
 * ]|
1114
 *
1115
 * Since: 2.68
1116
 */
1117
#if g_macro__has_attribute(__noreturn__)
1118
# define G_NORETURN_FUNCPTR __attribute__ ((__noreturn__))      \
1119
  GLIB_AVAILABLE_MACRO_IN_2_68
1120
#else
1121
# define G_NORETURN_FUNCPTR /* empty */         \
1122
  GLIB_AVAILABLE_MACRO_IN_2_68
1123
#endif
1124
1125
/**
1126
 * G_ALWAYS_INLINE:
1127
 *
1128
 * Expands to the GNU C `always_inline` or MSVC `__forceinline` function
1129
 * attribute depending on the compiler. It is used for declaring functions
1130
 * as always inlined, ignoring the compiler optimization levels.
1131
 *
1132
 * The attribute may be placed before the declaration or definition,
1133
 * right before the `static` keyword.
1134
 *
1135
 * |[<!-- language="C" -->
1136
 * G_ALWAYS_INLINE
1137
 * static int
1138
 * do_inline_this (void)
1139
 * {
1140
 *   ...
1141
 * }
1142
 * ]|
1143
 *
1144
 * See the
1145
 * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-always_005finline-function-attribute)
1146
 * and the
1147
 * [MSVC documentation](https://docs.microsoft.com/en-us/visualstudio/misc/inline-inline-forceinline)
1148
 *
1149
 * Since: 2.74
1150
 */
1151
/* Note: We can’t annotate this with GLIB_AVAILABLE_MACRO_IN_2_74 because it’s
1152
 * used within the GLib headers in function declarations which are always
1153
 * evaluated when a header is included. This results in warnings in third party
1154
 * code which includes glib.h, even if the third party code doesn’t use the new
1155
 * macro itself. */
1156
#if g_macro__has_attribute(__always_inline__)
1157
# if G_CXX_STD_CHECK_VERSION (11)
1158
    /* Use ISO C++11 syntax when the compiler supports it. */
1159
#   define G_ALWAYS_INLINE [[gnu::always_inline]]
1160
# else
1161
#   define G_ALWAYS_INLINE __attribute__ ((__always_inline__))
1162
# endif
1163
#elif defined (_MSC_VER)
1164
  /* Use MSVC specific syntax.  */
1165
# if G_CXX_STD_CHECK_VERSION (20) && _MSC_VER >= 1927
1166
#  define G_ALWAYS_INLINE [[msvc::forceinline]]
1167
# else
1168
#  define G_ALWAYS_INLINE __forceinline
1169
# endif
1170
#else
1171
# define G_ALWAYS_INLINE /* empty */
1172
#endif
1173
1174
/**
1175
 * G_NO_INLINE:
1176
 *
1177
 * Expands to the GNU C or MSVC `noinline` function attribute
1178
 * depending on the compiler. It is used for declaring functions
1179
 * preventing from being considered for inlining.
1180
 *
1181
 * Note that %G_NO_INLINE supersedes the previous %G_GNUC_NO_INLINE
1182
 * macro, which will eventually be deprecated.
1183
 * %G_NO_INLINE supports more platforms.
1184
 *
1185
 * The attribute may be placed before the declaration or definition,
1186
 * right before the `static` keyword.
1187
 *
1188
 * |[<!-- language="C" -->
1189
 * G_NO_INLINE
1190
 * static int
1191
 * do_not_inline_this (void)
1192
 * {
1193
 *   ...
1194
 * }
1195
 * ]|
1196
 *
1197
 * Since: 2.74
1198
 */
1199
/* Note: We can’t annotate this with GLIB_AVAILABLE_MACRO_IN_2_74 because it’s
1200
 * used within the GLib headers in function declarations which are always
1201
 * evaluated when a header is included. This results in warnings in third party
1202
 * code which includes glib.h, even if the third party code doesn’t use the new
1203
 * macro itself. */
1204
#if g_macro__has_attribute(__noinline__)
1205
# if G_CXX_STD_CHECK_VERSION (11)
1206
    /* Use ISO C++11 syntax when the compiler supports it. */
1207
#   if defined (__GNUC__)
1208
#      define G_NO_INLINE [[gnu::noinline]]
1209
#   elif defined (_MSC_VER)
1210
#      if G_CXX_STD_CHECK_VERSION (20) && _MSC_VER >= 1927
1211
#        define G_NO_INLINE [[msvc::noinline]]
1212
#      else
1213
#        define G_NO_INLINE __declspec (noinline)
1214
#      endif
1215
#   endif
1216
# else
1217
#   define G_NO_INLINE __attribute__ ((__noinline__))
1218
# endif
1219
#elif defined (_MSC_VER) && (1200 <= _MSC_VER)
1220
  /* Use MSVC specific syntax.  */
1221
    /* Use ISO C++11 syntax when the compiler supports it. */
1222
# if G_CXX_STD_CHECK_VERSION (20) && _MSC_VER >= 1927
1223
#   define G_NO_INLINE [[msvc::noinline]]
1224
# else
1225
#   define G_NO_INLINE __declspec (noinline)
1226
# endif
1227
#else
1228
# define G_NO_INLINE /* empty */
1229
#endif
1230
1231
/*
1232
 * The G_LIKELY and G_UNLIKELY macros let the programmer give hints to 
1233
 * the compiler about the expected result of an expression. Some compilers
1234
 * can use this information for optimizations.
1235
 *
1236
 * The _G_BOOLEAN_EXPR macro is intended to trigger a gcc warning when
1237
 * putting assignments in g_return_if_fail ().  
1238
 */
1239
#if G_GNUC_CHECK_VERSION(2, 0) && defined(__OPTIMIZE__)
1240
#define _G_BOOLEAN_EXPR_IMPL(uniq, expr)        \
1241
 G_GNUC_EXTENSION ({                            \
1242
   int G_PASTE (_g_boolean_var_, uniq) = 0;     \
1243
   if (expr)                                    \
1244
      G_PASTE (_g_boolean_var_, uniq) = 1;      \
1245
   G_PASTE (_g_boolean_var_, uniq);             \
1246
})
1247
#define _G_BOOLEAN_EXPR(expr) _G_BOOLEAN_EXPR_IMPL (__COUNTER__, expr)
1248
#define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 1))
1249
#define G_UNLIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 0))
1250
#else
1251
#define G_LIKELY(expr) (expr)
1252
#define G_UNLIKELY(expr) (expr)
1253
#endif
1254
1255
#if __GNUC__ >= 4 && !defined(_WIN32) && !defined(__CYGWIN__)
1256
#define G_HAVE_GNUC_VISIBILITY 1
1257
#endif
1258
1259
/* GLIB_CANNOT_IGNORE_DEPRECATIONS is defined above for compilers that do not
1260
 * have a way to temporarily suppress deprecation warnings. In these cases,
1261
 * suppress the deprecated attribute altogether (otherwise a simple #include
1262
 * <glib.h> will emit a barrage of warnings).
1263
 */
1264
#if defined(GLIB_CANNOT_IGNORE_DEPRECATIONS)
1265
#define G_DEPRECATED
1266
#elif G_GNUC_CHECK_VERSION(3, 1) || defined(__clang__)
1267
#define G_DEPRECATED __attribute__((__deprecated__))
1268
#elif defined(_MSC_VER) && (_MSC_VER >= 1300)
1269
#define G_DEPRECATED __declspec(deprecated)
1270
#else
1271
#define G_DEPRECATED
1272
#endif
1273
1274
#if defined(GLIB_CANNOT_IGNORE_DEPRECATIONS)
1275
#define G_DEPRECATED_FOR(f) G_DEPRECATED
1276
#elif G_GNUC_CHECK_VERSION(4, 5) || defined(__clang__)
1277
#define G_DEPRECATED_FOR(f) __attribute__((__deprecated__("Use '" #f "' instead")))
1278
#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
1279
#define G_DEPRECATED_FOR(f) __declspec(deprecated("is deprecated. Use '" #f "' instead"))
1280
#else
1281
#define G_DEPRECATED_FOR(f) G_DEPRECATED
1282
#endif
1283
1284
#if G_GNUC_CHECK_VERSION(4, 5) || defined(__clang__)
1285
#define G_UNAVAILABLE(maj,min) __attribute__((deprecated("Not available before " #maj "." #min)))
1286
#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
1287
#define G_UNAVAILABLE(maj,min) __declspec(deprecated("is not available before " #maj "." #min))
1288
#else
1289
#define G_UNAVAILABLE(maj,min) G_DEPRECATED
1290
#endif
1291
1292
/* These macros are used to mark deprecated symbols in GLib headers,
1293
 * and thus have to be exposed in installed headers. But please
1294
 * do *not* use them in other projects. Instead, use G_DEPRECATED
1295
 * or define your own wrappers around it.
1296
 */
1297
1298
#if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \
1299
    (G_GNUC_CHECK_VERSION(4, 6) ||                 \
1300
     __clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 4))
1301
#define _GLIB_GNUC_DO_PRAGMA(x) _Pragma(G_STRINGIFY (x))
1302
#define GLIB_DEPRECATED_MACRO _GLIB_GNUC_DO_PRAGMA(GCC warning "Deprecated pre-processor symbol")
1303
#define GLIB_DEPRECATED_MACRO_FOR(f) \
1304
  _GLIB_GNUC_DO_PRAGMA(GCC warning G_STRINGIFY (Deprecated pre-processor symbol: replace with #f))
1305
#define GLIB_UNAVAILABLE_MACRO(maj,min) \
1306
  _GLIB_GNUC_DO_PRAGMA(GCC warning G_STRINGIFY (Not available before maj.min))
1307
#else
1308
#define GLIB_DEPRECATED_MACRO
1309
#define GLIB_DEPRECATED_MACRO_FOR(f)
1310
#define GLIB_UNAVAILABLE_MACRO(maj,min)
1311
#endif
1312
1313
#if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \
1314
    (G_GNUC_CHECK_VERSION(6, 1) ||                 \
1315
     (defined (__clang_major__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 0))))
1316
#define GLIB_DEPRECATED_ENUMERATOR G_DEPRECATED
1317
#define GLIB_DEPRECATED_ENUMERATOR_FOR(f) G_DEPRECATED_FOR(f)
1318
#define GLIB_UNAVAILABLE_ENUMERATOR(maj,min) G_UNAVAILABLE(maj,min)
1319
#else
1320
#define GLIB_DEPRECATED_ENUMERATOR
1321
#define GLIB_DEPRECATED_ENUMERATOR_FOR(f)
1322
#define GLIB_UNAVAILABLE_ENUMERATOR(maj,min)
1323
#endif
1324
1325
#if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \
1326
    (G_GNUC_CHECK_VERSION(3, 1) ||                 \
1327
     (defined (__clang_major__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 0))))
1328
#define GLIB_DEPRECATED_TYPE G_DEPRECATED
1329
#define GLIB_DEPRECATED_TYPE_FOR(f) G_DEPRECATED_FOR(f)
1330
#define GLIB_UNAVAILABLE_TYPE(maj,min) G_UNAVAILABLE(maj,min)
1331
#else
1332
#define GLIB_DEPRECATED_TYPE
1333
#define GLIB_DEPRECATED_TYPE_FOR(f)
1334
#define GLIB_UNAVAILABLE_TYPE(maj,min)
1335
#endif
1336
1337
#ifndef __GI_SCANNER__
1338
1339
#if g_macro__has_attribute(cleanup)
1340
1341
/* these macros are private; note that gstdio.h also uses _GLIB_CLEANUP */
1342
#define _GLIB_AUTOPTR_FUNC_NAME(TypeName) glib_autoptr_cleanup_##TypeName
1343
#define _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) glib_autoptr_clear_##TypeName
1344
#define _GLIB_AUTOPTR_DESTROY_FUNC_NAME(TypeName) glib_autoptr_destroy_##TypeName
1345
#define _GLIB_AUTOPTR_TYPENAME(TypeName)  TypeName##_autoptr
1346
#define _GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName) glib_listautoptr_cleanup_##TypeName
1347
#define _GLIB_AUTOPTR_LIST_TYPENAME(TypeName)  TypeName##_listautoptr
1348
#define _GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName) glib_slistautoptr_cleanup_##TypeName
1349
#define _GLIB_AUTOPTR_SLIST_TYPENAME(TypeName)  TypeName##_slistautoptr
1350
#define _GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName) glib_queueautoptr_cleanup_##TypeName
1351
#define _GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName)  TypeName##_queueautoptr
1352
#define _GLIB_AUTO_FUNC_NAME(TypeName)    glib_auto_cleanup_##TypeName
1353
#define _GLIB_CLEANUP(func)               __attribute__((cleanup(func)))
1354
#define _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(TypeName, ParentName, cleanup) \
1355
  typedef TypeName *_GLIB_AUTOPTR_TYPENAME(TypeName);                                                           \
1356
  typedef GList *_GLIB_AUTOPTR_LIST_TYPENAME(TypeName);                                                         \
1357
  typedef GSList *_GLIB_AUTOPTR_SLIST_TYPENAME(TypeName);                                                       \
1358
  typedef GQueue *_GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName);                                                       \
1359
  G_GNUC_BEGIN_IGNORE_DEPRECATIONS                                                                              \
1360
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) (TypeName *_ptr)                     \
1361
0
    { if (_ptr) (cleanup) ((ParentName *) _ptr); }                                                              \
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GBytes
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GDate
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GDir
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GError
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GHmac
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GSource
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GNode
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRand
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRegex
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GScanner
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GSequence
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GSList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GThread
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GTimer
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GTree
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GVariant
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GRefString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GUri
Unexecuted instantiation: sdp-xml.c:glib_autoptr_clear_GPathBuf
1362
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_FUNC_NAME(TypeName) (TypeName **_ptr)                          \
1363
0
    { _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) (*_ptr); }                                                        \
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GBytes
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GDate
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GDir
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GError
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GHmac
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GSource
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GNode
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRand
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRegex
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GScanner
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GSequence
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GSList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GThread
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GTimer
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GTree
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GVariant
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GRefString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GUri
Unexecuted instantiation: sdp-xml.c:glib_autoptr_cleanup_GPathBuf
1364
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_DESTROY_FUNC_NAME(TypeName) (void *_ptr)                       \
1365
0
    { (cleanup) ((ParentName *) _ptr); }                                                                        \
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GBytes
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GDate
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GDir
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GError
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GHmac
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GSource
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GNode
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GQueue
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRand
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRegex
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GScanner
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GSequence
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GSList
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GThread
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GTimer
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GTree
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GVariant
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GRefString
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GUri
Unexecuted instantiation: sdp-xml.c:glib_autoptr_destroy_GPathBuf
1366
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName) (GList **_l)                          \
1367
0
    { g_list_free_full (*_l, _GLIB_AUTOPTR_DESTROY_FUNC_NAME(TypeName)); }                                      \
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GBytes
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GDate
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GDir
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GError
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GHmac
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GList
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GArray
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GSource
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GNode
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GQueue
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRand
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRegex
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GScanner
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GSequence
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GSList
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GString
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GThread
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GTimer
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GTree
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GVariant
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GRefString
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GUri
Unexecuted instantiation: sdp-xml.c:glib_listautoptr_cleanup_GPathBuf
1368
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName) (GSList **_l)                        \
1369
0
    { g_slist_free_full (*_l, _GLIB_AUTOPTR_DESTROY_FUNC_NAME(TypeName)); }                                     \
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GBytes
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GDate
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GDir
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GError
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GHmac
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GList
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GArray
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GSource
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GNode
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GQueue
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRand
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRegex
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GScanner
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GSequence
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GSList
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GString
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GThread
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GTimer
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GTree
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GVariant
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GRefString
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GUri
Unexecuted instantiation: sdp-xml.c:glib_slistautoptr_cleanup_GPathBuf
1370
  static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName) (GQueue **_q)                        \
1371
0
    { if (*_q) g_queue_free_full (*_q, _GLIB_AUTOPTR_DESTROY_FUNC_NAME(TypeName)); }                            \
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GAsyncQueue
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GBookmarkFile
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GBytes
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GChecksum
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GDateTime
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GDate
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GDir
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GError
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GHashTable
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GHmac
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GIOChannel
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GKeyFile
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GList
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GArray
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GPtrArray
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GByteArray
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMainContext
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMainContextPusher
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMainLoop
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GSource
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMappedFile
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMarkupParseContext
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GNode
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GOptionContext
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GOptionGroup
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GPatternSpec
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GQueue
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRand
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRegex
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMatchInfo
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GScanner
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GSequence
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GSList
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GString
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GStringChunk
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GStrvBuilder
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GThread
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRecMutexLocker
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRWLockWriterLocker
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRWLockReaderLocker
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GTimer
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GTimeZone
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GTree
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GVariant
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GVariantIter
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GVariantType
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GRefString
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GUri
Unexecuted instantiation: sdp-xml.c:glib_queueautoptr_cleanup_GPathBuf
1372
  G_GNUC_END_IGNORE_DEPRECATIONS
1373
#define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName) \
1374
  _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(ModuleObjName, ParentName, _GLIB_AUTOPTR_CLEAR_FUNC_NAME(ParentName))
1375
1376
1377
/* these macros are API */
1378
#define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func) \
1379
  _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(TypeName, TypeName, func)
1380
#define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func) \
1381
  G_GNUC_BEGIN_IGNORE_DEPRECATIONS                                                                              \
1382
0
  static G_GNUC_UNUSED inline void _GLIB_AUTO_FUNC_NAME(TypeName) (TypeName *_ptr) { (func) (_ptr); }                         \
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GQueue
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GMutex
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GCond
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GVariantBuilder
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GVariantDict
Unexecuted instantiation: sdp-xml.c:glib_auto_cleanup_GPathBuf
1383
  G_GNUC_END_IGNORE_DEPRECATIONS
1384
#define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none) \
1385
  G_GNUC_BEGIN_IGNORE_DEPRECATIONS                                                                              \
1386
0
  static G_GNUC_UNUSED inline void _GLIB_AUTO_FUNC_NAME(TypeName) (TypeName *_ptr) { if (*_ptr != none) (func) (*_ptr); }     \
1387
  G_GNUC_END_IGNORE_DEPRECATIONS
1388
#define g_autoptr(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_TYPENAME(TypeName)
1389
#define g_autolist(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_LIST_TYPENAME(TypeName)
1390
#define g_autoslist(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_SLIST_TYPENAME(TypeName)
1391
#define g_autoqueue(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName)
1392
#define g_auto(TypeName) _GLIB_CLEANUP(_GLIB_AUTO_FUNC_NAME(TypeName)) TypeName
1393
#define g_autofree _GLIB_CLEANUP(g_autoptr_cleanup_generic_gfree)
1394
1395
#else /* not GNU C */
1396
/* this (dummy) macro is private */
1397
#define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName)
1398
1399
/* these (dummy) macros are API */
1400
#define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func)
1401
#define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func)
1402
#define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none)
1403
1404
/* no declaration of g_auto() or g_autoptr() here */
1405
#endif /* __GNUC__ */
1406
1407
#else
1408
1409
#define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName)
1410
1411
#define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func)
1412
#define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func)
1413
#define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none)
1414
1415
#endif /* __GI_SCANNER__ */
1416
1417
/**
1418
 * G_SIZEOF_MEMBER:
1419
 * @struct_type: a structure type, e.g. #GOutputVector
1420
 * @member: a field in the structure, e.g. `size`
1421
 *
1422
 * Returns the size of @member in the struct definition without having a
1423
 * declared instance of @struct_type.
1424
 *
1425
 * Returns: the size of @member in bytes.
1426
 *
1427
 * Since: 2.64
1428
 */
1429
#define G_SIZEOF_MEMBER(struct_type, member) \
1430
    GLIB_AVAILABLE_MACRO_IN_2_64 \
1431
    sizeof (((struct_type *) 0)->member)
1432
1433
#endif /* __G_MACROS_H__ */