This function creates and returns a goal, using the criterion indicated by choose and the selector indicated by select. This goal is part of the enumeration algorithm available in an instance of IloSolver. It enables you to set parameters for choosing the order in which variables are tried during the search for a solution.

This goal binds each constrained variable in its argument vars. It does so by calling the function IloInstantiate for each of them. You control the order in which the variables are bound by means of the criterion choose.

The goal returned by this function differs from the one returned by IloBestGenerate: IloBestGenerate calls IloBestInstantiate, which tries only one value for each variable, whereas this one calls IloInstantiate, which may try all the values in the domain of each variable.

When it takes an instance of the class IloEnv as a parameter, it returns an instance of IloGoal for use with the member functions IloSolver::startNewSearch and IloSolver::solve. An instance of IloSolver extracts the goal that this function returns as an instance of IlcGoal for use during a Solver search.

This function works on numerical variables of type Float and type Int.