Какие знаешь интерфейсы коллекций?

Основные интерфейсы коллекций в C#

В языке C# существует набор ключевых интерфейсов, которые определяют поведение различных коллекций в библиотеке .NET. Эти интерфейсы образуют иерархию и позволяют унифицировать работу с группами объектов, обеспечивая гибкость и соблюдение принципов инкапсуляции и полиморфизма. Знание этих интерфейсов критически важно для понимания архитектуры встроенных коллекций (таких как List<T>, Dictionary<TKey, TValue>) и для создания собственных специализированных коллекций.

Корневой интерфейс: IEnumerable и IEnumerable<T>

Это наиболее базовые интерфейсы. Они предоставляют минимальную функциональность для перебора (итерирования) элементов коллекции.

• IEnumerable (негенерный): Определяет единственный метод GetEnumerator(), который возвращает объект IEnumerator. Этот интерфейс позволяет использовать коллекцию в цикле foreach. Все стандартные коллекции реализуют его.
• IEnumerable<T> (генерный): Более современная и типобезопасная версия. Определяет метод GetEnumerator(), возвращающий IEnumerator<T>. Именно этот интерфейс позволяет использовать большинство методов LINQ (Language Integrated Query).

// Пример использования IEnumerable<T>
IEnumerable<string> strings = new List<string> { "a", "b", "c" };
foreach (var s in strings)
{
    Console.WriteLine(s);
}

Интерфейсы для модификации коллекций: ICollection и ICollection<T>

Наследуются от IEnumerable и добавляют функциональность для управления содержимым коллекции: добавление, удаление, подсчет элементов.

• ICollection: Добавляет свойства Count, IsSynchronized, SyncRoot и методы CopyTo() (для копирования в массив), Add(), Remove(), Clear(), Contains(). Из-за отсутствия типизации часто используется через более конкретный ICollection<T>.
• ICollection<T>: Ключевой интерфейс для изменяемых коллекций. Определяет методы для прямого управления:

    *   `Add(T item)` – добавление элемента.
    *   `Remove(T item)` – удаление элемента.
    *   `Clear()` – очистка коллекции.
    *   `Contains(T item)` – проверка наличия элемента.
    *   `CopyTo(T[] array, int arrayIndex)` – копирование в массив.
    *   Свойства `Count` и `IsReadOnly`.

// Пример работы с ICollection<T>
ICollection<int> numbers = new List<int>();
numbers.Add(10);
numbers.Add(20);
Console.WriteLine(numbers.Contains(10)); // True
Console.WriteLine(numbers.Count); // 2
numbers.Remove(10);

Интерфейсы для индексированного доступа: IList и IList<T>

Наследуются от ICollection и предоставляют возможность доступа к элементам по индексу (позиции), как в массиве.

• IList: Добавляет свойства IsFixedSize, IsReadOnly и методы для работы с индексами: Item[int index] (индексатор), Insert(int index, object value), RemoveAt(int index), IndexOf(object value).
• IList<T>: Наиболее часто используемый интерфейс для списков. Классы List<T>, Array реализуют его. Помимо методов ICollection<T>, добавляет:

    *   `Insert(int index, T item)` – вставка по позиции.
    *   `RemoveAt(int index)` – удаление по позиции.
    *   `IndexOf(T item)` – поиск индекса элемента.
    *   Индексатор `T this[int index]` для чтения и записи.

// Пример использования индексатора через IList<T>
IList<string> list = new List<string> { "first", "second" };
list.Insert(1, "new second");
Console.WriteLine(list[0]); // "first"
Console.WriteLine(list.IndexOf("new second")); // 1

Интерфейсы для ключ-значение: IDictionary и IDictionary<TKey, TValue>

Наследуются от ICollection и предназначены для коллекций, хранящих пары ключ-значение, где каждый уникальный ключ соответствует одному значению (например, Dictionary, Hashtable).

• IDictionary: Определяет индексатор object this[object key], методы Add(object key, object value), Remove(object key), Contains(object key), а также свойства Keys и Values (как коллекции).
• IDictionary<TKey, TValue>: Типизированный и основной интерфейс для словарей. Определяет:

    *   `Add(TKey key, TValue value)` – добавление пары.
    *   `Remove(TKey key)` – удаление по ключу.
    *   `ContainsKey(TKey key)` – проверка наличия ключа (более эффективный аналог `Contains`).
    *   `TryGetValue(TKey key, out TValue value)` – безопасное получение значения (без исключения при отсутствии ключа).
    *   Индексатор `TValue this[TKey key]` для доступа к значению.
    *   Свойства `Keys` (`ICollection<TKey>`) и `Values` (`ICollection<TValue>`).

// Пример работы с IDictionary<TKey, TValue>
IDictionary<string, int> ages = new Dictionary<string, int>();
ages.Add("Alice", 30);
ages["Bob"] = 25; // Использование индексатора для добавления/обновления

if (ages.TryGetValue("Alice", out int aliceAge))
{
    Console.WriteLine(aliceAge); // 30
}

Специализированные интерфейсы

Помимо основных, существуют интерфейсы для конкретных сценариев:

• IReadOnlyCollection<T> и IReadOnlyList<T>: Предоставляют только возможности чтения (Count, индексатор), что полезно для обеспечения инвариантности и безопасности в многопоточных или публичных API.
• ISet<T>: Определяет операции для множеств (sets), где элементы уникальны согласно компаратору равенства. Методы UnionWith, IntersectWith, ExceptWith, Overlaps. Реализован в HashSet<T> и SortedSet<T>.
• IComparer<T> и IEqualityComparer<T>: Не являются интерфейсами коллекций напрямую, но критически важны для них. Определяют стратегии сравнения и вычисления хэш**-кода**, используемые в сортированных коллекциях (SortedDictionary) и коллекциях, основанных на хэшах (Dictionary, HashSet).

Практическое значение

Знание этих интерфейсов позволяет:

1. Абстрагироваться от конкретной реализации: Вы можете написать метод, принимающий IEnumerable<T> или ICollection<T>, и он будет работать с List<T>, Array, HashSet<T> или любым другим классом, реализующим этот интерфейс.
2. Выбирать оптимальную коллекцию: Понимая контракт интерфейса (IList для индексов, IDictionary для ключей), вы выбираете эффективную структуру данных.
3. Расширять систему коллекций: Вы можете создать свою коллекцию (например, круговая буферная очередь), реализовав необходимые интерфейсы, и она будет естественно интегрироваться с LINQ и другими механизмами .NET.
4. Правильно документировать и ограничивать API: Возвращая IReadOnlyList<T> из публичного метода, вы явно запрещаете клиентам изменять вашу внутреннюю коллекцию.

Таким образом, интерфейсы коллекций в C# представляют не просто список методов, а систему контрактов, которая формирует фундамент для эффективной и типобезопасной работы с данными в приложениях.