sort Method

Microsoft Office JScript

Microsoft® JScript® sort Method  Language Reference 
Version 2 

See Also                  Applies To


Description

Returns an Array objec with the elements sorted.

Syntax
arrayobj.sort(sortfunction)

The sortfunction argument is the name of the function used to determine the order of the elements. If omitted, the elements are sorted in ascending, ASCII character order.

Remarks
The sort method sorts the Array object in place; no new Array object is created during execution.

If you supply a function in the sortfunction argument, it must return one of the following values:

  • A negative value if the first argument passed is less than the second argument.
  • Zero if the two arguments are equivalent.
  • A positive value if the first argument is greater than the second argument.

The following example illustrates the use of the sort method:

function SortDemo()
{
  var a, l;
  a = new Array("X" ,"y" ,"d", "Z", "v","m","r");
  l = a.sort();
  return(l);
}