live_cells::previous_value_cell_state< C > Class Template Reference

Maintains the state of a previous_value_cell. More...

#include <previous_value_cell.hpp>

Inheritance diagram for live_cells::previous_value_cell_state< C >:

Collaboration diagram for live_cells::previous_value_cell_state< C >:

Public Member Functions
	previous_value_cell_state (key_ref k, C cell)
	Create a previous_value_cell state.
value_type	value ()
	Get the stored previous value.
Public Member Functions inherited from live_cells::cell_state
	cell_state (key_ref k)
	Create a cell state with a given key.
cell_state &	operator= (const cell_state &other)=delete
virtual void	add_observer (observer::ref o)
	Add an observer to the cell's set of observers.
virtual void	remove_observer (observer::ref o)
	Remove an observer from the cell's set of observers.
virtual void	notify_will_update ()
	Notify the observers that the cell's value will change.
virtual void	notify_update (bool did_change=true)
	Notify the observers that the cell's value has changed.

Protected Member Functions
void	init () override
	Called before the first observer is added.
void	pause () override
	Called after the last observer is removed.
void	will_update (const key_ref &k) override
	Notifies this observer that the value of the Cell identified by k is going to change.
void	update (const key_ref &k, bool changed) override
	Notifies this observer that the value of the Cell identified by k has changed.
Protected Member Functions inherited from live_cells::cell_state
bool	is_active () const
	Does the cell have at least one observer?
Protected Member Functions inherited from live_cells::observer_cell_state
void	init_observer_state ()
	Initialize the cell observation state.
void	pause_observer_state ()
	Pause the cell observation state.
void	handle_will_update (const std::invocable auto &notify_will_update)
	Handle a observer::will_update call.
void	handle_will_update (const std::invocable auto &pre_update, const std::invocable auto &notify_will_update)
	Handle a observer::will_update call.
void	handle_update (bool changed, const std::invocable< bool > auto &notify_update)
	Handle an observer::update call.
void	handle_update (bool changed, const std::invocable auto &did_change, const std::invocable< bool > auto &notify_update, const std::invocable auto &post_update)
	Handle an observer::update call.

Additional Inherited Members
Public Types inherited from live_cells::cell_state
typedef std::shared_ptr< cell_state >	ref
	Shared pointer to a cell_state.
Public Types inherited from live_cells::observer
typedef std::shared_ptr< observer >	ref
	Shared pointer to an observer.
Protected Attributes inherited from live_cells::cell_state
key_ref	key_
	Key identifying the cell corresponding to this state.
std::unordered_map< observer::ref, std::size_t >	observers
	The set of observers observing changes to the values in the cell corresponding to this state.
Protected Attributes inherited from live_cells::observer_cell_state
bool	stale = true
	Does the value have to be recomputed?
bool	updating = false
	Are the argument cells in the process of updating their values?

Detailed Description

template<Cell C>
class live_cells::previous_value_cell_state< C >

Maintains the state of a previous_value_cell.

Constructor & Destructor Documentation

previous_value_cell_state()

template<Cell C>

live_cells::previous_value_cell_state< C >::previous_value_cell_state ( key_ref k, C cell )

inline

Create a previous_value_cell state.

Parameters

k	Key identifying the cell
cell	The argument cell

Member Function Documentation

init()

template<Cell C>

void live_cells::previous_value_cell_state< C >::init ( )

inlineoverrideprotectedvirtual

Called before the first observer is added.

Subclasses should override this method to include initialization logic specific to this cell state.

Note

If the state needs to set up observers to other cells, it should be done in this method.

Reimplemented from live_cells::cell_state.

pause()

template<Cell C>

void live_cells::previous_value_cell_state< C >::pause ( )

inlineoverrideprotectedvirtual

Called after the last observer is removed.

Subclasses should override this method to include cleanup logic specific to this cell state.

Note

Observers added in init() should be removed in this method.

Reimplemented from live_cells::cell_state.

update()

template<Cell C>

void live_cells::previous_value_cell_state< C >::update ( const key_ref & k, bool did_change )

inlineoverrideprotectedvirtual

Notifies this observer that the value of the Cell identified by k has changed.

Parameters

k	identifying observable
did_change	true if the value of the cell may have changed, false if it is know that it hasn't changed.

Implements live_cells::observer.

value()

template<Cell C>

value_type live_cells::previous_value_cell_state< C >::value ( )

inline

Get the stored previous value.

Returns

The previous value

will_update()

template<Cell C>

void live_cells::previous_value_cell_state< C >::will_update ( const key_ref & k )

inlineoverrideprotectedvirtual

Notifies this observer that the value of the Cell identified by k is going to change.

Parameters

k	identifying observable

Implements live_cells::observer.

---

The documentation for this class was generated from the following file:

• src/previous_value_cell.hpp