yield breakと早期終了
条件に応じて反復処理を停止します。
「yield breakと早期終了」はCoddyKit上の無料C# Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全4レッスンが含まれています。
イテレーターを途中で停止する
自然な終端に達する前に、イテレーターによる値の生成を停止したい場合があります。yield break 文は、イテレーターにおける return のように、シーケンスを直ちに終了します。
基本的な yield break
yield break はイテレーターを終了させます。それ以降の値は生成されず、それを使用している foreach ループも終了します。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> UpToFive()
{
for (int i = 1; i <= 100; i++)
{
if (i > 5) yield break;
yield return i;
}
}
public static void Main()
{
foreach (var n in UpToFive())
Console.WriteLine(n);
}
}条件が成立する間だけ取得する
よくあるパターンは、条件が true の間だけ項目を生成し、その後で停止することです。yield break を使うと、これを簡潔に記述できます。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> WhileSmall(IEnumerable<int> nums)
{
foreach (var n in nums)
{
if (n >= 10) yield break;
yield return n;
}
}
public static void Main()
{
foreach (var n in WhileSmall(new[] { 2, 4, 8, 12, 3 }))
Console.WriteLine(n);
}
}yield break でガード節を作る
イテレーターの先頭で yield break をガードとして使えます。入力が空または無効な場合は、項目を 1 つも返さずに終了できます。
using System;
using System.Collections.Generic;
using System.Linq;
public class Program
{
static IEnumerable<string> Lines(string text)
{
if (string.IsNullOrEmpty(text)) yield break;
foreach (var line in text.Split('\n'))
yield return line;
}
public static void Main()
{
foreach (var l in Lines("a\nb\nc"))
Console.WriteLine(l);
Console.WriteLine("empty count: " + Lines("").Count());
}
}出力数を制限する
カウンターと yield break を組み合わせると、長い入力元に対しても、イテレーターが生成する項目数に上限を設定できます。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> Take(IEnumerable<int> source, int max)
{
int count = 0;
foreach (var item in source)
{
if (count++ >= max) yield break;
yield return item;
}
}
public static void Main()
{
foreach (var n in Take(new[] { 1, 2, 3, 4, 5 }, 3))
Console.WriteLine(n);
}
}呼び出し側の break と yield break
シーケンスを終了させる方法は 2 つあります。呼び出し側が break で値の取得を停止する方法と、イテレーターが yield break で値の生成を停止する方法です。どちらもループを終了させますが、理由は異なります。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> Counting()
{
int i = 1;
while (true) yield return i++;
}
public static void Main()
{
// Caller decides to stop with break
foreach (var n in Counting())
{
if (n > 3) break;
Console.WriteLine(n);
}
}
}yield break が終了させるのは現在のイテレーターだけ
yield break は、それが記述されたイテレーターメソッドを終了させます。呼び出し側にある外側のループを終了させるわけではありません。制御は列挙を行っていた側に戻ります。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> Bounded(IEnumerable<int> nums, int limit)
{
foreach (var n in nums)
{
if (n > limit) yield break; // ends Bounded only
yield return n;
}
}
public static void Main()
{
var result = Bounded(new[] { 1, 2, 9, 3 }, 5);
Console.WriteLine("iterator created, still running");
foreach (var n in result) Console.WriteLine(n);
}
}yield break の後に yield return は置けない
yield break が実行されると、イテレーターは終了します。同じ実行経路上でその後にあるコードからは、値が生成されることはありません。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> Demo(bool stopEarly)
{
yield return 1;
if (stopEarly) yield break;
yield return 2;
yield return 3;
}
public static void Main()
{
Console.WriteLine("stopEarly = true:");
foreach (var n in Demo(true)) Console.WriteLine(n);
Console.WriteLine("stopEarly = false:");
foreach (var n in Demo(false)) Console.WriteLine(n);
}
}フィルター処理と途中終了を組み合わせる
同じイテレーター内でフィルター処理と終了を行えます。いくつかの値をスキップし、別の値を生成し、終了を示す値が現れたら処理全体を中断できます。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> UntilZero(IEnumerable<int> nums)
{
foreach (var n in nums)
{
if (n == 0) yield break; // stop at sentinel
if (n < 0) continue; // skip negatives
yield return n;
}
}
public static void Main()
{
foreach (var n in UntilZero(new[] { 3, -1, 5, 0, 9 }))
Console.WriteLine(n);
}
}yield break と finally ブロック
イテレーターに try/finally がある場合、yield break でシーケンスを終了しても finally は実行されます。これにより、リソースのクローズなどのクリーンアップが確実に行われます。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> WithCleanup()
{
try
{
yield return 1;
yield break;
}
finally
{
Console.WriteLine("cleanup ran");
}
}
public static void Main()
{
foreach (var n in WithCleanup())
Console.WriteLine(n);
}
}自分で試す
フィルタリングと早期終了を組み合わせてみましょう。正の数を yield し、累積和が予算を超えたら完全に停止します。
using System;
using System.Collections.Generic;
public class Program
{
static IEnumerable<int> WithinBudget(IEnumerable<int> nums, int budget)
{
int spent = 0;
foreach (var n in nums)
{
if (n <= 0) continue;
if (spent + n > budget) yield break;
spent += n;
yield return n;
}
}
public static void Main()
{
foreach (var n in WithinBudget(new[] { 3, -2, 4, 5, 1 }, 10))
Console.WriteLine(n);
}
}クイックチェック
yield break の役割を思い出してください。
まとめ
yield break はイテレーターを途中で終了します。
- イテレーターでは、値を返さない
returnのように機能します。 - take-while のロジック、ガード、回数制限に使用します。
- 終了するのはイテレーターだけであり、呼び出し側のループではありません。
finallyブロックは引き続き実行されるため、クリーンアップが確実に行われます。
よくある質問
「yield breakと早期終了」レッスンは無料ですか？
はい。「yield breakと早期終了」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全4レッスンが含まれています。
「yield breakと早期終了」で何を学びますか？
条件に応じて反復処理を停止します。 ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
C# Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「yield breakと早期終了」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このC# Academyレッスンでコードを書いて実行できますか？
はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- yield returnによるイテレーターメソッド
- yield breakと早期終了
- 遅延評価のセマンティクス
- カスタム列挙可能型