Function1 (core 3.0.0 API)

Type Parameters:

T1 - the type of the input to the function

R - the type of the result of the function

All Superinterfaces:

Arity, FunctionN<R>, InputChainable<T1>, InputChainableInput<T1>, ResultChainable<R>, ResultChainableResult<R>, Variant<java.util.function.Function<T1,R>>

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 Function1<T1,R>
extends FunctionN<R>, Variant<java.util.function.Function<T1,R>>, InputChainableInput<T1>
```
Represents a function that accepts one argument and produces a result. This is the one-arity specialization of FunctionN.
This is a functional interface whose functional method is apply(Object).

Since:

3.0.0

See Also:

FunctionN

Nested Class Summary
- Nested classes/interfaces inherited from interface net.ashwork.functionality.FunctionN
  FunctionN.FunctionSizeException, FunctionN.Instance<R>

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default <V> Function1<T1,V>`	`andThen(Function1<? super R,? extends V> after)` Returns a chained object that applies this chainable object, and then applies the `after` function to ths result.
`default <V> Function1<T1,V>`	`andThenUnchecked(Function1<? super R,? extends V> after)` Returns a chained object that applies this chainable object, and then applies the `after` function to ths result.
`R`	`apply(T1 t1)` Applies this function to the given argument.
`default R`	`applyAllUnchecked(java.lang.Object... args)` Applies this function to the given arguments.
`default int`	`arity()` Returns the number of arguments of the function.
`default <V> Function1<V,R>`	`compose(Function1<? super V,? extends T1> before)` Returns a chained object that applies the `before` function to its input, and then applies this chainable object to the result.
`default <V> Function1<V,R>`	`composeUnchecked(Function1<? super V,? extends T1> before)` Returns a chained object that applies the `before` function to its input, and then applies this chainable object to the result.
`static <T1,R> Function1<T1,R>`	`fromVariant(java.util.function.Function<? super T1,? extends R> function)` Creates an instance of this object from its `Function` variant.
`default java.util.function.Function<T1,R>`	`toVariant()` Returns the variant of this object.

Methods inherited from interface net.ashwork.functionality.FunctionN
checkSize, checkSize, sizedApplyAllUnchecked

- Method Detail
  - apply
```
R apply(T1 t1)
```
    Applies this function to the given argument.
    
    Parameters:
    
    t1 - the function argument
    
    Returns:
    
    the function result
  - applyAllUnchecked
```
default R applyAllUnchecked(java.lang.Object... args)
```
    Description copied from interface: FunctionN
    
    Applies this function to the given arguments. Makes no assumptions of the arguments passed in and whether a value will compute successfully.
    
    Specified by:
    
    applyAllUnchecked in interface FunctionN<R>
    
    Parameters:
    
    args - the function arguments
    
    Returns:
    
    the function result
  - arity
```
default int arity()
```
    Description copied from interface: FunctionN
    
    Returns the number of arguments of the function. If used as a functional interface with a non-specific number of arguments, this will return -1.
    
    Specified by:
    
    arity in interface Arity
    
    Specified by:
    
    arity in interface FunctionN<R>
    
    Returns:
    
    the number of arguments of the function
  - fromVariant
```
static <T1,R> Function1<T1,R> fromVariant(java.util.function.Function<? super T1,? extends R> function)
```
    Creates an instance of this object from its Function variant.
    
    Type Parameters:
    
    T1 - the type of the input to the function
    
    R - the type of the result of the function
    
    Parameters:
    
    function - the variant of this object
    
    Returns:
    
    an instance of this object
    
    See Also:
    
    Function
  - toVariant
```
default java.util.function.Function<T1,R> toVariant()
```
    Description copied from interface: Variant
    
    Returns the variant of this object.
    
    Specified by:
    
    toVariant in interface Variant<java.util.function.Function<T1,R>>
    
    Returns:
    
    the variant of this object
    
    See Also:
    
    Function
  - compose
```
default <V> Function1<V,R> compose(Function1<? super V,? extends T1> before)
```
    Description copied from interface: InputChainable
    
    Returns a chained object that applies the before function to its input, and then applies this chainable object to the result. If evaluation of either throws an exception, it is relayed to the caller of the chained object.
    
    Specified by:
    
    compose in interface InputChainable<T1>
    
    Specified by:
    
    compose in interface InputChainableInput<T1>
    
    Type Parameters:
    
    V - the type of the input to the before function, and to then chained object
    
    Parameters:
    
    before - the function to apply before this chainable object is applied
    
    Returns:
    
    a chained object that first applies the before function and then applies this chainable object
  - composeUnchecked
```
default <V> Function1<V,R> composeUnchecked(Function1<? super V,? extends T1> before)
```
    Description copied from interface: InputChainable
    
    Returns a chained object that applies the before function to its input, and then applies this chainable object to the result. If evaluation of either throws an exception, it is relayed to the caller of the chained object. This makes no assumptions on the arguments of this method.
    
    Specified by:
    
    composeUnchecked in interface InputChainable<T1>
    
    Specified by:
    
    composeUnchecked in interface InputChainableInput<T1>
    
    Type Parameters:
    
    V - the type of the input to the before function, and to then chained object
    
    Parameters:
    
    before - the function to apply before this chainable object is applied
    
    Returns:
    
    a chained object that first applies the before function and then applies this chainable object
  - andThen
```
default <V> Function1<T1,V> andThen(Function1<? super R,? extends V> after)
```
    Description copied from interface: ResultChainable
    
    Returns a chained object that applies this chainable object, and then applies the after function to ths result. If evaluation of either throws an exception, it is relayed to the caller of the chained object.
    
    Specified by:
    
    andThen in interface FunctionN<R>
    
    Specified by:
    
    andThen in interface ResultChainable<R>
    
    Specified by:
    
    andThen in interface ResultChainableResult<R>
    
    Type Parameters:
    
    V - the type of the output of the after function, and of the chained object
    
    Parameters:
    
    after - the function to apply after this chainable object is applied
    
    Returns:
    
    a chained object that applies this chainable object and then applies the after function
  - andThenUnchecked
```
default <V> Function1<T1,V> andThenUnchecked(Function1<? super R,? extends V> after)
```
    Description copied from interface: ResultChainable
    
    Returns a chained object that applies this chainable object, and then applies the after function to ths result. If evaluation of either throws an exception, it is relayed to the caller of the chained object. This makes no assumptions on the arguments of this method.
    
    Specified by:
    
    andThenUnchecked in interface FunctionN<R>
    
    Specified by:
    
    andThenUnchecked in interface ResultChainable<R>
    
    Specified by:
    
    andThenUnchecked in interface ResultChainableResult<R>
    
    Type Parameters:
    
    V - the type of the output of the after function, and of the chained object
    
    Parameters:
    
    after - the function to apply after this chainable object is applied
    
    Returns:
    
    a chained object that applies this chainable object and then applies the after function

Interface Function1<T1,R>

Nested Class Summary

Nested classes/interfaces inherited from interface net.ashwork.functionality.FunctionN

Method Summary

Methods inherited from interface net.ashwork.functionality.FunctionN

Method Detail

apply

applyAllUnchecked

arity

fromVariant

toVariant

compose

composeUnchecked

andThen

andThenUnchecked