AppDividend
Latest Code Tutorials

Java Math signum() Function Example

0

Java Math signum() is an inbuilt method that is used to return the signum function value for any passed value(double or float). In mathematics,

  1. The signum function value for any positive number is 1.
  2. The signum function value for any negative number is -1.
  3. The signum function value for zero is 0.

Java Math signum()

Java Math signum() is an inbuilt method that returns the sign function of a value passed to it as an argument. If an argument passed is greater than zero, then the signum() function will return 1.0. If an argument passed is equal to zero, then the signum() function will return 0.

Syntax

public static double signum(double x)
public static float signum(float x)

Parameter(s)

The variable whose signum value is to be returned.

Return Value

  • If the passed value is positive, returns 1.0;
  • If the passed value is negative, returns -1.0;
  • If the passed value is zero, returns 0.0;

See the following figure.

 

Java Math signum()

Note

  1. If an argument is NaN, then this method returns NaN.
  2. If an argument is positive zero or negative zero, then this method returns the same value that is passed.

Consider the following examples.

Example1.java: The following example demonstrates the use of this method.

public class Example1 {
  public static void main(String[] args) {
    double a = 2.0;
    double b = -2.0;
    double c = 0.0;

    System.out.println(Math.signum(a));
    System.out.println(Math.signum(b));
    System.out.println(Math.signum(c));

    float x = 2.0f;
    float y = -2.0f;
    float z = 0.0f;

    System.out.println(Math.signum(x));
    System.out.println(Math.signum(y));
    System.out.println(Math.signum(z));
  }
}

Output

->javac Example1.java
->java Example1
1.0
-1.0
0.0
1.0
-1.0
0.0

Example2.java: The following example demonstrates the situation when the argument is NaN.

public class Example2 {
  public static void main(String[] args) {
    double a = Double.NaN;
    System.out.println(Math.signum(a));
  }
}

Output

->javac Example2.java
->java Example2
NaN

Example3.java: The following example demonstrates the situation of passing negative or positive zero.

public class Example3 {
  public static void main(String[] args) {
    double a = 0.0;
    double b = -0.0;

    System.out.println(Math.signum(a));
    System.out.println(Math.signum(b));

  }
}

Output

->javac Example3.java
->java Example3
0.0
-0.0

See also

Java Math pow()

Java Math ceil()

Java Math round()

Java Math min()

Java Math max()

Leave A Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.