Функции сортировки

В таблице приведены функции сортировки. Второй параметр каждой фунции, кроме функций usort и uksort, необязателен и задает способ сравнения элементов. Может принимать следующие значения:

· SORT_REGULAR – сравнивать элементы массива обычным образом;

· SORT_NUMERIC – сравнивать элементы массива как числа;

· SORT_STRING – сравнивать элементы массива как строки.

По умолчанию параметр имеет значение SORT_REGULAR.

Наименование функции	Назначение функции и возвращаемое значение	Параметры
sort	Сортировка элементов массива по возрастанию. Сортируются значения элементов, а не ключи! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false. При сортировке старые ключи элементов удаляются, новыми ключами становятся числа с 0 до <количество элементов массива>.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
rsort	Сортировка элементов массива по убыванию. Сортируются значения элементов, а не ключи! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false. При сортировке старые ключи элементов удаляются, новыми ключами становятся числа с 0 до <количество элементов массива>.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
asort	Сортировка элементов массива по возрастанию. Сортируются значения элементов, а не ключи! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false. При сортировке старые ключи элементов сохраняются.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
arsort	Сортировка элементов массива по убыванию. Сортируются значения элементов, а не ключи! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false. При сортировке старые ключи элементов сохраняются.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
ksort	Сортировка элементов массива по возрастанию. Сортируются ключи элементов, а не значения! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
krsort	Сортировка элементов массива по убыванию. Сортируются ключи элементов, а не значения! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false.	· Сортируемый массив; · Необязательный параметр, задающий способ сравнения элементов.
usort	Сортировка элементов массива с использованием пользовательской функции для сравнения элементов. Сортируются значения элементов, а не ключи! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false.	· Сортируемый массив; · Имя пользовательской функции для сортировки. Пользовательская функция должна иметь два параметра, параметры соответствуют сравниваемым двум значениям элементов массива. Пользовательская функция должна возвращать 0, если параметры равны, целое число меньше нуля, если первый параметр меньше и целое число больше 0, если первый параметр больше.
uksort	Сортировка элементов массива с использованием пользовательской функции для сравнения элементов. Сортируются ключи элементов, а не значения! В случае, если сортировка прошла успешно, то будет возвращено true, в противном случае возвращается false.	· Сортируемый массив; · Имя пользовательской функции для сортировки. Пользовательская функция должна иметь два параметра, параметры соответствуют сравниваемым двум ключам элементов массива. Пользовательская функция должна возвращать 0, если параметры равны, целое число меньше нуля, если первый параметр меньше и целое число больше 0, если первый параметр больше.

Примеры сортировок

Примеры сортировок:

<?php
$array_1 = array( 0 => "Сидоров", 1 => "Иванов", 2 => "Петров" );

if( sort( $array_1 ) )
{
// ожидаем, что $array_1 =
// ( 0 => "Иванов", 1 => "Петров", 2 => "Сидоров" )
;
}

rsort($array_1); // после rsort $array_1 =
// ( 0 => "Сидоров", 1 => "Петров", 2 => "Иванов" )

asort($array_1); // после asort $array_1 =
// ( 2 => "Иванов", 1 => "Петров", 0 => "Сидоров" )

arsort($array_1); // после arsort $array_1 =
// ( 0 => "Сидоров", 1 => "Петров", 2 => "Иванов" )

$array_1 = array( 1 => "Сидоров", 2 => "Иванов", 0 => "Петров" );

ksort($array_1); // после ksort $array_1 =
// ( 0 => "Петров", 1 => "Сидоров", 2 => "Иванов" )

krsort($array_1); // после krsort $array_1 =
// ( 2 => "Иванов", 1 => "Сидоров", 0 => "Петров" )

function sort_func1( $par1, $par2 )
{
if( $par1 == "Иванов" )
{
return 1;
}

if( $par1 == $par2 )
{
return 0;
}
elseif( $par1 > $par2 )
{
return 1;
}
else
{
return -1;
}
}

usort($array_1, "sort_func1" );
// после usort $array_1 =
// ( 0 => "Петров", 1 => "Сидоров", 2 => "Иванов" )

function sort_func2( $par1, $par2 )
{
if( $par1 == 1 )
{
return 1;
}

if( $par1 == $par2 )
{
return 0;
}
elseif( $par1 > $par2 )
{
return 1;
}
else
{
return -1;
}
}

uksort($array_1, "sort_func2" );
// после uksort $array_1 =
// ( 0 => "Петров", 2 => "Иванов", 1 => "Сидоров" )
?>