source: molecuilder/src/Actions/Calculation.hpp@ 78b9d9

/*
 * Calculation.hpp
 *
 *  Created on: Feb 19, 2010
 *      Author: crueger
 */

#ifndef CALCULATION_HPP_
#define CALCULATION_HPP_

#include "Actions/Process.hpp"

/**
 * A calculation is a Process that has some kind of result.
 *
 * This class can be used in the same way as any other Action or Process, but has some special methods
 * for inspecting the result of the calculation.
 */
template<typename T>
class Calculation : public Process
{
public:
  Calculation(int _maxSteps, std::string _name, bool _doRegister=true);
  virtual ~Calculation();

  /**
   * Reimplemented call method for Action Base class.
   * Resets the result and then redoes the calculation. Can be used to retrigger calculations
   * from menu Items or other places.
   */
  virtual void call();
  virtual void undo();
  virtual bool canUndo();

  /**
   * Does the actual calculation and returns the result.
   * When the calculation has been done before it is not redone, but the previous cached result is returned.
   * Call reset to delete the cached value.
   */
  virtual T operator()();

  /**
   * Check if a cached result is available.
   */
  virtual bool hasResult();

  /**
   * Get the cached result.
   * Fails if there is no cached result.
   */
  virtual T getResult();

  /**
   * Delete a previously calculated result from the cache.
   */
  virtual void reset();

protected:
  T* result;

  /**
   * Pure virtual method for implementation of the actual calculation procedure.
   */
  virtual T* doCalc()=0;
private:
  bool done;
};

#endif /* CALCULATION_HPP_ */