state.hpp

Go to the documentation of this file.

// Copyright (C) 2023 Miguel Ángel González Santamarta
//
// This program 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 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
#ifndef YASMIN__STATE_HPP_
#define YASMIN__STATE_HPP_
 
#include <atomic>
#include <string>
 
#include "yasmin/blackboard.hpp"
#include "yasmin/logs.hpp"
 
namespace yasmin {

enum class StateStatus {
  IDLE,     
  RUNNING,  
  CANCELED, 
  COMPLETED 
};

class State {
 
protected:
  Outcomes outcomes;
 
private:
  std::atomic<StateStatus> status{StateStatus::IDLE};

  void set_status(StateStatus new_status);

  StateStatus get_status() const;
 
public:
  YASMIN_PTR_ALIASES(State)
 
  
  State(const Outcomes &outcomes);

  virtual ~State() = default;

  bool is_idle() const noexcept;

  bool is_running() const noexcept;

  bool is_canceled() const noexcept;

  bool is_completed() const noexcept;

  std::string operator()(Blackboard::SharedPtr blackboard);

  virtual std::string execute(Blackboard::SharedPtr blackboard) {
    (void)blackboard; // Suppress unused parameter warning
    return "";
  }

  virtual void cancel_state() {
    YASMIN_LOG_INFO("Canceling state '%s'", this->to_string().c_str());
    this->set_status(StateStatus::CANCELED);
  }

  Outcomes const &get_outcomes() const noexcept;

  virtual std::string to_string() const;
};
 
} // namespace yasmin
 
#endif // YASMIN__STATE_HPP_