maximumBy -package:streamly-core

maximumBy :: Foldable t => (a -> a -> Ordering) -> t a -> a
base Data.List Data.Foldable, ghc-internal GHC.Internal.Data.Foldable GHC.Internal.Data.List
The largest element of a non-empty structure with respect to the given comparison function. Structure order is used as a tie-breaker: if there are multiple largest elements, the rightmost of them is chosen.

Examples

Basic usage: 
>>> maximumBy (compare `on` length) ["Hello", "World", "!", "Longest", "bar"]
"Longest"
WARNING: This function is partial for possibly-empty structures like lists.
maximumBy :: Foldable1 t => (a -> a -> Ordering) -> t a -> a
base Data.Foldable1
The largest element of a non-empty structure with respect to the given comparison function. Structure order is used as a tie-breaker: if there are multiple largest elements, the rightmost of them is chosen.
maximumBy :: (a -> a -> Ordering) -> Fold a (Maybe a)
foldl Control.Foldl
Computes the maximum element with respect to the given comparison function
maximumBy :: (a -> a -> Ordering) -> Fold1 a a
foldl Control.Foldl.NonEmpty
Computes the maximum element with respect to the given comparison function
maximumBy :: Foldable t => (a -> a -> Ordering) -> t a -> a
protolude Protolude, base-prelude BasePrelude, universum Universum.Unsafe, numhask NumHask.Prelude, rebase Rebase.Prelude
The largest element of a non-empty structure with respect to the given comparison function.

Examples

Basic usage: 
>>> maximumBy (compare `on` length) ["Hello", "World", "!", "Longest", "bar"]
"Longest"
WARNING: This function is partial for possibly-empty structures like lists.
maximumBy :: Foldable t => (a -> a -> Ordering) -> t a -> a
rio RIO.List.Partial
The largest element of a non-empty structure with respect to the given comparison function.
maximumBy :: (a -> a -> Ordering) -> Vector a -> a
rio RIO.Vector.Boxed.Partial
O(n) Yield the maximum element of the vector according to the given comparison function. The vector may not be empty.
maximumBy :: Vector v a => (a -> a -> Ordering) -> v a -> a
rio RIO.Vector.Partial
O(n) Yield the maximum element of the vector according to the given comparison function. The vector may not be empty.
maximumBy :: Storable a => (a -> a -> Ordering) -> Vector a -> a
rio RIO.Vector.Storable.Partial
O(n) Yield the maximum element of the vector according to the given comparison function. The vector may not be empty.
maximumBy :: Unbox a => (a -> a -> Ordering) -> Vector a -> a
rio RIO.Vector.Unboxed.Partial
O(n) Yield the maximum element of the vector according to the given comparison function. The vector may not be empty.
maximumBy :: MonoFoldable mono => (Element mono -> Element mono -> Ordering) -> NonNull mono -> Element mono
mono-traversable Data.NonNull
Get the maximum element of a monomorphic container, using a supplied element ordering function. Safe version of maximumByEx, only works on monomorphic containers wrapped in a NonNull.
maximumBy :: Foldable f => (a -> a -> Ordering) -> T f a -> a
non-empty Data.NonEmpty
maximumBy is a total function
maximumBy :: Monad m => (a -> a -> Ordering) -> SerialT m a -> m (Maybe a)
streamly Streamly.Internal.Data.Stream.IsStream Streamly.Prelude
Determine the maximum element in a stream using the supplied comparison function. 
maximumBy = Stream.fold Fold.maximumBy
maximumBy :: Foldable t => (a -> a -> Ordering) -> t a -> a
basic-prelude BasicPrelude
maximumBy :: (Contiguous arr, Element arr a) => (a -> a -> Ordering) -> arr a -> Maybe a
contiguous Data.Primitive.Contiguous
The largest element of a structure with respect to the given comparison function.
maximumBy :: (a -> a -> Ordering) -> NonEmpty a -> a
universum Universum.List.Safe
The largest element of a NonEmpty with respect to the given comparison function.
maximumBy :: Vector v a => (a -> a -> Ordering) -> Vector v (n + 1) a -> a
vector-sized Data.Vector.Generic.Sized
O(n) Yield the maximum element of the non-empty vector according to the given comparison function.
maximumBy :: Prim a => (a -> a -> Ordering) -> Vector (n + 1) a -> a
vector-sized Data.Vector.Primitive.Sized
O(n) Yield the maximum element of the non-empty vector according to the given comparison function.
maximumBy :: (a -> a -> Ordering) -> Vector (n + 1) a -> a
vector-sized Data.Vector.Sized
O(n) Yield the maximum element of the non-empty vector according to the given comparison function.
maximumBy :: Storable a => (a -> a -> Ordering) -> Vector (n + 1) a -> a
vector-sized Data.Vector.Storable.Sized
O(n) Yield the maximum element of the non-empty vector according to the given comparison function.
maximumBy :: Unbox a => (a -> a -> Ordering) -> Vector (n + 1) a -> a
vector-sized Data.Vector.Unboxed.Sized
O(n) Yield the maximum element of the non-empty vector according to the given comparison function.
maximumBy :: Foldable1 t => (a -> a -> Ordering) -> t a -> a
foldable1-classes-compat Data.Foldable1
The largest element of a non-empty structure with respect to the given comparison function.
maximumBy :: (a -> a -> Ordering) -> [a] -> a
prelude-compat Data.List2010
maximumBy :: (a -> a -> Ordering) -> [a] -> a
ghc-internal GHC.Internal.Data.OldList
The maximumBy function takes a comparison function and a list and returns the greatest element of the list by the comparison function. The list must be finite and non-empty. List order is used as a tie-breaker: if there are multiple greatest elements, the last of them is chosen.

Examples

We can use this to find the longest entry of a list: 
>>> maximumBy (\x y -> compare (length x) (length y)) ["Hello", "World", "!", "Longest", "bar"]
"Longest"

>>> minimumBy (\(a, b) (c, d) -> compare (abs (a - b)) (abs (c - d))) [(10, 15), (1, 2), (3, 5)]
(10, 15)
maximumBy :: MonadThrow m => (a -> a -> Ordering) -> [a] -> m a
listsafe Data.List.Safe
The maximumBy function takes a comparison function and a list and returns the greatest element of the list by the comparison function. The list must be finite and non-empty. Empty lists throw an EmptyListException.