Open In App

D3.js | d3.descending() Function

Last Updated : 28 Jun, 2019
Improve
Improve
Like Article
Like
Save
Share
Report

The d3.descending() function in D3.js is a comparator function for the reverse natural order and returns -1 if it takes two parameters in descending order, 1 if it takes two parameters in ascending order and 0 if it takes two equal parameters.

Syntax:

d3.descending(a, b)

Parameters: This function accepts parameters a, b which are any two value.

Return Value: It returns -1 if it takes two parameters in descending order (1st parameter is greater than 2nd parameter) or 1 if it takes two parameters in ascending order (2nd parameter is greater than 1st parameter) or 0 if it takes two equal parameters.

Below programs illustrate the d3.descending() function in D3.js.

Example 1:




<!DOCTYPE html>
<html>
  
<head>
    <title>d3.descending() function</title>
  
    <script src='https://d3js.org/d3.v4.min.js'></script>
</head>
  
<body>
    <script>
          
        // Calling to d3.descending() function with 
        // two integer value parameters
        A = d3.descending(50, 20);
        B = d3.descending(2, 5);
        C = d3.descending(5, 5);
           
        // Getting the results
        document.write(A + "<br>");
        document.write(B + "<br>");
        document.write(C + "<br>");
        console.log(A);
    </script>
</body>
  
</html>                    


Output:

-1
1
0

Example 2:




<!DOCTYPE html>
<html>
  
<head>
    <title>d3.descending() function</title>
  
    <script src='https://d3js.org/d3.v4.min.js'></script>
</head>
  
<body>
    <script>
          
        // Calling to d3.descending() function with 
        // some alphabetical parameters
        A = d3.descending();
        B = d3.descending("a", "b");
        C = d3.descending("b", "a");
        D = d3.descending("b", "b");
        E = d3.descending("b");
           
        // Getting the results
        document.write(A + "<br>");
        document.write(B + "<br>");
        document.write(C + "<br>");
        document.write(D + "<br>");
        document.write(E + "<br>");
    </script>
</body>
  
</html>                    


Output:

NaN
1
-1
0
NaN

NOTE: If this function takes alphabets as the parameter, it considers them in ascii form and evaluates the result accordingly and if the given parameter does not match the format of its parameter then it returns NaN i.e, Not a Number.

Reference: https://devdocs.io/d3~5/d3-array#descending



Like Article
Suggest improvement
Previous
Next
Share your thoughts in the comments

Similar Reads