[Previous] [Next]

XPRBnewprob

Purpose

Initialize a new problem.

Synopsis

XPRBprob XPRBnewprob(const char *probname);  

Argument

probname  

The problem name. May be NULL if not required.

Return value

Reference to a problem definition in BCL if function executed successfully, NULL otherwise.

Example

This example begins the definition of a new problem with the name example2.

XPRBprob expl2;
expl2 = XPRBnewprob("example2");

Further information

1. This function needs to be called to create and initialize a new problem. This function initializes BCL and also Xpress-Optimizer; it is not necessary to call XPRSinit from the user's program. If the initialization does not find a valid license, BCL does not initialize. 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. The name given to a problem determines the name and the location of the working files of Xpress-Optimizer. At the creation of a problem any existing working files of the same name are deleted. When solving several instances of a problem simultaneously the user must make sure to assign a different name to every instance. If no problem name is indicated, BCL creates a unique name including the full path to the temporary directory (Xpress-Optimizer creates its working files in the temporary directory).