com.aol.cyclops.types

Interface Functor<T>

All Known Subinterfaces:

AnyM<T>, AnyMSeq<T>, AnyMValue<T>, Applicativable<T>, Applicative<T,R,D>, Applicative2<T,T2,R,D>, Applicative3<T,T2,T3,R,D>, Applicative4<T,T2,T3,T4,R,D>, Applicative5<T,T2,T3,T4,T5,R,D>, CollectionX<T>, ConvertableFunctor<T>, ConvertableSequentialFunctor<T>, DequeX<T>, Eval<T>, FeatureToggle<F>, FilterableFunctor<T>, FlatMap<T>, FluentCollectionX<T>, FluentSequenceX<T>, Ior<ST,PT>, IterableFunctor<T>, LazyFutureStream<U>, ListX<T>, MapX<K,V>, Maybe<T>, Monad<T>, MutableCollectionX<T>, MutableSequenceX<T>, PBagX<T>, PersistentCollectionX<T>, PMapX<K,V>, POrderedSetX<T>, PQueueX<T>, PSetX<T>, PStackX<T>, PVectorX<T>, QueueX<T>, ReactiveSeq<T>, SetX<T>, SortedSetX<T>, Streamable<T>, Try<T,X>, WrappingFunctor<T>, Xor<ST,PT>, ZippingApplicativable<T>, ZippingApplicative<T,R,D>, ZippingApplicative2<T,T2,R,D>, ZippingApplicative3<T,T2,T3,R,D>, ZippingApplicative4<T,T2,T3,T4,R,D>, ZippingApplicative5<T,T2,T3,T4,T5,R,D>

All Known Implementing Classes:

AnyMSeqImpl, AnyMValueImpl, CollectionXImpl, DequeXImpl, Eval.Always, Eval.Later, Eval.Now, FeatureToggle.Disabled, FeatureToggle.Enabled, FunctorWrapper, FutureW, Ior.Both, Ior.Primary, Ior.Secondary, LazyFutureStreamImpl, LazyImmutable, ListXImpl, MapXImpl, MaterializedList, Maybe.Just, Maybe.Lazy, Maybe.Nothing, MonadWrapper, PBagXImpl, PMapXImpl, POrderedSetXImpl, PQueueXImpl, PSetXImpl, PStackXImpl, PVectorXImpl, QueueXImpl, ReactiveSeqImpl, ReversedIterator, SetXImpl, SortedSetXImpl, StreamableImpl, Try.Failure, Try.Success, Xor.Primary, Xor.Secondary

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface Functor<T>

Method Summary

Modifier and Type	Method and Description
default <U> Functor<U>	cast(java.lang.Class<U> type) Cast all elements in a stream to a given type, possibly throwing a ClassCastException.
<R> Functor<R>	map(java.util.function.Function<? super T,? extends R> fn)
default <R> Functor<R>	patternMatch(java.util.function.Function<Matchable.CheckValues<T,R>,Matchable.CheckValues<T,R>> case1, java.util.function.Supplier<? extends R> otherwise) Transform the elements of this Stream with a Pattern Matching case and default value
default Functor<T>	peek(java.util.function.Consumer<? super T> c)
default <R> Functor<R>	trampoline(java.util.function.Function<? super T,? extends Trampoline<? extends R>> mapper) Performs a map operation that can call a recursive method without running out of stack space

Method Detail

cast

default <U> Functor<U> cast(java.lang.Class<U> type)

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)

map

<R> Functor<R> map(java.util.function.Function<? super T,? extends R> fn)

peek

default Functor<T> peek(java.util.function.Consumer<? super T> c)

trampoline

default <R> Functor<R> trampoline(java.util.function.Function<? super T,? extends Trampoline<? extends R>> mapper)

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
 
 

Parameters:

mapper -

Returns:

patternMatch

default <R> Functor<R> patternMatch(java.util.function.Function<Matchable.CheckValues<T,R>,Matchable.CheckValues<T,R>> case1,
                                    java.util.function.Supplier<? extends R> otherwise)

Transform the elements of this Stream with a Pattern Matching case and default value

 
 List<String> result = CollectionX.of(1,2,3,4)
                                              .patternMatch(
                                                        c->c.valuesWhere(i->"even", (Integer i)->i%2==0 )
                                                      )
 
 // CollectionX["odd","even","odd","even"]
 

Parameters:

case1 - Function to generate a case (or chain of cases as a single case)

otherwise - Value if supplied case doesn't match

Returns:

CollectionX where elements are transformed by pattern matching