Functions
G_DEFINE_QUARK()
#define G_DEFINE_QUARK(QN, q_n)
A convenience macro which defines a function returning the
GQuark for the name QN
. The function will be named
q_n_quark()
.
Note that the quark name will be stringified automatically
in the macro, so you shouldn't use double quotes.
Since: 2.34
g_quark_from_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.
This function must not be used before library constructors have finished
running. In particular, this means it cannot be used to initialize global
variables in C++.
Returns
the GQuark identifying the string, or 0 if string
is NULL
g_quark_from_static_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 continue to exist until the program terminates. It can be used
with statically allocated strings in the main program, but not with
statically allocated memory in dynamically loaded modules, if you
expect to ever unload the module again (e.g. do not use this
function in GTK+ theme engines).
This function must not be used before library constructors have finished
running. In particular, this means it cannot be used to initialize global
variables in C++.
Returns
the GQuark identifying the string, or 0 if string
is NULL
g_quark_to_string ()
const gchar *
g_quark_to_string (GQuark quark);
Gets the string associated with the given GQuark.
Returns
the string associated with the GQuark
g_quark_try_string ()
GQuark
g_quark_try_string (const gchar *string);
Gets the GQuark associated with the given string, or 0 if string is
NULL or it 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().
This function must not be used before library constructors have finished
running.
Returns
the GQuark associated with the string, or 0 if string
is
NULL or there is no GQuark associated with it
g_intern_string ()
const gchar *
g_intern_string (const gchar *string);
Returns a canonical representation for string
. Interned strings
can be compared for equality by comparing the pointers, instead of
using strcmp().
This function must not be used before library constructors have finished
running. In particular, this means it cannot be used to initialize global
variables in C++.
Returns
a canonical representation for the string
Since: 2.10
g_intern_static_string ()
const gchar *
g_intern_static_string (const gchar *string);
Returns a canonical representation for string
. Interned strings
can be compared for equality by comparing the pointers, instead of
using strcmp(). g_intern_static_string() does not copy the string,
therefore string
must not be freed or modified.
This function must not be used before library constructors have finished
running. In particular, this means it cannot be used to initialize global
variables in C++.
Returns
a canonical representation for the string
Since: 2.10