La función d3.ascending() en D3.js es una función de comparación integrada para el orden natural que acepta dos parámetros y calcula su orden natural.
Sintaxis:
d3.ascending(x, y)
Parámetros: esta función acepta dos parámetros x, y cuyo orden natural debe calcularse.
Valor de retorno: la función tiene los siguientes valores de retorno:
- Devuelve -1 si los dos valores están en orden ascendente .
- Devuelve 1 si los dos valores están en orden descendente .
- Devuelve 0 si los dos valores son iguales
- Devuelve NaN si no hay valores comparables, es decir, solo se pasa uno o ningún parámetro a la función.
Los siguientes programas ilustran la función d3.ascending() en D3.js.
Ejemplo 1:
<!DOCTYPE html> <html> <head> <title>D3.js | d3.ascending() function</title> <script src='https://d3js.org/d3.v4.min.js'></script> </head> <body> <script> // If the two values are in // ascending order document.write(d3.ascending(33, 64) + "<br>"); // -1 // If the two values are in // descending order document.write(d3.ascending(42, 24) + "<br>"); // 1 // If the two values are equal document.write(d3.ascending(43, 43) + "<br>"); // 0 </script> </body> </html>
Producción:
-1 1 0
Ejemplo 2:
<!DOCTYPE html>
<html>
<head>
<title>D3.js d3.ascending() function</title>
<script src='https://d3js.org/d3.v4.min.js'></script>
</head>
<body>
<script>
// If no values are passed
document.write(d3.ascending() + "<br>"); // NaN
// If only one value is passed
document.write(d3.ascending(42) + "<br>"); // NaN
// If the two values are equal
document.write(d3.ascending("x", "x") + "<br>"); // 0
// If the two values are in
// ascending order
document.write(d3.ascending("x", "y") + "<br>"); // -1
// If the two values are in
// descending order
document.write(d3.ascending("y", "x") + "<br>"); // 1
</script>
</body>
</html>
Producción:
NaN NaN 0 -1 1
Referencia: https://devdocs.io/d3~5/d3-array#ascending
Publicación traducida automáticamente
Artículo escrito por RICHIK BHATTACHARJEE y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA