# Package org.apache.commons.lang3.math

package org.apache.commons.lang3.math
Provides `java.math` extensions 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

- Related Packages
  Package
  Description
  org.apache.commons.lang3
  Provides highly reusable utility methods, chiefly concerned with adding value to the `java.lang` classes.
- Classes
  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.