BinaryOperator (Java Platform SE 8 ) (original) (raw)

• Type Parameters:
  T - the type of the operands and result of the operator
  All Superinterfaces:
  BiFunction<T,T,T>
  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 BinaryOperator
extends BiFunction<T,T,T>
Represents an operation upon two operands of the same type, producing a result of the same type as the operands. This is a specialization ofBiFunction for the case where the operands and the result are all of the same type.
This is a functional interface whose functional method is BiFunction.apply(Object, Object).
Since:
1.8
See Also:
BiFunction, UnaryOperator

• • Method Summary

  All Methods Static Methods Default Methods

  Modifier and Type	Method	Description
  static BinaryOperator	maxBy(Comparator<? super T> comparator)	Returns a BinaryOperator which returns the greater of two elements according to the specified Comparator.
  static BinaryOperator	minBy(Comparator<? super T> comparator)	Returns a BinaryOperator which returns the lesser of two elements according to the specified Comparator.

     * ### Methods inherited from interface java.util.function.[BiFunction](../../../java/util/function/BiFunction.html "interface in java.util.function")  
     `[andThen](../../../java/util/function/BiFunction.html#andThen-java.util.function.Function-), [apply](../../../java/util/function/BiFunction.html#apply-T-U-)`

• • Method Detail

     * #### minBy  
     static <T> [BinaryOperator](../../../java/util/function/BinaryOperator.html "interface in java.util.function")<T> minBy([Comparator](../../../java/util/Comparator.html "interface in java.util")<? super T> comparator)  
     Returns a [BinaryOperator](../../../java/util/function/BinaryOperator.html "interface in java.util.function") which returns the lesser of two elements according to the specified `Comparator`.  
     Type Parameters:  
     `T` \- the type of the input arguments of the comparator  
     Parameters:  
     `comparator` \- a `Comparator` for comparing the two values  
     Returns:  
     a `BinaryOperator` which returns the lesser of its operands, according to the supplied `Comparator`  
     Throws:  
     `[NullPointerException](../../../java/lang/NullPointerException.html "class in java.lang")` \- if the argument is null  
     * #### maxBy  
     static <T> [BinaryOperator](../../../java/util/function/BinaryOperator.html "interface in java.util.function")<T> maxBy([Comparator](../../../java/util/Comparator.html "interface in java.util")<? super T> comparator)  
     Returns a [BinaryOperator](../../../java/util/function/BinaryOperator.html "interface in java.util.function") which returns the greater of two elements according to the specified `Comparator`.  
     Type Parameters:  
     `T` \- the type of the input arguments of the comparator  
     Parameters:  
     `comparator` \- a `Comparator` for comparing the two values  
     Returns:  
     a `BinaryOperator` which returns the greater of its operands, according to the supplied `Comparator`  
     Throws:  
     `[NullPointerException](../../../java/lang/NullPointerException.html "class in java.lang")` \- if the argument is null

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.