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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
// SPDX-FileCopyrightText: 2019 Kitsune Ral <Kitsune-Ral@users.sf.net>
// SPDX-License-Identifier: LGPL-2.1-or-later
#pragma once
#include "quotient_export.h"
#include <qobjectdefs.h>
#include <array>
// See https://bugreports.qt.io/browse/QTBUG-82295 - despite the comment that
// Q_FLAG[_NS] "should" be applied to the enum only, Qt doesn't allow to wrap
// a flag type into a QVariant then. The macros below define Q_FLAG[_NS] and on
// top of that add Q_ENUM[_NS]_IMPL which is a part of Q_ENUM() macro that
// enables the metatype data but goes under the moc radar to avoid double
// registration of the same data in the map defined in moc_*.cpp
#define QUO_DECLARE_FLAGS(Flags, Enum) \
Q_DECLARE_FLAGS(Flags, Enum) \
Q_ENUM_IMPL(Enum) \
Q_FLAG(Flags)
#define QUO_DECLARE_FLAGS_NS(Flags, Enum) \
Q_DECLARE_FLAGS(Flags, Enum) \
Q_ENUM_NS_IMPL(Enum) \
Q_FLAG_NS(Flags)
// Apple Clang hasn't caught up with explicit(bool) yet
#if __cpp_conditional_explicit >= 201806L
#define QUO_IMPLICIT explicit(false)
#else
#define QUO_IMPLICIT
#endif
#define DECL_DEPRECATED_ENUMERATOR(Deprecated, Recommended) \
Deprecated Q_DECL_ENUMERATOR_DEPRECATED_X("Use " #Recommended) = Recommended
#if QT_VERSION < QT_VERSION_CHECK(5, 14, 0)
// The first line forward-declares the namespace static metaobject with
// QUOTIENT_API so that dynamically linked clients could serialise flag/enum
// values from the namespace; Qt before 5.14 doesn't help with that. The second
// line is needed for moc to do its job on the namespace.
#define QUO_NAMESPACE \
extern QUOTIENT_API const QMetaObject staticMetaObject; \
Q_NAMESPACE
#else
// Since Qt 5.14.0, it's all packed in a single macro
#define QUO_NAMESPACE Q_NAMESPACE_EXPORT(QUOTIENT_API)
#endif
namespace Quotient {
QUO_NAMESPACE
// std::array {} needs explicit template parameters on macOS because
// Apple stdlib doesn't have deduction guides for std::array. C++20 has
// to_array() but that can't be borrowed, this time because of MSVC:
// https://developercommunity.visualstudio.com/t/vc-ice-p1-initc-line-3652-from-stdto-array/1464038
// Therefore a simpler (but also slightly more wobbly - it resolves the element
// type using std::common_type<>) make_array facility is implemented here.
template <typename... Ts>
constexpr auto make_array(Ts&&... items)
{
return std::array<std::common_type_t<Ts...>, sizeof...(items)>(
{ std::forward<Ts>(items)... });
}
// TODO: code like this should be generated from the CS API definition
//! \brief Membership states
//!
//! These are used for member events. The names here are case-insensitively
//! equal to state names used on the wire.
//! \sa MemberEventContent, RoomMemberEvent
enum class Membership : unsigned int {
// Specific power-of-2 values (1,2,4,...) are important here as syncdata.cpp
// depends on that, as well as Join being the first in line
Invalid = 0x0,
Join = 0x1,
Leave = 0x2,
Invite = 0x4,
Knock = 0x8,
Ban = 0x10,
Undefined = Invalid
};
QUO_DECLARE_FLAGS_NS(MembershipMask, Membership)
constexpr auto MembershipStrings = make_array(
// The order MUST be the same as the order in the original enum
"join", "leave", "invite", "knock", "ban");
//! \brief Local user join-state names
//!
//! This represents a subset of Membership values that may arrive as the local
//! user's state grouping for the sync response.
//! \sa SyncData
enum class JoinState : std::underlying_type_t<Membership> {
Invalid = std::underlying_type_t<Membership>(Membership::Invalid),
Join = std::underlying_type_t<Membership>(Membership::Join),
Leave = std::underlying_type_t<Membership>(Membership::Leave),
Invite = std::underlying_type_t<Membership>(Membership::Invite),
Knock = std::underlying_type_t<Membership>(Membership::Knock),
};
QUO_DECLARE_FLAGS_NS(JoinStates, JoinState)
[[maybe_unused]] constexpr auto JoinStateStrings = make_array(
MembershipStrings[0], MembershipStrings[1], MembershipStrings[2],
MembershipStrings[3] /* same as MembershipStrings, sans "ban" */
);
//! \brief Network job running policy flags
//!
//! So far only background/foreground flags are available.
//! \sa Connection::callApi, Connection::run
enum RunningPolicy { ForegroundRequest = 0x0, BackgroundRequest = 0x1 };
Q_ENUM_NS(RunningPolicy)
//! \brief The result of URI resolution using UriResolver
//! \sa UriResolver
enum UriResolveResult : short {
StillResolving = -1,
UriResolved = 0,
CouldNotResolve,
IncorrectAction,
InvalidUri,
NoAccount
};
Q_ENUM_NS(UriResolveResult)
enum RoomType {
Space,
Undefined,
};
Q_ENUM_NS(RoomType)
[[maybe_unused]] constexpr auto RoomTypeStrings = make_array("m.space");
} // namespace Quotient
Q_DECLARE_OPERATORS_FOR_FLAGS(Quotient::MembershipMask)
Q_DECLARE_OPERATORS_FOR_FLAGS(Quotient::JoinStates)
|
