1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
package Torello.Java.Function;

/**
 * Function-Pointer
 * <SPAN CLASS=TJF>Input:</SPAN> {@code byte}
 * <SPAN CLASS=TJF>Output:</SPAN> {@code void}.
 * 
 * <BR /><BR />
 * This is an extension of {@code java.util.function.*}.  This consumer accepts a {@code 'byte'}
 * as input to its  {@code 'accept'} method.
 */
@FunctionalInterface
public interface ByteConsumer
{
    /**
     * Performs this operation on the given argument.
     * @param b {@code byte} input-argument.
     */
    public void accept(byte b);

    /**
     * <EMBED CLASS="external-html" DATA-FILE-ID="CONTHENMETH">
     * @param after <EMBED CLASS="external-html" DATA-FILE-ID="CONTHENAFT">
     * @return <EMBED CLASS="external-html" DATA-FILE-ID="CONTHENRET">
     * @throws NullPointerException if parameter {@code 'other'} is null.
     */
    default ByteConsumer andThen(ByteConsumer after)
    {
        if (after == null)
            throw new NullPointerException("null has been passed to parameter 'after'");

        return (byte b) ->
        {
            this.accept(b); 
            after.accept(b);
        };
    }
}