no.digipost.tuple.Decuple Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of digg Show documentation
Show all versions of digg Show documentation
Some stellar general purpose utils.
The newest version!
/*
* Copyright (C) Posten Norge AS
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package no.digipost.tuple;
import no.digipost.function.DecaFunction;
import java.util.function.Function;
/**
* A decuple is a simple composition of ten arbitrary values (objects). A decuple
* captures no semantics of the ten values, and they are only referred to as
* "the first", "the second", "the third", "the fourth", "the fifth", "the sixth", "the seventh",
* "the eighth", and "the ninth" value.
*
* @param The type of the first value
* @param The type of the second value
* @param The type of the third value
* @param The type of the fourth value
* @param The type of the fifth value
* @param The type of the sixth value
* @param The type of the seventh value
* @param The type of the eighth value
* @param The type of the ninth value
* @param The type of the tenth value
*/
public interface Decuple extends ViewableAsDecuple {
static Decuple of(T1 first, T2 second, T3 third, T4 fourth, T5 fifth, T6 sixth, T7 seventh, T8 eighth, T9 ninth, T10 tenth) {
return new XTuple<>(first, second, third, fourth, fifth, sixth, seventh, eighth, ninth, tenth);
}
static Decuple flatten(Tuple, T3>, T4>, T5>, T6>, T7>, T8>, T9>, T10> nestedTuple) {
return Decuple.of(nestedTuple.first().first().first().first().first().first().first().first().first(),
nestedTuple.first().first().first().first().first().first().first().first().second(),
nestedTuple.first().first().first().first().first().first().first().second(),
nestedTuple.first().first().first().first().first().first().second(),
nestedTuple.first().first().first().first().first().second(),
nestedTuple.first().first().first().first().second(),
nestedTuple.first().first().first().second(),
nestedTuple.first().first().second(),
nestedTuple.first().second(),
nestedTuple.second());
}
/**
* @return the first value
*/
T1 first();
/**
* @return the second value
*/
T2 second();
/**
* @return the third value
*/
T3 third();
/**
* @return the fourth value
*/
T4 fourth();
/**
* @return the fifth value
*/
T5 fifth();
/**
* @return the sixth value
*/
T6 sixth();
/**
* @return the seventh value
*/
T7 seventh();
/**
* @return the eighth value
*/
T8 eighth();
/**
* @return the ninth value
*/
T9 ninth();
/**
* @return the tenth value
*/
T10 tenth();
/**
* Create a new decuple by applying a function to the first element, and putting the
* result as the first element of the new decuple.
*
* @param mapper the function to apply to the first element
* @return the new decuple
*/
Decuple mapFirst(Function mapper);
/**
* Create a new decuple by applying a function to the second element, and putting the
* result as the second element of the new decuple.
*
* @param mapper the function to apply to the second element
* @return the new decuple
*/
Decuple mapSecond(Function mapper);
/**
* Create a new decuple by applying a function to the third element, and putting the
* result as the third element of the new decuple.
*
* @param mapper the function to apply to the third element
* @return the new decuple
*/
Decuple mapThird(Function mapper);
/**
* Create a new decuple by applying a function to the fourth element, and putting the
* result as the fourth element of the new decuple.
*
* @param mapper the function to apply to the fourth element
* @return the new decuple
*/
Decuple mapFourth(Function mapper);
/**
* Create a new decuple by applying a function to the fifth element, and putting the
* result as the fifth element of the new decuple.
*
* @param mapper the function to apply to the fifth element
* @return the new decuple
*/
Decuple mapFifth(Function mapper);
/**
* Create a new decuple by applying a function to the sixth element, and putting the
* result as the sixth element of the new decuple.
*
* @param mapper the function to apply to the sixth element
* @return the new decuple
*/
Decuple mapSixth(Function mapper);
/**
* Create a new decuple by applying a function to the seventh element, and putting the
* result as the seventh element of the new decuple.
*
* @param mapper the function to apply to the seventh element
* @return the new decuple
*/
Decuple mapSeventh(Function mapper);
/**
* Create a new decuple by applying a function to the eighth element, and putting the
* result as the eighth element of the new decuple.
*
* @param mapper the function to apply to the eighth element
* @return the new decuple
*/
Decuple mapEighth(Function mapper);
/**
* Create a new decuple by applying a function to the ninth element, and putting the
* result as the ninth element of the new decuple.
*
* @param mapper the function to apply to the ninth element
* @return the new decuple
*/
Decuple mapNinth(Function mapper);
/**
* Create a new decuple by applying a function to the tenth element, and putting the
* result as the tenth element of the new decuple.
*
* @param mapper the function to apply to the tenth element
* @return the new decuple
*/
Decuple mapTenth(Function mapper);
/**
* Create a new decuple by applying a function to each element, and putting the
* results into a new decuple.
*
* @param firstMapper the function to apply to the first element
* @param secondMapper the function to apply to the second element
* @param thirdMapper the function to apply to the third element
* @param fourthMapper the function to apply to the fourth element
* @param fifthMapper the function to apply to the fifth element
* @param sixthMapper the function to apply to the sixth element
* @param seventhMapper the function to apply to the seventh element
* @param eighthMapper the function to apply to the eighth element
* @param ninthMapper the function to apply to the ninth element
* @param tenthMapper the function to apply to the tenth element
* @return the new decuple
*/
Decuple map(Function firstMapper,
Function secondMapper,
Function thirdMapper,
Function fourthMapper,
Function fifthMapper,
Function sixthMapper,
Function seventhMapper,
Function eighthMapper,
Function ninthMapper,
Function tenthMapper);
/**
* @return this decuple instance
*/
@Override
Decuple asDecuple();
/**
* Convert this decuple to an instance of an arbitrary type.
*
* @param The type of the resulting instance
* @param convertor the function used to convert the contained
* values to a resulting compound instance.
* @return the result from the given function
*/
R to(DecaFunction convertor);
}