JS+
Усиленный язык сценариев для Windows
с возможностью встраивания
в ваши приложения
О языке JS+ Справочник Скачать JS+ DLL
Контакты
СПРАВОЧНИК ПО ЯЗЫКУ JS+ Содержание

sort

- метод типа данных Array
Тип данных Array
Сортирует исходный массив.
Синтаксис
array.sort(
  compare(e1,e2)
): Array;

Параметры
Параметр Тип Описание
compare(e1,e2) Function функция сортировки двух элементов исходного массива (необязательный параметр)
Возвращаемое значение
Отсортированный исходный массив.
Пример (JS+)
var arr=new Array("раз","пять","два","четыре","три");

alert(
  arr.sort().join("-")+"\n"+
  arr.sort(compare).join("-")
);

function compare(e1,e2)
{
  return (str_to_num(e1)>str_to_num(e2) ? 1 : -1);
}

function str_to_num(num_Str)
{
  switch (num_Str) {
    case "раз" : return 1;
    case "два" : return 2;
    case "три" : return 3;
    case "четыре": return 4;
    case "пять" : return 5;
  }

  return 0;
}
Примечание
Функция изменяет исходный массив, делая его отсортированным.

Если параметр compare отсутствует, исходный массив сортируется по возрастанию элементов, автоматически преобразуемых к типу String в кодировке UNICODE.

Функция compare вызывается автоматически в процессе сортировки. Она должна сравнивать два передаваемых ей элемента массива и возвращать результат типа Number по следующим правилам:

- если ее результат меньше 0, индекс элемента e1 в отсортированном массиве будет меньше индекса элемента e2;
- если ее результат больше 0, индекс элемента e1 в отсортированном массиве будет больше индекса элемента e2;
- если ее результат равен 0, индексы элементов e1 и e2 в отсортированном массиве будут неизменными или неопределенными по отношению друг к другу.
Совместимость
JScript/JavaScript
См. также
JS+Руководство пользователя
Адрес этой страницы: https://jsplus.ru/MANUAL/JSPlus/DataType/Array/Method/sort.htm
© 2024-2025,