org.apache.commons.lang3.math
Date: 2017-02-08

# Package org.apache.commons.lang3.math

Extends `java.math` for business mathematical classes.

See: Description

- Class Summary
  Class | Description
  --- | ---
  Fraction | `Fraction` is a `Number` implementation that stores fractions accurately.
  IEEE754rUtils | Provides IEEE-754r variants of NumberUtils methods.
  NumberUtils | Provides extra functionality for Java Number classes.

## Package org.apache.commons.lang3.math Description

Extends `java.math` for business mathematical classes. This package is intended for business mathematical use, not scientific use. See Commons Math for a more complete set of mathematical classes. These classes are immutable, and therefore thread-safe.

Although Commons Math also exists, some basic mathematical functions are contained within Lang. These include classes to a `Fraction` class, various utilities for random numbers, and the flagship class, `NumberUtils` which contains a handful of classic number functions.

There are two aspects of this package that should be highlighted. The first is `NumberUtils.createNumber(String)`, a method which does its best to convert a String into a `Number` object. You have no idea what type of Number it will return, so you should call the relevant `xxxValue` method when you reach the point of needing a number. NumberUtils also has a related `NumberUtils.isCreatable(String)` method.

Since:
  2.0