I l@ve RuBoard Previous Section Next Section

asort

void asort(array array, [int flag]) 

array

Array to be sorted

flag

Flag specifying how to compare element values (PHP 4.0.0+ only)

Sorts the given array in ascending order.

Returns:

Nothing

Description:

Sorts the elements of the array given by array in ascending order by element value while maintaining the key/value associations. This function differs from sort() in that it works with both associative and indexed arrays; the a in asort() stands for associative.

This function operates directly on the passed array.

After calling asort(), the internal array pointer is on the first element of array .

(PHP 4.0.0+ only) The way in which element values are compared can be modified by passing one of the following named constants as flag :

SORT_REGULAR

Compare element values according to PHP's normal comparison rules. This is the default if flag is not given.

SORT_NUMERIC

Compare element values according to their numeric values.

SORT_STRING

Compare element values according to their string values.

Version:

PHP 3, PHP 4

See also:

array_multisort() 
arsort() 
krsort() 
ksort() 
natsort() 
natcasesort() 
rsort() 
sort() 
uasort() 
uksort() 
usort() 

Example:

Sort an array in ascending order by value
echo "Unsorted:\n"; 
$my_array = array("x" => "d", "z" => "c", "y" => "b", "w" => "a"); 
while (list($key, $val) = each($my_array)) {
   echo "Key: $key Val: $val\n"; 
} 
$ret = asort($my_array); 
echo "--After sorting--\n"; 
echo "Sorted:\n"; 
while (list($key, $val) = each($my_array)) {
   echo "Key: $key -- Val: $val\n"; 
} 

Output: 
Unsorted: 
Key: x Val: d 
Key: z Val: c 
Key: y Val: b 
Key: w Val: a 
--After sorting--
Sorted: 
Key: w -- Val: a 
Key: y -- Val: b 
Key: z -- Val: c 
Key: x -- Val: d 
    I l@ve RuBoard Previous Section Next Section