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
| 型 | ミューテーブル | データをコピーするか? | スタック上に置けるか | クラス/構造体 | クラスのフィールドにできるか |
|---|---|---|---|---|---|
|
はい | - | いいえ | クラス | はい |
|
はい | いいえ | いいえ | 構造体 | はい |
|
はい | いいえ | はい | 構造体 | いいえ |
|
いいえ | いいえ | はい | 構造体 | いいえ |
つまり、Span<T> は ArraySegment<T> の進化形で、より高速で安全です。
8. 典型的なミスと落とし穴
Span<T> をクラスのフィールドに保持しようとする試み。 これは禁止です:フィールドはヒープに存在し、Span<T> はスタック上にあるべきです。代わりに ArraySegment<T> やインデックスで参照してください。
Span<T> を async メソッドから返したり保持したりすること。 できません:非同期処理はスタックを分断します。データは別の方法で渡してください — 例えば配列や Memory<T>/ReadOnlyMemory<T> を使うなど。
スライス作成時の不正な範囲指定。 範囲外は実行時例外になります。スライスを作る前に長さと境界を必ずチェックしてください。
スパンが元データを反映することを忘れている。 Span<T> での変更は元の配列を変更します。独立したコピーが必要なら明示的にデータをコピーしてください。
GO TO FULL VERSION