Method GetNextDecisionNode

src/order_cmd.cpp:327–352

* Get the next order which will make the given vehicle stop at a station * or refit at a depot or evaluate a non-trivial condition. * @param next The order to start looking at. * @param hops The number of orders we have already looked at. * @return Either of * \li a station order * \li a refitting depot order * \li a non-trivial conditional order * \li INVAL

 *         \li INVALID_VEH_ORDER_ID if the vehicle won't stop anymore.
 */
VehicleOrderID OrderList::GetNextDecisionNode(VehicleOrderID next, uint hops) const
{
	if (hops > this->GetNumOrders() || next >= this->GetNumOrders()) return INVALID_VEH_ORDER_ID;

	const Order &order_next = this->orders[next];
	if (order_next.IsType(OT_CONDITIONAL)) {
		if (order_next.GetConditionVariable() != OrderConditionVariable::Unconditionally) return next;

		/* We can evaluate trivial conditions right away. They're conceptually
		 * the same as regular order progression. */
		return this->GetNextDecisionNode(
				order_next.GetConditionSkipToOrder(),
				hops + 1);
	}

	if (order_next.IsType(OT_GOTO_DEPOT)) {
		if (order_next.GetDepotActionType().Test(OrderDepotActionFlag::Halt)) return INVALID_VEH_ORDER_ID;
		if (order_next.IsRefit()) return next;
	}

	if (!order_next.CanLoadOrUnload()) {
		return this->GetNextDecisionNode(this->GetNext(next), hops + 1);
	}

	return next;
}

/**
 * Recursively determine the next deterministic station to stop at.