matlab::cpplib::runMain

Execute a function with its input arguments within the main function

Description

int runMain(std::function<int(std::shared_ptr<MatlabApplication> func, int, const char**)>std::shared_ptr<MatlabApplication>&& app, int argc, const char **argv);

Execute a function with its input arguments within the main function. matlab.cpplib.runMain accepts as input the function you want to execute, an instance of MATLABApplication, and the inputs to the function you want to execute. It returns as output a code indicating the success or failure of execution.

This function can be used on any platform to separate the logic of the primary function from that of main(). On macOS, it also fulfills the requirements of the Cocoa API

Parameters

`std::function<int(std::shared_ptr<MATLABApplication>, int, const char**)> func`	A `std::function` instance that takes three parameters (namely, a pointer to a `MATLABApplication` object, an `int` representing the number of input arguments, and a `const char**` representing the input arguments themselves) and returns an `int`.
`std::shared_ptr<MATLABApplication>&& app`	Instance of `MATLABApplication`, passed as `rvalue`.
`int argc`	Number of input arguments from the command line.
`const char **argv`	Input arguments array.

Return Value

int

Return code indicating success (by convention: 0), or failure (by convention, a non-zero number).

Examples

Move the `MATLABApplication` Object into `runMain` and Terminate It

int myMainFunc(std::shared_ptr<mc::MATLABApplication> app,
    const int argc, const char * argv[])
  {
     try {
        // initialize library, call feval, etc.
     } catch(const std::exception & exc) {
        std::cerr << exc.what() << std::endl;
        return -1;
     }
     return 0; // no error
  }

  int main(const int argc, const char * argv[])
  {
      std::vector<std::u16string> options  ; 
      auto matlabApplication = mc::initMATLABApplication(
            mc::MATLABApplicationMode::IN_PROCESS,options);
      return mc::runMain(myMainFunc, std::move(matlabApplication), argc, argv);
  }

Version History

Introduced in R2018a