// 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;
}
}
}