【UE5】ユニークIDを作る方法

#include "Misc/Guid.h"

// GUIDを生成します.
FString GenerateUniqueId()
{
    FGuid NewGuid = FGuid::NewGuid();
    return NewGuid.ToString(); // 文字列形式で返す
}

// ■ユニークID生成.
// idは(0～281474976710655 [48bit]) indexは(0～65535 [16bit])
// |63------|15-----0|
// |生成回数|要素番号|
inline uint64 UNIQUE_MAKE_ID_U64( uint64 id, uint16 index ) { //!< ユニークIDを生成.
  return ( ((uint64)id << 0x10) | index );
}
inline uint64 UNIQUE_GET_ID_U64( uint64 uniqueId ) { //!< IDを取得.
  return ( uniqueId >> 0x10 );
}
inline uint16 UNIQUE_GET_INDEX( uint16 uniqueId ) { //!< INDEXを取得.
  return ( uniqueId & 0xffff );
}

/**
 * @brief タイマーイベントのハンドル.
 */
USTRUCT(BlueprintType)
struct FTimerEventHandle {
  GENERATED_BODY()

  uint64 Handle = 0;

  bool IsValid() const {
    // 0以外なら有効。ただしハンドルとして有効なだけでありオブジェクトの有効判定は別途必要.
    return Handle != 0;
  }
  void Clear() {
    // ハンドルをクリア.
    Handle = 0;
  }
  // 一致するかどうか.
  bool operator==(const FTimerEventHandle& Other) const {
    return Handle == Other.Handle; // ハンドルが一致するかどうかで判定.
  }
};

/**
 * @brief 時間管理.
 */
UCLASS()
class SV_API ACPP_GameTimer : public AActor
{
  GENERATED_BODY()
public:
  // ------------------------------------------------------- const(s).
  static constexpr int32 MAX_TIMER_EVENT = 256; // 最大タイマーイベント数.
  /**
   * @brief タイマーイベントの登録.
   * @return 生成に成功した場合はハンドルを返します.
   */
  const FTimerEventHandle& RegisterTimerEvent(const FTimerEvent& TimerEvent);

  /**
   * @brief タイマーイベントの削除.
   * @param TimerEventHandle 削除するタイマーイベントのハンドル.
   * @param isSort 削除成功後にソートを実行するかどうか.
   * @return 削除に成功した場合はtrueを返します.
   */
  bool RemoveTimerEvent(const FTimerEventHandle& TimerEventHandle, bool isSort=true);

  /**
   * @brief タイマーイベントの有効判定.
   * @param Handle 判定するタイマーイベントのハンドル.
   * @return 有効な場合はtrueを返します.
   */
  bool IsValidTimerEvent(const FTimerEventHandle& TimerEventHandle);

private: // -------------------------------------------------------- function(s)

  /**
   * @brief タイマーイベントの検索.
   * @return 見つからなかった場合は無効なイベントを返します.
   */
  FTimerEvent& _SearchEvent(FTimerEventHandle Handle);

private: // -------------------------------------------------------- var(s)
  /**
   * @brief タイマーイベントリスト (固定長配列).
   */
  UPROPERTY()
  TArray<FTimerEvent> m_TimerEvents;

private: // --------------------------------------------------------- static var(s)
  // タイマーイベントハンドル用の通し番号.
  static uint64 s_UniqueId;
};

// タイマーイベントハンドル用の通し番号.
uint64 ACPP_GameTimer::s_UniqueId = 1; // 1始まりにすることで初期値0と重複することを防止.
// 無効なハンドル.
static const FTimerEventHandle s_InvalidHandle = {};

/**
 * @brief タイマーイベントの登録.
 */
const FTimerEventHandle& ACPP_GameTimer::RegisterTimerEvent(const FTimerEvent& TimerEvent)
{
  // 要素に空きがあるかどうか.
  for(int index = 0; auto& LEvent : m_TimerEvents) {
    if(LEvent.Handle.IsValid()) {
      // 使用中.
      // ※C++20の残念仕様のためここでインクリメントが必要...
      index++;
      continue;
    }

    // 空きがあったので、ここに登録します.
    LEvent = TimerEvent;

    // 現在時間を登録.
    LEvent.StartTime = m_CurrentTime;

    // ユニークIDを生成します.
    LEvent.Handle.Handle = UNIQUE_MAKE_ID_U64(++s_UniqueId, index);

    // ソート実行.
    _SortTimerEvents();

    // ハンドルを返します.
    return LEvent.Handle;
  }

  // 見つからなかったら無効なハンドルを返します.
  return s_InvalidHandle;
}

/**
  * @brief タイマーイベントの検索.
  * @return 見つからなかった場合は無効なイベントを返します.
  */
FTimerEvent& ACPP_GameTimer::_SearchEvent(FTimerEventHandle Handle)
{
  if(Handle.IsValid() == false) {
    // ハンドルが無効な場合は無効なイベントを返します.
    return s_InvalidEvent;
  }

  // ハンドルを検索します.
  int32 index = UNIQUE_GET_INDEX(Handle.Handle);
  if(index < 0 || index >= m_TimerEvents.Num()) {
    // 範囲外は無効.
    return s_InvalidEvent;
  }

  // ハンドルを取得します.
  auto& LEvent = m_TimerEvents[index];
  if(LEvent.Handle == Handle) {
    // ハンドルが一致したので、イベントを返します.
    return LEvent;
  }

  // ハンドルが無効な場合は無効なイベントを返します.
  return s_InvalidEvent;
}

// 無効なイベント.
static FTimerEvent s_InvalidEvent = {};

// イベントの開始.
void ACPP_GameTimer::BeginPlay()
{
	Super::BeginPlay();

	// あらかじめ配列の要素を確保しておきます.
	m_TimerEvents.Reserve(MAX_TIMER_EVENT);
	for(int i = 0; i < MAX_TIMER_EVENT; i++) {
		m_TimerEvents.Add(s_InvalidEvent); // 無効なイベントを登録.
	}
}