Ichthyostega
8dc6580da1
Notably some links on the **Gnome documentation** pages are problematic, since there was seemingly an infrastructure change -- which unfortunately leads to loosing several deep-links into the GTK-3 related documentation and tutorials. While the differences to GTK-4 are often rather minimal, I would still prefer to link to those documentation pages used as reference at implementation time of our related library and GUI functionality. In several cases I have thus looked up the old URLs at Archive.org
120 lines
3.8 KiB
C++
120 lines
3.8 KiB
C++
/*
|
||
NOCOPY.hpp - some flavours of non-copyable entities
|
||
|
||
Copyright (C)
|
||
2012, Hermann Vosseler <Ichthyostega@web.de>
|
||
|
||
**Lumiera** 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; either version 2 of the License, or (at your
|
||
option) any later version. See the file COPYING for further details.
|
||
|
||
*/
|
||
|
||
|
||
/** @file nocopy.hpp
|
||
** Mix-Ins to allow or prohibit various degrees of copying and cloning.
|
||
** Whenever a class is conceived as entity with a well-defined "identity",
|
||
** or whenever a service has to manage resources, we consider it good practice
|
||
** to define it by default as "non copyable". This rules out a lot of complexities
|
||
** with mutable state and confusion regarding equality.
|
||
** @remark inspired by [Boost-Noncopyable]
|
||
**
|
||
** [Boost-Noncopyable]: https://www.boost.org/doc/libs/1_55_0/libs/utility/utility.htm#Class_noncopyable
|
||
*/
|
||
|
||
|
||
#ifndef LIB_NOCOPY_H
|
||
#define LIB_NOCOPY_H
|
||
|
||
|
||
|
||
namespace util {
|
||
|
||
/**
|
||
* Any copy and copy construction prohibited
|
||
*/
|
||
class NonCopyable
|
||
{
|
||
protected:
|
||
~NonCopyable() = default;
|
||
NonCopyable() = default;
|
||
NonCopyable (NonCopyable const&) = delete;
|
||
NonCopyable& operator= (NonCopyable const&) = delete;
|
||
};
|
||
|
||
/**
|
||
* Types marked with this mix-in may be moved but not copied
|
||
*/
|
||
class MoveOnly
|
||
{
|
||
protected:
|
||
~MoveOnly() = default;
|
||
MoveOnly() = default;
|
||
MoveOnly (MoveOnly&&) = default;
|
||
MoveOnly (MoveOnly const&) = delete;
|
||
MoveOnly& operator= (MoveOnly&&) = delete;
|
||
MoveOnly& operator= (MoveOnly const&) = delete;
|
||
};
|
||
|
||
/**
|
||
* Types marked with this mix-in may be moved and move-assigned
|
||
*/
|
||
class MoveAssign
|
||
{
|
||
protected:
|
||
~MoveAssign() = default;
|
||
MoveAssign() = default;
|
||
MoveAssign (MoveAssign&&) = default;
|
||
MoveAssign (MoveAssign const&) = delete;
|
||
MoveAssign& operator= (MoveAssign&&) = default;
|
||
MoveAssign& operator= (MoveAssign const&) = delete;
|
||
};
|
||
|
||
/**
|
||
* Types marked with this mix-in may be created and moved
|
||
* liberally at construction, while any further assignment
|
||
* to object instances is prohibited thereafter.
|
||
*/
|
||
class NonAssign
|
||
{
|
||
protected:
|
||
~NonAssign() = default;
|
||
NonAssign() = default;
|
||
NonAssign (NonAssign&&) = default;
|
||
NonAssign (NonAssign const&) = default;
|
||
NonAssign& operator= (NonAssign&&) = delete;
|
||
NonAssign& operator= (NonAssign const&) = delete;
|
||
};
|
||
|
||
/**
|
||
* Types marked with this mix-in may be duplicated
|
||
* by copy-construction, yet may not be moved or
|
||
* transferred any further after creation.
|
||
*/
|
||
class Cloneable
|
||
{
|
||
protected:
|
||
~Cloneable() = default;
|
||
Cloneable() = default;
|
||
Cloneable (Cloneable&&) = delete;
|
||
Cloneable (Cloneable const&) = default;
|
||
Cloneable& operator= (Cloneable&&) = delete;
|
||
Cloneable& operator= (Cloneable const&) = delete;
|
||
};
|
||
|
||
/**
|
||
* Not meant to be instantiated in any way.
|
||
* Types marked this way are typically used for metaprogramming
|
||
* or expose static factory methods to some related sibling
|
||
* based on a template parameter or similar configuration.
|
||
*/
|
||
class NoInstance
|
||
{
|
||
protected:
|
||
NoInstance() = delete;
|
||
};
|
||
|
||
|
||
} // namespace util
|
||
#endif /*LIB_NOCOPY_H*/
|