Get Lower, Higher and Closest Number in JavaScript

Javascript Course

A function that can be used in JavaSccript to get the lower, higher, and closest number. The function receives two parameters: an array (or object) with numbers, and the number. Compares that number with the numbers from array /object, than returns an object with three elements: the "lower", "higher", and "closest" number.
Here's the function:

// retutrs an object with the number from "nums": lower, higher and closest to nr
// "nums" can be an Array with numbers [-2, 0, 3], or an object {'n1': -1, 'n2': 1, 'n3': 2}
function closestLowerHigherNr(nums, nr) {
 // JavaScript & jQuery Course - https://coursesweb.net/javascript/
  // Gets into an Array the values from "nums" array /object, and sorts from lowest to highest
  var vnums = [];
  for each(var val in nums) vnums.push(val);
  vnums.sort(function(a,b){return a - b;});

  var nr_vnums = vnums.length;      // number of elements in vnums

  // sets the object that will be returned, initially with the lowest and highest number from vnums
  var re_obj = {'lower': Math.min(vnums[0], nr), 'higher': Math.max(vnums[nr_vnums-1], nr), 'closest': nr};

  // traverse the numbers, stores in re_obj the number immediately lower and higher than nr
  for(var i=0; i<nr_vnums; i++){
    if(nr > vnums[i]) re_obj['lower'] = vnums[i];
    else if(nr <= vnums[i]){
      // if the current number from vnums is equal to nr, or immediately higher, stores that number
      // and stops the for each() loop
      re_obj['higher'] = vnums[i];
      break;
    }
  }

  // here it gets the closest number to nr
  // (the number ('lower' or 'higher') with the lowest diferrence between its value and nr)
  re_obj['closest'] = (Math.abs(nr - re_obj['lower']) < Math.abs(re_obj['higher'] - nr)) ? re_obj['lower'] : re_obj['higher'];

  return re_obj;
}

Example usage closestLowerHigherNr() function.

<script type="text/javascript"><!--
// retutrs an object with the number from "nums": lower, higher and closest to nr
// "nums" can be an Array with numbers [-2, 0, 3], or an object {'n1': -1, 'n2': 1, 'n3': 2}
function closestLowerHigherNr(nums, nr) {
 // JavaScript & jQuery Course - https://coursesweb.net/javascript/
  // Gets into an Array the values from "nums" array /object, and sorts from lowest to highest
  var vnums = [];
  for each(var val in nums) vnums.push(val);
  vnums.sort(function(a,b){return a - b;});

  var nr_vnums = vnums.length;      // number of elements in vnums

  // sets the object that will be returned, initially with the lowest and highest number from vnums
  var re_obj = {'lower': Math.min(vnums[0], nr), 'higher': Math.max(vnums[nr_vnums-1], nr), 'closest': nr};

  // traverse the numbers, stores in re_obj the number immediately lower and higher than nr
  for(var i=0; i<nr_vnums; i++){
    if(nr > vnums[i]) re_obj['lower'] = vnums[i];
    else if(nr <= vnums[i]){
      // if the current number from vnums is equal to nr, or immediately higher, stores that number
      // and stops the for each() loop
      re_obj['higher'] = vnums[i];
      break;
    }
  }

  // here it gets the closest number to nr
  // (the number ('lower' or 'higher') with the lowest diferrence between its value and nr)
  re_obj['closest'] = (Math.abs(nr - re_obj['lower']) < Math.abs(re_obj['higher'] - nr)) ? re_obj['lower'] : re_obj['higher'];

  return re_obj;
}

// Example
var numbers = [-8, -3, 0, 5.8, 12, 9, 2.1];
var test1 = closestLowerHigherNr(numbers, -6);
var test2 = closestLowerHigherNr(numbers, 3);

// the numbers are strored into an object
var nums_obj = {'n1':-8, 'n2':0, 'n3':12, 'n4':5.8, 'n5':9, 'n6':2.1};
var test3 = closestLowerHigherNr(nums_obj, 9);

// see the values in test1, test2, test3
alert('lower: '+test1.lower+ ', higher: '+test1.higher+ ', closest: '+ test1.closest);
  // Result: lower: -8, higher: -3, closest: -8

alert('lower: '+test2.lower+ ', higher: '+test2.higher+ ', closest: '+ test2.closest);
  // Result: lower: 2.1, higher: 5.8, closest: 2.1

alert('lower: '+test3.lower+ ', higher: '+test3.higher+ ', closest: '+ test3.closest);
  // Result: lower: 5.8, higher: 9, closest: 9
//-->
</script>

This function works also if "nr" is lower, or higher than any number in array /object.
Example:

<script type="text/javascript"><!--
// here add the closestLowerHigherNr() function

var numbers = [-8, 2, 12];
var test4 = closestLowerHigherNr(numbers, -23);      // -23 is lower than any number in "numbers"
var test5 = closestLowerHigherNr(numbers, 18);       // 18 is higher than any number in "numbers"

// see the values in test4, test5
alert('lower: '+test4.lower+ ', higher: '+test4.higher+ ', closest: '+ test4.closest);
  // Result: lower: -28, higher: -8, closest: -23
alert('lower: '+test5.lower+ ', higher: '+test5.higher+ ', closest: '+ test5.closest);
  // Result: lower: 12, higher: 18, closest: 12
//-->
</script>

<p>Address: <strong>http://CoursesWeb.net/</strong> - Tutorials.</p>

#id {
  font-weight: 800;
}

function someFunction() { alert("CoursesWeb.net"); }
setInterval("someFunction()", 2000);

$vname = 8;
echo $vname;