ValueTuple の利用時の注意点と対処方法例

はじめに

　C# 7 以降、複数の値を返したい場面ではタプル (Tuple)が広く使われるようになりました。
ただし、現在の C# で「タプル」と言うと、実際には旧来の System.Tuple クラスではなく、構造体の System.ValueTuple を指します。

　Unity など IL2CPP を用いた環境では、この ValueTuple 構造体の扱い方によっては、思わぬ「無限ループ」や「フリーズ」が発生するケースがあります。

　この記事では、実際に遭遇した現象をもとに、ValueTuple の利用時の注意点、安全な使い方と回避策を紹介します。

Tuple と ValueTuple の違い

型	名前空間	型の種類	記法	特徴
System.Tuple<T1, T2>	System	クラス	Tuple.Create(1, "A")	参照型。Immutable。フィールド名は Item1, Item2
System.ValueTuple<T1, T2>	System	構造体	(1, "A")	値型。軽量で高速。C# 7以降の標準記法

　つまり、現在よく使う (int, string) のようなタプルは、ValueTuple 構造体です。

参考サイト

MicroSoft 公式リファレンス
ValueTuple 構造体
https://learn.microsoft.com/ja-jp/dotnet/api/syste...

複数回の戻り値での問題例

　メソッドの戻り値にタプルを利用した場合に発生する問題です。

// メソッドの戻り値にも注意
public static List<(int, int)> GetRewardList(int count) {
    List<(int, int)> list = new();
    for (int i = 0; i < count; i++) {        
        list.Add(GetReward());  // ←　①Unity IL2CPP 環境下ではここで停止することがある
    }
    return list; // ← ②ここでも停止・フリーズの可能性あり
}

// 複数回呼び出される ValueTuple の戻り値
public static (int itemId, int count) GetReward() {
    return (1001, 5);
}

　ValueTuple 構造体を複数回 return して積み上げる形や、List のようなジェネリック構造が、IL2CPP ビルドや Unity Editor 実行環境で不安定になることがあります。

　これは for 文や List を利用していないケースでも、メソッドの戻り値を複数回利用するケースでも発生することがあります。
例えば HogeA メソッド(戻り値がタプル)→ HogeB メソッド(戻り値がタプル)→HogeC メソッド(戻り値がタプル) のような、再帰的な処理の場合です。

対策①：クラスを定義して戻す

　メソッドの戻り値にタプルを利用せず、下記のように戻り値用にクラスを用意し、それをインスタンスして戻すことで問題を回避できます。
クラスは参照型なので、IL2CPPでも安全に扱えます。

/// <summary>
/// 戻り値用のクラス
/// </summary>
[Sysytem.Serialize]
public class GachaReward {
    public int itemId;
    public int count;
}

// 戻り値もタプルの List ではなくてクラスの List に変える
public static List<GachaReward> GetRewardList(int count) {
    List<GachaReward> list = new();
    for (int i = 0; i < count; i++) {
        list.Add(GetReward());
    }
    return list;
}

// 戻り値をクラスに変える
public static GachaReward GetReward() {
    return new GachaReward { itemId = 1001, count = 5 };
}

　このようにメソッドの戻り値をクラス（参照型）にすると IL2CPP の構造体コピーを避けられ、安定して動作します。

対策②：ValueTupleを使うなら「単発」までにする

　複数回の戻り値を経由しない場合や、List<(int,int)> や Dictionary<T, (int, int)> のようなネスト構造は避ければ、タプルも問題なく利用できます。

// 単発のValueTupleは安全
public static (int itemId, int count) GetSingleReward() {
    return (1001, 5);
}

LINQ 変換 (Select → ToList) での問題例

　特定条件下（ジェネリック＋LINQ＋一部最適化）でメモリアクセス不整合を起こすことがあります。

List<GachaReward> rewards = GetRewardList(10);

// Unity で無限ループ／フリーズすることがある
List<(int itemId, int count)> tupleList = rewards.Select(r => (r.itemId, r.count)).ToList();

　この .Select(...).ToList() は内部的にイテレータクラス（MoveNext() を持つ匿名構造体）を生成し、その中で大量の ValueTuple コピーを発生させます。
そのため、IL2CPP の最適化との組み合わせ次第で、「無限ループ」「Unity Editor ごとフリーズ」になることがあります。

回避法：明示的にループで変換する

　下記の方法なら、中間イテレータを生成せず、単純なループ＋構造体生成だけで済むため、安全で安定します。

List<GachaReward> rewards = GetRewardList(10);

List<(int itemId, int count)> tupleList = new();

for (int i = 0; i < rewards.Count; i++) {
    var reward = rewards[i];   // var は GachaReward 型
    tupleList.Add((reward.itemId, reward.count));  // ここでタプルとして追加
}

原因の整理

　この現象の原因ですが、List<(int, int)> は List<ValueTuple<int,int>> と同義であり、構造体のリストを返すため、戻り値時に構造体配列のコピーが行われます。
それがネストしたメソッド呼び出しや、ジェネリック経由（List<T>）になると、IL2CPP の構造体メモリ配置最適化が破綻してしまう？ようです。

　C#（Mono）上では問題ないですが、IL2CPP や Burst コンパイラ環境だと「スタックの整合性が崩壊 → 実行停止」になります。

　この問題は Unity 2021～2022、6000 以降でも依然として発生例があります。
特に非同期処理 (async/await, UniTask) や LINQ と併用した ValueTuple の場合に顕著です。

結論

　ValueTuple は軽量で便利ですが、Unity では構造体コピーに注意をしましょう。
LINQ やネストされた return で使うと、IL2CPP が落ちることがありますので、必要に応じてクラスに置き換えるのが安全な対処方法になります。

　以上です。

このページを編集するこのページを元に新規ページを作成

印刷する

コメント（0）

ValueTuple の利用時の注意点と対処方法例 - i-school 先頭へ

コメントをかく

名前	ユーザIDを使用しないで書き込む	ユーザーIDを使う	ログインする
画像コード	画像に記載されている文字を下のフォームに入力してください。
備考	「http://」を含む投稿は禁止されています。
本文
利用規約をご確認のうえご記入下さい

i-school