mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2026-10-24 00:49:00 +03:00
016829559e
g_type_ensure has a large comment saying _get_type shouldn't be marked with G_GNUC_CONST because it has side-effects on the first run, but it's OK if you consistently call g_type_ensure first. Unfortunately, this isn't accurate. GCC trunk (observed at r17-1725-ge259a182e1f100) now analyses points-to information more effectively and propagates its findings, so it sees the function modifies some global state, concludes that can't be possible (because of the const attribute), and deletes the stores. pure unfortunately is unsuitable for *_get_type too as it has a side-effect (writes to global memory). Mesa had a similar issue which I fixed recently [0]. glib and glibmm likely want the (not-yet-implemented) 'idempotent' attribute instead [1]. In fact, this exact problem is what motivated that request! :) ebassi mentions an alternative to the current setup as well, using atomics [2]. This problem has gone back many years but the compiler has finally fully outsmarted us here, so give in. [0] https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/42361 [1] https://gcc.gnu.org/PR32911 [2] https://gitlab.gnome.org/GNOME/glib/-/merge_requests/4249#note_2583110 Fixes: https://gitlab.gnome.org/GNOME/glib/-/work_items/3984 Signed-off-by: Sam James <sam@gentoo.org>
454 lines
9.9 KiB
C
454 lines
9.9 KiB
C
/* GObject - GLib Type, Object, Parameter and Signal Library
|
|
* Copyright (C) 2000-2001 Red Hat, Inc.
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1-or-later
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#ifndef __GLIB_TYPES_H__
|
|
#define __GLIB_TYPES_H__
|
|
|
|
#if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) && !defined(GLIB_COMPILATION)
|
|
#error "Only <glib-object.h> can be included directly."
|
|
#endif
|
|
|
|
#include <glib.h>
|
|
#include <gobject/gobject-visibility.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* A hack necessary to preprocess this file with g-ir-scanner */
|
|
#ifdef __GI_SCANNER__
|
|
typedef gsize GType;
|
|
#endif
|
|
|
|
/* --- GLib boxed types --- */
|
|
/**
|
|
* G_TYPE_DATE:
|
|
*
|
|
* The #GType for #GDate.
|
|
*/
|
|
#define G_TYPE_DATE (g_date_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_STRV:
|
|
*
|
|
* The #GType for a boxed type holding a %NULL-terminated array of strings.
|
|
*
|
|
* The code fragments in the following example show the use of a property of
|
|
* type %G_TYPE_STRV with g_object_class_install_property(), g_object_set()
|
|
* and g_object_get().
|
|
*
|
|
* |[
|
|
* g_object_class_install_property (object_class,
|
|
* PROP_AUTHORS,
|
|
* g_param_spec_boxed ("authors",
|
|
* _("Authors"),
|
|
* _("List of authors"),
|
|
* G_TYPE_STRV,
|
|
* G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
|
|
*
|
|
* gchar *authors[] = { "Owen", "Tim", NULL };
|
|
* g_object_set (obj, "authors", authors, NULL);
|
|
*
|
|
* gchar *writers[];
|
|
* g_object_get (obj, "authors", &writers, NULL);
|
|
* /* do something with writers */
|
|
* g_strfreev (writers);
|
|
* ]|
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
#define G_TYPE_STRV (g_strv_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_GSTRING:
|
|
*
|
|
* The #GType for #GString.
|
|
*/
|
|
#define G_TYPE_GSTRING (g_gstring_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_HASH_TABLE:
|
|
*
|
|
* The #GType for a boxed type holding a #GHashTable reference.
|
|
*
|
|
* Since: 2.10
|
|
*/
|
|
#define G_TYPE_HASH_TABLE (g_hash_table_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_REGEX:
|
|
*
|
|
* The #GType for a boxed type holding a #GRegex reference.
|
|
*
|
|
* Since: 2.14
|
|
*/
|
|
#define G_TYPE_REGEX (g_regex_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_MATCH_INFO:
|
|
*
|
|
* The #GType for a boxed type holding a #GMatchInfo reference.
|
|
*
|
|
* Since: 2.30
|
|
*/
|
|
#define G_TYPE_MATCH_INFO (g_match_info_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_ARRAY:
|
|
*
|
|
* The #GType for a boxed type holding a #GArray reference.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_TYPE_ARRAY (g_array_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_BYTE_ARRAY:
|
|
*
|
|
* The #GType for a boxed type holding a #GByteArray reference.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_TYPE_BYTE_ARRAY (g_byte_array_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_PTR_ARRAY:
|
|
*
|
|
* The #GType for a boxed type holding a #GPtrArray reference.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
#define G_TYPE_PTR_ARRAY (g_ptr_array_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_BYTES:
|
|
*
|
|
* The #GType for #GBytes.
|
|
*
|
|
* Since: 2.32
|
|
*/
|
|
#define G_TYPE_BYTES (g_bytes_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_VARIANT_TYPE:
|
|
*
|
|
* The #GType for a boxed type holding a #GVariantType.
|
|
*
|
|
* Since: 2.24
|
|
*/
|
|
#define G_TYPE_VARIANT_TYPE (g_variant_type_get_gtype ())
|
|
|
|
/**
|
|
* G_TYPE_ERROR:
|
|
*
|
|
* The #GType for a boxed type holding a #GError.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
#define G_TYPE_ERROR (g_error_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_DATE_TIME:
|
|
*
|
|
* The #GType for a boxed type holding a #GDateTime.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
#define G_TYPE_DATE_TIME (g_date_time_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_TIME_ZONE:
|
|
*
|
|
* The #GType for a boxed type holding a #GTimeZone.
|
|
*
|
|
* Since: 2.34
|
|
*/
|
|
#define G_TYPE_TIME_ZONE (g_time_zone_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_IO_CHANNEL:
|
|
*
|
|
* The #GType for #GIOChannel.
|
|
*/
|
|
#define G_TYPE_IO_CHANNEL (g_io_channel_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_IO_CONDITION:
|
|
*
|
|
* The #GType for #GIOCondition.
|
|
*/
|
|
#define G_TYPE_IO_CONDITION (g_io_condition_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_VARIANT_BUILDER:
|
|
*
|
|
* The #GType for a boxed type holding a #GVariantBuilder.
|
|
*
|
|
* Since: 2.30
|
|
*/
|
|
#define G_TYPE_VARIANT_BUILDER (g_variant_builder_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_VARIANT_DICT:
|
|
*
|
|
* The #GType for a boxed type holding a #GVariantDict.
|
|
*
|
|
* Since: 2.40
|
|
*/
|
|
#define G_TYPE_VARIANT_DICT (g_variant_dict_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_MAIN_LOOP:
|
|
*
|
|
* The #GType for a boxed type holding a #GMainLoop.
|
|
*
|
|
* Since: 2.30
|
|
*/
|
|
#define G_TYPE_MAIN_LOOP (g_main_loop_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_MAIN_CONTEXT:
|
|
*
|
|
* The #GType for a boxed type holding a #GMainContext.
|
|
*
|
|
* Since: 2.30
|
|
*/
|
|
#define G_TYPE_MAIN_CONTEXT (g_main_context_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_SOURCE:
|
|
*
|
|
* The #GType for a boxed type holding a #GSource.
|
|
*
|
|
* Since: 2.30
|
|
*/
|
|
#define G_TYPE_SOURCE (g_source_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_POLLFD:
|
|
*
|
|
* The #GType for a boxed type holding a #GPollFD.
|
|
*
|
|
* Since: 2.36
|
|
*/
|
|
#define G_TYPE_POLLFD (g_pollfd_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_MARKUP_PARSE_CONTEXT:
|
|
*
|
|
* The #GType for a boxed type holding a #GMarkupParseContext.
|
|
*
|
|
* Since: 2.36
|
|
*/
|
|
#define G_TYPE_MARKUP_PARSE_CONTEXT (g_markup_parse_context_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_KEY_FILE:
|
|
*
|
|
* The #GType for a boxed type holding a #GKeyFile.
|
|
*
|
|
* Since: 2.32
|
|
*/
|
|
#define G_TYPE_KEY_FILE (g_key_file_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_MAPPED_FILE:
|
|
*
|
|
* The #GType for a boxed type holding a #GMappedFile.
|
|
*
|
|
* Since: 2.40
|
|
*/
|
|
#define G_TYPE_MAPPED_FILE (g_mapped_file_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_THREAD:
|
|
*
|
|
* The #GType for a boxed type holding a #GThread.
|
|
*
|
|
* Since: 2.36
|
|
*/
|
|
#define G_TYPE_THREAD (g_thread_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_CHECKSUM:
|
|
*
|
|
* The #GType for a boxed type holding a #GChecksum.
|
|
*
|
|
* Since: 2.36
|
|
*/
|
|
#define G_TYPE_CHECKSUM (g_checksum_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_OPTION_GROUP:
|
|
*
|
|
* The #GType for a boxed type holding a #GOptionGroup.
|
|
*
|
|
* Since: 2.44
|
|
*/
|
|
#define G_TYPE_OPTION_GROUP (g_option_group_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_URI:
|
|
*
|
|
* The #GType for a boxed type holding a #GUri.
|
|
*
|
|
* Since: 2.66
|
|
*/
|
|
#define G_TYPE_URI (g_uri_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_TREE:
|
|
*
|
|
* The #GType for #GTree.
|
|
*
|
|
* Since: 2.68
|
|
*/
|
|
#define G_TYPE_TREE (g_tree_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_PATTERN_SPEC:
|
|
*
|
|
* The #GType for #GPatternSpec.
|
|
*
|
|
* Since: 2.70
|
|
*/
|
|
#define G_TYPE_PATTERN_SPEC (g_pattern_spec_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_BOOKMARK_FILE:
|
|
*
|
|
* The #GType for a boxed type holding a #GBookmarkFile.
|
|
*
|
|
* Since: 2.76
|
|
*/
|
|
#define G_TYPE_BOOKMARK_FILE (g_bookmark_file_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_HMAC:
|
|
*
|
|
* The #GType for a boxed type holding a #GHmac.
|
|
*
|
|
* Since: 2.80
|
|
*/
|
|
#define G_TYPE_HMAC (g_hmac_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_DIR:
|
|
*
|
|
* The #GType for a boxed type holding a #GDir.
|
|
*
|
|
* Since: 2.80
|
|
*/
|
|
#define G_TYPE_DIR (g_dir_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_RAND:
|
|
*
|
|
* The #GType for a boxed type holding a #GRand.
|
|
*
|
|
* Since: 2.80
|
|
*/
|
|
#define G_TYPE_RAND (g_rand_get_type ())
|
|
|
|
/**
|
|
* G_TYPE_STRV_BUILDER:
|
|
*
|
|
* The #GType for a boxed type holding a #GStrvBuilder.
|
|
*
|
|
* Since: 2.80
|
|
*/
|
|
#define G_TYPE_STRV_BUILDER (g_strv_builder_get_type ())
|
|
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_date_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_strv_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_gstring_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_hash_table_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_array_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_byte_array_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_ptr_array_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_bytes_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_variant_type_get_gtype (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_regex_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_30
|
|
GType g_match_info_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_error_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_date_time_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_time_zone_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_io_channel_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_io_condition_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_variant_builder_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_40
|
|
GType g_variant_dict_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_ALL
|
|
GType g_key_file_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_30
|
|
GType g_main_loop_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_30
|
|
GType g_main_context_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_30
|
|
GType g_source_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_36
|
|
GType g_pollfd_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_36
|
|
GType g_thread_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_36
|
|
GType g_checksum_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_36
|
|
GType g_markup_parse_context_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_40
|
|
GType g_mapped_file_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_44
|
|
GType g_option_group_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_66
|
|
GType g_uri_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_68
|
|
GType g_tree_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_70
|
|
GType g_pattern_spec_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_76
|
|
GType g_bookmark_file_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_80
|
|
GType g_hmac_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_80
|
|
GType g_dir_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_80
|
|
GType g_rand_get_type (void);
|
|
GOBJECT_AVAILABLE_IN_2_80
|
|
GType g_strv_builder_get_type (void);
|
|
|
|
GOBJECT_DEPRECATED_FOR('G_TYPE_VARIANT')
|
|
GType g_variant_get_gtype (void);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GLIB_TYPES_H__ */
|