【UE5】ソートのフリーレン。散らかったカードを「整列する魔法（C++）」で片付ける（実装編その1）【開発38日目】

こんにちは、「まる。」です。
昨日は更新をお休みし、一日ゆっくりと過ごさせていただきました。

おかげでしっかりと気分転換ができたので、
これから挑む「ソート機能の実装」という難関も、
今のコンディションならどうにか乗り越えられそうです！

それでは、リフレッシュした頭で今日も張り切って実装を進めていきましょう！

▼前回の記事

▼今回のサムネイル

1.やることのおさらい

さて、一日リフレッシュしたので、まずは頭の体操も兼ねて「やること」のおさらいから始めます。
前回の記事を振り返ると、実装すべき機能は大きく以下の3つでした。

実装方針の整理
これらのロジックも、前回のフィルタ機能と同様に「C++で重い処理（並び替え）を行い、BPで表示だけ行う」という必勝パターンで攻めます。

いきなりコードを書き始める前に、具体的な実装ステップを整理しておきましょう。

2.実装ステップの整理

それぞれの機能を細分化し、何が必要でどこから着手すべきか整理します。
（※Gemini先生から実装のヒントはもらっていますが、そのまま写経するだけでは応用が利かなくなるので、まずは自分の頭で設計を考えます）

その上で、私の考えと先生の提案をすり合わせて
具体的な実装方法を詰めていこうと思います。

・単一選択の並び替えについて

🤔まる。の考え

このあたり、どうするのがベストなのでしょうか？ Gemini先生！

👨‍🏫 Gemini先生としての回答

あー、そうか。コレクションメニュー以外で使いまわす可能性もあるのか。

Gemini先生の指摘でハッとしました。
確かに、この「カードを並び替える」という機能、
言われてみれば「ショップ画面」や「デッキ編成画面」でも絶対に欲しくなる機能です。
そうなると、コレクション画面専用の場所に書いてしまうのは後々不便になりそうです。

🤔まる。の追加意見

👨‍🏫 Gemini先生の回答

よし、一旦これで行きましょう。
※正直、今回のコレクション機能は他UIでもそのまま使えそうなので流用する気満々なんですが（笑）、
今後の設計次第でどうなるか分からないので、念のため拡張性のある実装にしておきます。

・リストの再取得とソートについて

🤔まる。の考え

これについては、Gemini先生はどう思いますか？

👨‍🏫 Gemini先生の回答

OKです。
実際どういう風にコードを書いてもらうかはGemini先生にお任せしますが、
とりあえず考え方としては問題なさそうです。

【追加要件】昇順・降順について

🤔まる。の考え

Gemini先生、何か良い案はありますか？

👨‍🏫 Gemini先生の回答

全体の流れとしては問題なさそうですね。
もしかしたら、もっと効率的なアプローチもあるかと思いますが一旦、
私がイメージした流れでの実装を試みます。

3.実装フェーズ

準備が整ったので、いよいよ実装に入ります。
ここでは、先ほど整理した流れに沿ってロジックを組んでいきます。

以下の2つの機能を実装することが今回のゴールです。

1. 「昇順・降順」切り替えの検知
   ユーザーがUIでどちらを選んだか判定する。

2. 項目の確認とソート実行
   「名前順」「攻撃力順」など、選ばれた項目に合わせて並び替える。

STEP 1:ソート条件の定義（Enumの作成）

ソート機能を実装するには、
まず「ユーザーがどんな並び替えをしたいのか？」をC++側で判断できるようにする必要があります。

そこで、プログラム内で扱いやすいようにEnum（列挙型）を使って、
「並び順」と「項目」をあらかじめ定義しておきます。これが後々の判定処理の土台になります。

編集するファイル:AlcaStellaCardLibrary.h

クラス定義（class ...）よりも上の部分に、以下のコードを追加します。

// 昇順・降順を指定するEnum
UENUM(BlueprintType)
enum class ECardSortOrder : uint8
{
    Ascending  UMETA(DisplayName = "昇順 (小さい順)"),
    Descending UMETA(DisplayName = "降順 (大きい順)")
};

// ソートの基準項目（5項目）
UENUM(BlueprintType)
enum class ECardSortType : uint8
{
    ID          UMETA(DisplayName = "ID順"),
    Name        UMETA(DisplayName = "名前順"),
    Likability  UMETA(DisplayName = "好感度順"),
    ATK         UMETA(DisplayName = "ATK順"),
    DEF         UMETA(DisplayName = "DEF順")
};

STEP 2：ヘッダーファイル（.h）の関数更新

続いて、作成したEnumを関数で使えるようにします。
FilterCardsUnified 関数の引数に、先ほどの「ソート項目（SortType）」と「昇順・降順（SortOrder）」を追加します。

// 変更前
static TArray<UAlcaStellaCardDataCollection*> FilterCardsUnified(
    const TArray<UAlcaStellaCardDataCollection*>& InCardList,
    FString Keyword,
    int32 OwnedFilterType,
    const TArray<ECharacterClass>& SelectedClasses
);

// 変更後（末尾に SortOrder を追加）
static TArray<UAlcaStellaCardDataCollection*> FilterCardsUnified(
    const TArray<UAlcaStellaCardDataCollection*>& InCardList,
    FString Keyword,
    int32 OwnedFilterType,
    const TArray<ECharacterClass>& SelectedClasses,
    ECardSortType SortType,
    ECardSortOrder SortOrder
);

これで関数の定義が変わり、WBP上からこれらの情報を渡せる準備が整いました。

STEP 3：ソースファイル（.cpp）の実装を更新

いよいよ、実際の処理（ソートロジック）を書き加えます。

編集ファイル: AlcaStellaCardLibrary.cpp

FilterCardsUnified 関数を以下のように修正します。

1. 引数の追加: ヘッダーファイルと同様に、関数の定義行の末尾に SortType と SortOrder を加えます。

2. ソート処理の追加: return ResultArray; の直前に、ソート用のコードを挿入します。

// 関数の定義行（引数を追加）
TArray<UAlcaStellaCardDataCollection*> UAlcaStellaCardLibrary::FilterCardsUnified(
    const TArray<UAlcaStellaCardDataCollection*>& InCardList,
    FString Keyword,
    int32 OwnedFilterType,
    const TArray<ECharacterClass>& SelectedClasses, // ★STEP2に合わせて修正
    ECardSortType SortType,   // ★追加
    ECardSortOrder SortOrder  // ★追加
)
{
 // ...（既存のフィルタリング処理：ResultArrayを作っている部分）...
// ★★★ ここからソート処理を追加 ★★★
// ソート実行（ラムダ式を使用） 
// 配列の中身はポインタなので、引数 A, B もポインタとして受け取ります 

ResultArray.Sort([SortType, SortOrder](const UAlcaStellaCardDataCollection& ARef, const UAlcaStellaCardDataCollection& BRef) { 
    // ポインタとして安全に扱えるように整理 
    const UAlcaStellaCardDataCollection* A = &ARef;
    const UAlcaStellaCardDataCollection* B = &BRef;
    // 比較結果（AはBより手前に来るべきか？）
    bool bIsPrior = false;
    switch (SortType)
    {
    case ECardSortType::ID:
        if (SortOrder == ECardSortOrder::Ascending)
            bIsPrior = (A->CardId.ToString() < B->CardId.ToString());
        else
            bIsPrior = (A->CardId.ToString() > B->CardId.ToString());
        break;
    case ECardSortType::Name:
        // 文字列比較
        if (SortOrder == ECardSortOrder::Ascending)
            bIsPrior = (A->CardData.DisplayName.ToString() < B->CardData.DisplayName.ToString());
        else
            bIsPrior = (A->CardData.DisplayName.ToString() > B->CardData.DisplayName.ToString());
        break;
    case ECardSortType::ATK:
        {
            // データがない場合の安全策として0扱いにする
            int32 AtkA = A->CardData.BattleLevelStatValues.Contains(1) ? A->CardData.BattleLevelStatValues[1].ATK : 0;
            int32 AtkB = B->CardData.BattleLevelStatValues.Contains(1) ? B->CardData.BattleLevelStatValues[1].ATK : 0;
            
            if (SortOrder == ECardSortOrder::Ascending) 
                bIsPrior = (AtkA < AtkB);
            else 
                bIsPrior = (AtkA > AtkB);
        }
        break;
    case ECardSortType::DEF:
        {
            int32 DefA = A->CardData.BattleLevelStatValues.Contains(1) ? A->CardData.BattleLevelStatValues[1].DEF : 0;
            int32 DefB = B->CardData.BattleLevelStatValues.Contains(1) ? B->CardData.BattleLevelStatValues[1].DEF : 0;
            if (SortOrder == ECardSortOrder::Ascending) 
                bIsPrior = (DefA < DefB);
            else 
                bIsPrior = (DefA > DefB);
        }
        break;
    default:
        // デフォルトはID昇順
        bIsPrior = (A->CardId.ToString() < B->CardId.ToString()); 
        break;
    }
    return bIsPrior;
});
// ★★★ ここまで ★★★
return ResultArray;
}

・・・さぁ、頭が痛くなりそうなコードがやって来ました。
正直、読み飛ばしたいですがしっかりコードレビューします。

🤔コードレビュー

ぶっちゃけて言うと、過去イチ複雑なコードかもしれません。
ここで登場する「ラムダ式」という書き方…
…Unity（C#）を触っていた時に少し見た気もしますが、
正直全くと言っていいほど覚えていませんでした。

しかし、今回のソート機能はこのラムダ式がロジックの根幹になっています。
ここでしっかりと覚え直しておきましょう！

💡ラムダ式とは？

// 従来の関数定義
bool traditional_compare(int a, int b) {
    return a < b;
}
// 同じ機能をラムダ式で実装
auto lambda_compare = [](int a, int b) { return a < b; };

もっと分かりやすく、UnityなどでおなじみのC#と比較してみましょう。

// 普通の関数記法
private int Add(int x, int y)
{
    return x + y;
}

// ラムダ式の記法
(int x, int y) => { return x + y; };

こんな感じの理解であってますか？
Gemini先生。

🤖 Gemini先生からのコメント

良かった。合ってたみたいですね。
では、気を取り直して仕上げに入ります。

STEP 4：ビルドする

ここまで来れば、C++側のコーディングは完了です！ あとはこのロジックをUE5のエディタ（WBP）側で使えるように、いつものビルド（コンパイル）を行います。

エラーが出ずに成功すれば、いよいよ仕上げのUI実装フェーズです。

まとめ

長くなりましたが、今日はここまで！

ぶっちゃけた話、ソート機能の実装がここまで複雑だとは思いませんでした……。
途中で何度も「あれ？ ロジックどうなってたっけ？」と迷子になりかけましたが、なんとか形になってきました。

次回こそはソート機能を完遂し、
残る「詳細表示」を作ってコレクションメニューを完成させます！

果たして、無事にメニュー画面が完成するのか？
ご期待ください！

今日のポラリスちゃん

公式サイトへの圧が強いぜ…!

もしこの記事が「参考になった」「開発の苦労が伝わった！」「続きが気になる！」と思ったら、
記事の下にある「スキ（ハートマーク）」を押していただけると嬉しいです！
皆様の応援こそが、毎日の開発と更新の何よりの励みになります。
最後までお読みいただき、ありがとうございました！
また次回の記事でお会いしましょう！

• #日記

• #毎日更新

• #カード

• #ゲーム制作

• #カードゲーム

• #ゲーム開発

• #個人開発

• #開発日誌

• #UE5

• #UnrealEngine

• #データテーブル

• #生成AI

• #Cプラプラ

• #HorizonNotes