blob: bf839596eedf6f3959e906b7a61436af30620551 (
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
|
#ifndef _GLIBMM_QUARK_H
#define _GLIBMM_QUARK_H
/* quark.h
*
* Copyright 2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <glibmmconfig.h>
#include <glibmm/ustring.h>
#include <glib.h>
namespace Glib
{
/** Quarks are unique IDs in Glib for strings for use in
* hash table lookups. Each Quark is unique but may change
* between runs.
*
* QueryQuark is a converter class for looking up but not
* allocating an ID. An id means the quark lookup failed.
*
* Quark is used for actions for which the id should live on
* While QueryQuark should be used for queries.
* ie.
* void set_data (const Quark&, void * data);
* void* get_data (const QueryQuark&);
*/
class GLIBMM_API QueryQuark
{
public:
QueryQuark(const GQuark& q);
QueryQuark(const ustring& s);
QueryQuark(const char* s);
~QueryQuark() noexcept {}
QueryQuark& operator=(const QueryQuark& q);
operator ustring() const;
operator GQuark() const { return quark_; }
GQuark id() const { return quark_; }
private:
GQuark quark_;
};
class GLIBMM_API Quark : public QueryQuark
{
public:
Quark(const ustring& s);
Quark(const char* s);
~Quark() noexcept;
};
/** @relates Glib::QueryQuark */
inline bool
operator==(const QueryQuark& a, const QueryQuark& b)
{
return a.id() == b.id();
}
/** @relates Glib::QueryQuark */
inline bool
operator!=(const QueryQuark& a, const QueryQuark& b)
{
return a.id() != b.id();
}
#ifndef DOXYGEN_SHOULD_SKIP_THIS
// TODO: Put this somewhere else.
// (internal) The quark for C++ wrappers.
extern GLIBMM_API GQuark quark_;
extern GLIBMM_API GQuark quark_cpp_wrapper_deleted_;
#endif
} /* namespace Glib */
#endif /* _GLIBMM_QUARK_H */
|
