construct/include/ircd/m/event/refs.h

// 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_EVENT_REFS_H

namespace ircd::m::dbs
{
	//NOTE: this is a forward declaration for the reference type enumeration
	//NOTE: which is defined in the dbs/ system rather than here, for now.

	enum class ref :uint8_t;
}

/// Interface to the forward-references for an event. Forward-references are
/// virtually constructed from prev-references made by other events. This
/// interface queries the database which has pre-indexed the prev-references
/// made by other events at their insertion (it does not conduct any expensive
/// scan when using this interface, etc).
struct ircd::m::event::refs
{
	using closure = util::closure_bool
	<
		std::function,
		const event::idx &, const dbs::ref &
	>;

	event::idx idx;

  private:
	bool _for_each(const dbs::ref &type, const closure &, const bool ascending) const;

  public:
	bool for_each(const dbs::ref &type, const closure &) const;
	bool for_each(const closure &) const;

	bool rfor_each(const dbs::ref &type, const closure &) const;
	bool rfor_each(const closure &) const;

	bool has(const dbs::ref &type, const event::idx &) const;
	bool has(const dbs::ref &type) const;
	bool has(const event::idx &) const;

	size_t count(const dbs::ref &type) const;
	size_t count() const;

	bool prefetch(const dbs::ref &type) const;
	bool prefetch() const;

	refs(const event::idx &idx) noexcept;

	static void rebuild();
};

inline
ircd::m::event::refs::refs(const event::idx &idx)
noexcept
:idx{idx}
{}

inline bool
ircd::m::event::refs::rfor_each(const closure &closure)
const
{
	return rfor_each(dbs::ref(-1), closure);
}

inline bool
ircd::m::event::refs::rfor_each(const dbs::ref &type,
                                const closure &closure)
const
{
	return idx?
		_for_each(type, closure, false):
		true;
}

inline bool
ircd::m::event::refs::for_each(const closure &closure)
const
{
	return for_each(dbs::ref(-1), closure);
}

inline bool
ircd::m::event::refs::for_each(const dbs::ref &type,
                               const closure &closure)
const
{
	return idx?
		_for_each(type, closure, true):
		true;
}