Ior (cyclops-react 2.0.0-MI1 API)

Type Parameters:

ST - Secondary type

PT - Primary type

All Superinterfaces:

BiFunctor<ST,PT>, Convertable<PT>, ConvertableToReactiveSeq<PT>, Filters<PT>, Fn0<PT>, Folds<PT>, org.jooq.lambda.function.Function0<PT>, java.lang.Iterable<PT>, MonadicValue<PT>, java.util.function.Predicate<PT>, org.reactivestreams.Publisher<PT>, java.util.function.Supplier<PT>, To<Ior<ST,PT>>, ToStream<PT>, Transformable<PT>, Unit<PT>, Value<PT>, Visitable<PT>, Zippable<PT>

All Known Implementing Classes:

Ior.Both, Ior.Primary, Ior.Secondary
```
public interface Ior<ST,PT>
extends To<Ior<ST,PT>>, MonadicValue<PT>, BiFunctor<ST,PT>
```
Inclusive Or (can be one of Primary, Secondary or Both Primary and Secondary) An Either or Union type, but right biased. Primary and Secondary are used instead of Right & Left. 'Right' (or primary type) biased disjunct union. No 'projections' are provided, swap() and secondaryXXXX alternative methods can be used instead. For eXclusive Ors @see Xor

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class Ior.Both<ST,PT>

static class Ior.Primary<ST,PT>

static class Ior.Secondary<ST,PT>
- Nested classes/interfaces inherited from interface com.aol.cyclops2.types.Value
  Value.ValueImpl<T>
- Nested classes/interfaces inherited from interface com.aol.cyclops2.types.Convertable
  Convertable.SupplierToConvertable<T>
- Nested classes/interfaces inherited from interface cyclops.function.Fn0
  Fn0.FunctionalOperations<R>, Fn0.Instances, Fn0.SupplierKind<R>

Nested Classes
Modifier and Type	Interface and Description
`static class`	`Ior.Both<ST,PT>`
`static class`	`Ior.Primary<ST,PT>`
`static class`	`Ior.Secondary<ST,PT>`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`static <ST,PT,R> Ior<?,R>`	`accumulatePrimary(CollectionX<Ior<ST,PT>> iors, java.util.function.Function<? super PT,R> mapper, Semigroup<R> reducer)` Accumulate the results only from those Iors which have a Primary type present, using the supplied mapping function to convert the data from each Ior before reducing them using the supplied Semgigroup (a combining BiFunction/BinaryOperator that takes two input values of the same type and returns the combined result) `cyclops2.Semigroups` .
`static <ST,PT,R> Ior<?,R>`	`accumulatePrimary(CollectionX<Ior<ST,PT>> iors, Reducer<R> reducer)` Accumulate the result of the Primary types in the Collection of Iors provided using the supplied Reducer `cyclops2.Reducers`.
`static <ST,PT> Ior<?,PT>`	`accumulatePrimary(CollectionX<Ior<ST,PT>> iors, Semigroup<PT> reducer)` Accumulate the results only from those Iors which have a Primary type present, using the supplied Semgigroup (a combining BiFunction/BinaryOperator that takes two input values of the same type and returns the combined result) `cyclops2.Semigroups` .
`static <ST,PT,R> Ior<?,R>`	`accumulateSecondary(CollectionX<Ior<ST,PT>> iors, java.util.function.Function<? super ST,R> mapper, Monoid<R> reducer)` Accumulate the results only from those Iors which have a Secondary type present, using the supplied mapping function to convert the data from each Ior before reducing them using the supplied Monoid (a combining BiFunction/BinaryOperator and identity element that takes two input values of the same type and returns the combined result) `cyclops2.Monoids` .
`static <ST,PT,R> Ior<?,R>`	`accumulateSecondary(CollectionX<Ior<ST,PT>> iors, Reducer<R> reducer)` Accumulate the result of the Secondary types in the Collection of Iors provided using the supplied Reducer `cyclops2.Reducers`.
`static <ST,PT> Ior<?,ST>`	`accumulateSecondary(Monoid<ST> reducer, CollectionX<Ior<ST,PT>> iors)` Accumulate the results only from those Iors which have a Secondary type present, using the supplied Monoid (a combining BiFunction/BinaryOperator and identity element that takes two input values of the same type and returns the combined result) `cyclops2.Monoids` .
`default AnyMValue<Witness.ior,PT>`	`anyM()`
`static <X,LT extends X,M extends X,RT extends X,R> java.util.function.Function<java.util.function.Function<? super X,R>,R>`	`applyAny(Ior<LT,RT> either)`
`default <U1,U2> Ior<U1,U2>`	`bicast(java.lang.Class<U1> type1, java.lang.Class<U2> type2)` Cast two data types simulatanously.
`default <R1,R2> Ior<R1,R2>`	`bimap(java.util.function.Function<? super ST,? extends R1> fn1, java.util.function.Function<? super PT,? extends R2> fn2)` Transform this BiFunctor, changing two value types at once.
`default Ior<ST,PT>`	`bipeek(java.util.function.Consumer<? super ST> c1, java.util.function.Consumer<? super PT> c2)` Peek at two data types simulatanously (typically to perform a side-effect with each data point)
`default <R1,R2> Ior<R1,R2>`	`bitrampoline(java.util.function.Function<? super ST,? extends Trampoline<? extends R1>> mapper1, java.util.function.Function<? super PT,? extends Trampoline<? extends R2>> mapper2)` Perform a tail-call optimized recursive transformation operation across two data points simultaneously
`java.util.Optional<org.jooq.lambda.tuple.Tuple2<ST,PT>>`	`both()`
`static <ST,PT> Ior<ST,PT>`	`both(Ior<ST,PT> secondary, Ior<ST,PT> primary)` Deprecated.
`static <ST,PT> Ior<ST,PT>`	`both(ST secondary, PT primary)` Create an Ior instance that contains both secondary and primary types
`default Value<java.util.Optional<org.jooq.lambda.tuple.Tuple2<ST,PT>>>`	`bothValue()`
`default <U> Ior<ST,U>`	`cast(java.lang.Class<? extends U> type)` Cast all elements in a stream to a given type, possibly throwing a `ClassCastException`.
`default <R> Ior<ST,R>`	`coflatMap(java.util.function.Function<? super MonadicValue<PT>,R> mapper)` Perform a coflatMap operation.
`default <T2,R> Ior<ST,R>`	`combine(Value<? extends T2> app, java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)` Lazily combine this ApplicativeFunctor with the supplied value via the supplied BiFunction Example
`default Ior<ST,PT>`	`combineEager(Monoid<PT> monoid, MonadicValue<? extends PT> v2)` Eagerly combine two MonadicValues using the supplied monoid (@see ApplicativeFunctor for type appropraite i.e.
`static <X,LT extends X,M extends X,RT extends X> java.util.function.Consumer<java.util.function.Consumer<? super X>>`	`consumeAny(Ior<LT,RT> either)` Static method useful as a method reference for fluent consumption of any value type stored in this Either (will capture the lowest common type)
`Ior<ST,PT>`	`filter(java.util.function.Predicate<? super PT> test)` Keep only elements for which the supplied predicates hold e.g.
`default Ior<ST,PT>`	`filterNot(java.util.function.Predicate<? super PT> fn)` Remove any elements for which the predicate holds (inverse operation to filter) e.g.
`<RT1> Ior<ST,RT1>`	`flatMap(java.util.function.Function<? super PT,? extends MonadicValue<? extends RT1>> mapper)` A flattening transformation operation (@see `Optional.flatMap(Function)`
`default <R> Ior<ST,R>`	`flatMapI(java.util.function.Function<? super PT,? extends java.lang.Iterable<? extends R>> mapper)` A flattening transformation operation that takes the first value from the returned Iterable.
`default <R> Ior<ST,R>`	`flatMapP(java.util.function.Function<? super PT,? extends org.reactivestreams.Publisher<? extends R>> mapper)` A flattening transformation operation that takes the first value from the returned Publisher.
`default <R> Ior<ST,R>`	`flatMapS(java.util.function.Function<? super PT,? extends java.util.stream.Stream<? extends R>> mapper)`
`default <R1,R> Ior<ST,R>`	`forEach2(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,? extends R> yieldingFunction)` Perform a two level nested internal iteration over this MonadicValue and the supplied MonadicValue
`default <R1,R> Ior<ST,R>`	`forEach2(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,java.lang.Boolean> filterFunction, java.util.function.BiFunction<? super PT,? super R1,? extends R> yieldingFunction)` Perform a two level nested internal iteration over this MonadicValue and the supplied stream
`default <T2,R1,R2,R> Ior<ST,R>`	`forEach3(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2, Fn3<? super PT,? super R1,? super R2,? extends R> yieldingFunction)` Perform a three level nested internal iteration over this MonadicValue and the supplied MonadicValues
`default <T2,R1,R2,R> Ior<ST,R>`	`forEach3(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2, Fn3<? super PT,? super R1,? super R2,java.lang.Boolean> filterFunction, Fn3<? super PT,? super R1,? super R2,? extends R> yieldingFunction)` Perform a three level nested internal iteration over this MonadicValue and the supplied MonadicValues
`default <T2,R1,R2,R3,R> Ior<ST,R>`	`forEach4(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2, Fn3<? super PT,? super R1,? super R2,? extends MonadicValue<R3>> value3, Fn4<? super PT,? super R1,? super R2,? super R3,? extends R> yieldingFunction)` Perform a four level nested internal iteration over this MonadicValue and the supplied MonadicValues
`default <T2,R1,R2,R3,R> Ior<ST,R>`	`forEach4(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1, java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2, Fn3<? super PT,? super R1,? super R2,? extends MonadicValue<R3>> value3, Fn4<? super PT,? super R1,? super R2,? super R3,java.lang.Boolean> filterFunction, Fn4<? super PT,? super R1,? super R2,? super R3,? extends R> yieldingFunction)` Perform a four level nested internal iteration over this MonadicValue and the supplied MonadicValues `Maybe.of(3) .forEach4(a->Maybe.just(a+10), (a,b)->Maybe.just(a+b), (a,b,c)->Maybe.none(), (a,b,c,d)->a+b+c<100, (a,b,c,d)->a+b+c+d); //Maybe.none`
`static <ST,T> Ior<ST,T>`	`fromIterable(java.lang.Iterable<T> iterable)` Construct an Ior that contains a single value extracted from the supplied Iterable
`static <T> Ior<java.lang.Throwable,T>`	`fromPublisher(org.reactivestreams.Publisher<T> pub)` Construct an Ior that contains a single value extracted from the supplied reactive-streams Publisher
`PT`	`get()` Apply this function to the arguments.
`boolean`	`isBoth()`
`default boolean`	`isPresent()`
`boolean`	`isPrimary()`
`boolean`	`isSecondary()`
`<R> Ior<ST,R>`	`map(java.util.function.Function<? super PT,? extends R> fn)` Transform this functor using the supplied transformation function
`default Ior<ST,MonadicValue<PT>>`	`nest()` cojoin pattern.
`default Ior<ST,PT>`	`notNull()` Filter elements retaining only values which are not null
`default <U> Ior<ST,U>`	`ofType(java.lang.Class<? extends U> type)` Keep only those elements in a stream that are of a given type.
`Ior<ST,PT>`	`peek(java.util.function.Consumer<? super PT> action)` Peek at the current value of this Transformable, without transforming it
`static <ST,PT> Ior<ST,PT>`	`primary(PT primary)` Create an instance of the primary type.
`default <R> Ior<ST,R>`	`retry(java.util.function.Function<? super PT,? extends R> fn)` Retry a transformation if it fails.
`default <R> Ior<ST,R>`	`retry(java.util.function.Function<? super PT,? extends R> fn, int retries, long delay, java.util.concurrent.TimeUnit timeUnit)` Retry a transformation if it fails.
`static <ST,PT> Ior<ST,PT>`	`secondary(ST secondary)` Create an instance of the secondary type.
`<LT1> Ior<LT1,PT>`	`secondaryFlatMap(java.util.function.Function<? super ST,? extends Ior<LT1,PT>> mapper)` Perform a flatMap operation on the Secondary type
`ST`	`secondaryGet()`
`<R> Ior<R,PT>`	`secondaryMap(java.util.function.Function<? super ST,? extends R> fn)` Always map the Secondary type of this Ior if it is present using the provided transformation function
`Ior<ST,PT>`	`secondaryPeek(java.util.function.Consumer<? super ST> action)` Peek at the Secondary type value if present
`java.util.Optional<ST>`	`secondaryToOptional()`
`Ior<ST,PT>`	`secondaryToPrimayFlatMap(java.util.function.Function<? super ST,? extends Ior<ST,PT>> fn)` A flatMap operation that keeps the Secondary and Primary types the same
`Ior<ST,PT>`	`secondaryToPrimayMap(java.util.function.Function<? super ST,? extends PT> fn)` If this Ior contains the Secondary type only, map it's value so that it contains the Primary type only If this Ior contains both types, this method has no effect in the default implementations
`ReactiveSeq<ST>`	`secondaryToStream()`
`Value<ST>`	`secondaryValue()`
`static <ST,PT> Ior<ListX<ST>,ListX<PT>>`	`sequencePrimary(CollectionX<Ior<ST,PT>> iors)` Turn a collection of Iors into a single Ior with Lists of values.
`static <ST,PT> Ior<ListX<PT>,ListX<ST>>`	`sequenceSecondary(CollectionX<? extends Ior<ST,PT>> iors)` Turn a collection of Iors into a single Ior with Lists of values.
`Ior<PT,ST>`	`swap()`
`default Ior<ST,PT>`	`toIor()` Return an Ior that can be this object or a Ior.primary or Ior.secondary
`Xor<ST,PT>`	`toXor()`
`default <ST2> Xor<ST2,PT>`	`toXor(ST2 secondary)` Convert to an Xor where the secondary value will be used if no primary value is present
`Xor<ST,PT>`	`toXorDropPrimary()`
`default <R> Ior<ST,R>`	`trampoline(java.util.function.Function<? super PT,? extends Trampoline<? extends R>> mapper)` Performs a map operation that can call a recursive method without running out of stack space
`default <T> Ior<ST,T>`	`unit(T unit)`
`default <R> R`	`visit(java.util.function.Function<? super ST,? extends R> secondary, java.util.function.Function<? super PT,? extends R> primary, java.util.function.BiFunction<? super ST,? super PT,? extends R> both)` Visitor pattern for this Ior.
`static <X,LT extends X,RT extends X> X`	`visitAny(java.util.function.Consumer<? super X> c, Ior<LT,RT> either)`
`static <X,PT extends X,ST extends X,R> R`	`visitAny(Ior<ST,PT> either, java.util.function.Function<? super X,? extends R> fn)`
`default Ior<ST,PT>`	`zip(java.util.function.BinaryOperator<Zippable<PT>> combiner, Zippable<PT> app)` Combine two applicatives together using the provided BinaryOperator (Semigroup, Monoid and Reducer all extend BinaryOperator - checkout Semigroups and Monoids for a large number of canned combinations).
`default <T2,R> Ior<ST,R>`	`zip(java.lang.Iterable<? extends T2> app, java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)` Zip (combine) this Zippable with the supplied Iterable using the supplied combining function
`default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>>`	`zip(java.lang.Iterable<? extends U> other)` Zip (combine) this Zippable with the supplied Iterable combining both into a Tuple2
`default <S,U> Ior<ST,org.jooq.lambda.tuple.Tuple3<PT,S,U>>`	`zip3(java.lang.Iterable<? extends S> second, java.lang.Iterable<? extends U> third)` zip 3 Streams into one
`default <S,U,R> Ior<ST,R>`	`zip3(java.lang.Iterable<? extends S> second, java.lang.Iterable<? extends U> third, Fn3<? super PT,? super S,? super U,? extends R> fn3)`
`default <T2,T3,T4> Ior<ST,org.jooq.lambda.tuple.Tuple4<PT,T2,T3,T4>>`	`zip4(java.lang.Iterable<? extends T2> second, java.lang.Iterable<? extends T3> third, java.lang.Iterable<? extends T4> fourth)` zip 4 Streams into 1
`default <T2,T3,T4,R> Ior<ST,R>`	`zip4(java.lang.Iterable<? extends T2> second, java.lang.Iterable<? extends T3> third, java.lang.Iterable<? extends T4> fourth, Fn4<? super PT,? super T2,? super T3,? super T4,? extends R> fn)`
`default <T2,R> Ior<ST,R>`	`zipP(org.reactivestreams.Publisher<? extends T2> app, java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)` Zip (combine) this Zippable with the supplied Publisher, using the supplied combining function
`default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>>`	`zipP(org.reactivestreams.Publisher<? extends U> other)`
`default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>>`	`zipS(java.util.stream.Stream<? extends U> other)` Zip (combine) this Zippable with the supplied Stream combining both into a Tuple2
`default <U,R> Ior<ST,R>`	`zipS(java.util.stream.Stream<? extends U> other, java.util.function.BiFunction<? super PT,? super U,? extends R> zipper)` Zip (combine) this Zippable with the supplied Stream, using the supplied combining function
`default <R> Ior<ST,R>`	`zipWith(java.lang.Iterable<java.util.function.Function<? super PT,? extends R>> fn)`
`default <R> Ior<ST,R>`	`zipWithP(org.reactivestreams.Publisher<java.util.function.Function<? super PT,? extends R>> fn)`
`default <R> Ior<ST,R>`	`zipWithS(java.util.stream.Stream<java.util.function.Function<? super PT,? extends R>> fn)`

Methods inherited from interface com.aol.cyclops2.types.To
to

Methods inherited from interface com.aol.cyclops2.types.Value
apply, generate, iterate, iterator, mkString, newSubscriber, of, stream, subscribe, test, toEvalAlways, toEvalLater, toEvalNow, toMaybe, toTry, toTry, toTry

Methods inherited from interface com.aol.cyclops2.types.Folds
endsWith, endsWithIterable, findAny, findFirst, firstValue, foldLeft, foldLeft, foldLeft, foldLeft, foldRight, foldRight, foldRight, foldRightMapToType, get, groupBy, join, join, join, mapReduce, mapReduce, print, print, printErr, printOut, reduce, reduce, reduce, reduce, reduce, reduce, reduce, schedule, scheduleFixedDelay, scheduleFixedRate, single, single, singleOptional, startsWith, startsWithIterable, toConcurrentLazyCollection, toConcurrentLazyStreamable, toLazyCollection, xMatch

Methods inherited from interface com.aol.cyclops2.types.stream.ToStream
futureStream, getStreamable, isEmpty, jdkStream, reactiveSeq, reveresedJDKStream, reveresedStream

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from interface com.aol.cyclops2.types.Convertable
collect, fromSupplier, orElse, orElseGet, orElseThrow, toCompletableFuture, toCompletableFutureAsync, toCompletableFutureAsync, toFuture, toFutureWAsync, toFutureWAsync, toOptional, toStream, visit

Methods inherited from interface cyclops.function.Fn0
andThen, fnTo, functionOps, lift, lift, liftF, liftOpt, liftTry, memoize, memoize, run, suspend, λ, λv

Methods inherited from interface org.jooq.lambda.function.Function0
apply, from, toSupplier

Methods inherited from interface java.util.function.Predicate
and, isEqual, negate, or

Method Detail

consumeAny
```
static <X,LT extends X,M extends X,RT extends X> java.util.function.Consumer<java.util.function.Consumer<? super X>> consumeAny(Ior<LT,RT> either)
```
Static method useful as a method reference for fluent consumption of any value type stored in this Either (will capture the lowest common type)
```
 

   myEither.to(Xor::consumeAny)
    .accept(System.out::println);
 
 
```
Parameters:

either - Xor to consume value for

Returns:

Consumer we can apply to consume value

applyAny

static <X,LT extends X,M extends X,RT extends X,R> java.util.function.Function<java.util.function.Function<? super X,R>,R> applyAny(Ior<LT,RT> either)

visitAny

static <X,PT extends X,ST extends X,R> R visitAny(Ior<ST,PT> either,
                                                  java.util.function.Function<? super X,? extends R> fn)

visitAny

static <X,LT extends X,RT extends X> X visitAny(java.util.function.Consumer<? super X> c,
                                                Ior<LT,RT> either)

both

@Deprecated
static <ST,PT> Ior<ST,PT> both(Ior<ST,PT> secondary,
                                           Ior<ST,PT> primary)

Deprecated.

fromPublisher

static <T> Ior<java.lang.Throwable,T> fromPublisher(org.reactivestreams.Publisher<T> pub)

Construct an Ior that contains a single value extracted from the supplied reactive-streams Publisher

  
   ReactiveSeq<Integer> stream =  ReactiveSeq.of(1,2,3);
        
        Ior<Throwable,Integer> future = Ior.fromPublisher(stream);
        
        //Ior[1]

Parameters:: pub - Publisher to extract value from
Returns:: Ior populated from Publisher

fromIterable

static <ST,T> Ior<ST,T> fromIterable(java.lang.Iterable<T> iterable)

Construct an Ior that contains a single value extracted from the supplied Iterable

  
   List<Integer> list =  Arrays.asList(1,2,3);
        
        Ior<Throwable,Integer> future = Ior.fromPublisher(list);
        
        //Ior[1]

Parameters:: iterable - Iterable to extract value from
Returns:: Ior populated from Iterable

primary
```
static <ST,PT> Ior<ST,PT> primary(PT primary)
```
Create an instance of the primary type. Most methods are biased to the primary type, which means, for example, that the map method operates on the primary type but does nothing on secondary Iors
```
  
   Ior.<Integer,Integer>primary(10).map(i->i+1);
 //Ior.primary[11]
    
   
 
 
```
Parameters:

value - To construct an Ior from

Returns:

Primary type instanceof Ior

secondary
```
static <ST,PT> Ior<ST,PT> secondary(ST secondary)
```
Create an instance of the secondary type. Most methods are biased to the primary type, so you will need to use swap() or secondaryXXXX to manipulate the wrapped value
```
  
   Ior.<Integer,Integer>secondary(10).map(i->i+1);
   //Ior.secondary[10]
    
    Ior.<Integer,Integer>secondary(10).swap().map(i->i+1);
    //Ior.primary[11]
 
 
```
Parameters:

value - to wrap

Returns:

Secondary instance of Ior

both
```
static <ST,PT> Ior<ST,PT> both(ST secondary,
                               PT primary)
```
Create an Ior instance that contains both secondary and primary types
```
  
    Ior<String,Ingeger> kv = Ior.both("hello",90);
    //Ior["hello",90]
 
 
```
Parameters:

secondary - Secondary value

primary - Primary value

Returns:

Ior that contains both the secondary and the primary value

zipWith

default <R> Ior<ST,R> zipWith(java.lang.Iterable<java.util.function.Function<? super PT,? extends R>> fn)

Specified by:: zipWith in interface Zippable<PT>

zipWithS

default <R> Ior<ST,R> zipWithS(java.util.stream.Stream<java.util.function.Function<? super PT,? extends R>> fn)

Specified by:: zipWithS in interface Zippable<PT>

zipWithP

default <R> Ior<ST,R> zipWithP(org.reactivestreams.Publisher<java.util.function.Function<? super PT,? extends R>> fn)

Specified by:: zipWithP in interface Zippable<PT>

retry

default <R> Ior<ST,R> retry(java.util.function.Function<? super PT,? extends R> fn)

Description copied from interface: Transformable

Retry a transformation if it fails. Default settings are to retry up to 7 times, with an doubling backoff period starting @ 2 seconds delay before retry.

 
 given(serviceMock.apply(anyInt())).willThrow(
 				new RuntimeException(new SocketException("First")),
 				new RuntimeException(new IOException("Second"))).willReturn(
 				"42");


 		String result = ReactiveSeq.of( 1,  2, 3)
 				.retry(serviceMock)
 				.firstValue();

 		//result = 42

Specified by:: retry in interface Transformable<PT>
Parameters:: fn - Function to retry if fails

zipP

default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>> zipP(org.reactivestreams.Publisher<? extends U> other)

Specified by:: zipP in interface Zippable<PT>

retry

default <R> Ior<ST,R> retry(java.util.function.Function<? super PT,? extends R> fn,
                            int retries,
                            long delay,
                            java.util.concurrent.TimeUnit timeUnit)

Description copied from interface: Transformable

Retry a transformation if it fails. Retries up to retries times, with an doubling backoff period starting @ delay TimeUnits delay before retry.

 
 given(serviceMock.apply(anyInt())).willThrow(
 				new RuntimeException(new SocketException("First")),
 				new RuntimeException(new IOException("Second"))).willReturn(
 				"42");


 		String result = ReactiveSeq.of( 1,  2, 3)
 				.retry(serviceMock, 7, 2, TimeUnit.SECONDS)
 				.firstValue();

 		//result = 42

Specified by:: retry in interface Transformable<PT>
Parameters:: fn - Function to retry if fails; retries - Number of retries; delay - Delay in TimeUnits; timeUnit - TimeUnit to use for delay

zip3

default <S,U> Ior<ST,org.jooq.lambda.tuple.Tuple3<PT,S,U>> zip3(java.lang.Iterable<? extends S> second,
                                                                java.lang.Iterable<? extends U> third)

Description copied from interface: Zippable

zip 3 Streams into one

 
  List<Tuple3<Integer, Integer, Character>> list = of(1, 2, 3, 4, 5, 6).zip3(of(100, 200, 300, 400), of('a', 'b', 'c')).collect(Collectors.toList());

  // [[1,100,'a'],[2,200,'b'],[3,300,'c']]

Specified by:: zip3 in interface Zippable<PT>

zip3

default <S,U,R> Ior<ST,R> zip3(java.lang.Iterable<? extends S> second,
                               java.lang.Iterable<? extends U> third,
                               Fn3<? super PT,? super S,? super U,? extends R> fn3)

Specified by:: zip3 in interface Zippable<PT>

zip4

default <T2,T3,T4> Ior<ST,org.jooq.lambda.tuple.Tuple4<PT,T2,T3,T4>> zip4(java.lang.Iterable<? extends T2> second,
                                                                          java.lang.Iterable<? extends T3> third,
                                                                          java.lang.Iterable<? extends T4> fourth)

Description copied from interface: Zippable

zip 4 Streams into 1

 
  List<Tuple4<Integer, Integer, Character, String>> list = of(1, 2, 3, 4, 5, 6).zip4(of(100, 200, 300, 400), of('a', 'b', 'c'), of("hello", "world"))
          .collect(Collectors.toList());

 
 // [[1,100,'a',"hello"],[2,200,'b',"world"]]

Specified by:: zip4 in interface Zippable<PT>

zip4

default <T2,T3,T4,R> Ior<ST,R> zip4(java.lang.Iterable<? extends T2> second,
                                    java.lang.Iterable<? extends T3> third,
                                    java.lang.Iterable<? extends T4> fourth,
                                    Fn4<? super PT,? super T2,? super T3,? super T4,? extends R> fn)

Specified by:: zip4 in interface Zippable<PT>

flatMapS

default <R> Ior<ST,R> flatMapS(java.util.function.Function<? super PT,? extends java.util.stream.Stream<? extends R>> mapper)

Specified by:: flatMapS in interface MonadicValue<PT>

forEach4

default <T2,R1,R2,R3,R> Ior<ST,R> forEach4(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                           java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2,
                                           Fn3<? super PT,? super R1,? super R2,? extends MonadicValue<R3>> value3,
                                           Fn4<? super PT,? super R1,? super R2,? super R3,? extends R> yieldingFunction)

Description copied from interface: MonadicValue

Perform a four level nested internal iteration over this MonadicValue and the supplied MonadicValues

  
  Maybe.of(3)
       .forEach4(a->Maybe.just(a+10),
                 (a,b)->Maybe.just(a+b),
                 (a,b,c)->Maybe.none(),
                 (a,b,c,d)->a+b+c+d);
                                  
  
  //Maybe.none

Specified by:: forEach4 in interface MonadicValue<PT>
Parameters:: value1 - Nested MonadicValue to iterate over; value2 - Nested MonadicValue to iterate over; value3 - Nested MonadicValue to iterate over; yieldingFunction - Function with pointers to the current element from both MonadicValue that generates the new elements
Returns:: MonadicValue with elements generated via nested iteration

forEach4
```
default <T2,R1,R2,R3,R> Ior<ST,R> forEach4(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                           java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2,
                                           Fn3<? super PT,? super R1,? super R2,? extends MonadicValue<R3>> value3,
                                           Fn4<? super PT,? super R1,? super R2,? super R3,java.lang.Boolean> filterFunction,
                                           Fn4<? super PT,? super R1,? super R2,? super R3,? extends R> yieldingFunction)
```
Description copied from interface: MonadicValue

Perform a four level nested internal iteration over this MonadicValue and the supplied MonadicValues Maybe.of(3) .forEach4(a->Maybe.just(a+10), (a,b)->Maybe.just(a+b), (a,b,c)->Maybe.none(), (a,b,c,d)->a+b+c<100, (a,b,c,d)->a+b+c+d); //Maybe.none

Specified by:

forEach4 in interface MonadicValue<PT>

Parameters:

value1 - Nested MonadicValue to iterate over

value2 - Nested MonadicValue to iterate over

value3 - Nested MonadicValue to iterate over

filterFunction - Filter to apply over elements before passing non-filtered values to the yielding function

yieldingFunction - Function with pointers to the current element from both MonadicValue that generates the new elements

Returns:

MonadicValue with elements generated via nested iteration

forEach3

default <T2,R1,R2,R> Ior<ST,R> forEach3(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                        java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2,
                                        Fn3<? super PT,? super R1,? super R2,? extends R> yieldingFunction)

Description copied from interface: MonadicValue

Perform a three level nested internal iteration over this MonadicValue and the supplied MonadicValues

  
  Maybe.of(3)
       .forEach3(a->Maybe.just(a+10),
                 (a,b)->Maybe.just(a+b),
                 (a,b,c)->a+b+c<100,
                 (a,b,c)->a+b+c);
                                  
  
  //Maybe[32]

Specified by:: forEach3 in interface MonadicValue<PT>
Parameters:: value1 - Nested MonadicValue to iterate over; value2 - Nested MonadicValue to iterate over; yieldingFunction - Function with pointers to the current element from both MonadicValue that generates the new elements
Returns:: MonadicValue with elements generated via nested iteration

forEach3

default <T2,R1,R2,R> Ior<ST,R> forEach3(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                        java.util.function.BiFunction<? super PT,? super R1,? extends MonadicValue<R2>> value2,
                                        Fn3<? super PT,? super R1,? super R2,java.lang.Boolean> filterFunction,
                                        Fn3<? super PT,? super R1,? super R2,? extends R> yieldingFunction)

Description copied from interface: MonadicValue

Perform a three level nested internal iteration over this MonadicValue and the supplied MonadicValues

  
  Maybe.of(3)
       .forEach3(a->Maybe.just(a+10),
                 (a,b)->Maybe.just(a+b),
                 (a,b,c)->a+b+c<100,
                 (a,b,c)->a+b+c);
                                  
  
  //Maybe[32]

Specified by:: forEach3 in interface MonadicValue<PT>
Parameters:: value1 - Nested MonadicValue to iterate over; value2 - Nested MonadicValue to iterate over; filterFunction - Filter to apply over elements before passing non-filtered values to the yielding function; yieldingFunction - Function with pointers to the current element from both MonadicValue that generates the new elements
Returns:: MonadicValue with elements generated via nested iteration

forEach2
```
default <R1,R> Ior<ST,R> forEach2(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                  java.util.function.BiFunction<? super PT,? super R1,? extends R> yieldingFunction)
```
Description copied from interface: MonadicValue
Perform a two level nested internal iteration over this MonadicValue and the supplied MonadicValue
```
  
  Maybe.of(3)
       .forEach2(a->Maybe.none(),
                 (a,b)->a+b);
                                  
 
  //Maybe.none()
 
 
```
Specified by:

forEach2 in interface MonadicValue<PT>

Parameters:

value1 - Nested Monadic Type to iterate over

yieldingFunction - Function with pointers to the current element from both monad types that generates the new elements

Returns:

MonadicValue with elements generated via nested iteration

forEach2

default <R1,R> Ior<ST,R> forEach2(java.util.function.Function<? super PT,? extends MonadicValue<R1>> value1,
                                  java.util.function.BiFunction<? super PT,? super R1,java.lang.Boolean> filterFunction,
                                  java.util.function.BiFunction<? super PT,? super R1,? extends R> yieldingFunction)

Description copied from interface: MonadicValue

Perform a two level nested internal iteration over this MonadicValue and the supplied stream

  
  Maybe.of(3)
       .forEach2(a->Maybe.none(),
                 a->b-> a<3 && b>10,
                 (a,b)->a+b);
                                  
 
  //Maybe.none()

Specified by:: forEach2 in interface MonadicValue<PT>; filterFunction - Filter to apply over elements before passing non-filtered values to the yielding function; yieldingFunction - Function with pointers to the current element from both Streams that generates the new elements
Returns:: MonadicValue with elements generated via nested iteration

flatMapI
```
default <R> Ior<ST,R> flatMapI(java.util.function.Function<? super PT,? extends java.lang.Iterable<? extends R>> mapper)
```
Description copied from interface: MonadicValue
A flattening transformation operation that takes the first value from the returned Iterable.
```
  
   Maybe.just(1).map(i->i+2).flatMapI(i->Arrays.asList(()->i*3,20);
   //Maybe[9]
 
 
```
Specified by:

flatMapI in interface MonadicValue<PT>

Parameters:

mapper - transformation function

Returns:

MonadicValue

flatMapP
```
default <R> Ior<ST,R> flatMapP(java.util.function.Function<? super PT,? extends org.reactivestreams.Publisher<? extends R>> mapper)
```
Description copied from interface: MonadicValue
A flattening transformation operation that takes the first value from the returned Publisher.
```
  
   FutureW.ofResult(1).map(i->i+2).flatMapP(i->Flux.just(()->i*3,20);
   //FutureW[9]
 
 
```
Specified by:

flatMapP in interface MonadicValue<PT>

Parameters:

mapper - transformation function

Returns:

MonadicValue

anyM

default AnyMValue<Witness.ior,PT> anyM()

unit
```
default <T> Ior<ST,T> unit(T unit)
```
Specified by:

unit in interface MonadicValue<PT>

Specified by:

unit in interface Unit<PT>

filter
```
Ior<ST,PT> filter(java.util.function.Predicate<? super PT> test)
```
Description copied from interface: Filters
Keep only elements for which the supplied predicates hold e.g.
```
  
   
     of(1,2,3).filter(i->i>2);
     
     //[3]
   
 
 
```
Specified by:

filter in interface Filters<PT>

Specified by:

filter in interface MonadicValue<PT>

Parameters:

test - to filter elements by, retaining matches

Returns:

Filters with elements removed where the predicate does not hold

toXor
```
Xor<ST,PT> toXor()
```
Specified by:

toXor in interface Value<PT>

Returns:

Primary Xor that has the same value as this Value

toXorDropPrimary
```
Xor<ST,PT> toXorDropPrimary()
```
Returns:

Convert to an Xor, dropping the primary type if this Ior contains both

toXor
```
default <ST2> Xor<ST2,PT> toXor(ST2 secondary)
```
Description copied from interface: Value

Convert to an Xor where the secondary value will be used if no primary value is present

Specified by:

toXor in interface Value<PT>

Parameters:

secondary - Value to use in case no primary value is present

Returns:

Primary Xor with same value as this Value, or a Secondary Xor with the provided Value if this Value is empty

toIor
```
default Ior<ST,PT> toIor()
```
Description copied from interface: Value

Return an Ior that can be this object or a Ior.primary or Ior.secondary

Specified by:

toIor in interface Value<PT>

Returns:

new Ior

secondaryToPrimayMap
```
Ior<ST,PT> secondaryToPrimayMap(java.util.function.Function<? super ST,? extends PT> fn)
```
If this Ior contains the Secondary type only, map it's value so that it contains the Primary type only If this Ior contains both types, this method has no effect in the default implementations

Parameters:

fn - Function to map secondary type to primary

Returns:

Ior with secondary type mapped to primary

secondaryMap
```
<R> Ior<R,PT> secondaryMap(java.util.function.Function<? super ST,? extends R> fn)
```
Always map the Secondary type of this Ior if it is present using the provided transformation function

Parameters:

fn - Transformation function for Secondary types

Returns:

Ior with Secondary type transformed

map
```
<R> Ior<ST,R> map(java.util.function.Function<? super PT,? extends R> fn)
```
Description copied from interface: Transformable
Transform this functor using the supplied transformation function
```
  
  
  
    of(1,2,3).map(i->i*2)
    
    //[2,4,6]
  
 
 
```
Specified by:

map in interface MonadicValue<PT>

Specified by:

map in interface Transformable<PT>

Parameters:

fn - Transformation function

Returns:

Transformed Transformable

secondaryPeek
```
Ior<ST,PT> secondaryPeek(java.util.function.Consumer<? super ST> action)
```
Peek at the Secondary type value if present

Parameters:

action - Consumer to peek at the Secondary type value

Returns:

Ior with the same values as before

peek
```
Ior<ST,PT> peek(java.util.function.Consumer<? super PT> action)
```
Description copied from interface: Transformable
Peek at the current value of this Transformable, without transforming it
```
  
  
  
    of(1,2,3).map(System.out::println)
    
    1
    2
    3
  
 
 
```
Specified by:

peek in interface Transformable<PT>

Parameters:

action - Consumer that recieves each element from this Transformable

Returns:

Transformable that will peek at each value

swap
```
Ior<PT,ST> swap()
```
Returns:

Ior with Primary and Secondary types and value swapped

coflatMap
```
default <R> Ior<ST,R> coflatMap(java.util.function.Function<? super MonadicValue<PT>,R> mapper)
```
Description copied from interface: MonadicValue
Perform a coflatMap operation. The mapping function accepts this MonadicValue and returns a single value to be wrapped inside a Monad.
```
  
   Maybe.none().coflatMap(m -> m.isPresent() ? m.get() : 10);
   //Maybe[10]
 
 
```
Specified by:

coflatMap in interface MonadicValue<PT>

Parameters:

mapper - Mapping / transformation function

Returns:

MonadicValue wrapping return value from transformation function applied to the value inside this MonadicValue

nest
```
default Ior<ST,MonadicValue<PT>> nest()
```
Description copied from interface: MonadicValue

cojoin pattern. Nests this Monad inside another.

Specified by:

nest in interface MonadicValue<PT>

Returns:

Nested Monad

combineEager

default Ior<ST,PT> combineEager(Monoid<PT> monoid,
                                MonadicValue<? extends PT> v2)

Description copied from interface: MonadicValue

Eagerly combine two MonadicValues using the supplied monoid (@see ApplicativeFunctor for type appropraite i.e. lazy / async alternatives)

  
 
  Monoid<Integer> add = Monoid.of(1,Semigroups.intSum);
  Maybe.of(10).combineEager(add,Maybe.none());
  //Maybe[10]
  
  Maybe.none().combineEager(add,Maybe.of(10));
  //Maybe[10]
  
  Maybe.none().combineEager(add,Maybe.none());
  //Maybe.none()
  
  Maybe.of(10).combineEager(add,Maybe.of(10));
  //Maybe[20]
  
  Monoid<Integer> firstNonNull = Monoid.of(null , Semigroups.firstNonNull());
  Maybe.of(10).combineEager(firstNonNull,Maybe.of(10));
  //Maybe[10]

Specified by:: combineEager in interface MonadicValue<PT>
Returns:

both
```
java.util.Optional<org.jooq.lambda.tuple.Tuple2<ST,PT>> both()
```
Returns:

An empty Optional if this Ior only has either the Secondary or Primary type. Or an Optional containing a Tuple2 with both the Secondary and Primary types if they are both present.

bothValue

default Value<java.util.Optional<org.jooq.lambda.tuple.Tuple2<ST,PT>>> bothValue()

Returns:: The result of @see Ior#both wrapped in a Value

bimap

default <R1,R2> Ior<R1,R2> bimap(java.util.function.Function<? super ST,? extends R1> fn1,
                                 java.util.function.Function<? super PT,? extends R2> fn2)

Description copied from interface: BiFunctor

Transform this BiFunctor, changing two value types at once.

 
     MapX<String,Integer> map = MapXs.of("hello",2);
     MapX<String,Integer> transformedMap = map.bimap(s->s+" world",i->i*4);
     //["hello world",8]

Specified by:: bimap in interface BiFunctor<ST,PT>
Parameters:: fn1 - transformation function for the first type; fn2 - transformation function for the second type
Returns:: New BiFunctor containing transformed data

visit

default <R> R visit(java.util.function.Function<? super ST,? extends R> secondary,
                    java.util.function.Function<? super PT,? extends R> primary,
                    java.util.function.BiFunction<? super ST,? super PT,? extends R> both)

Visitor pattern for this Ior. Execute the secondary function if this Ior contains an element of the secondary type only Execute the primary function if this Ior contains an element of the primary type only Execute the both function if this Ior contains an element of both type

  
  Ior.primary(10)
     .visit(secondary->"no", primary->"yes",(sec,pri)->"oops!")
  //Ior["yes"]
        
        Ior.secondary(90)
           .visit(secondary->"no", primary->"yes",(sec,pri)->"oops!")
        //Ior["no"]
         
        Ior.both(10, "eek")
           .visit(secondary->"no", primary->"yes",(sec,pri)->"oops!")
        //Ior["oops!"]

Parameters:: secondary - Function to execute if this is a Secondary Ior; primary - Function to execute if this is a Primary Ior; both - Function to execute if this Ior contains both types
Returns:: Result of executing the appropriate function

get
```
PT get()
```
Description copied from interface: org.jooq.lambda.function.Function0

Apply this function to the arguments.

Specified by:

get in interface Convertable<PT>

Specified by:

get in interface org.jooq.lambda.function.Function0<PT>

Specified by:

get in interface java.util.function.Supplier<PT>

Returns:

Contained value, maybe null

isPresent
```
default boolean isPresent()
```
Specified by:

isPresent in interface Convertable<PT>

Returns:

True if value exists and is non-null

secondaryValue
```
Value<ST> secondaryValue()
```
Returns:

A Value containing the secondary Value if present

secondaryGet
```
ST secondaryGet()
```
Returns:

The Secondary Value if present, otherwise null

secondaryToOptional
```
java.util.Optional<ST> secondaryToOptional()
```
Returns:

The Secondary value wrapped in an Optional if present, otherwise an empty Optional

secondaryToStream
```
ReactiveSeq<ST> secondaryToStream()
```
Returns:

A Stream containing the secondary value if present, otherwise an empty Stream

flatMap
```
<RT1> Ior<ST,RT1> flatMap(java.util.function.Function<? super PT,? extends MonadicValue<? extends RT1>> mapper)
```
Description copied from interface: MonadicValue
A flattening transformation operation (@see Optional.flatMap(Function)
```
  
   Eval.now(1).map(i->i+2).flatMap(i->Eval.later(()->i*3);
   //Eval[9]
 
 
```
Specified by:

flatMap in interface MonadicValue<PT>

Parameters:

mapper - transformation function

Returns:

MonadicValue

secondaryFlatMap
```
<LT1> Ior<LT1,PT> secondaryFlatMap(java.util.function.Function<? super ST,? extends Ior<LT1,PT>> mapper)
```
Perform a flatMap operation on the Secondary type

Parameters:

mapper - Flattening transformation function

Returns:

Ior containing the value inside the result of the transformation function as the Secondary value, if the Secondary type was present

secondaryToPrimayFlatMap
```
Ior<ST,PT> secondaryToPrimayFlatMap(java.util.function.Function<? super ST,? extends Ior<ST,PT>> fn)
```
A flatMap operation that keeps the Secondary and Primary types the same

Parameters:

fn - Transformation function

Returns:

Ior

isPrimary
```
boolean isPrimary()
```
Returns:

True if this is a primary (only) Ior

isSecondary
```
boolean isSecondary()
```
Returns:

True if this was a secondary (only) Ior

isBoth
```
boolean isBoth()
```
Returns:

True if this Ior has both secondary and primary types

sequenceSecondary

static <ST,PT> Ior<ListX<PT>,ListX<ST>> sequenceSecondary(CollectionX<? extends Ior<ST,PT>> iors)

Turn a collection of Iors into a single Ior with Lists of values. Primary and secondary types are swapped during this operation.

  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
  Ior<ListX<Integer>,ListX<String>> iors =Ior.sequenceSecondary(ListX.of(just,none,Ior.primary(1)));
        //Ior.primary(ListX.of("none")))

Parameters:: iors - Iors to sequence
Returns:: Ior sequenced and swapped

accumulateSecondary

static <ST,PT,R> Ior<?,R> accumulateSecondary(CollectionX<Ior<ST,PT>> iors,
                                              Reducer<R> reducer)

Accumulate the result of the Secondary types in the Collection of Iors provided using the supplied Reducer cyclops2.Reducers.

  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
        
  Ior<?,PSetX<String>> iors = Ior.accumulateSecondary(ListX.of(just,none,Ior.primary(1)),Reducers.<String>toPSetX());
      //Ior.primary(PSetX.of("none"))));

Parameters:: iors - Collection of Iors to accumulate secondary values; reducer - Reducer to accumulate results
Returns:: Ior populated with the accumulate secondary operation

accumulateSecondary
```
static <ST,PT,R> Ior<?,R> accumulateSecondary(CollectionX<Ior<ST,PT>> iors,
                                              java.util.function.Function<? super ST,R> mapper,
                                              Monoid<R> reducer)
```
Accumulate the results only from those Iors which have a Secondary type present, using the supplied mapping function to convert the data from each Ior before reducing them using the supplied Monoid (a combining BiFunction/BinaryOperator and identity element that takes two input values of the same type and returns the combined result) cyclops2.Monoids .
```
  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
        
  Ior<?,String> iors = Ior.accumulateSecondary(ListX.of(just,none,Ior.secondary("1")),i->""+i,Monoids.stringConcat);
        //Ior.primary("none1")
 
 
 
```
Parameters:

iors - Collection of Iors to accumulate secondary values

mapper - Mapping function to be applied to the result of each Ior

reducer - Semigroup to combine values from each Ior

Returns:

Ior populated with the accumulate Secondary operation

accumulateSecondary

static <ST,PT> Ior<?,ST> accumulateSecondary(Monoid<ST> reducer,
                                             CollectionX<Ior<ST,PT>> iors)

Accumulate the results only from those Iors which have a Secondary type present, using the supplied Monoid (a combining BiFunction/BinaryOperator and identity element that takes two input values of the same type and returns the combined result) cyclops2.Monoids .

  
 
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
        
 Ior<?,Integer> iors = Ior.accumulateSecondary(Monoids.intSum,ListX.of(Ior.both(2, "boo!"),Ior.secondary(1)));
       //Ior.primary(3);  2+1

Parameters:: iors - Collection of Iors to accumulate secondary values; reducer - Semigroup to combine values from each Ior
Returns:: populated with the accumulate Secondary operation

sequencePrimary

static <ST,PT> Ior<ListX<ST>,ListX<PT>> sequencePrimary(CollectionX<Ior<ST,PT>> iors)

Turn a collection of Iors into a single Ior with Lists of values.

  
 
 Ior<String,Integer> just  = Ior.primary(10);
       Ior<String,Integer> none = Ior.secondary("none");
        
        
 Ior<ListX<String>,ListX<Integer>> iors =Ior.sequencePrimary(ListX.of(just,none,Ior.primary(1)));
       //Ior.primary(ListX.of(10,1)));

Parameters:: iors - Iors to sequence
Returns:: Ior Sequenced

accumulatePrimary

static <ST,PT,R> Ior<?,R> accumulatePrimary(CollectionX<Ior<ST,PT>> iors,
                                            Reducer<R> reducer)

Accumulate the result of the Primary types in the Collection of Iors provided using the supplied Reducer cyclops2.Reducers.

  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
 
  Ior<?,PSetX<Integer>> iors =Ior.accumulatePrimary(ListX.of(just,none,Ior.primary(1)),Reducers.toPSetX());
        //Ior.primary(PSetX.of(10,1))));

Parameters:: iors - Collection of Iors to accumulate primary values; reducer - Reducer to accumulate results
Returns:: Ior populated with the accumulate primary operation

accumulatePrimary
```
static <ST,PT,R> Ior<?,R> accumulatePrimary(CollectionX<Ior<ST,PT>> iors,
                                            java.util.function.Function<? super PT,R> mapper,
                                            Semigroup<R> reducer)
```
Accumulate the results only from those Iors which have a Primary type present, using the supplied mapping function to convert the data from each Ior before reducing them using the supplied Semgigroup (a combining BiFunction/BinaryOperator that takes two input values of the same type and returns the combined result) cyclops2.Semigroups .
```
  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
        
 Ior<?,String> iors = Ior.accumulatePrimary(ListX.of(just,none,Ior.primary(1)),i->""+i,Semigroups.stringConcat);
       //Ior.primary("101"));
 
 
```
Parameters:

iors - Collection of Iors to accumulate primary values

mapper - Mapping function to be applied to the result of each Ior

reducer - Reducer to accumulate results

Returns:

Ior populated with the accumulate primary operation

accumulatePrimary

static <ST,PT> Ior<?,PT> accumulatePrimary(CollectionX<Ior<ST,PT>> iors,
                                           Semigroup<PT> reducer)

Accumulate the results only from those Iors which have a Primary type present, using the supplied Semgigroup (a combining BiFunction/BinaryOperator that takes two input values of the same type and returns the combined result) cyclops2.Semigroups .

  
  Ior<String,Integer> just  = Ior.primary(10);
        Ior<String,Integer> none = Ior.secondary("none");
  
  Ior<?,Integer> iors =Ior.accumulatePrimary(ListX.of(just,none,Ior.primary(1)),Semigroups.intSum);
        //Ior.primary(11);

Parameters:: iors - Collection of Iors to accumulate primary values; reducer - Reducer to accumulate results
Returns:: Ior populated with the accumulate primary operation

combine

default <T2,R> Ior<ST,R> combine(Value<? extends T2> app,
                                 java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)

Description copied from interface: MonadicValue

Lazily combine this ApplicativeFunctor with the supplied value via the supplied BiFunction Example

 
   Maybe<Integer> some = Maybe.just(10);
   just.combine(Eval.now(20), this::add);
   //Some[30]

   Maybe<Integer> none = Maybe.none();
   none.combine(Eval.now(20), this::add);
   //None

Specified by:: combine in interface MonadicValue<PT>
Parameters:: app - Value to combine with this one.; fn - BiFunction to combine them
Returns:: New Applicativefunctor that represents the combined values

zip
```
default Ior<ST,PT> zip(java.util.function.BinaryOperator<Zippable<PT>> combiner,
                       Zippable<PT> app)
```
Description copied from interface: Zippable

Combine two applicatives together using the provided BinaryOperator (Semigroup, Monoid and Reducer all extend BinaryOperator - checkout Semigroups and Monoids for a large number of canned combinations). If this Applicative is a scalar value the provided value is combined with that value, otherwise the value is combined pair wise with all value in a non-scalar datastructure
Specified by:

zip in interface Zippable<PT>

Returns:

See Also:
Semigroup, Semigroups, Monoid,
To lift any Semigroup (or monoid) up to handling Applicatives use the combineApplicatives operator in Semigroups {@see com.aol.cyclops2.Semigroups#combineApplicatives(BiFunction) } or Monoids { {@see com.aol.cyclops2.Monoids#combineApplicatives(java.util.function.Function, com.aol.cyclops2.function.Monoid) } {@code BinaryOperator> sumMaybes = Semigroups.combineScalarFunctors(Semigroups.intSum); Maybe.just(1).zip(sumMaybes, Maybe.just(5)) //Maybe.just(6)); }

ofType

default <U> Ior<ST,U> ofType(java.lang.Class<? extends U> type)

Description copied from interface: Filters

Keep only those elements in a stream that are of a given type.

  
 
 // (1, 2, 3) ReactiveSeq.of(1, "a", 2, "b",3).ofType(Integer.class)

Specified by:: ofType in interface Filters<PT>

filterNot
```
default Ior<ST,PT> filterNot(java.util.function.Predicate<? super PT> fn)
```
Description copied from interface: Filters
Remove any elements for which the predicate holds (inverse operation to filter) e.g.
```
  
   
     of(1,2,3).filter(i->i>2);
     
     //[1,2]
   
 
 
```
Specified by:

filterNot in interface Filters<PT>

Parameters:

fn - to filter elements by, retaining matches

Returns:

Filters with elements removed where the predicate does not hold

notNull
```
default Ior<ST,PT> notNull()
```
Description copied from interface: Filters
Filter elements retaining only values which are not null
```
  
 
   of(1,2,null,4).nonNull();
 
   //[1,2,4]
   
 
 
```
Specified by:

notNull in interface Filters<PT>

Returns:

Filters with nulls removed

cast
```
default <U> Ior<ST,U> cast(java.lang.Class<? extends U> type)
```
Description copied from interface: Transformable

Cast all elements in a stream to a given type, possibly throwing a ClassCastException. // ClassCastException ReactiveSeq.of(1, "a", 2, "b", 3).cast(Integer.class)

Specified by:

cast in interface Transformable<PT>

trampoline

default <R> Ior<ST,R> trampoline(java.util.function.Function<? super PT,? extends Trampoline<? extends R>> mapper)

Description copied from interface: Transformable

Performs a map operation that can call a recursive method without running out of stack space

 
 ReactiveSeq.of(10,20,30,40)
    			 .trampoline(i-> fibonacci(i))
    			 .forEach(System.out::println); 
    			 
    	Trampoline<Long> fibonacci(int i){
    		return fibonacci(i,1,0);
    	}
    	Trampoline<Long> fibonacci(int n, long a, long b) {
        	return n == 0 ? Trampoline.done(b) : Trampoline.more( ()->fibonacci(n-1, a+b, a));
    	}		 
    			 
 55
    	6765
    	832040
    	102334155
 
 
 ReactiveSeq.of(10_000,200_000,3_000_000,40_000_000)
    			 .trampoline(i-> fibonacci(i))
    			 .forEach(System.out::println);
    			 
    			 
 completes successfully

Specified by:: trampoline in interface Transformable<PT>
Parameters:: mapper - TCO Transformation function
Returns:: Transformable transformed by the supplied transformation function

bipeek
```
default Ior<ST,PT> bipeek(java.util.function.Consumer<? super ST> c1,
                          java.util.function.Consumer<? super PT> c2)
```
Description copied from interface: BiFunctor
Peek at two data types simulatanously (typically to perform a side-effect with each data point)
```
 
     MapX<String,Integer> map = MapXs.of("hello",2);
     map.bipeek(s->System.out.pritnln("key = " + s),System.out::println);
 
 
```
Specified by:

bipeek in interface BiFunctor<ST,PT>

Parameters:

c1 - consumer for the first type

c2 - consumer for the second type

Returns:

New BiFunctor with the same data

bicast

default <U1,U2> Ior<U1,U2> bicast(java.lang.Class<U1> type1,
                                  java.lang.Class<U2> type2)

Description copied from interface: BiFunctor

Cast two data types simulatanously.

 
     MapX<Animal,Food> map = MapXs.of(cow,grass);
     MapX<Mamaml,Vegitation> herbervoreMammals = map.bicast(Mammal.class,Vegitation.class);

Specified by:: bicast in interface BiFunctor<ST,PT>
Returns:

bitrampoline
```
default <R1,R2> Ior<R1,R2> bitrampoline(java.util.function.Function<? super ST,? extends Trampoline<? extends R1>> mapper1,
                                        java.util.function.Function<? super PT,? extends Trampoline<? extends R2>> mapper2)
```
Description copied from interface: BiFunctor

Perform a tail-call optimized recursive transformation operation across two data points simultaneously

Specified by:

bitrampoline in interface BiFunctor<ST,PT>

Parameters:

mapper1 - transformation function for the first type

mapper2 - transformation function for the second type

Returns:

New BiFunctor containing transformed data

zip
```
default <T2,R> Ior<ST,R> zip(java.lang.Iterable<? extends T2> app,
                             java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)
```
Description copied from interface: Zippable

Zip (combine) this Zippable with the supplied Iterable using the supplied combining function

Specified by:

zip in interface MonadicValue<PT>

Specified by:

zip in interface Zippable<PT>

Parameters:

app - to zip with

fn - Zip function

Returns:

Combined zippable

zipP
```
default <T2,R> Ior<ST,R> zipP(org.reactivestreams.Publisher<? extends T2> app,
                              java.util.function.BiFunction<? super PT,? super T2,? extends R> fn)
```
Description copied from interface: Zippable

Zip (combine) this Zippable with the supplied Publisher, using the supplied combining function

Specified by:

zipP in interface MonadicValue<PT>

Specified by:

zipP in interface Zippable<PT>

Parameters:

app - to combine with

fn - Zip / combining function

Returns:

Combined zippable

zipS
```
default <U,R> Ior<ST,R> zipS(java.util.stream.Stream<? extends U> other,
                             java.util.function.BiFunction<? super PT,? super U,? extends R> zipper)
```
Description copied from interface: Zippable

Zip (combine) this Zippable with the supplied Stream, using the supplied combining function

Specified by:

zipS in interface Zippable<PT>

Parameters:

other - Stream to combine with

zipper - Zip / combining function

Returns:

Combined zippable

zipS
```
default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>> zipS(java.util.stream.Stream<? extends U> other)
```
Description copied from interface: Zippable

Zip (combine) this Zippable with the supplied Stream combining both into a Tuple2

Specified by:

zipS in interface Zippable<PT>

Parameters:

other - Stream to combine with

Returns:

Combined Zippable

zip
```
default <U> Ior<ST,org.jooq.lambda.tuple.Tuple2<PT,U>> zip(java.lang.Iterable<? extends U> other)
```
Description copied from interface: Zippable

Zip (combine) this Zippable with the supplied Iterable combining both into a Tuple2

Specified by:

zip in interface Zippable<PT>

Parameters:

other - Iterable to combine with

Returns:

Interface Ior<ST,PT>

Nested Class Summary

Nested classes/interfaces inherited from interface com.aol.cyclops2.types.Value

Nested classes/interfaces inherited from interface com.aol.cyclops2.types.Convertable

Nested classes/interfaces inherited from interface cyclops.function.Fn0

Method Summary

Methods inherited from interface com.aol.cyclops2.types.To

Methods inherited from interface com.aol.cyclops2.types.Value

Methods inherited from interface com.aol.cyclops2.types.Folds

Methods inherited from interface com.aol.cyclops2.types.stream.ToStream

Methods inherited from interface java.lang.Iterable

Methods inherited from interface com.aol.cyclops2.types.Convertable

Methods inherited from interface cyclops.function.Fn0

Methods inherited from interface org.jooq.lambda.function.Function0

Methods inherited from interface java.util.function.Predicate

Method Detail

consumeAny

applyAny

visitAny

visitAny

both

fromPublisher

fromIterable

primary

secondary

both

zipWith

zipWithS

zipWithP

retry

zipP

retry

zip3

zip3

zip4

zip4

flatMapS

forEach4

forEach4

forEach3

forEach3

forEach2

forEach2

flatMapI

flatMapP

anyM

unit

filter

toXor

toXorDropPrimary

toXor

toIor

secondaryToPrimayMap

secondaryMap

map

secondaryPeek

peek

swap

coflatMap

nest

combineEager

both

bothValue

bimap

visit

get

isPresent

secondaryValue

secondaryGet

secondaryToOptional

secondaryToStream

flatMap

secondaryFlatMap

secondaryToPrimayFlatMap

isPrimary

isSecondary

isBoth

sequenceSecondary

accumulateSecondary

accumulateSecondary