mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-02-24 19:22:11 +01:00
5a82f45432
The existing API for registering enumeration types requires that the GEnumValue and GFlagsValue arrays that describe the enumeration values is located in static storage. This causes unnecessary relocations, and does not save that much memory, compared to the rest of GType. We can provide a new API, to be used by developers, to copy the enumeration values, and thus drop the ones they have from static storage.
288 lines
8.2 KiB
C
288 lines
8.2 KiB
C
/* GObject - GLib Type, Object, Parameter and Signal Library
|
|
* Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.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 __G_ENUMS_H__
|
|
#define __G_ENUMS_H__
|
|
|
|
#if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION)
|
|
#error "Only <glib-object.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gobject/gtype.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* --- type macros --- */
|
|
/**
|
|
* G_TYPE_IS_ENUM:
|
|
* @type: a #GType ID.
|
|
*
|
|
* Checks whether @type "is a" %G_TYPE_ENUM.
|
|
*
|
|
* Returns: %TRUE if @type "is a" %G_TYPE_ENUM.
|
|
*/
|
|
#define G_TYPE_IS_ENUM(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM)
|
|
/**
|
|
* G_ENUM_CLASS:
|
|
* @class: a valid #GEnumClass
|
|
*
|
|
* Casts a derived #GEnumClass structure into a #GEnumClass structure.
|
|
*/
|
|
#define G_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_ENUM, GEnumClass))
|
|
/**
|
|
* G_IS_ENUM_CLASS:
|
|
* @class: a #GEnumClass
|
|
*
|
|
* Checks whether @class "is a" valid #GEnumClass structure of type %G_TYPE_ENUM
|
|
* or derived.
|
|
*/
|
|
#define G_IS_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_ENUM))
|
|
/**
|
|
* G_ENUM_CLASS_TYPE:
|
|
* @class: a #GEnumClass
|
|
*
|
|
* Get the type identifier from a given #GEnumClass structure.
|
|
*
|
|
* Returns: the #GType
|
|
*/
|
|
#define G_ENUM_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class))
|
|
/**
|
|
* G_ENUM_CLASS_TYPE_NAME:
|
|
* @class: a #GEnumClass
|
|
*
|
|
* Get the static type name from a given #GEnumClass structure.
|
|
*
|
|
* Returns: the type name.
|
|
*/
|
|
#define G_ENUM_CLASS_TYPE_NAME(class) (g_type_name (G_ENUM_CLASS_TYPE (class)))
|
|
|
|
|
|
/**
|
|
* G_TYPE_IS_FLAGS:
|
|
* @type: a #GType ID.
|
|
*
|
|
* Checks whether @type "is a" %G_TYPE_FLAGS.
|
|
*
|
|
* Returns: %TRUE if @type "is a" %G_TYPE_FLAGS.
|
|
*/
|
|
#define G_TYPE_IS_FLAGS(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS)
|
|
/**
|
|
* G_FLAGS_CLASS:
|
|
* @class: a valid #GFlagsClass
|
|
*
|
|
* Casts a derived #GFlagsClass structure into a #GFlagsClass structure.
|
|
*/
|
|
#define G_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_FLAGS, GFlagsClass))
|
|
/**
|
|
* G_IS_FLAGS_CLASS:
|
|
* @class: a #GFlagsClass
|
|
*
|
|
* Checks whether @class "is a" valid #GFlagsClass structure of type %G_TYPE_FLAGS
|
|
* or derived.
|
|
*/
|
|
#define G_IS_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_FLAGS))
|
|
/**
|
|
* G_FLAGS_CLASS_TYPE:
|
|
* @class: a #GFlagsClass
|
|
*
|
|
* Get the type identifier from a given #GFlagsClass structure.
|
|
*
|
|
* Returns: the #GType
|
|
*/
|
|
#define G_FLAGS_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class))
|
|
/**
|
|
* G_FLAGS_CLASS_TYPE_NAME:
|
|
* @class: a #GFlagsClass
|
|
*
|
|
* Get the static type name from a given #GFlagsClass structure.
|
|
*
|
|
* Returns: the type name.
|
|
*/
|
|
#define G_FLAGS_CLASS_TYPE_NAME(class) (g_type_name (G_FLAGS_CLASS_TYPE (class)))
|
|
|
|
|
|
/**
|
|
* G_VALUE_HOLDS_ENUM:
|
|
* @value: a valid #GValue structure
|
|
*
|
|
* Checks whether the given #GValue can hold values derived from type %G_TYPE_ENUM.
|
|
*
|
|
* Returns: %TRUE on success.
|
|
*/
|
|
#define G_VALUE_HOLDS_ENUM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ENUM))
|
|
/**
|
|
* G_VALUE_HOLDS_FLAGS:
|
|
* @value: a valid #GValue structure
|
|
*
|
|
* Checks whether the given #GValue can hold values derived from type %G_TYPE_FLAGS.
|
|
*
|
|
* Returns: %TRUE on success.
|
|
*/
|
|
#define G_VALUE_HOLDS_FLAGS(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLAGS))
|
|
|
|
|
|
/* --- enum/flag values & classes --- */
|
|
typedef struct _GEnumClass GEnumClass;
|
|
typedef struct _GFlagsClass GFlagsClass;
|
|
typedef struct _GEnumValue GEnumValue;
|
|
typedef struct _GFlagsValue GFlagsValue;
|
|
|
|
/**
|
|
* GEnumClass:
|
|
* @g_type_class: the parent class
|
|
* @minimum: the smallest possible value.
|
|
* @maximum: the largest possible value.
|
|
* @n_values: the number of possible values.
|
|
* @values: an array of #GEnumValue structs describing the
|
|
* individual values.
|
|
*
|
|
* The class of an enumeration type holds information about its
|
|
* possible values.
|
|
*/
|
|
struct _GEnumClass
|
|
{
|
|
GTypeClass g_type_class;
|
|
|
|
/*< public >*/
|
|
gint minimum;
|
|
gint maximum;
|
|
guint n_values;
|
|
GEnumValue *values;
|
|
};
|
|
/**
|
|
* GFlagsClass:
|
|
* @g_type_class: the parent class
|
|
* @mask: a mask covering all possible values.
|
|
* @n_values: the number of possible values.
|
|
* @values: an array of #GFlagsValue structs describing the
|
|
* individual values.
|
|
*
|
|
* The class of a flags type holds information about its
|
|
* possible values.
|
|
*/
|
|
struct _GFlagsClass
|
|
{
|
|
GTypeClass g_type_class;
|
|
|
|
/*< public >*/
|
|
guint mask;
|
|
guint n_values;
|
|
GFlagsValue *values;
|
|
};
|
|
/**
|
|
* GEnumValue:
|
|
* @value: the enum value
|
|
* @value_name: the name of the value
|
|
* @value_nick: the nickname of the value
|
|
*
|
|
* A structure which contains a single enum value, its name, and its
|
|
* nickname.
|
|
*/
|
|
struct _GEnumValue
|
|
{
|
|
gint value;
|
|
const gchar *value_name;
|
|
const gchar *value_nick;
|
|
};
|
|
/**
|
|
* GFlagsValue:
|
|
* @value: the flags value
|
|
* @value_name: the name of the value
|
|
* @value_nick: the nickname of the value
|
|
*
|
|
* A structure which contains a single flags value, its name, and its
|
|
* nickname.
|
|
*/
|
|
struct _GFlagsValue
|
|
{
|
|
guint value;
|
|
const gchar *value_name;
|
|
const gchar *value_nick;
|
|
};
|
|
|
|
|
|
/* --- prototypes --- */
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GEnumValue* g_enum_get_value (GEnumClass *enum_class,
|
|
gint value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GEnumValue* g_enum_get_value_by_name (GEnumClass *enum_class,
|
|
const gchar *name);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GEnumValue* g_enum_get_value_by_nick (GEnumClass *enum_class,
|
|
const gchar *nick);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFlagsValue* g_flags_get_first_value (GFlagsClass *flags_class,
|
|
guint value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFlagsValue* g_flags_get_value_by_name (GFlagsClass *flags_class,
|
|
const gchar *name);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GFlagsValue* g_flags_get_value_by_nick (GFlagsClass *flags_class,
|
|
const gchar *nick);
|
|
GLIB_AVAILABLE_IN_2_54
|
|
gchar *g_enum_to_string (GType g_enum_type,
|
|
gint value);
|
|
GLIB_AVAILABLE_IN_2_54
|
|
gchar *g_flags_to_string (GType flags_type,
|
|
guint value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_value_set_enum (GValue *value,
|
|
gint v_enum);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gint g_value_get_enum (const GValue *value);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_value_set_flags (GValue *value,
|
|
guint v_flags);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
guint g_value_get_flags (const GValue *value);
|
|
|
|
|
|
|
|
/* --- registration functions --- */
|
|
/* const_static_values is a NULL terminated array of enum/flags
|
|
* values that is taken over!
|
|
*/
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_enum_register_static (const gchar *name,
|
|
const GEnumValue *const_static_values);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_flags_register_static (const gchar *name,
|
|
const GFlagsValue *const_static_values);
|
|
|
|
GLIB_AVAILABLE_IN_2_54
|
|
GType g_enum_type_register_static (const gchar *name,
|
|
const GEnumValue *values);
|
|
GLIB_AVAILABLE_IN_2_54
|
|
GType g_flags_type_register_static (const gchar *name,
|
|
const GFlagsValue *values);
|
|
|
|
/* functions to complete the type information
|
|
* for enums/flags implemented by plugins
|
|
*/
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_enum_complete_type_info (GType g_enum_type,
|
|
GTypeInfo *info,
|
|
const GEnumValue *const_values);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_flags_complete_type_info (GType g_flags_type,
|
|
GTypeInfo *info,
|
|
const GFlagsValue *const_values);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_ENUMS_H__ */
|