CKTIS / C#
Negenerička sučelja IEnumerable i IEnumerator u prostoru imena System.Collections
IEnumerable daje enumerator, a IEnumerator prati položaj u slijedu. Eksplicitna implementacija ispunjava negenerički ugovor bez dupliciranja logike prolaska kroz elemente.
Verzija: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
using System.Collections;
using System.Collections.Generic;
sealed class Sequence<T> : IEnumerable<T>
{
public IEnumerator<T> GetEnumerator()
{
yield break;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}System.Collections.IEnumerable predstavlja izvor elemenata. Njegova metoda GetEnumerator() vraća System.Collections.IEnumerator koji prati položaj u slijedu. Enumerator počinje ispred prvog elementa. Čitaj Current samo nakon što MoveNext() vrati true i završi prolazak kad vrati false. Reset() služi za povratak na početni položaj, ali može izazvati iznimku NotSupportedException, kao kod iteratora s yield. Za novi prolazak dohvati novi enumerator.
IEnumerable<T> iz System.Collections.Generic nasljeđuje negenerički IEnumerable, pa klasa mora ispuniti oba ugovora. Izloži javnu metodu koja vraća IEnumerator<T> i dodaj IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Ta je eksplicitna implementacija dostupna putem negeneričkog sučelja. Nije riječ o običnom preopterećenju: C# ne dopušta preopterećenja koja se razlikuju samo po povratnom tipu. Oba poziva koriste istu logiku prolaska.
IEnumerator<T> nasljeđuje IEnumerator i IDisposable. Generički Current ima tip T, a negenerički Current vraća object. Pri čitanju negeneričkog Current u primjeru se int pakira u objekt (boxing), a foreach (int ...) ga raspakirava (unboxing). Iterator s yield pruža obje verzije svojstva Current. Ako pišeš vlastiti enumerator, negenerički Current možeš implementirati eksplicitno.
foreach poziva MoveNext() i čita Current bez upotrebe metode Reset(). Poziva i Dispose() ako enumerator implementira IDisposable, čak i pri ranijem izlasku iz petlje. Pri ručnom prolasku kroz IEnumerator u bloku finally provjeri implementira li enumerator IDisposable i, ako da, pozovi Dispose(): negeneričko sučelje ne zahtijeva tu metodu.
Primjeri
using System;
using System.Collections;
using System.Collections.Generic;
IEnumerable<int> typed = new EvenPair();
IEnumerable untyped = typed;
foreach (int value in typed)
Console.WriteLine(FormattableString.Invariant($"Generic: {value}"));
foreach (int value in untyped)
Console.WriteLine(FormattableString.Invariant($"Non-generic: {value}"));
sealed class EvenPair : IEnumerable<int>
{
public IEnumerator<int> GetEnumerator()
{
yield return 2;
yield return 4;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}Rezultat
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Obje varijable upućuju na isti objekt. Druga petlja poziva eksplicitnu implementaciju putem sučelja `IEnumerable` i ponovno čita `2` i `4`.
Povezane lekcije
- C# · Lekcija 38 · Srednje · Verzija: 2
Izvori
- IEnumerable Interface (System.Collections)
- IEnumerator Interface (System.Collections)
- IEnumerable<T> Interface (System.Collections.Generic)
- IEnumerator<T> Interface (System.Collections.Generic)
- Explicit Interface Implementation (C# Programming Guide)
- Iterate through collections
- Statements — C# language specification
- Basic concepts — C# language specification
- Boxing and Unboxing (C# Programming Guide)