Trait/Object

cats

NonEmptyTraverse

Related Docs: object NonEmptyTraverse | package cats

Permalink

trait NonEmptyTraverse[F[_]] extends Traverse[F] with Reducible[F] with Serializable

NonEmptyTraverse, also known as Traversable1.

NonEmptyTraverse is like a non-empty Traverse. In addition to the traverse and sequence methods it provides nonEmptyTraverse and nonEmptySequence methods which require an Apply instance instead of Applicative.

Self Type
NonEmptyTraverse[F]
Linear Supertypes
Reducible[F], Traverse[F], Foldable[F], Functor[F], Invariant[F], Serializable, Serializable, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. NonEmptyTraverse
  2. Reducible
  3. Traverse
  4. Foldable
  5. Functor
  6. Invariant
  7. Serializable
  8. Serializable
  9. AnyRef
  10. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def foldLeft[A, B](fa: F[A], b: B)(f: (B, A) ⇒ B): B

    Permalink

    Left associative fold on 'F' using the function 'f'.

    Left associative fold on 'F' using the function 'f'.

    Definition Classes
    Foldable
  2. abstract def foldRight[A, B](fa: F[A], lb: Eval[B])(f: (A, Eval[B]) ⇒ Eval[B]): Eval[B]

    Permalink

    Right associative lazy fold on F using the folding function 'f'.

    Right associative lazy fold on F using the folding function 'f'.

    This method evaluates lb lazily (in some cases it will not be needed), and returns a lazy value. We are using (A, Eval[B]) => Eval[B] to support laziness in a stack-safe way. Chained computation should be performed via .map and .flatMap.

    For more detailed information about how this method works see the documentation for Eval[_].

    Definition Classes
    Foldable
  3. abstract def nonEmptyTraverse[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit arg0: Apply[G]): G[F[B]]

    Permalink

    Given a function which returns a G effect, thread this effect through the running of this function on all the values in F, returning an F[B] in a G context.

    Given a function which returns a G effect, thread this effect through the running of this function on all the values in F, returning an F[B] in a G context.

    Example:

    scala> import cats.implicits._
    scala> import cats.data.NonEmptyList
    scala> def countWords(words: List[String]): Map[String, Int] = words.groupBy(identity).mapValues(_.length)
    scala> NonEmptyList.of(List("How", "do", "you", "fly"), List("What", "do", "you", "do")).nonEmptyTraverse(countWords)
    res0: Map[String,cats.data.NonEmptyList[Int]] = Map(do -> NonEmptyList(1, 2), you -> NonEmptyList(1, 1))
  4. abstract def reduceLeftTo[A, B](fa: F[A])(f: (A) ⇒ B)(g: (B, A) ⇒ B): B

    Permalink

    Apply f to the "initial element" of fa and combine it with every other value using the given function g.

    Apply f to the "initial element" of fa and combine it with every other value using the given function g.

    Definition Classes
    Reducible
  5. abstract def reduceRightTo[A, B](fa: F[A])(f: (A) ⇒ B)(g: (A, Eval[B]) ⇒ Eval[B]): Eval[B]

    Permalink

    Apply f to the "initial element" of fa and lazily combine it with every other value using the given function g.

    Apply f to the "initial element" of fa and lazily combine it with every other value using the given function g.

    Definition Classes
    Reducible

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. def as[A, B](fa: F[A], b: B): F[B]

    Permalink

    Replaces the A value in F[A] with the supplied value.

    Replaces the A value in F[A] with the supplied value.

    Definition Classes
    Functor
  5. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  6. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  7. def combineAll[A](fa: F[A])(implicit arg0: Monoid[A]): A

    Permalink

    Alias for fold.

    Alias for fold.

    Definition Classes
    Foldable
  8. def compose[G[_]](implicit arg0: NonEmptyTraverse[G]): NonEmptyTraverse[[α]F[G[α]]]

    Permalink
  9. def compose[G[_]](implicit arg0: Reducible[G]): Reducible[[α]F[G[α]]]

    Permalink
    Definition Classes
    Reducible
  10. def compose[G[_]](implicit arg0: Traverse[G]): Traverse[[α]F[G[α]]]

    Permalink
    Definition Classes
    Traverse
  11. def compose[G[_]](implicit arg0: Foldable[G]): Foldable[[α]F[G[α]]]

    Permalink
    Definition Classes
    Foldable
  12. def compose[G[_]](implicit arg0: Functor[G]): Functor[[α]F[G[α]]]

    Permalink
    Definition Classes
    Functor
  13. def compose[G[_]](implicit arg0: Invariant[G]): Invariant[[α]F[G[α]]]

    Permalink
    Definition Classes
    Invariant
  14. def composeContravariant[G[_]](implicit arg0: Contravariant[G]): Contravariant[[α]F[G[α]]]

    Permalink
    Definition Classes
    FunctorInvariant
  15. def composeFunctor[G[_]](implicit arg0: Functor[G]): Invariant[[α]F[G[α]]]

    Permalink
    Definition Classes
    Invariant
  16. def dropWhile_[A](fa: F[A])(p: (A) ⇒ Boolean): List[A]

    Permalink

    Convert F[A] to a List[A], dropping all initial elements which match p.

    Convert F[A] to a List[A], dropping all initial elements which match p.

    Definition Classes
    Foldable
  17. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  18. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  19. def exists[A](fa: F[A])(p: (A) ⇒ Boolean): Boolean

    Permalink

    Check whether at least one element satisfies the predicate.

    Check whether at least one element satisfies the predicate.

    If there are no elements, the result is false.

    Definition Classes
    Foldable
  20. def existsM[G[_], A](fa: F[A])(p: (A) ⇒ G[Boolean])(implicit G: Monad[G]): G[Boolean]

    Permalink

    Check whether at least one element satisfies the effectful predicate.

    Check whether at least one element satisfies the effectful predicate.

    If there are no elements, the result is false. existsM short-circuits, i.e. once a true result is encountered, no further effects are produced.

    For example:

    scala> import cats.implicits._
    scala> val F = Foldable[List]
    scala> F.existsM(List(1,2,3,4))(n => Option(n <= 4))
    res0: Option[Boolean] = Some(true)
    
    scala> F.existsM(List(1,2,3,4))(n => Option(n > 4))
    res1: Option[Boolean] = Some(false)
    
    scala> F.existsM(List(1,2,3,4))(n => if (n <= 2) Option(true) else Option(false))
    res2: Option[Boolean] = Some(true)
    
    scala> F.existsM(List(1,2,3,4))(n => if (n <= 2) Option(true) else None)
    res3: Option[Boolean] = Some(true)
    
    scala> F.existsM(List(1,2,3,4))(n => if (n <= 2) None else Option(true))
    res4: Option[Boolean] = None
    Definition Classes
    Foldable
  21. def filter_[A](fa: F[A])(p: (A) ⇒ Boolean): List[A]

    Permalink

    Convert F[A] to a List[A], only including elements which match p.

    Convert F[A] to a List[A], only including elements which match p.

    Definition Classes
    Foldable
  22. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  23. def find[A](fa: F[A])(f: (A) ⇒ Boolean): Option[A]

    Permalink

    Find the first element matching the predicate, if one exists.

    Find the first element matching the predicate, if one exists.

    Definition Classes
    Foldable
  24. def flatSequence[G[_], A](fgfa: F[G[F[A]]])(implicit G: Applicative[G], F: FlatMap[F]): G[F[A]]

    Permalink

    Thread all the G effects through the F structure and flatten to invert the structure from F[G[F[A]]] to G[F[A]].

    Thread all the G effects through the F structure and flatten to invert the structure from F[G[F[A]]] to G[F[A]].

    Example:

    scala> import cats.implicits._
    scala> val x: List[Option[List[Int]]] = List(Some(List(1, 2)), Some(List(3)))
    scala> val y: List[Option[List[Int]]] = List(None, Some(List(3)))
    scala> x.flatSequence
    res0: Option[List[Int]] = Some(List(1, 2, 3))
    scala> y.flatSequence
    res1: Option[List[Int]] = None
    Definition Classes
    Traverse
  25. def flatTraverse[G[_], A, B](fa: F[A])(f: (A) ⇒ G[F[B]])(implicit G: Applicative[G], F: FlatMap[F]): G[F[B]]

    Permalink

    A traverse followed by flattening the inner result.

    A traverse followed by flattening the inner result.

    Example:

    scala> import cats.implicits._
    scala> def parseInt(s: String): Option[Int] = Either.catchOnly[NumberFormatException](s.toInt).toOption
    scala> val x = Option(List("1", "two", "3"))
    scala> x.flatTraverse(_.map(parseInt))
    res0: List[Option[Int]] = List(Some(1), None, Some(3))
    Definition Classes
    Traverse
  26. def fold[A](fa: F[A])(implicit A: Monoid[A]): A

    Permalink

    Fold implemented using the given Monoid[A] instance.

    Fold implemented using the given Monoid[A] instance.

    Definition Classes
    Foldable
  27. def foldK[G[_], A](fga: F[G[A]])(implicit G: MonoidK[G]): G[A]

    Permalink

    Fold implemented using the given MonoidK[G] instance.

    Fold implemented using the given MonoidK[G] instance.

    This method is identical to fold, except that we use the universal monoid (MonoidK[G]) to get a Monoid[G[A]] instance.

    For example:

    scala> import cats.implicits._
    scala> val F = Foldable[List]
    scala> F.foldK(List(1 :: 2 :: Nil, 3 :: 4 :: 5 :: Nil))
    res0: List[Int] = List(1, 2, 3, 4, 5)
    Definition Classes
    Foldable
  28. final def foldLeftM[G[_], A, B](fa: F[A], z: B)(f: (B, A) ⇒ G[B])(implicit G: Monad[G]): G[B]

    Permalink

    Alias for foldM.

    Alias for foldM.

    Definition Classes
    Foldable
  29. def foldM[G[_], A, B](fa: F[A], z: B)(f: (B, A) ⇒ G[B])(implicit G: Monad[G]): G[B]

    Permalink

    Perform a stack-safe monadic left fold from the source context F into the target monad G.

    Perform a stack-safe monadic left fold from the source context F into the target monad G.

    This method can express short-circuiting semantics. Even when fa is an infinite structure, this method can potentially terminate if the foldRight implementation for F and the tailRecM implementation for G are sufficiently lazy.

    Instances for concrete structures (e.g. List) will often have a more efficient implementation than the default one in terms of foldRight.

    Definition Classes
    Foldable
  30. def foldMap[A, B](fa: F[A])(f: (A) ⇒ B)(implicit B: Monoid[B]): B

    Permalink

    Fold implemented by mapping A values into B and then combining them using the given Monoid[B] instance.

    Fold implemented by mapping A values into B and then combining them using the given Monoid[B] instance.

    Definition Classes
    Foldable
  31. def foldMapM[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit G: Monad[G], B: Monoid[B]): G[B]

    Permalink

    Monadic folding on F by mapping A values to G[B], combining the B values using the given Monoid[B] instance.

    Monadic folding on F by mapping A values to G[B], combining the B values using the given Monoid[B] instance.

    Similar to foldM, but using a Monoid[B].

    scala> import cats.Foldable
    scala> import cats.implicits._
    scala> val evenNumbers = List(2,4,6,8,10)
    scala> val evenOpt: Int => Option[Int] =
         |   i => if (i % 2 == 0) Some(i) else None
    scala> Foldable[List].foldMapM(evenNumbers)(evenOpt)
    res0: Option[Int] = Some(30)
    scala> Foldable[List].foldMapM(evenNumbers :+ 11)(evenOpt)
    res1: Option[Int] = None
    Definition Classes
    Foldable
  32. def forall[A](fa: F[A])(p: (A) ⇒ Boolean): Boolean

    Permalink

    Check whether all elements satisfy the predicate.

    Check whether all elements satisfy the predicate.

    If there are no elements, the result is true.

    Definition Classes
    Foldable
  33. def forallM[G[_], A](fa: F[A])(p: (A) ⇒ G[Boolean])(implicit G: Monad[G]): G[Boolean]

    Permalink

    Check whether all elements satisfy the effectful predicate.

    Check whether all elements satisfy the effectful predicate.

    If there are no elements, the result is true. forallM short-circuits, i.e. once a false result is encountered, no further effects are produced.

    For example:

    scala> import cats.implicits._
    scala> val F = Foldable[List]
    scala> F.forallM(List(1,2,3,4))(n => Option(n <= 4))
    res0: Option[Boolean] = Some(true)
    
    scala> F.forallM(List(1,2,3,4))(n => Option(n <= 1))
    res1: Option[Boolean] = Some(false)
    
    scala> F.forallM(List(1,2,3,4))(n => if (n <= 2) Option(true) else Option(false))
    res2: Option[Boolean] = Some(false)
    
    scala> F.forallM(List(1,2,3,4))(n => if (n <= 2) Option(false) else None)
    res3: Option[Boolean] = Some(false)
    
    scala> F.forallM(List(1,2,3,4))(n => if (n <= 2) None else Option(false))
    res4: Option[Boolean] = None
    Definition Classes
    Foldable
  34. def fproduct[A, B](fa: F[A])(f: (A) ⇒ B): F[(A, B)]

    Permalink

    Tuple the values in fa with the result of applying a function with the value

    Tuple the values in fa with the result of applying a function with the value

    Definition Classes
    Functor
  35. def get[A](fa: F[A])(idx: Long): Option[A]

    Permalink

    Get the element at the index of the Foldable.

    Get the element at the index of the Foldable.

    Definition Classes
    Foldable
  36. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  37. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  38. def imap[A, B](fa: F[A])(f: (A) ⇒ B)(g: (B) ⇒ A): F[B]

    Permalink
    Definition Classes
    FunctorInvariant
  39. def intercalate[A](fa: F[A], a: A)(implicit A: Monoid[A]): A

    Permalink

    Intercalate/insert an element between the existing elements while folding.

    Intercalate/insert an element between the existing elements while folding.

    scala> import cats.implicits._
    scala> Foldable[List].intercalate(List("a","b","c"), "-")
    res0: String = a-b-c
    scala> Foldable[List].intercalate(List("a"), "-")
    res1: String = a
    scala> Foldable[List].intercalate(List.empty[String], "-")
    res2: String = ""
    scala> Foldable[Vector].intercalate(Vector(1,2,3), 1)
    res3: Int = 8
    Definition Classes
    Foldable
  40. def intersperseList[A](xs: List[A], x: A): List[A]

    Permalink
    Attributes
    protected
    Definition Classes
    Foldable
  41. def isEmpty[A](fa: F[A]): Boolean

    Permalink

    Returns true if there are no elements.

    Returns true if there are no elements. Otherwise false.

    Definition Classes
    ReducibleFoldable
  42. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  43. def lift[A, B](f: (A) ⇒ B): (F[A]) ⇒ F[B]

    Permalink

    Lift a function f to operate on Functors

    Lift a function f to operate on Functors

    Definition Classes
    Functor
  44. def map[A, B](fa: F[A])(f: (A) ⇒ B): F[B]

    Permalink
    Definition Classes
    TraverseFunctor
  45. def mapWithIndex[A, B](fa: F[A])(f: (A, Int) ⇒ B): F[B]

    Permalink

    Akin to map, but also provides the value's index in structure F when calling the function.

    Akin to map, but also provides the value's index in structure F when calling the function.

    Definition Classes
    Traverse
  46. def maximum[A](fa: F[A])(implicit A: Order[A]): A

    Permalink
    Definition Classes
    Reducible
  47. def maximumOption[A](fa: F[A])(implicit A: Order[A]): Option[A]

    Permalink

    Find the maximum A item in this structure according to the Order[A].

    Find the maximum A item in this structure according to the Order[A].

    returns

    None if the structure is empty, otherwise the maximum element wrapped in a Some.

    Definition Classes
    ReducibleFoldable
    See also

    minimumOption for minimum instead of maximum.

    Reducible#maximum for a version that doesn't need to return an Option for structures that are guaranteed to be non-empty.

  48. def minimum[A](fa: F[A])(implicit A: Order[A]): A

    Permalink
    Definition Classes
    Reducible
  49. def minimumOption[A](fa: F[A])(implicit A: Order[A]): Option[A]

    Permalink

    Find the minimum A item in this structure according to the Order[A].

    Find the minimum A item in this structure according to the Order[A].

    returns

    None if the structure is empty, otherwise the minimum element wrapped in a Some.

    Definition Classes
    ReducibleFoldable
    See also

    maximumOption for maximum instead of minimum.

    Reducible#minimum for a version that doesn't need to return an Option for structures that are guaranteed to be non-empty.

  50. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  51. def nonEmpty[A](fa: F[A]): Boolean

    Permalink
    Definition Classes
    ReducibleFoldable
  52. def nonEmptyFlatSequence[G[_], A](fgfa: F[G[F[A]]])(implicit G: Apply[G], F: FlatMap[F]): G[F[A]]

    Permalink

    Thread all the G effects through the F structure and flatten to invert the structure from F[G[F[A]]] to G[F[A]].

    Thread all the G effects through the F structure and flatten to invert the structure from F[G[F[A]]] to G[F[A]].

    Example:

    scala> import cats.implicits._
    scala> import cats.data.NonEmptyList
    scala> val x = NonEmptyList.of(Map(0 ->NonEmptyList.of(1, 2)), Map(0 -> NonEmptyList.of(3)))
    scala> val y: NonEmptyList[Map[Int, NonEmptyList[Int]]] = NonEmptyList.of(Map(), Map(1 -> NonEmptyList.of(3)))
    scala> x.nonEmptyFlatSequence
    res0: Map[Int,cats.data.NonEmptyList[Int]] = Map(0 -> NonEmptyList(1, 2, 3))
    scala> y.nonEmptyFlatSequence
    res1: Map[Int,cats.data.NonEmptyList[Int]] = Map()
  53. def nonEmptyFlatTraverse[G[_], A, B](fa: F[A])(f: (A) ⇒ G[F[B]])(implicit G: Apply[G], F: FlatMap[F]): G[F[B]]

    Permalink

    A nonEmptyTraverse followed by flattening the inner result.

    A nonEmptyTraverse followed by flattening the inner result.

    Example:

    scala> import cats.implicits._
    scala> import cats.data.NonEmptyList
    scala> val x = NonEmptyList.of(List("How", "do", "you", "fly"), List("What", "do", "you", "do"))
    scala> x.nonEmptyFlatTraverse(_.groupByNel(identity) : Map[String, NonEmptyList[String]])
    res0: Map[String,cats.data.NonEmptyList[String]] = Map(do -> NonEmptyList(do, do, do), you -> NonEmptyList(you, you))
  54. def nonEmptyIntercalate[A](fa: F[A], a: A)(implicit A: Semigroup[A]): A

    Permalink

    Intercalate/insert an element between the existing elements while reducing.

    Intercalate/insert an element between the existing elements while reducing.

    scala> import cats.implicits._
    scala> import cats.data.NonEmptyList
    scala> val nel = NonEmptyList.of("a", "b", "c")
    scala> Reducible[NonEmptyList].nonEmptyIntercalate(nel, "-")
    res0: String = a-b-c
    scala> Reducible[NonEmptyList].nonEmptyIntercalate(NonEmptyList.of("a"), "-")
    res1: String = a
    Definition Classes
    Reducible
  55. def nonEmptyPartition[A, B, C](fa: F[A])(f: (A) ⇒ Either[B, C]): Ior[NonEmptyList[B], NonEmptyList[C]]

    Permalink

    Partition this Reducible by a separating function A => Either[B, C]

    Partition this Reducible by a separating function A => Either[B, C]

    scala> import cats.data.NonEmptyList
    scala> val nel = NonEmptyList.of(1,2,3,4)
    scala> Reducible[NonEmptyList].nonEmptyPartition(nel)(a => if (a % 2 == 0) Left(a.toString) else Right(a))
    res0: cats.data.Ior[cats.data.NonEmptyList[String],cats.data.NonEmptyList[Int]] = Both(NonEmptyList(2, 4),NonEmptyList(1, 3))
    scala> Reducible[NonEmptyList].nonEmptyPartition(nel)(a => Right(a * 4))
    res1: cats.data.Ior[cats.data.NonEmptyList[Nothing],cats.data.NonEmptyList[Int]] = Right(NonEmptyList(4, 8, 12, 16))
    Definition Classes
    Reducible
  56. def nonEmptySequence[G[_], A](fga: F[G[A]])(implicit arg0: Apply[G]): G[F[A]]

    Permalink

    Thread all the G effects through the F structure to invert the structure from F[G[A]] to G[F[A]].

    Thread all the G effects through the F structure to invert the structure from F[G[A]] to G[F[A]].

    Example:

    scala> import cats.implicits._
    scala> import cats.data.NonEmptyList
    scala> val x = NonEmptyList.of(Map("do" -> 1, "you" -> 1), Map("do" -> 2, "you" -> 1))
    scala> val y = NonEmptyList.of(Map("How" -> 3, "do" -> 1, "you" -> 1), Map[String,Int]())
    scala> x.nonEmptySequence
    res0: Map[String,NonEmptyList[Int]] = Map(do -> NonEmptyList(1, 2), you -> NonEmptyList(1, 1))
    scala> y.nonEmptySequence
    res1: Map[String,NonEmptyList[Int]] = Map()
  57. def nonEmptySequence_[G[_], A](fga: F[G[A]])(implicit G: Apply[G]): G[Unit]

    Permalink

    Sequence F[G[A]] using Apply[G].

    Sequence F[G[A]] using Apply[G].

    This method is similar to Foldable.sequence_ but requires only an Apply instance for G instead of Applicative. See the nonEmptyTraverse_ documentation for a description of the differences.

    Definition Classes
    Reducible
  58. def nonEmptyTraverse_[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit G: Apply[G]): G[Unit]

    Permalink

    Traverse F[A] using Apply[G].

    Traverse F[A] using Apply[G].

    A values will be mapped into G[B] and combined using Apply#map2.

    This method is similar to Foldable.traverse_. There are two main differences:

    1. We only need an Apply instance for G here, since we don't need to call Applicative.pure for a starting value. 2. This performs a strict left-associative traversal and thus must always traverse the entire data structure. Prefer Foldable.traverse_ if you have an Applicative instance available for G and want to take advantage of short-circuiting the traversal.

    Definition Classes
    Reducible
  59. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  60. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  61. def partitionEither[A, B, C](fa: F[A])(f: (A) ⇒ Either[B, C])(implicit A: Alternative[F]): (F[B], F[C])

    Permalink

    Separate this Foldable into a Tuple by a separating function A => Either[B, C] Equivalent to Functor#map and then Alternative#separate.

    Separate this Foldable into a Tuple by a separating function A => Either[B, C] Equivalent to Functor#map and then Alternative#separate.

    scala> import cats.implicits._
    scala> val list = List(1,2,3,4)
    scala> Foldable[List].partitionEither(list)(a => if (a % 2 == 0) Left(a.toString) else Right(a))
    res0: (List[String], List[Int]) = (List(2, 4),List(1, 3))
    scala> Foldable[List].partitionEither(list)(a => Right(a * 4))
    res1: (List[Nothing], List[Int]) = (List(),List(4, 8, 12, 16))
    Definition Classes
    Foldable
  62. def reduce[A](fa: F[A])(implicit A: Semigroup[A]): A

    Permalink

    Reduce a F[A] value using the given Semigroup[A].

    Reduce a F[A] value using the given Semigroup[A].

    Definition Classes
    Reducible
  63. def reduceK[G[_], A](fga: F[G[A]])(implicit G: SemigroupK[G]): G[A]

    Permalink

    Reduce a F[G[A]] value using SemigroupK[G], a universal semigroup for G[_].

    Reduce a F[G[A]] value using SemigroupK[G], a universal semigroup for G[_].

    This method is a generalization of reduce.

    Definition Classes
    Reducible
  64. def reduceLeft[A](fa: F[A])(f: (A, A) ⇒ A): A

    Permalink

    Left-associative reduction on F using the function f.

    Left-associative reduction on F using the function f.

    Implementations should override this method when possible.

    Definition Classes
    Reducible
  65. def reduceLeftM[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(g: (B, A) ⇒ G[B])(implicit G: FlatMap[G]): G[B]

    Permalink

    Monadic variant of reduceLeftTo

    Monadic variant of reduceLeftTo

    Definition Classes
    Reducible
  66. def reduceLeftOption[A](fa: F[A])(f: (A, A) ⇒ A): Option[A]

    Permalink

    Reduce the elements of this structure down to a single value by applying the provided aggregation function in a left-associative manner.

    Reduce the elements of this structure down to a single value by applying the provided aggregation function in a left-associative manner.

    returns

    None if the structure is empty, otherwise the result of combining the cumulative left-associative result of the f operation over all of the elements.

    Definition Classes
    Foldable
    See also

    Reducible#reduceLeft for a version that doesn't need to return an Option for structures that are guaranteed to be non-empty. Example:

    scala> import cats.implicits._
    scala> val l = List(6, 3, 2)
    This is equivalent to (6 - 3) - 2
    scala> Foldable[List].reduceLeftOption(l)(_ - _)
    res0: Option[Int] = Some(1)
    scala> Foldable[List].reduceLeftOption(List.empty[Int])(_ - _)
    res1: Option[Int] = None

    reduceRightOption for a right-associative alternative.

  67. def reduceLeftToOption[A, B](fa: F[A])(f: (A) ⇒ B)(g: (B, A) ⇒ B): Option[B]

    Permalink

    Overriden from Foldable for efficiency.

    Overriden from Foldable for efficiency.

    Definition Classes
    ReducibleFoldable
  68. def reduceMap[A, B](fa: F[A])(f: (A) ⇒ B)(implicit B: Semigroup[B]): B

    Permalink

    Apply f to each element of fa and combine them using the given Semigroup[B].

    Apply f to each element of fa and combine them using the given Semigroup[B].

    Definition Classes
    Reducible
  69. def reduceMapM[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit G: FlatMap[G], B: Semigroup[B]): G[B]

    Permalink

    Monadic reducing by mapping the A values to G[B].

    Monadic reducing by mapping the A values to G[B]. combining the B values using the given Semigroup[B] instance.

    Similar to reduceLeftM, but using a Semigroup[B].

    scala> import cats.Reducible
    scala> import cats.data.NonEmptyList
    scala> import cats.implicits._
    scala> val evenOpt: Int => Option[Int] =
         |   i => if (i % 2 == 0) Some(i) else None
    scala> val allEven = NonEmptyList.of(2,4,6,8,10)
    allEven: cats.data.NonEmptyList[Int] = NonEmptyList(2, 4, 6, 8, 10)
    scala> val notAllEven = allEven ++ List(11)
    notAllEven: cats.data.NonEmptyList[Int] = NonEmptyList(2, 4, 6, 8, 10, 11)
    scala> Reducible[NonEmptyList].reduceMapM(allEven)(evenOpt)
    res0: Option[Int] = Some(30)
    scala> Reducible[NonEmptyList].reduceMapM(notAllEven)(evenOpt)
    res1: Option[Int] = None
    Definition Classes
    Reducible
  70. def reduceRight[A](fa: F[A])(f: (A, Eval[A]) ⇒ Eval[A]): Eval[A]

    Permalink

    Right-associative reduction on F using the function f.

    Right-associative reduction on F using the function f.

    Definition Classes
    Reducible
  71. def reduceRightOption[A](fa: F[A])(f: (A, Eval[A]) ⇒ Eval[A]): Eval[Option[A]]

    Permalink

    Reduce the elements of this structure down to a single value by applying the provided aggregation function in a right-associative manner.

    Reduce the elements of this structure down to a single value by applying the provided aggregation function in a right-associative manner.

    returns

    None if the structure is empty, otherwise the result of combining the cumulative right-associative result of the f operation over the A elements.

    Definition Classes
    Foldable
    See also

    Reducible#reduceRight for a version that doesn't need to return an Option for structures that are guaranteed to be non-empty. Example:

    scala> import cats.implicits._
    scala> val l = List(6, 3, 2)
    This is eqivalent to 6 - (3 - 2)
    scala> Foldable[List].reduceRightOption(l)((current, rest) => rest.map(current - _)).value
    res0: Option[Int] = Some(5)
    scala> Foldable[List].reduceRightOption(List.empty[Int])((current, rest) => rest.map(current - _)).value
    res1: Option[Int] = None

    reduceLeftOption for a left-associative alternative

  72. def reduceRightToOption[A, B](fa: F[A])(f: (A) ⇒ B)(g: (A, Eval[B]) ⇒ Eval[B]): Eval[Option[B]]

    Permalink

    Overriden from Foldable for efficiency.

    Overriden from Foldable for efficiency.

    Definition Classes
    ReducibleFoldable
  73. def sequence[G[_], A](fga: F[G[A]])(implicit arg0: Applicative[G]): G[F[A]]

    Permalink

    Thread all the G effects through the F structure to invert the structure from F[G[A]] to G[F[A]].

    Thread all the G effects through the F structure to invert the structure from F[G[A]] to G[F[A]].

    Example:

    scala> import cats.implicits._
    scala> val x: List[Option[Int]] = List(Some(1), Some(2))
    scala> val y: List[Option[Int]] = List(None, Some(2))
    scala> x.sequence
    res0: Option[List[Int]] = Some(List(1, 2))
    scala> y.sequence
    res1: Option[List[Int]] = None
    Definition Classes
    Traverse
  74. def sequence_[G[_], A](fga: F[G[A]])(implicit arg0: Applicative[G]): G[Unit]

    Permalink

    Sequence F[G[A]] using Applicative[G].

    Sequence F[G[A]] using Applicative[G].

    This is similar to traverse_ except it operates on F[G[A]] values, so no additional functions are needed.

    For example:

    scala> import cats.implicits._
    scala> val F = Foldable[List]
    scala> F.sequence_(List(Option(1), Option(2), Option(3)))
    res0: Option[Unit] = Some(())
    scala> F.sequence_(List(Option(1), None, Option(3)))
    res1: Option[Unit] = None
    Definition Classes
    Foldable
  75. def size[A](fa: F[A]): Long

    Permalink

    The size of this Foldable.

    The size of this Foldable.

    This is overriden in structures that have more efficient size implementations (e.g. Vector, Set, Map).

    Note: will not terminate for infinite-sized collections.

    Definition Classes
    Foldable
  76. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  77. def takeWhile_[A](fa: F[A])(p: (A) ⇒ Boolean): List[A]

    Permalink

    Convert F[A] to a List[A], retaining only initial elements which match p.

    Convert F[A] to a List[A], retaining only initial elements which match p.

    Definition Classes
    Foldable
  78. def toList[A](fa: F[A]): List[A]

    Permalink

    Convert F[A] to a List[A].

    Convert F[A] to a List[A].

    Definition Classes
    Foldable
  79. def toNonEmptyList[A](fa: F[A]): NonEmptyList[A]

    Permalink
    Definition Classes
    Reducible
  80. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  81. def traverse[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit arg0: Applicative[G]): G[F[B]]

    Permalink

    Given a function which returns a G effect, thread this effect through the running of this function on all the values in F, returning an F[B] in a G context.

    Given a function which returns a G effect, thread this effect through the running of this function on all the values in F, returning an F[B] in a G context.

    Example:

    scala> import cats.implicits._
    scala> def parseInt(s: String): Option[Int] = Either.catchOnly[NumberFormatException](s.toInt).toOption
    scala> List("1", "2", "3").traverse(parseInt)
    res0: Option[List[Int]] = Some(List(1, 2, 3))
    scala> List("1", "two", "3").traverse(parseInt)
    res1: Option[List[Int]] = None
    Definition Classes
    NonEmptyTraverseTraverse
  82. def traverseWithIndexM[G[_], A, B](fa: F[A])(f: (A, Int) ⇒ G[B])(implicit G: Monad[G]): G[F[B]]

    Permalink

    Akin to traverse, but also provides the value's index in structure F when calling the function.

    Akin to traverse, but also provides the value's index in structure F when calling the function.

    This performs the traversal in a single pass but requires that effect G is monadic. An applicative traversal can be performed in two passes using zipWithIndex followed by traverse.

    Definition Classes
    Traverse
  83. def traverse_[G[_], A, B](fa: F[A])(f: (A) ⇒ G[B])(implicit G: Applicative[G]): G[Unit]

    Permalink

    Traverse F[A] using Applicative[G].

    Traverse F[A] using Applicative[G].

    A values will be mapped into G[B] and combined using Applicative#map2.

    For example:

    scala> import cats.implicits._
    scala> def parseInt(s: String): Option[Int] = Either.catchOnly[NumberFormatException](s.toInt).toOption
    scala> val F = Foldable[List]
    scala> F.traverse_(List("333", "444"))(parseInt)
    res0: Option[Unit] = Some(())
    scala> F.traverse_(List("333", "zzz"))(parseInt)
    res1: Option[Unit] = None

    This method is primarily useful when G[_] represents an action or effect, and the specific A aspect of G[A] is not otherwise needed.

    Definition Classes
    Foldable
  84. def tupleLeft[A, B](fa: F[A], b: B): F[(B, A)]

    Permalink

    Tuples the A value in F[A] with the supplied B value, with the B value on the left.

    Tuples the A value in F[A] with the supplied B value, with the B value on the left.

    Definition Classes
    Functor
  85. def tupleRight[A, B](fa: F[A], b: B): F[(A, B)]

    Permalink

    Tuples the A value in F[A] with the supplied B value, with the B value on the right.

    Tuples the A value in F[A] with the supplied B value, with the B value on the right.

    Definition Classes
    Functor
  86. def void[A](fa: F[A]): F[Unit]

    Permalink

    Empty the fa of the values, preserving the structure

    Empty the fa of the values, preserving the structure

    Definition Classes
    Functor
  87. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  88. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  89. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  90. def widen[A, B >: A](fa: F[A]): F[B]

    Permalink

    Lifts natural subtyping covariance of covariant Functors.

    Lifts natural subtyping covariance of covariant Functors.

    NOTE: In certain (perhaps contrived) situations that rely on universal equality this can result in a ClassCastException, because it is implemented as a type cast. It could be implemented as map(identity), but according to the functor laws, that should be equal to fa, and a type cast is often much more performant. See this example of widen creating a ClassCastException.

    Definition Classes
    Functor
  91. def zipWithIndex[A](fa: F[A]): F[(A, Int)]

    Permalink

    Traverses through the structure F, pairing the values with assigned indices.

    Traverses through the structure F, pairing the values with assigned indices.

    The behavior is consistent with the Scala collection library's zipWithIndex for collections such as List.

    Definition Classes
    Traverse

Inherited from Reducible[F]

Inherited from Traverse[F]

Inherited from Foldable[F]

Inherited from Functor[F]

Inherited from Invariant[F]

Inherited from Serializable

Inherited from Serializable

Inherited from AnyRef

Inherited from Any

Ungrouped