Initializing help system before first use

XPRS_bo_getlasterror

XPRS_bo_getlasterror


Purpose
Returns the last error encountered during a call to the given branch object.
Synopsis
int XPRS_CC XPRS_bo_getlasterror(XPRSbranchobject obranch, int* iMsgCode, char* _msg, int _iStringBufferBytes, int* _iBytesInInternalString);
Arguments
obranch 
The branch object.
iMsgCode 
Location where the error code will be returned. Can be NULL if not required.
_msg 
A character buffer of size iStringBufferBytes in which the last error message relating to the given branching object will be returned.
iStringBufferBytes 
The size of the character buffer _msg.
_iBytesInInternalString 
The size of the required character buffer to fully return the error string.
Example
The following shows how this function might be used in error checking:
XPRSbranchobject obranch;
...
char* cbuf;
int cbuflen;
if (XPRS_bo_setpreferredbranch(obranch,3)) {
  XPRS_bo_getlasterror(obranch,NULL,NULL,0,&cbuflen);
  cbuf = malloc(cbuflen);
  XPRS_bo_getlasterror(obranch,NULL, cbuf, cbuflen, NULL);
  printf("ERROR when setting preferred branch: %s\n", cbuf);
}
Related topics