com.aoindustries.math

Class SafeMath

java.lang.Object

com.aoindustries.math.SafeMath

public class SafeMath
extends Object

Math routines that check for overflow conditions. TODO: In Java 8, there are methods like addExact that should be used instead.

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method and Description
static int	avg(int value1, int value2) Computes the average of two values without overflow or underflow.
static byte	castByte(int value) Casts int to byte, looking for any underflow or overflow.
static byte	castByte(long value) Casts long to byte, looking for any underflow or overflow.
static int	castInt(long value) Casts long to int, looking for any underflow or overflow.
static short	castShort(int value) Casts int to short, looking for any underflow or overflow.
static long	multiply(long value1, long value2) Multiplies two longs, looking for any overflow.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

castByte

public static byte castByte(int value)
                     throws ArithmeticException

Casts int to byte, looking for any underflow or overflow.

Throws:

ArithmeticException - for underflow or overflow

castByte

public static byte castByte(long value)
                     throws ArithmeticException

Casts long to byte, looking for any underflow or overflow.

Throws:

ArithmeticException - for underflow or overflow

castShort

public static short castShort(int value)
                       throws ArithmeticException

Casts int to short, looking for any underflow or overflow.

Throws:

ArithmeticException - for underflow or overflow

castInt

public static int castInt(long value)
                   throws ArithmeticException

Casts long to int, looking for any underflow or overflow.

Throws:

ArithmeticException - for underflow or overflow

multiply

public static long multiply(long value1,
                            long value2)

Multiplies two longs, looking for any overflow.

Throws:

ArithmeticException - for overflow

avg

public static int avg(int value1,
                      int value2)

Computes the average of two values without overflow or underflow.