Initializing help system before first use

XSLPsetcbiterend

XSLPsetcbiterend


Purpose
Set a user callback to be called at the end of each SLP iteration
Synopsis
int XPRS_CC XSLPsetcbiterend(XSLPprob Prob, int (XPRS_CC *UserFunc) (XSLPprob myProb, void *myObject), void *Object);
Arguments
Prob 
The current SLP problem.
UserFunc 
The function to be called at the end of each SLP iteration. UserFunc returns an integer value. If the return value is nonzero, the SLP iterations will stop.
myProb 
The problem passed to the callback function.
myObject 
The user-defined object passed as Object to XSLPsetcbiterend.
Object 
Address of a user-defined object, which can be used for any purpose by the function. Object is passed to UserFunc as myObject.
Example
The following example sets up a callback to be executed at the end of each SLP iteration. It records the number of LP iterations in the latest optimization and stops if there were fewer than 10:
XSLPsetcbiterend(Prob, CBIterEnd, NULL);
A suitable callback function might resemble this:
int XPRS_CC CBIterEnd(XSLPprob MyProb, void *Obj) {
  int nIter;
  XPRSprob xprob;
  XSLPgetptrattrib(MyProb, XSLP_XPRSPROBLEM, &xprob);
  XSLPgetintattrib(xprob, XPRS_SIMPLEXITER, &nIter);
  if (nIter < 10) return 1;
  return 0;
}
The Object argument is not used here, and so is passed as NULL.
Further information
This callback can be used at the end of each SLP iteration to carry out any further processing and/or stop any further SLP iterations.
Related topics