001/*
002 * ============================================================================
003 * Copyright © 2002-2020by Thomas Thrien.
004 * All Rights Reserved.
005 * ============================================================================
006 *
007 * Licensed to the public under the agreements of the GNU Lesser General Public
008 * License, version 3.0 (the "License"). You may obtain a copy of the License at
009 *
010 *      http://www.gnu.org/licenses/lgpl.html
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
014 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
015 * License for the specific language governing permissions and limitations
016 * under the License.
017 */
018
019package org.tquadrat.foundation.function.tce;
020
021import static org.apiguardian.api.API.Status.STABLE;
022
023import org.apiguardian.api.API;
024import org.tquadrat.foundation.annotation.ClassVersion;
025
026/**
027 *  The TCE version of the interface
028 *  {@link org.tquadrat.foundation.function.TriConsumer}
029 *  that represents an operation that accepts three input arguments and returns
030 *  no result. This is the three-arity specialisation of
031 *  {@link TCEConsumer}.
032 *  Unlike most other functional interfaces, {@code TriConsumer} is expected to
033 *  operate via side effects.<br>
034 *  <br>Different from the method
035 *  {@link org.tquadrat.foundation.function.TriConsumer#accept(Object,Object,Object) BiConsumer.accept()}
036 *  the method
037 *  {@link #accept(Object,Object,Object)}
038 *  of this interface declares to throw a
039 *  {@linkplain Exception checked exception}.<br>
040 *  <br>This is a functional interface whose functional method is
041 *  {@link #accept(Object,Object,Object)}.
042 *
043 *  @param <T1> The type of the first argument to the operation.
044 *  @param <T2> The type of the second argument to the operation.
045 *  @param <T3> The type of the third argument to the operation.
046 *
047 *  @extauthor Thomas Thrien - thomas.thrien@tquadrat.org
048 *  @version $Id: TCETriConsumer.java 993 2022-01-19 22:26:20Z tquadrat $
049 *  @since 0.0.5
050 *
051 *  @UMLGraph.link
052 */
053@FunctionalInterface
054@ClassVersion( sourceVersion = "$Id: TCETriConsumer.java 993 2022-01-19 22:26:20Z tquadrat $" )
055@API( status = STABLE, since = "0.0.5" )
056public interface TCETriConsumer<T1,T2,T3>
057{
058        /*---------*\
059    ====** Methods **==========================================================
060        \*---------*/
061    /**
062     *  Performs this operation on the given argument.
063     *
064     *  @param  arg1    The first input argument
065     *  @param  arg2    The second input argument
066     *  @param  arg3    The third input argument
067     *  @throws Exception   Something went wrong.
068     */
069    @SuppressWarnings( "ProhibitedExceptionDeclared" )
070    public void accept( T1 arg1, T2 arg2, T3 arg3 ) throws Exception;
071}
072//  interface TCETriConsumer
073
074/*
075 *  End of File
076 */