MathUtils (bboss-velocity 6.1.5 API)

java.lang.Object
- bboss.org.apache.velocity.runtime.parser.node.MathUtils

```
public abstract class MathUtils
extends java.lang.Object
```
Utility-class for all arithmetic-operations.

All operations (+ - / *) return a Number which type is the type of the bigger argument.
Example:
add ( new Integer(10), new Integer(1)) will return an Integer-Object with the value 11
add ( new Long(10), new Integer(1)) will return an Long-Object with the value 11
add ( new Integer(10), new Float(1)) will return an Float-Object with the value 11

Overflow checking:
For integral values (byte, short, int) there is an implicit overflow correction (the next "bigger" type will be returned). For example, if you call add (new Integer (Integer.MAX_VALUE), 1) a Long-object will be returned with the correct value of Integer.MAX_VALUE+1.
In addition to that the methods multiply,add and substract implement overflow checks for long-values. That means that if an overflow occurs while working with long values a BigInteger will be returned.
For all other operations and types (such as Float and Double) there is no overflow checking.

从以下版本开始:

1.5

字段概要

字段
限定符和类型	字段和说明
`protected static int`	`BASE_BIGDECIMAL`
`protected static int`	`BASE_BIGINTEGER`
`protected static int`	`BASE_DOUBLE`
`protected static int`	`BASE_FLOAT`
`protected static int`	`BASE_LONG` The constants are used to determine in which context we have to calculate.
`protected static java.math.BigDecimal`	`DECIMAL_ZERO` A BigDecimal representing the number 0
`protected static java.util.Map`	`ints` The `Class`-object is key, the maximum-value is the value
`protected static java.util.List`	`typesBySize` The "size" of the number-types - ascending.

构造器概要

构造器
构造器和说明

MathUtils()

构造器
构造器和说明
`MathUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static java.lang.Number`	`add(java.lang.Number op1, java.lang.Number op2)` Add two numbers and return the correct value / type.
`static int`	`compare(java.lang.Number op1, java.lang.Number op2)` Compare two numbers.
`static java.lang.Number`	`divide(java.lang.Number op1, java.lang.Number op2)` Divide two numbers.
`static boolean`	`isInteger(java.lang.Number n)` Test, whether the given object is an integer value (Byte, Short, Integer, Long, BigInteger)
`static boolean`	`isZero(java.lang.Number n)` Compare the given Number to 0.
`static java.lang.Number`	`modulo(java.lang.Number op1, java.lang.Number op2)` Modulo two numbers.
`static java.lang.Number`	`multiply(java.lang.Number op1, java.lang.Number op2)` Multiply two numbers and return the correct value / type.
`static java.lang.Number`	`subtract(java.lang.Number op1, java.lang.Number op2)` Subtract two numbers and return the correct value / type.
`static java.math.BigDecimal`	`toBigDecimal(java.lang.Number n)` Convert the given Number to a BigDecimal
`static java.math.BigInteger`	`toBigInteger(java.lang.Number n)` Convert the given Number to a BigInteger
`static java.lang.Number`	`wrapPrimitive(long value, java.lang.Class type)` Wrap the given primitive into the given class if the value is in the range of the destination type.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DECIMAL_ZERO
```
protected static final java.math.BigDecimal DECIMAL_ZERO
```
    A BigDecimal representing the number 0
  - BASE_LONG
```
protected static final int BASE_LONG
```
    The constants are used to determine in which context we have to calculate.
    
    另请参阅:
    
    常量字段值
  - BASE_FLOAT
```
protected static final int BASE_FLOAT
```
    另请参阅:
    
    常量字段值
  - BASE_DOUBLE
```
protected static final int BASE_DOUBLE
```
    另请参阅:
    
    常量字段值
  - BASE_BIGINTEGER
```
protected static final int BASE_BIGINTEGER
```
    另请参阅:
    
    常量字段值
  - BASE_BIGDECIMAL
```
protected static final int BASE_BIGDECIMAL
```
    另请参阅:
    
    常量字段值
  - ints
```
protected static final java.util.Map ints
```
    The Class-object is key, the maximum-value is the value
  - typesBySize
```
protected static final java.util.List typesBySize
```
    The "size" of the number-types - ascending.
- 构造器详细资料
  - MathUtils
```
public MathUtils()
```
- 方法详细资料
  - toBigDecimal
```
public static java.math.BigDecimal toBigDecimal(java.lang.Number n)
```
    Convert the given Number to a BigDecimal
    
    参数:
    
    n -
    
    返回:
    
    The number as BigDecimal
  - toBigInteger
```
public static java.math.BigInteger toBigInteger(java.lang.Number n)
```
    Convert the given Number to a BigInteger
    
    参数:
    
    n -
    
    返回:
    
    The number as BigInteger
  - isZero
```
public static boolean isZero(java.lang.Number n)
```
    Compare the given Number to 0.
    
    参数:
    
    n -
    
    返回:
    
    True if number is 0.
  - isInteger
```
public static boolean isInteger(java.lang.Number n)
```
    Test, whether the given object is an integer value (Byte, Short, Integer, Long, BigInteger)
    
    参数:
    
    n -
    
    返回:
    
    True if n is an integer.
  - wrapPrimitive
```
public static java.lang.Number wrapPrimitive(long value,
                                             java.lang.Class type)
```
    Wrap the given primitive into the given class if the value is in the range of the destination type. If not the next bigger type will be chosen.
    
    参数:
    
    value -
    
    type -
    
    返回:
    
    Number object representing the primitive.
  - add
```
public static java.lang.Number add(java.lang.Number op1,
                                   java.lang.Number op2)
```
    Add two numbers and return the correct value / type. Overflow detection is done for integer values (byte, short, int, long) only!
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    Addition result.
  - subtract
```
public static java.lang.Number subtract(java.lang.Number op1,
                                        java.lang.Number op2)
```
    Subtract two numbers and return the correct value / type. Overflow detection is done for integer values (byte, short, int, long) only!
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    Subtraction result.
  - multiply
```
public static java.lang.Number multiply(java.lang.Number op1,
                                        java.lang.Number op2)
```
    Multiply two numbers and return the correct value / type. Overflow detection is done for integer values (byte, short, int, long) only!
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    Multiplication result.
  - divide
```
public static java.lang.Number divide(java.lang.Number op1,
                                      java.lang.Number op2)
```
    Divide two numbers. The result will be returned as Integer-type if and only if both sides of the division operator are Integer-types. Otherwise a Float, Double, or BigDecimal will be returned.
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    Division result.
  - modulo
```
public static java.lang.Number modulo(java.lang.Number op1,
                                      java.lang.Number op2)
                               throws java.lang.ArithmeticException
```
    Modulo two numbers.
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    Modulo result.
    
    抛出:
    
    java.lang.ArithmeticException - If at least one parameter is a BigDecimal
  - compare
```
public static int compare(java.lang.Number op1,
                          java.lang.Number op2)
```
    Compare two numbers.
    
    参数:
    
    op1 -
    
    op2 -
    
    返回:
    
    1 if n1 > n2, -1 if n1 < n2 and 0 if equal.

类 MathUtils

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

DECIMAL_ZERO

BASE_LONG

BASE_FLOAT

BASE_DOUBLE

BASE_BIGINTEGER

BASE_BIGDECIMAL

ints

typesBySize

构造器详细资料

MathUtils

方法详细资料

toBigDecimal

toBigInteger

isZero

isInteger

wrapPrimitive

add

subtract

multiply

divide

modulo

compare