This function creates and returns a goal that limits the exploration of the search tree defined by goal in the way directed by searchLimit. All nodes explored after that limit has been met are discarded.

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 it returns as an instance of IlcGoal for use during a Solver search.

IBM® ILOG® Solver offers predefined search limits, instances of the class IloSearchLimit, such as the return value of the function IloFailLimit, IloOrLimit, and IloTimeLimit.