summaryrefslogtreecommitdiff
path: root/include/accessgroup.h
blob: 76d30f62213e4ec81d563441a4991befc036e6d4 (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
/*
 * Anope IRC Services
 *
 * Copyright (C) 2011-2017 Anope Team <team@anope.org>
 *
 * This file is part of Anope. Anope 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, version 2.
 *
 * This program 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 this program; if not, see see <http://www.gnu.org/licenses/>.
 */

#include "modules/chanserv.h"

#pragma once

namespace ChanServ
{

/* A group of access entries. This is used commonly, for example with ChanServ::Channel::AccessFor,
 * to show what access a user has on a channel because users can match multiple access entries.
 */
class CoreExport AccessGroup : public std::vector<ChanAccess *>
{
 public:
	/* Channel these access entries are on */
	ChanServ::Channel *ci = nullptr;
	/* Account these entries affect, if any */
	const NickServ::Account *nc = nullptr;
	/* super_admin always gets all privs. founder is a special case where ci->founder == nc */
	bool super_admin = false, founder = false;

	/** Check if this access group has a certain privilege. Eg, it
	 * will check every ChanAccess entry of this group for any that
	 * has the given privilege.
	 * @param priv The privilege
	 * @return true if any entry has the given privilege
	 */
	bool HasPriv(const Anope::string &priv);

	/** Get the "highest" access entry from this group of entries.
	 * The highest entry is determined by the entry that has the privilege
	 * with the highest rank (see Privilege::rank).
	 * @return The "highest" entry
	 */
	ChanAccess *Highest() const;

	/* Comparison operators to other AccessGroups */
	bool operator>(AccessGroup &other);
	bool operator<(AccessGroup &other);
	bool operator>=(AccessGroup &other);
	bool operator<=(AccessGroup &other);
};

} // namespace ChanServ