# Collection::sortByColumn()

URL: https://chugunov.pro/api-bitrix/main/type/collection/sortbycolumn/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\Type\Collection`](https://chugunov.pro/api-bitrix/main/type/collection/)
Модуль: Main.
Свойства элемента: method, public, static.

## Сигнатура

```php
public static sortByColumn(array<string|int, mixed> &$array, string|array<string|int, mixed> $columns[, string|array<string|int, mixed> $callbacks = '' ][, null $defaultValueIfNotSetValue = null ][, bool $preserveKeys = false ]) : mixed
```

## Описание

Можно использовать короткий режим: Collection::sortByColumn($arr, 'value'); Это равнозначно Collection::sortByColumn($arr, array('value' => SORT_ASC))

Обратите внимание: если два элемента при сравнении равны, их относительный порядок в отсортированном массиве не определён. Сортировка не является стабильной.

Ещё пример:
Collection::sortByColumn($arr, array('value' => array(SORT_NUMERIC, SORT_ASC), 'attr' => SORT_DESC), array('attr' => 'strlen'), 'www');

## Параметры

- `$array` `array<string|int, mixed>` — обязательный
- `$columns` `string|array<string|int, mixed>` — обязательный
- `$callbacks` `string|array<string|int, mixed>` — необязательный, по умолчанию `''`
- `$defaultValueIfNotSetValue` `null` — необязательный, по умолчанию `null`. Если значение не задано — используется $defaultValueIfNotSetValue (любые столбцы)
- `$preserveKeys` `bool` — необязательный, по умолчанию `false`. Если false, числовые ключи будут переиндексированы. Если true — сохраняются.

## Возвращаемое значение

`mixed`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Type-Collection.html