ResultsFunction.java

package aima.core.search.nondeterministic;

import aima.core.agent.Action;
import java.util.Set;

/**
 * Artificial Intelligence A Modern Approach (3rd Edition): page 136.<br>
 * <br>
 * Closely related to ResultFunction, but for non-deterministic problems; in
 * these problems, the outcome of an action will be a set of results, not a
 * single result. This class implements the functionality of RESULTS(s, a), page
 * 136, returning the states resulting from doing action a in state s.
 * 
 * @author Andrew Brown
 */
public interface ResultsFunction {

	/**
	 * Returns the states that result from doing action a in state s
	 * 
	 * @param s
	 *            a particular state.
	 * @param a
	 *            an action to be performed in state s.
	 * @return the states that result from doing action a in state s.
	 */
	Set<Object> results(Object s, Action a);
}