XPRBinit
XPRBinit |
Purpose
Synopsis
int XPRBinit(void);
Return value
|
0
|
function executed successfully,
|
|
1
|
an error has occurred,
|
|
32
|
BCL has been set running in Student mode.
|
Example
XPRBseterrctrl(0);
if(XPRBinit())
printf("BCL has not been initialized correctly.
Please check your Xpress licenses.");
This switches to user error handling and initializes BCL (or performs license test).
Further information
1. This function explicitly initializes BCL, that is it tests whether a
license for running this software is available. It is possible to run BCL with a student license; this mode implies restrictions to the available functionality and to the accepted problem size.
2. With BCL C, the initialization is also performed by function
XPRBnewprob
so that it is not required to call this explicit initialization, particularly for stand-alone model runs. This function may be used if the embedding of BCL into some larger application requires a test of the license at an earlier stage, before even creating any model.
3. In applications that create a large number of problems it is recommended to use the explicit initialization—once only per process for highest efficiency.
4. Note that this function also initializes Xpress Optimizer, so that it is usually not necessary to call
XPRSinit separately (the latter is only required if one wishes to continue using the optimizer after terminating BCL).
Related topics