mpd/src/util/IntrusiveList.hxx

346 lines
7.8 KiB
C++
Raw Normal View History

/*
* Copyright 2020 Max Kellermann <max.kellermann@gmail.com>
* All rights reserved.
*
* author: Max Kellermann <mk@cm4all.com>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* - Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the
* distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#pragma once
#include "Cast.hxx"
#include <iterator>
#include <type_traits>
#include <utility>
struct IntrusiveListNode {
IntrusiveListNode *next, *prev;
};
class IntrusiveListHook {
template<typename T> friend class IntrusiveList;
protected:
IntrusiveListNode siblings;
public:
void unlink() noexcept {
siblings.next->prev = siblings.prev;
siblings.prev->next = siblings.next;
}
private:
static constexpr auto &Cast(IntrusiveListNode &node) noexcept {
return ContainerCast(node, &IntrusiveListHook::siblings);
}
static constexpr const auto &Cast(const IntrusiveListNode &node) noexcept {
return ContainerCast(node, &IntrusiveListHook::siblings);
}
};
/**
* A variant of #IntrusiveListHook which keeps track of whether it is
* currently in a list.
*/
class SafeLinkIntrusiveListHook : public IntrusiveListHook {
public:
SafeLinkIntrusiveListHook() noexcept {
siblings.next = nullptr;
}
void unlink() noexcept {
IntrusiveListHook::unlink();
siblings.next = nullptr;
}
bool is_linked() const noexcept {
return siblings.next != nullptr;
}
};
/**
* A variant of #IntrusiveListHook which auto-unlinks itself from the
* list upon destruction. As a side effect, it has an is_linked()
* method.
*/
class AutoUnlinkIntrusiveListHook : public SafeLinkIntrusiveListHook {
public:
~AutoUnlinkIntrusiveListHook() noexcept {
if (is_linked())
unlink();
}
};
template<typename T>
class IntrusiveList {
IntrusiveListNode head{&head, &head};
static constexpr T *Cast(IntrusiveListNode *node) noexcept {
static_assert(std::is_base_of<IntrusiveListHook, T>::value);
auto *hook = &IntrusiveListHook::Cast(*node);
return static_cast<T *>(hook);
}
static constexpr const T *Cast(const IntrusiveListNode *node) noexcept {
static_assert(std::is_base_of<IntrusiveListHook, T>::value);
const auto *hook = &IntrusiveListHook::Cast(*node);
return static_cast<const T *>(hook);
}
static constexpr IntrusiveListHook &ToHook(T &t) noexcept {
static_assert(std::is_base_of<IntrusiveListHook, T>::value);
return t;
}
static constexpr const IntrusiveListHook &ToHook(const T &t) noexcept {
static_assert(std::is_base_of<IntrusiveListHook, T>::value);
return t;
}
static constexpr IntrusiveListNode &ToNode(T &t) noexcept {
return ToHook(t).siblings;
}
static constexpr const IntrusiveListNode &ToNode(const T &t) noexcept {
return ToHook(t).siblings;
}
public:
2021-02-24 20:16:18 +01:00
constexpr IntrusiveList() noexcept = default;
IntrusiveList(IntrusiveList &&src) noexcept {
if (src.empty())
return;
head = src.head;
head.next->prev = &head;
head.prev->next = &head;
src.head.next = &src.head;
src.head.prev = &src.head;
}
~IntrusiveList() noexcept {
if constexpr (std::is_base_of<SafeLinkIntrusiveListHook, T>::value)
clear();
}
IntrusiveList &operator=(IntrusiveList &&) = delete;
constexpr bool empty() const noexcept {
return head.next == &head;
}
void clear() noexcept {
if constexpr (std::is_base_of<SafeLinkIntrusiveListHook, T>::value) {
/* for SafeLinkIntrusiveListHook, we need to
remove each item manually, or else its
is_linked() method will not work */
while (!empty())
pop_front();
} else
head = {&head, &head};
}
template<typename D>
void clear_and_dispose(D &&disposer) noexcept {
while (!empty()) {
auto *item = &front();
pop_front();
disposer(item);
}
}
template<typename P, typename D>
void remove_and_dispose_if(P &&pred, D &&dispose) noexcept {
auto *n = head.next;
while (n != &head) {
auto *i = Cast(n);
n = n->next;
if (pred(*i)) {
i->unlink();
dispose(i);
}
}
}
const T &front() const noexcept {
return *Cast(head.next);
}
T &front() noexcept {
return *Cast(head.next);
}
void pop_front() noexcept {
front().unlink();
}
template<typename D>
void pop_front_and_dispose(D &&disposer) noexcept {
auto &i = front();
i.unlink();
disposer(&i);
}
T &back() noexcept {
return *Cast(head.prev);
}
void pop_back() noexcept {
back().unlink();
}
class const_iterator;
class iterator final
: public std::iterator<std::forward_iterator_tag, T> {
friend IntrusiveList;
friend const_iterator;
IntrusiveListNode *cursor;
constexpr iterator(IntrusiveListNode *_cursor) noexcept
:cursor(_cursor) {}
public:
2021-02-24 20:17:26 +01:00
iterator() noexcept = default;
constexpr bool operator==(const iterator &other) const noexcept {
return cursor == other.cursor;
}
constexpr bool operator!=(const iterator &other) const noexcept {
return !(*this == other);
}
constexpr T &operator*() const noexcept {
return *Cast(cursor);
}
constexpr T *operator->() const noexcept {
return Cast(cursor);
}
iterator &operator++() noexcept {
cursor = cursor->next;
return *this;
}
};
constexpr iterator begin() noexcept {
return {head.next};
}
constexpr iterator end() noexcept {
return {&head};
}
static constexpr iterator iterator_to(T &t) noexcept {
return {&ToNode(t)};
}
class const_iterator final
: public std::iterator<std::forward_iterator_tag, const T> {
friend IntrusiveList;
const IntrusiveListNode *cursor;
constexpr const_iterator(const IntrusiveListNode *_cursor) noexcept
:cursor(_cursor) {}
public:
2021-02-24 20:17:26 +01:00
const_iterator() noexcept = default;
const_iterator(iterator src) noexcept
:cursor(src.cursor) {}
constexpr bool operator==(const const_iterator &other) const noexcept {
return cursor == other.cursor;
}
constexpr bool operator!=(const const_iterator &other) const noexcept {
return !(*this == other);
}
constexpr const T &operator*() const noexcept {
return *Cast(cursor);
}
constexpr const T *operator->() const noexcept {
return Cast(cursor);
}
const_iterator &operator++() noexcept {
cursor = cursor->next;
return *this;
}
};
constexpr const_iterator begin() const noexcept {
return {head.next};
}
constexpr const_iterator end() const noexcept {
return {&head};
}
static constexpr iterator iterator_to(const T &t) noexcept {
return {&t};
}
iterator erase(iterator i) noexcept {
auto result = std::next(i);
ToHook(*i).unlink();
return result;
2021-02-17 20:19:19 +01:00
}
void push_front(T &t) noexcept {
insert(begin(), t);
}
void push_back(T &t) noexcept {
insert(end(), t);
}
void insert(iterator p, T &t) noexcept {
auto &existing_node = ToNode(*p);
auto &new_node = ToNode(t);
existing_node.prev->next = &new_node;
new_node.prev = existing_node.prev;
existing_node.prev = &new_node;
new_node.next = &existing_node;
}
};