CodeGym /コース /C# SELF /新しい機能 Span<T>

新しい機能 Span<T>

C# SELF
レベル 65, レッスン 3
使用可能

1. はじめに

ファイルから読み込んだバイトなど、大きなデータ配列があると想像してください。その一部を処理したい、文字列として一部分を読むか、メソッドにデータの区間を渡したい場合があります。従来のやり方では、そのバイトを新しい配列にコピーしていました — これは遅く、メモリを消費します。しかもそのような区間が何十・何百もあったら?

そこで登場するのがヒーロー、Span<T>。これは配列(または連続した任意のメモリ領域)に対するスライス(view)をデータをコピーせずに表す特殊な構造体です。重要なのは:Span<T> は新しいコレクションではなく、既存の配列への安全な「窓」だということです!

Span<T> の主な特徴と制約

  • Span<T> は構造体(値型)で、メモリ上の「窓」を表し要素をコピーしません。
  • 配列、配列の一部、stackalloc ブロック、特殊なメソッド経由の文字列メモリ、または unsafe コード内のメモリなど、連続したメモリ領域だけを参照します。
  • Span<T> はスタック上に存在します。クラスのフィールドに保持したり、async メソッドから直接返すことはできません。
  • 型安全を保証します:ポインタを手動で扱わなくてもメモリへアクセスできます(unsafe を使わない限り)。

C# 14 の新機能について簡単に

C# 14 はスライス操作を拡張します:便利な範囲演算子 .. と末尾インデックス ^1、配列やスライス向けの改善されたパターンマッチング、その他の「構文糖」的な改善が含まれます。これは後で詳しく見ます。

2. Span<T> の作り方

まずは単純な配列からスパンを作ってみます:

int[] numbers = { 10, 20, 30, 40, 50, 60 };
Span<int> midSpan = new Span<int>(numbers, 2, 3); // 3 番目の要素 (インデックス 2) から 3 要素を取る

今、midSpan は要素 30, 40, 50 を指しています — これはコピーではなく配列の「生きた」要素へのビューです。スパン経由でそれらを変更すれば元の配列も変わります。

midSpan[0] = 100;
Console.WriteLine(numbers[2]); // 100 と出力される

なぜ配列のスライスを直接使わないのか?

古典的な LINQ スライスは 新しい配列 を作成します:

int[] slice = numbers.Skip(2).Take(3).ToArray(); // <-- ここでコピーが作られる!

これは時間とメモリの無駄です。Span は余分なコピーの問題を解決し、数値以外にも使えます。

3. Span<T> を作るさらに多くの方法

既存の配列から

Span<int> mySpan = numbers; // 配列から Span への暗黙的変換

配列の一部

int[] numbers = {10, 20, 30, 40, 50, 60};
Span<int> part = numbers.AsSpan(1, 4); // インデックス 1 から 4 要素: {20, 30, 40, 50}

スタックメモリ (stackalloc)

Span<T> はスタック上に配列を確保することを可能にします:

Span<byte> buffer = stackalloc byte[128];
for (int i = 0; i < buffer.Length; i++)
    buffer[i] = (byte)i;

スタックメモリは高速で、メソッドを抜けると自動的に解放されます。ただしサイズは現実的に — スタックにメガバイト単位は置かないでください。

文字列と ReadOnlySpan<char>

.NET の文字列は不変なので、ReadOnlySpan<char> を使います:

string greeting = "Hello, C# world!";
ReadOnlySpan<char> span = greeting.AsSpan(7, 8);   // "C# world"
Console.WriteLine(span.ToString());                // C# world

4. 実例を組み立てよう

using System;

class Program
{
    static void Main()
    {
        int[] orderTotals = { 100, 200, 300, 400, 500, 600, 700 };
        Console.WriteLine("全注文履歴: ");
        foreach (int total in orderTotals)
            Console.Write(total + " ");
        Console.WriteLine();
        
        Console.WriteLine("インデックス 2〜4 の注文を表示 (インデックス 1-3):");
        Span<int> recentOrders = orderTotals.AsSpan(1, 3);
        foreach (int t in recentOrders)
            Console.Write(t + " ");
        Console.WriteLine();
        
        // Span 経由でデータを変更する
        recentOrders[1] = 999;
        Console.WriteLine("Span 経由で変更した後:");
        foreach (int total in orderTotals)
            Console.Write(total + " ");
        Console.WriteLine();
    }
}

スライス recentOrders は実際に配列を直接操作します — コピーではありません。

5. セキュリティ、パフォーマンス、チェック

  • メモリ利用の節約:余分なコピーがない。
  • 境界チェックが配列外アクセスを防ぐ。
  • JIT の最適化で非常に高速にアクセスできる(unsafe を使わなくても)。

メソッドとのやり取り

メソッドは Span<T> または ReadOnlySpan<T> を受け取れます。データを書き換えないなら ReadOnlySpan<T> を使いましょう。

static int Sum(Span<int> slice)
{
    int sum = 0;
    foreach (var item in slice)
        sum += item;
    return sum;
}

int[] data = { 1, 2, 3, 4, 5, 6, 7 };
Console.WriteLine(Sum(data.AsSpan(2, 3))); // 3+4+5=12

6. 範囲演算子 (range) の使い方

C# 8 以降、範囲演算子 .. と末尾インデックス ^ が利用でき、スライスと相性が良いです。

int[] arr = { 10, 20, 30, 40, 50, 60 };

Span<int> span = arr[2..5]; // インデックス 2,3,4 - つまり 30, 40, 50

範囲では開始インデックスは含み、終了インデックスは含みません。

末尾インデックス

int lastElement = arr[^1];     // 最後の要素 (60)
Span<int> lastTwo = arr[^2..]; // 最後の 2 要素 (50, 60)

範囲と文字列

string code = "SpanMagic!";
var mid = code[4..9]; // "Magic"

このスライスは ReadOnlySpan<char> です;文字列を得たいなら ToString() を呼んでください。

7. スライスに対するモダンなパターン (C# 14)

新しいパターンは配列やスライスの分解を簡単にします。

if (arr is [10, 20, .. var rest]) // .. は配列の "尾" をキャプチャする
{
    Console.WriteLine("先頭が一致しました、尾:");
    foreach (var x in rest)
        Console.WriteLine(x);
}
if (arr is [.., 50, 60])
    Console.WriteLine("配列は 50, 60 で終わる");

比較: 配列、ArraySegment、Span

型 ミューテーブル データをコピーするか? スタック上に置けるか クラス/構造体 クラスのフィールドにできるか
T[]
はい - いいえ クラス はい
ArraySegment<T>
はい いいえ いいえ 構造体 はい
Span<T>
はい いいえ はい 構造体 いいえ
ReadOnlySpan<T>
いいえ いいえ はい 構造体 いいえ

つまり、Span<T> は ArraySegment<T> の進化形で、より高速で安全です。

8. 典型的なミスと落とし穴

Span<T> をクラスのフィールドに保持しようとする試み。 これは禁止です:フィールドはヒープに存在し、Span<T> はスタック上にあるべきです。代わりに ArraySegment<T> やインデックスで参照してください。

Span<T> を async メソッドから返したり保持したりすること。 できません:非同期処理はスタックを分断します。データは別の方法で渡してください — 例えば配列や Memory<T>/ReadOnlyMemory<T> を使うなど。

スライス作成時の不正な範囲指定。 範囲外は実行時例外になります。スライスを作る前に長さと境界を必ずチェックしてください。

スパンが元データを反映することを忘れている。 Span<T> での変更は元の配列を変更します。独立したコピーが必要なら明示的にデータをコピーしてください。

2
タスク
C# SELF, レベル 65, レッスン 3
ロック未解除
範囲と末尾からのインデックスを使って配列の一部を表示しよう
範囲と末尾からのインデックスを使って配列の一部を表示しよう
コメント
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION