CKTIS / C#
Enumerable.GroupBy — seskupování podle klíče
Enumerable.GroupBy rozdělí sekvenci do skupin podle vybraného klíče. Každá skupina zpřístupňuje svůj klíč prostřednictvím Key a její prvky lze přímo procházet jako sekvenci.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
IEnumerable<IGrouping<TKey, TSource>> groups = source.GroupBy(keySelector);
IEnumerable<IGrouping<TKey, TElement>> groups = source.GroupBy(keySelector, elementSelector);Enumerable.GroupBy z System.Linq seskupuje podle keySelector. Bez elementSelector zachovává zdrojové prvky; s tímto selektorem ukládá jejich promítnuté hodnoty.
Tato přetížení vracejí IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementuje IEnumerable<TElement>: samotná skupina je sekvencí prvků, nikoli objektem se samostatnou kolekcí Values. Vlastnost IGrouping<TKey,TElement>.Key vrací společný klíč. Bez projekce je TElement typem zdrojového prvku.
Provedení je odloženo až do enumerace. Skupiny zachovávají pořadí prvního výskytu klíčů a prvky pořadí zdroje; klíče se netřídí. Ve výchozím nastavení se používá EqualityComparer<TKey>.Default; pro jiné porovnávání zadejte IEqualityComparer<TKey>.
Příklad pro .NET 10 seskupuje slova podle délky. group.Key je délka a elements odkazuje na samotnou skupinu.
Příklady
using System;
using System.Collections.Generic;
using System.Linq;
string[] words = { "pear", "fig", "plum", "kiwi", "tea" };
IEnumerable<IGrouping<int, string>> groups = words.GroupBy(word => word.Length);
foreach (IGrouping<int, string> group in groups)
{
IEnumerable<string> elements = group;
Console.WriteLine($"{group.Key}: {string.Join(", ", elements)}");
}Výsledek
4: pear, plum, kiwi 3: fig, tea
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.