0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-01 03:18:54 +01:00
construct/include/ircd/m/room/origins.h

43 lines
1.5 KiB
C++

// Matrix Construct
//
// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice is present in all copies. The
// full license for this software is available in the LICENSE file.
#pragma once
#define HAVE_IRCD_M_ROOM_ORIGINS_H
/// Interface to the servers of a room. Messages have to be sent to them,
/// and an efficient iteration of the origins as provided by this interface
/// helps with that. This includes servers with joined members by default.
///
struct ircd::m::room::origins
{
using closure = std::function<void (const string_view &)>;
using closure_bool = std::function<bool (const string_view &)>;
m::room room;
public:
bool for_each(const closure_bool &view) const;
void for_each(const closure &view) const;
bool has(const string_view &origin) const;
bool only(const string_view &origin) const;
size_t count_online() const;
size_t count_error() const;
size_t count() const;
bool empty() const;
// select an origin in the room at random; use proffer to refuse and try another.
static bool random(const origins &, const closure &, const closure_bool &);
string_view random(const mutable_buffer &buf, const closure_bool &proffer = nullptr) const;
bool random(const closure &, const closure_bool &proffer = nullptr) const;
origins(const m::room &room)
:room{room}
{}
};