glib-2.0/glib/gquark.h

0001 /* GLIB - Library of useful routines for C programming
0002  * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
0003  *
0004  * SPDX-License-Identifier: LGPL-2.1-or-later
0005  *
0006  * This library is free software; you can redistribute it and/or
0007  * modify it under the terms of the GNU Lesser General Public
0008  * License as published by the Free Software Foundation; either
0009  * version 2.1 of the License, or (at your option) any later version.
0010  *
0011  * This library is distributed in the hope that it will be useful,
0012  * but WITHOUT ANY WARRANTY; without even the implied warranty of
0013  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0014  * Lesser General Public License for more details.
0015  *
0016  * You should have received a copy of the GNU Lesser General Public
0017  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
0018  */
0019
0020 /*
0021  * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
0022  * file for a list of people on the GLib Team.  See the ChangeLog
0023  * files for a list of changes.  These files are distributed with
0024  * GLib at ftp://ftp.gtk.org/pub/gtk/.
0025  */
0026
0027 #ifndef __G_QUARK_H__
0028 #define __G_QUARK_H__
0029
0030 #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
0031 #error "Only <glib.h> can be included directly."
0032 #endif
0033
0034 #include <glib/gtypes.h>
0035
0036 G_BEGIN_DECLS
0037
0038 typedef guint32 GQuark;
0039
0040 /* Quarks (string<->id association)
0041  */
0042 GLIB_AVAILABLE_IN_ALL
0043 GQuark                g_quark_try_string         (const gchar *string);
0044 GLIB_AVAILABLE_IN_ALL
0045 GQuark                g_quark_from_static_string (const gchar *string);
0046 GLIB_AVAILABLE_IN_ALL
0047 GQuark                g_quark_from_string        (const gchar *string);
0048 GLIB_AVAILABLE_IN_ALL
0049 const gchar *         g_quark_to_string          (GQuark       quark) G_GNUC_CONST;
0050
0051 #define G_DEFINE_QUARK(QN, q_n)                                         \
0052 GQuark                                                                  \
0053 q_n##_quark (void)                                                      \
0054 {                                                                       \
0055   static GQuark q;                                                      \
0056                                                                         \
0057   if G_UNLIKELY (q == 0)                                                \
0058     q = g_quark_from_static_string (#QN);                               \
0059                                                                         \
0060   return q;                                                             \
0061 }
0062
0063 GLIB_AVAILABLE_IN_ALL
0064 const gchar *         g_intern_string            (const gchar *string);
0065 GLIB_AVAILABLE_IN_ALL
0066 const gchar *         g_intern_static_string     (const gchar *string);
0067
0068 G_END_DECLS
0069
0070 #endif /* __G_QUARK_H__ */