| GObject Reference Manual |
|---|
Enums and FlagsEnums and Flags — Enumeration and flags types |
#include <glib-object.h>
GEnumClass;
GFlagsClass;
#define G_ENUM_CLASS_TYPE (class)
#define G_ENUM_CLASS_TYPE_NAME (class)
#define G_TYPE_IS_ENUM (type)
#define G_ENUM_CLASS (class)
#define G_IS_ENUM_CLASS (class)
#define G_TYPE_IS_FLAGS (type)
#define G_FLAGS_CLASS (class)
#define G_IS_FLAGS_CLASS (class)
#define G_FLAGS_CLASS_TYPE (class)
#define G_FLAGS_CLASS_TYPE_NAME (class)
GEnumValue;
GFlagsValue;
GEnumValue* g_enum_get_value (GEnumClass *enum_class,
gint value);
GEnumValue* g_enum_get_value_by_name (GEnumClass *enum_class,
const gchar *name);
GEnumValue* g_enum_get_value_by_nick (GEnumClass *enum_class,
const gchar *nick);
GFlagsValue* g_flags_get_first_value (GFlagsClass *flags_class,
guint value);
GFlagsValue* g_flags_get_value_by_name (GFlagsClass *flags_class,
const gchar *name);
GFlagsValue* g_flags_get_value_by_nick (GFlagsClass *flags_class,
const gchar *nick);
GType g_enum_register_static (const gchar *name,
const GEnumValue *const_static_values);
GType g_flags_register_static (const gchar *name,
const GFlagsValue *const_static_values);
void g_enum_complete_type_info (GType g_enum_type,
GTypeInfo *info,
const GEnumValue *const_values);
void g_flags_complete_type_info (GType g_flags_type,
GTypeInfo *info,
const GFlagsValue *const_values);
typedef struct {
GTypeClass g_type_class;
gint minimum;
gint maximum;
guint n_values;
GEnumValue *values;
} GEnumClass;
The class of an enumeration type holds information about its possible values.
GTypeClass g_type_class; |
|
gint minimum; |
the smallest possible value. |
gint maximum; |
the largest possible value. |
guint n_values; |
the number of possible values. |
GEnumValue *values; |
an array of GEnumValue structs describing the individual values. |
typedef struct {
GTypeClass g_type_class;
guint mask;
guint n_values;
GFlagsValue *values;
} GFlagsClass;
The class of a flags type holds information about its possible values.
GTypeClass g_type_class; |
|
guint mask; |
a mask covering all possible values. |
guint n_values; |
the number of possible values. |
GFlagsValue *values; |
an array of GFlagsValue structs describing the individual values. |
#define G_ENUM_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class))
Returns the type identifier from a given GEnumClass structure.
class : |
a GEnumClass |
#define G_ENUM_CLASS_TYPE_NAME(class) (g_type_name (G_ENUM_CLASS_TYPE (class)))
Returns the static type name from a given GEnumClass structure.
class : |
a GEnumClass |
#define G_TYPE_IS_ENUM(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM)
Returns whether type "is a" G_TYPE_ENUM.
type : |
a GType ID. |
#define G_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_ENUM, GEnumClass))
Casts a derived GEnumClass structure into a GEnumClass structure.
class : |
a valid GEnumClass |
#define G_IS_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_ENUM))
Checks whether class "is a" valid GEnumClass structure of type G_TYPE_ENUM
or derived.
class : |
a GEnumClass |
#define G_TYPE_IS_FLAGS(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS)
Returns whether type "is a" G_TYPE_FLAGS.
type : |
a GType ID. |
#define G_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_FLAGS, GFlagsClass))
Casts a derived GFlagsClass structure into a GFlagsClass structure.
class : |
a valid GFlagsClass |
#define G_IS_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_FLAGS))
Checks whether class "is a" valid GFlagsClass structure of type G_TYPE_FLAGS
or derived.
class : |
a GFlagsClass |
#define G_FLAGS_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class))
Returns the type identifier from a given GFlagsClass structure.
class : |
a GFlagsClass |
#define G_FLAGS_CLASS_TYPE_NAME(class) (g_type_name (G_FLAGS_TYPE (class)))
Returns the static type name from a given GFlagsClass structure.
class : |
a GFlagsClass |
typedef struct {
gint value;
gchar *value_name;
gchar *value_nick;
} GEnumValue;
A structure which contains a single enum value, it's name, and it's nickname.
typedef struct {
guint value;
gchar *value_name;
gchar *value_nick;
} GFlagsValue;
A structure which contains a single flags value, it's name, and it's nickname.
GEnumValue* g_enum_get_value (GEnumClass *enum_class, gint value);
Returns the GEnumValue for a value.
enum_class : |
a GEnumClass |
value : |
the value to look up |
| Returns : | the GEnumValue for value, or NULL if value is not
a member of the enumeration
|
GEnumValue* g_enum_get_value_by_name (GEnumClass *enum_class, const gchar *name);
Looks up a GEnumValue by name.
enum_class : |
a GEnumClass |
name : |
the name to look up |
| Returns : | the GEnumValue with name name, or NULL if the enumeration doesn'
t have a member with that name
|
GEnumValue* g_enum_get_value_by_nick (GEnumClass *enum_class, const gchar *nick);
Looks up a GEnumValue by nickname.
enum_class : |
a GEnumClass |
nick : |
the nickname to look up |
| Returns : | the GEnumValue with nickname nick, or NULL if the enumeration doesn'
t have a member with that nickname
|
GFlagsValue* g_flags_get_first_value (GFlagsClass *flags_class, guint value);
Returns the first GFlagsValue which is set in value.
flags_class : |
a GFlagsClass |
value : |
the value |
| Returns : | the first GFlagsValue which is set in value, or NULL if none is set
|
GFlagsValue* g_flags_get_value_by_name (GFlagsClass *flags_class, const gchar *name);
Looks up a GFlagsValue by name.
flags_class : |
a GFlagsClass |
name : |
the name to look up |
| Returns : | the GFlagsValue with name name, or NULL if there is no flag with
that name
|
GFlagsValue* g_flags_get_value_by_nick (GFlagsClass *flags_class, const gchar *nick);
Looks up a GFlagsValue by nickname.
flags_class : |
a GFlagsClass |
nick : |
the nickname to look up |
| Returns : | the GFlagsValue with nickname nick, or NULL if there is no flag
with that nickname
|
GType g_enum_register_static (const gchar *name, const GEnumValue *const_static_values);
Registers a new static enumeration type with the name name.
It is normally more convenient to let
glib-mkenums generate a
my_enum_get_type() function from a usual C enumeration definition
than to write one yourself using g_enum_register_static().
name : |
A nul-terminated string used as the name of the new type. |
const_static_values : |
An array of GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. |
| Returns : | The new type identifier. |
GType g_flags_register_static (const gchar *name, const GFlagsValue *const_static_values);
Registers a new static flags type with the name name.
It is normally more convenient to let
glib-mkenums generate a
my_flags_get_type() function from a usual C enumeration definition
than to write one yourself using g_flags_register_static().
name : |
A nul-terminated string used as the name of the new type. |
const_static_values : |
An array of GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. |
| Returns : | The new type identifier. |
void g_enum_complete_type_info (GType g_enum_type, GTypeInfo *info, const GEnumValue *const_values);
This function is meant to be called from the complete_type_info() function
of a GTypePlugin implementation, as in the following example:
static void
my_enum_complete_type_info (GTypePlugin *plugin,
GType g_type,
GTypeInfo *info,
GTypeValueTable *value_table)
{
static const GEnumValue values[] = {
{ MY_ENUM_FOO, "MY_ENUM_FOO", "foo" },
{ MY_ENUM_BAR, "MY_ENUM_BAR", "bar" },
{ 0, NULL, NULL }
};
g_enum_complete_type_info (type, info, values);
}
g_enum_type : |
the type identifier of the type being completed |
info : |
the GTypeInfo struct to be filled in |
const_values : |
An array of GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. |
void g_flags_complete_type_info (GType g_flags_type, GTypeInfo *info, const GFlagsValue *const_values);
This function is meant to be called from the complete_type_info() function
of a GTypePlugin implementation, see the example for
g_enumeration_complete_type_info() above.
g_flags_type : |
the type identifier of the type being completed |
info : |
the GTypeInfo struct to be filled in |
const_values : |
An array of GFlagsValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. |
| << GObject | GBoxed >> |