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
140
141
142
143
144
145
|
/*
* Copyright (C) 2019-2024 Matthias Klumpp <matthias@tenstral.net>
*
* Licensed under the GNU Lesser General Public License Version 2.1
*
* 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/>.
*/
#pragma once
#include <QSharedDataPointer>
#include <QObject>
#include "appstreamqt_export.h"
#include "component.h"
class QString;
struct _AsComponentBox;
namespace AppStream
{
class ComponentBoxData;
/**
* A container for AppStream::Component components.
*/
class APPSTREAMQT_EXPORT ComponentBox
{
Q_GADGET
public:
class iterator
{
public:
iterator(const iterator &it)
: index(it.index),
data(it.data)
{
}
bool operator==(iterator other) const
{
return index == other.index && data == other.data;
}
bool operator!=(iterator other) const
{
return index != other.index || data != other.data;
}
iterator &operator++()
{
index++;
return *this;
}
Component operator*() const;
std::optional<Component> operator->() const
{
return data->indexSafe(index);
}
iterator &operator=(const iterator &other)
{
if (&other != this) {
index = other.index;
data = other.data;
}
return *this;
}
private:
friend class ComponentBox;
iterator(uint index, const ComponentBox *cb)
: index(index),
data(cb)
{
}
uint index;
const ComponentBox *data;
};
/**
* ComponentBox::Flags:
* FlagNone: No flags.
* FlagNoChecks: Only perform the most basic verification.
*
* Flags for a ComponentBox.
**/
enum Flag {
FlagNone = 0,
FlagNoChecks = 1 << 0,
};
Q_DECLARE_FLAGS(Flags, Flag)
ComponentBox(ComponentBox::Flags flags);
ComponentBox(_AsComponentBox *cbox);
ComponentBox(const ComponentBox &other);
~ComponentBox();
ComponentBox &operator=(const ComponentBox &other);
/**
* \returns the internally stored AsComponentBox
*/
_AsComponentBox *cPtr() const;
/**
* \returns the contents of this component box as list.
*/
QList<Component> toList() const;
iterator begin() const
{
return iterator(0, this);
}
iterator end() const
{
return iterator(size(), this);
}
iterator erase(iterator it);
void operator+=(const ComponentBox &other);
uint size() const;
bool isEmpty() const;
std::optional<Component> indexSafe(uint index) const;
void sort();
void sortByScore();
private:
QSharedDataPointer<ComponentBoxData> d;
};
}
|
