history_func.hpp

Go to the documentation of this file.

/*
 * This file is part of OpenTTD.
 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef HISTORY_FUNC_HPP
#define HISTORY_FUNC_HPP
 
#include "../core/bitmath_func.hpp"
#include "../core/math_func.hpp"
#include "../timer/timer_game_economy.h"
#include "history_type.hpp"
 
void UpdateValidHistory(ValidHistoryMask &valid_history, const HistoryRange &hr, uint cur_month);
bool IsValidHistory(ValidHistoryMask valid_history, const HistoryRange &hr, uint age);
 
template <typename T>
T SumHistory(typename std::span<const T> history);
 
template <typename T>
void RotateHistory(HistoryData<T> &history, ValidHistoryMask valid_history, const HistoryRange &hr, uint cur_month)
{
  if (hr.hr != nullptr) RotateHistory(history, valid_history, *hr.hr, cur_month);
  if (cur_month % hr.total_division != 0) return;
 
  std::move_backward(std::next(std::begin(history), hr.first), std::next(std::begin(history), hr.last - 1), std::next(std::begin(history), hr.last));
 
  if (hr.total_division == 1) {
    history[hr.first] = history[hr.first - 1];
    history.front() = {};
  } else if (HasBit(valid_history, hr.first - hr.division)) {
    auto first = std::next(std::begin(history), hr.first - hr.division);
    auto last = std::next(first, hr.division);
    history[hr.first] = SumHistory<T>(std::span{first, last});
  }
}
 
template <typename T, typename Taccrued>
T GetAndResetAccumulatedAverage(Taccrued &total)
{
  T result = ClampTo<T>(total / std::max(1U, TimerGameEconomy::days_since_last_month));
  total = 0;
  return result;
}
 
template <typename T>
bool GetHistory(const HistoryData<T> &history, ValidHistoryMask valid_history, const HistoryRange &hr, uint age, T &result)
{
  if (hr.hr == nullptr) {
    if (age < hr.periods) {
      uint slot = hr.first + age;
      result = history[slot];
      return HasBit(valid_history, slot);
    }
  } else {
    if (age * hr.division < static_cast<uint>(hr.hr->periods - hr.division)) {
      bool is_valid = false;
      std::array<T, HISTORY_MAX_DIVISION> tmp_result; // No need to clear as we fill every element we use.
      uint start = age * hr.division + ((TimerGameEconomy::month / hr.hr->division) % hr.division);
      for (auto i = start; i != start + hr.division; ++i) {
        is_valid |= GetHistory(history, valid_history, *hr.hr, i, tmp_result[i - start]);
      }
      result = SumHistory<T>(std::span{std::begin(tmp_result), hr.division});
      return is_valid;
    }
    if (age < hr.periods) {
      uint slot = hr.first + age - ((hr.hr->periods / hr.division) - 1);
      result = history[slot];
      return HasBit(valid_history, slot);
    }
  }
  NOT_REACHED();
}
 
template <uint N, typename T, typename... Tfillers>
void FillFromHistory(const HistoryData<T> &history, ValidHistoryMask valid_history, const HistoryRange &hr, Tfillers &&... fillers)
{
  T result{};
  for (uint i = 0; i != N; ++i) {
    if (GetHistory(history, valid_history, hr, N - i - 1, result)) {
      (fillers.Fill(i, result), ...);
    } else {
      (fillers.MakeInvalid(i), ...);
    }
  }
}
 
template <uint N, typename T, typename... Tfillers>
void FillFromHistory(const HistoryData<T> *history, ValidHistoryMask valid_history, const HistoryRange &hr, Tfillers &&... fillers)
{
  if (history != nullptr) {
    FillFromHistory<N>(*history, valid_history, hr, std::forward<Tfillers &&>(fillers)...);
    return;
  }
 
  /* History isn't present, fill zero or invalid instead. */
  for (uint i = 0; i != N; ++i) {
    if (IsValidHistory(valid_history, hr, N - i - 1)) {
      (fillers.MakeZero(i), ...);
    } else {
      (fillers.MakeInvalid(i), ...);
    }
  }
}
 
#endif /* HISTORY_FUNC_HPP */