This function creates and returns a search limit that limits the exploration of the search tree during the search for a solution by stopping the search when a given number of failures (maxNbFails) have occurred. A fail limit is useful in a goal, such as the one returned by the function IloLimitSearch or other instances of IloGoal, to control the exploration of the search tree.

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