manager/program.h

   1 #ifndef PROGRAM_H
   2 #define PROGRAM_H
   3
   4 #include "thread_util.h"
   5
   6 #include <string>
   7
   8 /**
   9  * A wrapping class for an external program, which can exchange messages with the current process through stdin/stdout
  10  * Useful for attaching control of an operation to an external process - for example, AI for a game
  11  */
  12 class Program
  13 {
  14         public:
  15                 Program(const char * executeablePath); //Constructor
  16                 virtual ~Program(); //Destructor
  17
  18
  19
  20
  21                 bool SendMessage(const char * print, ...); //Sends a formated message (NOTE: Prints a newline)
  22                 bool SendMessage(const std::string & buffer) {return SendMessage(buffer.c_str());} //Sends a C++ string message
  23                 bool GetMessage(std::string & buffer, double timeout=-1); //Retrieves a message, or waits for a timeout (if positive)
  24
  25                 bool Running() const;
  26
  27
  28
  29         protected:
  30                 FILE * input;   //Stream used for sending information TO the process
  31                 FILE * output; //Stream used for retrieving information FROM the process
  32
  33         private:
  34                 pid_t pid; //Process ID of the program wrapped
  35
  36 };
  37
  38 #endif //PROGRAM_H
  39
  40