// Copyright (c) Microsoft Open Technologies, Inc. All rights reserved. See License.txt in the project root for license information. using System; using System.Collections.Generic; using System.Linq; namespace System.Linq { /// /// Provides a set of additional static methods that allow querying enumerable sequences. /// public static partial class EnumerableEx { /// /// Determines whether an enumerable sequence is empty. /// /// Source sequence element type. /// Source sequence. /// true if the sequence is empty; false otherwise. public static bool IsEmpty(this IEnumerable source) { if (source == null) throw new ArgumentNullException("source"); return !source.Any(); } /// /// Returns the minimum value in the enumerable sequence by using the specified comparer to compare values. /// /// Source sequence element type. /// Source sequence. /// Comparer used to determine the minimum value. /// Minimum value in the sequence. public static TSource Min(this IEnumerable source, IComparer comparer) { if (source == null) throw new ArgumentNullException("source"); if (comparer == null) throw new ArgumentNullException("comparer"); return MinBy(source, x => x, comparer).First(); } /// /// Returns the elements with the minimum key value by using the default comparer to compare key values. /// /// Source sequence element type. /// Key type. /// Source sequence. /// Key selector used to extract the key for each element in the sequence. /// List with the elements that share the same minimum key value. public static IList MinBy(this IEnumerable source, Func keySelector) { if (source == null) throw new ArgumentNullException("source"); if (keySelector == null) throw new ArgumentNullException("keySelector"); return MinBy(source, keySelector, Comparer.Default); } /// /// Returns the elements with the minimum key value by using the specified comparer to compare key values. /// /// Source sequence element type. /// Key type. /// Source sequence. /// Key selector used to extract the key for each element in the sequence. /// Comparer used to determine the minimum key value. /// List with the elements that share the same minimum key value. public static IList MinBy(this IEnumerable source, Func keySelector, IComparer comparer) { if (source == null) throw new ArgumentNullException("source"); if (keySelector == null) throw new ArgumentNullException("keySelector"); if (comparer == null) throw new ArgumentNullException("comparer"); return ExtremaBy(source, keySelector, (key, minValue) => -comparer.Compare(key, minValue)); } /// /// Returns the maximum value in the enumerable sequence by using the specified comparer to compare values. /// /// Source sequence element type. /// Source sequence. /// Comparer used to determine the maximum value. /// Maximum value in the sequence. public static TSource Max(this IEnumerable source, IComparer comparer) { if (source == null) throw new ArgumentNullException("source"); if (comparer == null) throw new ArgumentNullException("comparer"); return MaxBy(source, x => x, comparer).First(); } /// /// Returns the elements with the maximum key value by using the default comparer to compare key values. /// /// Source sequence element type. /// Key type. /// Source sequence. /// Key selector used to extract the key for each element in the sequence. /// List with the elements that share the same maximum key value. public static IList MaxBy(this IEnumerable source, Func keySelector) { if (source == null) throw new ArgumentNullException("source"); if (keySelector == null) throw new ArgumentNullException("keySelector"); return MaxBy(source, keySelector, Comparer.Default); } /// /// Returns the elements with the minimum key value by using the specified comparer to compare key values. /// /// Source sequence element type. /// Key type. /// Source sequence. /// Key selector used to extract the key for each element in the sequence. /// Comparer used to determine the maximum key value. /// List with the elements that share the same maximum key value. public static IList MaxBy(this IEnumerable source, Func keySelector, IComparer comparer) { if (source == null) throw new ArgumentNullException("source"); if (keySelector == null) throw new ArgumentNullException("keySelector"); if (comparer == null) throw new ArgumentNullException("comparer"); return ExtremaBy(source, keySelector, (key, minValue) => comparer.Compare(key, minValue)); } private static IList ExtremaBy(IEnumerable source, Func keySelector, Func compare) { var result = new List(); using (var e = source.GetEnumerator()) { if (!e.MoveNext()) throw new InvalidOperationException("Source sequence doesn't contain any elements."); var current = e.Current; var resKey = keySelector(current); result.Add(current); while (e.MoveNext()) { var cur = e.Current; var key = keySelector(cur); var cmp = compare(key, resKey); if (cmp == 0) { result.Add(cur); } else if (cmp > 0) { result = new List { cur }; resKey = key; } } } return result; } } }