GLib Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <glib.h> typedef GQuark; GQuark g_quark_from_string (const gchar *string); GQuark g_quark_from_static_string (const gchar *string); gchar* g_quark_to_string (GQuark quark); GQuark g_quark_try_string (const gchar *string); |
Quarks are associations between strings and integer identifiers. Given either the string or the GQuark identifier it is possible to retrieve the other.
Quarks are used for both Datasets and Keyed Data Lists.
To create a new quark from a string, use g_quark_from_string() or g_quark_from_static_string().
To find the string corresponding to a given GQuark, use g_quark_to_string().
To find the GQuark corresponding to a given string, use g_quark_try_string().
GQuark g_quark_from_string (const gchar *string); |
Gets the GQuark identifying the given string. If the string does not currently have an associated GQuark, a new GQuark is created, using a copy of the string.
string : | a string. |
Returns : | the GQuark identifying the string. |
GQuark g_quark_from_static_string (const gchar *string); |
Gets the GQuark identifying the given (static) string. If the string does not currently have an associated GQuark, a new GQuark is created, linked to the given string.
Note that this function is identical to g_quark_from_string() except that if a new GQuark is created the string itself is used rather than a copy. This saves memory, but can only be used if the string will always exist (if, for example, it is a statically-allocated string).
string : | a string. |
Returns : | the GQuark identifying the string. |
gchar* g_quark_to_string (GQuark quark); |
Gets the string associated with the given GQuark.
GQuark g_quark_try_string (const gchar *string); |
Gets the GQuark associated with the given string, or 0 if the string has no associated GQuark.
If you want the GQuark to be created if it doesn't already exist, use g_quark_from_string() or g_quark_from_static_string().