LToCharFunction (magma-func 2.0.0 API)

All Superinterfaces:

Codomain<aType.aChar>, Domain, Domain1<aType.a<T>>, Formattable, MetaFunction, MetaFunctionalInterface, MetaInterface, MetaInterface.NonThrowing, MetaInterface.Throwing<RuntimeException>, OFunction<T,aType.aChar>

All Known Implementing Classes:

LToCharFunction.LToCharFunctionSingle
```
@FunctionalInterface
public interface LToCharFunction<T>
extends MetaFunction, MetaInterface.NonThrowing, OFunction<T,aType.aChar>, Codomain<aType.aChar>, Domain1<aType.a<T>>
```
Non-throwing functional interface (lambda) LToCharFunction for Java 8.
Type: function
Domain (lvl: 1): T a
Co-domain: char
Special case of function that corresponds to expressions like (iterator) -> Iterator::next

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class LToCharFunction.LToCharFunctionSingle<T>
- Nested classes/interfaces inherited from interface eu.lunisolar.magma.basics.meta.MetaInterface
  MetaInterface.NonThrowing, MetaInterface.Throwing<X>

Nested Classes
Modifier and Type	Interface and Description
`static class`	`LToCharFunction.LToCharFunctionSingle<T>`

Field Summary

Fields
Modifier and Type Field and Description

static String DESCRIPTION

Fields
Modifier and Type	Field and Description
`static String`	`DESCRIPTION`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default char`	`applyAsChar(T a)`
`default char`	`applyAsChar(T a, ExWF<RuntimeException> exF)`
`default char`	`applyAsChar(T a, ExWMF<RuntimeException> exF, String newMessage, Object... messageParams)`
`default char`	`applyAsCharThen(T a, LToCharFunction<Throwable> handler)`
`char`	`applyAsCharX(T a)` Implement this, but call applyAsChar(T a)
`static <T> char`	`call(T a, LToCharFunction<T> lambda)`
`default LCharSupplier`	`capture(T a)` Captures arguments but delays the evaluation.
`default <V2> LToCharFunction<V2>`	`cast()` Cast that replace generics.
`static <V2,T> LToCharFunction<V2>`	`cast(LToCharFunction<T> function)` Cast that replace generics.
`default <V> LToCharFunction<V>`	`compose(LFunction<? super V,? extends T> before)` Allows to manipulate the domain of the function.
`static <V,T> LToCharFunction<V>`	`composed(LFunction<? super V,? extends T> before, LToCharFunction<T> after)`
`static <T> LToCharFunction<T>`	`constant(char r)` Creates function that always returns the same value.
`static <T> LToCharFunction<T>`	`failSafe(LToCharFunction<T> func, LToCharFunction<T> failSafe)`
`default char`	`failSafeApplyAsChar(T a, LToCharFunction<T> failSafe)`
`static <T> char`	`failSafeApplyAsChar(T a, LToCharFunction<T> func, LToCharFunction<T> failSafe)`
`default <C0> void`	`forEach(IndexedRead<C0,aType.a<T>> ia, C0 source, LCharConsumer consumer)` For each element (or tuple) from arguments, calls the function and passes the result to consumer.
`static <T> void`	`fromTill(int min_i, int max_i, T a, LToCharFunction<T> func)` From-To.
`static <T> void`	`fromTo(int min_i, int max_i, T a, LToCharFunction<T> func)` From-To.
`default String`	`functionalInterfaceDescription()` Returns description of the functional interface.
`default LToCharFunction<T>`	`handling(HandlingInstructions<Throwable,RuntimeException> handling)`
`default char`	`handlingApplyAsChar(T a, HandlingInstructions<Throwable,RuntimeException> handling)` Function call that handles exceptions according to the instructions.
`static <T> char`	`handlingApplyAsChar(T a, LToCharFunction<T> func, HandlingInstructions<Throwable,RuntimeException> handling)`
`default <C0,I0> void`	`iterate(SequentialRead<C0,I0,aType.a<T>> sa, C0 source, LCharConsumer consumer)` For each element (or tuple) from arguments, calls the function and passes the result to consumer.
`default char`	`nestingApplyAsChar(T a)` Function call that handles exceptions by always nesting checked exceptions and propagating the others as is.
`default char`	`nonNullApplyAsChar(T a)` Just to mirror the method: Ensures the result is not null
`static <T> char`	`produceChar(T a)` Does nothing (LToCharFunction) Function
`static <T> LToCharFunction<T>`	`recursive(LFunction<LToCharFunction<T>,LToCharFunction<T>> selfLambda)`
`static <T> LToCharFunction<T>`	`safe()` Safe instance.
`static <T> LToCharFunction<T>`	`safe(LToCharFunction<T> other)` Safe wrapping.
`static <T> LSupplier<LToCharFunction<T>>`	`safeSupplier()` Safe instance supplier.
`static <T> LSupplier<LToCharFunction<T>>`	`safeSupplier(LSupplier<LToCharFunction<T>> supplier)` Safe supplier.
`default char`	`shovingApplyAsChar(T a)` Function call that handles exceptions by always propagating them as is, even when they are undeclared checked ones.
`default <V> LFunction<T,V>`	`then(LCharFunction<? extends V> after)` Combines two functions together in a order.
`default LPredicate<T>`	`thenToBool(LCharPredicate after)` Combines two functions together in a order.
`default LToByteFunction<T>`	`thenToByte(LCharToByteFunction after)` Combines two functions together in a order.
`default LToCharFunction<T>`	`thenToChar(LCharUnaryOperator after)` Combines two functions together in a order.
`default LToDblFunction<T>`	`thenToDbl(LCharToDblFunction after)` Combines two functions together in a order.
`default LToFltFunction<T>`	`thenToFlt(LCharToFltFunction after)` Combines two functions together in a order.
`default LToIntFunction<T>`	`thenToInt(LCharToIntFunction after)` Combines two functions together in a order.
`default LToLongFunction<T>`	`thenToLong(LCharToLongFunction after)` Combines two functions together in a order.
`default LToSrtFunction<T>`	`thenToSrt(LCharToSrtFunction after)` Combines two functions together in a order.
`static <T> void`	`times(int max_i, T a, LToCharFunction<T> func)` From-To.
`static <T> LToCharFunction<T>`	`toCharFunc(LToCharFunction<T> lambda)` Convenient method in case lambda expression is ambiguous for the compiler (that might happen for overloaded methods accepting different interfaces).
`static <T> LToCharFunction<T>`	`toCharFuncThrowing(ExF<Throwable> exF)`
`static <T> LToCharFunction<T>`	`toCharFuncThrowing(String message, ExMF<Throwable> exF)`
`static <T> char`	`tryApplyAsChar(T a, LToCharFunction<T> func)`
`static <T> char`	`tryApplyAsChar(T a, LToCharFunction<T> func, ExWF<RuntimeException> exF)`
`static <T> char`	`tryApplyAsChar(T a, LToCharFunction<T> func, ExWMF<RuntimeException> exF, String newMessage, Object... messageParams)`
`static <T> char`	`tryApplyAsCharThen(T a, LToCharFunction<T> func, LToCharFunction<Throwable> handler)`
`default LToCharFunction<T>`	`trying(ExWF<RuntimeException> exF)`
`default LToCharFunction<T>`	`trying(ExWMF<RuntimeException> exF, String newMessage, Object... messageParams)`
`default LToCharFunction<T>`	`tryingThen(LToCharFunction<Throwable> handler)`
`default char`	`tupleApplyAsChar(LSingle<T> args)`
`default LToCharFunction`	`untyped()` Cast that removes generics.

Methods inherited from interface eu.lunisolar.magma.basics.meta.MetaInterface.NonThrowing
isThrowing

Methods inherited from interface eu.lunisolar.magma.basics.meta.functional.type.MetaFunction
isFunction

Methods inherited from interface eu.lunisolar.magma.basics.meta.functional.MetaFunctionalInterface
formatTo, isAction, isConsumer, isOperator, isPredicate, isSupplier

Field Detail
- DESCRIPTION
```
static final String DESCRIPTION
```
  See Also:
  
  Constant Field Values

Method Detail

applyAsChar
```
default char applyAsChar(T a)
```

applyAsCharX
```
char applyAsCharX(T a)
           throws Throwable
```
Implement this, but call applyAsChar(T a)

Throws:

Throwable

tupleApplyAsChar

default char tupleApplyAsChar(LSingle<T> args)

handlingApplyAsChar

default char handlingApplyAsChar(T a,
                                 HandlingInstructions<Throwable,RuntimeException> handling)

Function call that handles exceptions according to the instructions.

handling

default LToCharFunction<T> handling(HandlingInstructions<Throwable,RuntimeException> handling)

applyAsChar

default char applyAsChar(T a,
                         @Nonnull
                         ExWMF<RuntimeException> exF,
                         @Nonnull
                         String newMessage,
                         @Nullable
                         Object... messageParams)

trying

default LToCharFunction<T> trying(@Nonnull
                                  ExWMF<RuntimeException> exF,
                                  @Nonnull
                                  String newMessage,
                                  @Nullable
                                  Object... messageParams)

applyAsChar

default char applyAsChar(T a,
                         @Nonnull
                         ExWF<RuntimeException> exF)

trying

default LToCharFunction<T> trying(@Nonnull
                                  ExWF<RuntimeException> exF)

applyAsCharThen

default char applyAsCharThen(T a,
                             @Nonnull
                             LToCharFunction<Throwable> handler)

tryingThen

default LToCharFunction<T> tryingThen(@Nonnull
                                      LToCharFunction<Throwable> handler)

nestingApplyAsChar
```
default char nestingApplyAsChar(T a)
```
Function call that handles exceptions by always nesting checked exceptions and propagating the others as is.

shovingApplyAsChar
```
default char shovingApplyAsChar(T a)
```
Function call that handles exceptions by always propagating them as is, even when they are undeclared checked ones.

handlingApplyAsChar

static <T> char handlingApplyAsChar(T a,
                                    LToCharFunction<T> func,
                                    HandlingInstructions<Throwable,RuntimeException> handling)

tryApplyAsChar

static <T> char tryApplyAsChar(T a,
                               LToCharFunction<T> func)

tryApplyAsChar

static <T> char tryApplyAsChar(T a,
                               LToCharFunction<T> func,
                               @Nonnull
                               ExWMF<RuntimeException> exF,
                               @Nonnull
                               String newMessage,
                               @Nullable
                               Object... messageParams)

tryApplyAsChar

static <T> char tryApplyAsChar(T a,
                               LToCharFunction<T> func,
                               @Nonnull
                               ExWF<RuntimeException> exF)

tryApplyAsCharThen

static <T> char tryApplyAsCharThen(T a,
                                   LToCharFunction<T> func,
                                   @Nonnull
                                   LToCharFunction<Throwable> handler)

failSafeApplyAsChar

default char failSafeApplyAsChar(T a,
                                 @Nonnull
                                 LToCharFunction<T> failSafe)

failSafeApplyAsChar

static <T> char failSafeApplyAsChar(T a,
                                    LToCharFunction<T> func,
                                    @Nonnull
                                    LToCharFunction<T> failSafe)

failSafe

static <T> LToCharFunction<T> failSafe(LToCharFunction<T> func,
                                       @Nonnull
                                       LToCharFunction<T> failSafe)

nonNullApplyAsChar
```
default char nonNullApplyAsChar(T a)
```
Just to mirror the method: Ensures the result is not null

functionalInterfaceDescription
```
@Nonnull
default String functionalInterfaceDescription()
```
Returns description of the functional interface.

Specified by:

functionalInterfaceDescription in interface MetaFunctionalInterface

fromTo

static <T> void fromTo(int min_i,
                       int max_i,
                       T a,
                       LToCharFunction<T> func)

From-To. Intended to be used with non-capturing lambda.

fromTill

static <T> void fromTill(int min_i,
                         int max_i,
                         T a,
                         LToCharFunction<T> func)

From-To. Intended to be used with non-capturing lambda.

times

static <T> void times(int max_i,
                      T a,
                      LToCharFunction<T> func)

From-To. Intended to be used with non-capturing lambda.

untyped
```
default LToCharFunction untyped()
```
Cast that removes generics.

cast

default <V2> LToCharFunction<V2> cast()

Cast that replace generics.

cast

static <V2,T> LToCharFunction<V2> cast(LToCharFunction<T> function)

Cast that replace generics.

capture
```
default LCharSupplier capture(T a)
```
Captures arguments but delays the evaluation.

constant
```
static <T> LToCharFunction<T> constant(char r)
```
Creates function that always returns the same value.

toCharFunc

@Nonnull
static <T> LToCharFunction<T> toCharFunc(@Nonnull
                                                   LToCharFunction<T> lambda)

Convenient method in case lambda expression is ambiguous for the compiler (that might happen for overloaded methods accepting different interfaces).

recursive

@Nonnull
static <T> LToCharFunction<T> recursive(@Nonnull
                                                  LFunction<LToCharFunction<T>,LToCharFunction<T>> selfLambda)

toCharFuncThrowing

@Nonnull
static <T> LToCharFunction<T> toCharFuncThrowing(@Nonnull
                                                           ExF<Throwable> exF)

toCharFuncThrowing

@Nonnull
static <T> LToCharFunction<T> toCharFuncThrowing(String message,
                                                           @Nonnull
                                                           ExMF<Throwable> exF)

call

static <T> char call(T a,
                     @Nonnull
                     LToCharFunction<T> lambda)

safe
```
@Nonnull
static <T> LToCharFunction<T> safe()
```
Safe instance. That always returns the same value (as produceChar).

safeSupplier
```
@Nonnull
static <T> LSupplier<LToCharFunction<T>> safeSupplier()
```
Safe instance supplier. Returns supplier of safe() instance.

safe

@Nonnull
static <T> LToCharFunction<T> safe(@Nullable
                                             LToCharFunction<T> other)

Safe wrapping. Either argument function is returned (if it is not null) or safe() instance.

safeSupplier

@Nonnull
static <T> LSupplier<LToCharFunction<T>> safeSupplier(@Nullable
                                                                LSupplier<LToCharFunction<T>> supplier)

Safe supplier. Either argument supplier is returned (if it is not null) or supplier of safe() instance.

compose

@Nonnull
default <V> LToCharFunction<V> compose(@Nonnull
                                                 LFunction<? super V,? extends T> before)

Allows to manipulate the domain of the function.