Сортирует таблицу значений по указанным правилам
Синтаксис
Метод Сортировать()
имеет следующий синтаксис:
Сортировать(Колонки, [ОбъектСравнения])
А также альтернативный англоязычный синтаксис:
Sort(Columns, [ComparisonObject])
Параметры
Описание параметров метода Сортировать()
:
Имя параметра* | Тип | Описание | ||||
---|---|---|---|---|---|---|
Колонки | Строка | Список имен колонок, разделенных запятыми, по которым производится сортировка таблицы. После каждого имени колонки через пробел может быть указано направление сортировки:
|
||||
ОбъектСравнения | СравнениеЗначений | Объект для сравнения значений. Реализует сравнение значений, типы которых отличаются от простых (Строка, Число, Дата, Булево) | ||||
*Жирным шрифтом выделены обязательные параметры |
Описание
Метод Сортировать()
cортирует строки таблицы значений в соответствии с указанными правилами сортировки. Порядок указания имен колонок таблицы определяет порядок сортировки. Это означает, что сначала таблица сортируется по колонке, указанной первой. Затем группы строк с одинаковым значением в первой колонке сортируются по колонке, которая указана второй, и так далее.
Если параметр ОбъектСравнения
не задан, значения простых типов сравниваются по значению, а значения остальных типов — по строковому представлению.
Если параметр ОбъектСравнения
задан, значения простых типов также сравниваются по значению, а значения остальных типов — по правилам:
- объекты сравниваются по идентификатору
- моменты времени сравниваются по дате и идентификатору объекта
- остальные значения сравниваются по строковому представлению
Доступность
Версия | Поддержка |
---|---|
8.1 | Сервер, Клиент, Внешнее соединение |
8.2 | Сервер, Толстый клиент, Внешнее соединение |
8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Сортировать()
:
//создание таблицы тз = Новый ТаблицаЗначений; тз.Колонки.Добавить("Значение"); тз.Колонки.Добавить("Тип"); //заполнение НоваяСтрока = тз.Добавить(); НоваяСтрока.Значение = 1; НоваяСтрока.Тип = ТипЗнч(НоваяСтрока.Значение); НоваяСтрока = тз.Добавить(); НоваяСтрока.Значение = "1"; НоваяСтрока.Тип = ТипЗнч(НоваяСтрока.Значение); НоваяСтрока = тз.Добавить(); НоваяСтрока.Значение = 1.1; НоваяСтрока.Тип = ТипЗнч(НоваяСтрока.Значение); //сортировка тз.Сортировать("Значение", Новый СравнениеЗначений); //проверка результата тз.ВыбратьСтроку("Результат сортировки");