Java ulp Function

The Java ulp Function is one of the Java Math Library function which is used to return the size of a ulp of the argument. An ulp of a float value is the positive distance between given value and the next value that is larger in magnitude. In this article we will show you, How to use Java Math.ulp function with example.

Java ulp Function Syntax

The basic syntax of the Math.ulp Function in Java Programming language is as shown below.

Math.ulp(data_type number);

Number: It can be a number or a valid numerical expression.

• If the number argument is positive or negative double or float value, Math.ulp function will return the output.
• If the number argument is not a number, Math.ulp function will return NaN.
• If the number argument is positive or negative Zero, Math.ulp function will return Float.MIN_EXPONENT.
• If the number argument is positive or negative Infinity, Math.ulp function will return Positive Infinity.
• If the number argument is positive or negative Float.MAX_EXPONENT, Math.ulp function will return the result as 2¹⁰⁴.

Java Programming provides two different functions to find the ulp of the specified value. Following function will accept positive or negative float value as argument and returns the float ulp.

static float ulp(float number); //Return Type is Float

// In order to use in program: 
Math.ulp(float number);

Following function will accept positive or negative double value as argument and returns the ulp of type double.

static double ulp(double number); //Return Type is Double

// In order to use in program: 
Math.ulp(double number);

Java ulp Function Example

The Java Math.ulp function is used to find the ulp of the specified expression. In this Java program, We are going to find the same on both positive and negative values and display the output

JAVA CODE

//Java Math.ulp Function example
package MathFunctions;

public class UlpMethod {
	public static void main(String[] args) {
		double a = 2.352, b = -6.953;
		float c = 65.14f, d = -16.590f;	

		System.out.println("\nMath.ulp Function result of Zero: " + Math.ulp(0));
		
		System.out.println("\nMath.ulp Function of result Positive Double Value: " + Math.ulp(a));
		System.out.println("Math.ulp Function of result Negative Double Value: " + Math.ulp(b));
		
		System.out.println("\nMath.ulp Function of result Positive Float Value: " + Math.ulp(c));
		System.out.println("Math.ulp Function of result Negative Float Value: " + Math.ulp(d));
		
		double e = Math.ulp(100.90 + 165.10 - 180.50 + 6.50);
		System.out.println("\nMath.ulp Function results = " + e);
	}
}

OUTPUT

ANALYSIS

First, We declared variables of type Double and Float to display the functionality of java Math.ulp function on different data types.

double a = 2.352, b = -6.953;
float c = 65.14f, d = -16.590f;

Next, We used the Zero as the argument of Java Math.ulp Function.

System.out.println("\nMath.ulp Function result of Zero: " + Math.ulp(0));

Next, We used the Java Math.ulp Function on variable a and b (they belongs to double type). Following statements will call the ulp method of double type ( static double ulp(double number) ) to display the result.

System.out.println("\nMath.ulp Function of result Positive Double Value: " + Math.ulp(a));
System.out.println("Math.ulp Function of result Negative Double Value: " + Math.ulp(b));

Then, We used the Math.scalb Function on variable c and d (they belongs to float type). Following statements will call the ulp method of float type ( static float ulp(float number) ) to display the result.

System.out.println("\nMath.ulp Function of result Positive Float Value: " + Math.ulp(c));
System.out.println("Math.ulp Function of result Negative Float Value: " + Math.ulp(d));

Lastly, We declared variable of type Double and performed the Java Math.ulp function directly on expression.

double e = Math.ulp(100.90 + 165.10 - 180.50 + 6.50);
System.out.println("\nMath.ulp Function results = " + e);

Thank You for Visiting Our Blog