interpreter.h

Go to the documentation of this file.

 
#ifndef NSBACI_SERVICES_RUNTIME_INTERPRETER_H
#define NSBACI_SERVICES_RUNTIME_INTERPRETER_H
 
#include <functional>
#include <optional>
#include <string>
 
#include "baseResult.h"
#include "drawingTypes.h"
#include "program.h"
#include "thread.h"
 
struct InterpreterResult : nsbaci::BaseResult {
  InterpreterResult() : BaseResult() {}
  explicit InterpreterResult(std::vector<nsbaci::Error> errs)
      : BaseResult(std::move(errs)) {}
  explicit InterpreterResult(nsbaci::Error error)
      : BaseResult(std::move(error)) {}
 
  InterpreterResult(InterpreterResult&&) noexcept = default;
  InterpreterResult& operator=(InterpreterResult&&) noexcept = default;
 
  InterpreterResult(const InterpreterResult&) = default;
  InterpreterResult& operator=(const InterpreterResult&) = default;
 
  bool needsInput = false;  
  std::string inputPrompt;  
  std::string output;       
 
  // Concurrency control signals
  bool shouldBlock = false;           
  uint32_t blockingSemaphore = 0;     
  bool shouldYield = false;           
  bool cobeginStart = false;          
  bool coendWait = false;             
  int32_t expectedThreadCount = 0;    
  bool createThread = false;          
  uint32_t newThreadPC = 0;           
  bool signalSemaphore = false;       
  uint32_t signaledSemaphore = 0;     
};

namespace nsbaci::services::runtime {

using OutputCallback = std::function<void(const std::string&)>;

using InputRequestCallback = std::function<void(const std::string&)>;

using DrawingCallback = std::function<void(const nsbaci::types::DrawCommand&)>;

class Interpreter {
 public:
  Interpreter() = default;
  virtual ~Interpreter() = default;

  virtual InterpreterResult executeInstruction(Thread& t, Program& program) = 0;

  virtual void provideInput(const std::string& input) = 0;

  virtual bool isWaitingForInput() const = 0;

  virtual void setOutputCallback(OutputCallback callback) = 0;

  virtual void setDrawingCallback(DrawingCallback callback) = 0;

  virtual void reset() = 0;
};
 
}  // namespace nsbaci::services::runtime
 
#endif  // NSBACI_SERVICES_RUNTIME_INTERPRETER_H