C# 4.0: полное руководство

// Этот итератор возвращает символы из массива chrs.

public IEnumerator GetEnumerator() {

  foreach(char ch in chrs)

    yield return ch;

}

Это и есть итератор для объектов класса MyClass. Как видите, в нем явно реализуется метод GetEnumerator(), определенный в интерфейсе IEnumerable. А теперь перейдем непосредственно к телу данного метода. Оно состоит из цикла foreach, в котором возвращаются элементы из массива chrs. И делается это с помощью оператора yield return. Этот оператор возвращает следующий объект в коллекции, которым в данном случае оказывается очередной символ в массиве chrs. Благодаря этому средству обращение к объекту mc типа MyClass организуется в цикле foreach внутри метода Main().

Обозначение yield служит в языке C# в качестве контекстного ключевого слова. Это означает, что оно имеет специальное назначение только в блоке итератора. А вне этого блока оно может быть использовано аналогично любому другому идентификатору.

Следует особо подчеркнуть, что итератор не обязательно должен опираться на массив или коллекцию другого типа. Он должен просто возвращать следующий элемент из совокупности элементов. Это означает, что элементы могут быть построены динамически с помощью соответствующего алгоритма. В качестве примера ниже приведена версия предыдущей программы, в которой возвращаются все буквы английского алфавита, набранные в верхнем регистре. Вместо массива буквы формируются в цикле for.

// Пример динамического построения значений,

// возвращаемых по очереди с помощью итератора.

using System;

using System.Collections;

class MyClass {

  char ch = 'A';

  // Этот итератор возвращает буквы английского

  // алфавита, набранные в верхнем регистре.

  public IEnumerator GetEnumerator() {

    for (int i = 0; i < 26; i++)

      yield return (char)(ch + i);

  }

}

class ItrDemo2 {

  static void Main() {

    MyClass me = new MyClass();

    foreach (char ch in me)

      Console.Write(ch + " ");

    Console.WriteLine();

  }

}

Вот к какому результату приводит выполнение этой программы.

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Прерывание итератора

Для преждевременного прерывания итератора служит следующая форма оператора yield.

yield break;

Когда этот оператор выполняется, итератор уведомляет о том, что достигнут конец коллекции. А это, по существу, останавливает сам итератор.

Приведенная ниже программа является версией предыдущей программы, измененной с целью отобразить только первые десять букв английского алфавита.

// Пример прерывания итератора.

using System;

using System.Collections;

class MyClass {

  char ch = 'A';

  // Этот итератор возвращает первые 10 букв английского алфавита,

  public IEnumerator GetEnumerator() {

    for (int i = 0; i < 26; i++) {

      if (i == 10) yield break; // прервать итератор преждевременно

      yield return (char)(ch + i);

    }

  }

}

class ItrDemo3 {

  static void Main() {

    MyClass mc = new MyClass();

    foreach (char ch in mc)

      Console.Write(ch + " ");

    Console.WriteLine();

  }

}

Эта программа дает следующий результат.

A B C D E F G H I J

Применение нескольких операторов yield

В итераторе допускается применение нескольких операторов yield. Но каждый такой оператор должен возвращать следующий элемент в коллекции. В качестве примера рассмотрим следующую программу.

// Пример применения нескольких операторов yield.

using System;

using System.Collections;

class MyClass {

  // Этот итератор возвращает буквы А, В, С, D и Е.

  public IEnumerator GetEnumerator() {

    yield return 'A';

    yield return 'B';

    yield return 'C';

    yield return 'D';

    yield return 'E';

  }

}

class ItrDemo5 {

  static void Main() {