StrictMath Class

Reference

Definition

Namespace:: Java.Lang

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The class StrictMath contains methods for performing basic numeric operations such as the elementary exponential, logarithm, square root, and trigonometric functions.

[Android.Runtime.Register("java/lang/StrictMath", DoNotGenerateAcw=true)]
public sealed class StrictMath : Java.Lang.Object

[<Android.Runtime.Register("java/lang/StrictMath", DoNotGenerateAcw=true)>]
type StrictMath = class
    inherit Object

Inheritance: Object

Object
StrictMath

Attributes: RegisterAttribute

Remarks

The class StrictMath contains methods for performing basic numeric operations such as the elementary exponential, logarithm, square root, and trigonometric functions.

To help ensure portability of Java programs, the definitions of some of the numeric functions in this package require that they produce the same results as certain published algorithms. These algorithms are available from the well-known network library netlib as the package "Freely Distributable Math Library," fdlibmhttps://www.netlib.org/fdlibm/. These algorithms, which are written in the C programming language, are then to be understood as executed with all floating-point operations following the rules of Java floating-point arithmetic.

The Java math library is defined with respect to fdlibm version 5.3. Where fdlibm provides more than one definition for a function (such as acos), use the "IEEE 754 core function" version (residing in a file whose name begins with the letter e). The methods which require fdlibm semantics are sin, cos, tan, asin, acos, atan, exp, log, log10, cbrt, atan2, pow, sinh, cosh, tanh, hypot, expm1, and log1p.

The platform uses signed two's complement integer arithmetic with int and long primitive types. The developer should choose the primitive type to ensure that arithmetic operations consistently produce correct results, which in some cases means the operations will not overflow the range of values of the computation. The best practice is to choose the primitive type and algorithm to avoid overflow. In cases where the size is int or long and overflow errors need to be detected, the methods addExact, subtractExact, multiplyExact, toIntExact, incrementExact, decrementExact and negateExact throw an ArithmeticException when the results overflow. For the arithmetic operations divide and absolute value, overflow occurs only with a specific minimum or maximum value and should be checked against the minimum or maximum as appropriate.

<h2>Ieee754RecommendedOps>IEEE 754 Recommended Operations</h2>

The java.lang.Math Math class discusses how the shared quality of implementation criteria for selected Math and StrictMath methods relate to the IEEE 754 recommended operations.

Added in 1.3.

Java documentation for java.lang.StrictMath.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Fields

E	The `double` value that is closer than any other to e, the base of the natural logarithms.
Pi	The `double` value that is closer than any other to pi, the ratio of the circumference of a circle to its diameter.

Properties

Class	Returns the runtime class of this `Object`. (Inherited from Object)
Handle	The handle to the underlying Android instance. (Inherited from Object)
JniIdentityHashCode	(Inherited from Object)
JniPeerMembers
PeerReference	(Inherited from Object)
ThresholdClass	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object)
ThresholdType	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object)

Methods

Abs(Double)	Returns the absolute value of a `double` value.
Abs(Int32)	Returns the absolute value of an `int` value.
Abs(Int64)	Returns the absolute value of a `long` value.
Abs(Single)	Returns the absolute value of a `float` value.
AbsExact(Int32)	Returns the mathematical absolute value of an `int` value if it is exactly representable as an `int`, throwing `ArithmeticException` if the result overflows the positive `int` range.
AbsExact(Int64)	Returns the mathematical absolute value of an `long` value if it is exactly representable as an `long`, throwing `ArithmeticException` if the result overflows the positive `long` range.
Acos(Double)	Returns the arc cosine of a value; the returned angle is in the range 0.
AddExact(Int32, Int32)	Returns the sum of its arguments, throwing an exception if the result overflows an `int`.
AddExact(Int64, Int64)	Returns the sum of its arguments, throwing an exception if the result overflows a `long`.
Asin(Double)	Returns the arc sine of a value; the returned angle is in the range -pi/2 through pi/2.
Atan(Double)	Returns the arc tangent of a value; the returned angle is in the range -pi/2 through pi/2.
Atan2(Double, Double)	Returns the angle theta from the conversion of rectangular coordinates (`x`, `y`) to polar coordinates (r, theta).
Cbrt(Double)	Returns the cube root of a `double` value.
Ceil(Double)	Returns the smallest (closest to negative infinity) `double` value that is greater than or equal to the argument and is equal to a mathematical integer.
Clone()	Creates and returns a copy of this object. (Inherited from Object)
CopySign(Double, Double)	Returns the first floating-point argument with the sign of the second floating-point argument.
CopySign(Single, Single)	Returns the first floating-point argument with the sign of the second floating-point argument.
Cos(Double)	Returns the trigonometric cosine of an angle.
Cosh(Double)	Returns the hyperbolic cosine of a `double` value.
DecrementExact(Int32)	Returns the argument decremented by one, throwing an exception if the result overflows an `int`.
DecrementExact(Int64)	Returns the argument decremented by one, throwing an exception if the result overflows a `long`.
Dispose()	(Inherited from Object)
Dispose(Boolean)	(Inherited from Object)
Equals(Object)	Indicates whether some other object is "equal to" this one. (Inherited from Object)
Exp(Double)	Returns Euler's number e raised to the power of a `double` value.
Expm1(Double)	Returns e<sup>x</sup> -1.
Floor(Double)	Returns the largest (closest to positive infinity) `double` value that is less than or equal to the argument and is equal to a mathematical integer.
FloorDiv(Int32, Int32)	Returns the largest (closest to positive infinity) `int` value that is less than or equal to the algebraic quotient.
FloorDiv(Int64, Int32)	Returns the largest (closest to positive infinity) `long` value that is less than or equal to the algebraic quotient.
FloorDiv(Int64, Int64)	Returns the largest (closest to positive infinity) `long` value that is less than or equal to the algebraic quotient.
FloorMod(Int32, Int32)	Returns the floor modulus of the `int` arguments.
FloorMod(Int64, Int32)	Returns the floor modulus of the `long` and `int` arguments.
FloorMod(Int64, Int64)	Returns the floor modulus of the `long` arguments.
Fma(Double, Double, Double)	Returns the fused multiply add of the three arguments; that is, returns the exact product of the first two arguments summed with the third argument and then rounded once to the nearest `double`.
Fma(Single, Single, Single)	Returns the fused multiply add of the three arguments; that is, returns the exact product of the first two arguments summed with the third argument and then rounded once to the nearest `float`.
GetExponent(Double)	Returns the unbiased exponent used in the representation of a `double`.
GetExponent(Single)	Returns the unbiased exponent used in the representation of a `float`.
GetHashCode()	Returns a hash code value for the object. (Inherited from Object)
Hypot(Double, Double)	Returns sqrt(x<sup>2</sup> +y<sup>2</sup>) without intermediate overflow or underflow.
IEEEremainder(Double, Double)	Computes the remainder operation on two arguments as prescribed by the IEEE 754 standard.
IncrementExact(Int32)	Returns the argument incremented by one, throwing an exception if the result overflows an `int`.
IncrementExact(Int64)	Returns the argument incremented by one, throwing an exception if the result overflows a `long`.
JavaFinalize()	Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object)
Log(Double)	Returns the natural logarithm (base e) of a `double` value.
Log10(Double)	Returns the base 10 logarithm of a `double` value.
Log1p(Double)	Returns the natural logarithm of the sum of the argument and 1.
Max(Double, Double)	Returns the greater of two `double` values.
Max(Int32, Int32)	Returns the greater of two `int` values.
Max(Int64, Int64)	Returns the greater of two `long` values.
Max(Single, Single)	Returns the greater of two `float` values.
Min(Double, Double)	Returns the smaller of two `double` values.
Min(Int32, Int32)	Returns the smaller of two `int` values.
Min(Int64, Int64)	Returns the smaller of two `long` values.
Min(Single, Single)	Returns the smaller of two `float` values.
MultiplyExact(Int32, Int32)	Returns the product of the arguments, throwing an exception if the result overflows an `int`.
MultiplyExact(Int64, Int32)	Returns the product of the arguments, throwing an exception if the result overflows a `long`.
MultiplyExact(Int64, Int64)	Returns the product of the arguments, throwing an exception if the result overflows a `long`.
MultiplyFull(Int32, Int32)	Returns the exact mathematical product of the arguments.
MultiplyHigh(Int64, Int64)	Returns as a `long` the most significant 64 bits of the 128-bit product of two 64-bit factors.
NegateExact(Int32)	Returns the negation of the argument, throwing an exception if the result overflows an `int`.
NegateExact(Int64)	Returns the negation of the argument, throwing an exception if the result overflows a `long`.
NextAfter(Double, Double)	Returns the floating-point number adjacent to the first argument in the direction of the second argument.
NextAfter(Single, Double)	Returns the floating-point number adjacent to the first argument in the direction of the second argument.
NextDown(Double)	Returns the floating-point value adjacent to `d` in the direction of negative infinity.
NextDown(Single)	Returns the floating-point value adjacent to `f` in the direction of negative infinity.
NextUp(Double)	Returns the floating-point value adjacent to `d` in the direction of positive infinity.
NextUp(Single)	Returns the floating-point value adjacent to `f` in the direction of positive infinity.
Notify()	Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object)
NotifyAll()	Wakes up all threads that are waiting on this object's monitor. (Inherited from Object)
Pow(Double, Double)	Returns the value of the first argument raised to the power of the second argument.
Random()	Returns a `double` value with a positive sign, greater than or equal to `0.0` and less than `1.0`.
Rint(Double)	Returns the `double` value that is closest in value to the argument and is equal to a mathematical integer.
Round(Double)	Returns the closest `long` to the argument, with ties rounding to positive infinity.
Round(Single)	Returns the closest `int` to the argument, with ties rounding to positive infinity.
Scalb(Double, Int32)	Returns `d` × 2<sup>`scaleFactor`</sup> rounded as if performed by a single correctly rounded floating-point multiply.
Scalb(Single, Int32)	Returns `f` × 2<sup>`scaleFactor`</sup> rounded as if performed by a single correctly rounded floating-point multiply.
SetHandle(IntPtr, JniHandleOwnership)	Sets the Handle property. (Inherited from Object)
Signum(Double)	Returns the signum function of the argument; zero if the argument is zero, 1.
Signum(Single)	Returns the signum function of the argument; zero if the argument is zero, 1.
Sin(Double)	Returns the trigonometric sine of an angle.
Sinh(Double)	Returns the hyperbolic sine of a `double` value.
Sqrt(Double)	Returns the correctly rounded positive square root of a `double` value.
SubtractExact(Int32, Int32)	Returns the difference of the arguments, throwing an exception if the result overflows an `int`.
SubtractExact(Int64, Int64)	Returns the difference of the arguments, throwing an exception if the result overflows a `long`.
Tan(Double)	Returns the trigonometric tangent of an angle.
Tanh(Double)	Returns the hyperbolic tangent of a `double` value.
ToArray<T>()	(Inherited from Object)
ToDegrees(Double)	Converts an angle measured in radians to an approximately equivalent angle measured in degrees.
ToIntExact(Int64)	Returns the value of the `long` argument, throwing an exception if the value overflows an `int`.
ToRadians(Double)	Converts an angle measured in degrees to an approximately equivalent angle measured in radians.
ToString()	Returns a string representation of the object. (Inherited from Object)
Ulp(Double)	Returns the size of an ulp of the argument.
Ulp(Single)	Returns the size of an ulp of the argument.
UnregisterFromRuntime()	(Inherited from Object)
Wait()	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object)
Wait(Int64)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)
Wait(Int64, Int32)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed()	(Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced()	(Inherited from Object)
IJavaPeerable.Finalized()	(Inherited from Object)
IJavaPeerable.JniManagedPeerState	(Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	(Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	(Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	(Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to