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.
When used with VB, the callback function has the prototype:
Public Function mycbfunc (ByVal prob As Long, ByVal object As Long) As Long

Related topics
XSLPsetcbiterstart, XSLPsetcbitervar, XSLPsetcbitervarF


If you have any comments or suggestions about these pages, please send mail to docs@dashoptimization.com.