MemCore::Ageable Class Reference

Base class for objects which change from time to time. More...

#include <elementary/memcore/Ageable.hpp>

Inheritance diagram for MemCore::Ageable:

Public Member Functions
	Ageable () noexcept
	Constructor; remembers birth time from current time counter.
constexpr	Ageable (age_t t) noexcept
	Constructor with explicit time value.
constexpr	Ageable (const Ageable &A) noexcept
	Copy constructor.
	Ageable (const volatile Ageable &A) noexcept
	Copy constructor.
constexpr const Ageable &	getAge () const
	Return reference to this age, useful for derived classes.
bool	isNewerThan (const Ageable &a) const noexcept
	Comparison operator.
bool	isOlderThan (const Ageable &a) const noexcept
	Comparison operator.
bool	isYoungerThan (const Ageable &a) const noexcept
	Comparison operator (alias to isNewerThan() )
bool	operator!= (const Ageable &a) const noexcept
	Comparison operator.
bool	operator< (const Ageable &a) const noexcept
	Comparison operator.
bool	operator<= (const Ageable &a) const noexcept
	Comparision operator.
bool	operator<= (const volatile Ageable &a) const volatile noexcept
	Comparision operator.
bool	operator== (const Ageable &a) const noexcept
	Comparison operator.
bool	operator> (const Ageable &a) const noexcept
	Comparison operator.
bool	operator> (const volatile Ageable &a) const volatile throw ()
	Comparision operator.
bool	operator>= (const Ageable &a) const noexcept
	Comparision operator.
bool	operator>= (const volatile Ageable &a) const volatile noexcept
	Comparison operator.
constexpr void	resetAge () noexcept
	Set time value to InfinitelyOld().
void	setInfinitelyNew () noexcept
	Set time value to InfinitelyOld().
age_t	time_value () const noexcept
	Return an object's current age.
age_t	time_value () const volatile noexcept
	Return an object's current age.
Ageable &	touch () noexcept
	Mark the current object as being modified "now".
age_t	update (age_t age) noexcept
	Set the age of the current object to a specific age if that is newer than the current one.
age_t	update (const Ageable &Other) noexcept
	Set the age of the current object to the age of another object if that other one is newer than the current one.
age_t	update (const volatile Ageable &Other) volatile noexcept
	Set the age of the current object to the age of another object if that other one is newer than the current one.
	~Ageable () noexcept
	Destructor.

Static Public Member Functions
static const Ageable &	InfinitelyNew () noexcept
	Return a time that is infinitely in the future (well, sort of).
static constexpr const Ageable &	InfinitelyOld () noexcept
	Return a time that is infinitely in the past (well, sort of).
static age_t	now () noexcept
	Return the current global time.

Detailed Description

Base class for objects which change from time to time.

Upon touching such "ageable" objects, a change is indicated. The "age" is not related to physical time, but just an integer number. This number is a global counter that is increased when any object is touched.

Member Function Documentation

InfinitelyNew()

const Ageable & MemCore::Ageable::InfinitelyNew ( )

staticnoexcept

Return a time that is infinitely in the future (well, sort of).

It is a reference to a static members whose time value is the largest one possible, meaning no object will ever reach this age.

InfinitelyOld()

static constexpr const Ageable & MemCore::Ageable::InfinitelyOld ( )

inlinestaticconstexprnoexcept

Return a time that is infinitely in the past (well, sort of).

It is a reference to a static members whose time value is zero, means it's the oldest of all objects (smallest age).

Referenced by Wizt::VSaveable::getMostRecentSaver(), Wizt::VObjectAge::operator()(), and Wizt::VSlot::ValueAge().

touch()

Ageable & MemCore::Ageable::touch ( )

inlinenoexcept

Mark the current object as being modified "now".

The global time counter is increased by this operation.

Referenced by Wizt::VSlot::assignParameter(), MemCore::Creator< RefType, MyCreatorBase >::Creator(), Wizt::VishSaver::Save(), Wizt::VRenderContext::setLightSources(), and MemCore::Attributes::touchAttributes().