summaryrefslogtreecommitdiff
path: root/mate-dictionary/libgdict/gdict-context-private.h
blob: a29b237b6486e78247be1ec16d822c61b3b9dc8c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/* Copyright (C) 2005 Emmanuele Bassi <ebassi@gmail.com>
 * Copyright (C) 2012-2021 MATE Developers
 *
 * This file is part of MATE Utils.
 *
 * MATE Utils is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 2 of the License, or
 * (at your option) any later version.
 *
 * MATE Utils 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with MATE Utils.  If not, see <https://www.gnu.org/licenses/>.
 */

#ifndef __GDICT_PRIVATE_H__
#define __GDICT_PRIVATE_H__

#ifndef GDICT_ENABLE_INTERNALS
#error "You are trying to access Gdict's internals outside Gdict.  The API of these internal functions is not fixed."
#endif

#include <glib-object.h>

#include "gdict-context.h"

G_BEGIN_DECLS

/* boilerplate code, similar to G_DEFINE_TYPE in spirit, used to define
 * our boxed types and their ref/unref functions; you still have to
 * implement your own ref/unref functions!
 */
#define GDICT_DEFINE_BOXED_TYPE(TypeName,type_name)	\
\
static gpointer type_name##_intern_ref (gpointer self) \
{ \
  return type_name##_ref ((TypeName *) self); \
} \
static void type_name##_intern_unref (gpointer self) \
{ \
  type_name##_unref ((TypeName *) self); \
} \
\
GType \
type_name##_get_type (void) \
{ \
  static GType gdict_define_boxed_type = 0; \
  if (G_UNLIKELY (gdict_define_boxed_type == 0)) \
    gdict_define_boxed_type = g_boxed_type_register_static (#TypeName, (GBoxedCopyFunc) type_name##_intern_ref, (GBoxedFreeFunc) type_name##_intern_unref); \
  return gdict_define_boxed_type; \
}

/* Never, _ever_ access the members of these structures, unless you
 * know what you are doing.
 */

struct _GdictDatabase
{
  gchar *name;
  gchar *full_name;

  guint ref_count;
};

struct _GdictStrategy
{
  gchar *name;
  gchar *description;

  guint ref_count;
};

struct _GdictMatch
{
  gchar *database;
  gchar *word;

  guint ref_count;
};

struct _GdictDefinition
{
  gint total;

  gchar *word;
  gchar *database_name;
  gchar *database_full;
  gchar *definition;

  guint ref_count;
};

/* constructors for these objects are private, as the world outside do
 * not know what they hold, and accessor functions are getters only
 */
GdictDatabase *   _gdict_database_new   (const gchar *name);
GdictStrategy *   _gdict_strategy_new   (const gchar *name);
GdictMatch *      _gdict_match_new      (const gchar *word);
GdictDefinition * _gdict_definition_new (gint         total);

G_END_DECLS

#endif /* __GDICT_PRIVATE_H__ */