/**
* ArraySorter
*
* Copyright (c) 2011 Przemek Berezowski (przemek@otn.pl)
* All rights reserved.
* @category Library
* @package ArraySorter
* @copyright Copyright (c) 2011 Przemek Berezowski (przemek@otn.pl)
* @version 0.9
* @license New BSD License
*/
1. Description
ArraySorter class can be used to sort multidimensional arrays.
It takes multidimensional array or an array of objects and sorts it
by the given value.
The sorting entry name may include one more entry names, one per each dimension.
The sorting order may be configured also to be ascending or descending.
2. Preparing ArraySorter to do a job
First of all create the instance of ArraySorter.
Secondly set the array to sort using ArraySorter method setArray($array2Sort);
3. Sorting
In the class there is public method sort($field, $direction)
which can be used to sort given array.
- Sorting by given field
$field param is a string desribing field position in array.
Each dimension of array is separated by a dot "."
Suppose we have such an array
[0]['name'] = 'something';
[0]['vandor']['name'] = 'company';
[0]['vandor']['address']['street'] = 'abbay road';
[1]['name'] = 'something else';
[1]['vendor']['name'] = 'company';
[1]['vendor']['address']['street'] = 'abbay road';
- to sort by name set param $field to 'name'
- to sort by vendor name set param $field to 'vendor.name'
- to sort by vendor street set param $field to 'vendor.address.street'
The same naming convention are used to sort array of objects or mixed structures
where araay can contains objecs which contains array fields.
- Define sort order
To define sort order, there are two constants in ArraySorter
ArraySorter::DIRECTION_ASC - defining ascending sorting direction
ArraySorter::DIRECTION_DESC - defining descending sorting direction
These contants can be used as a second parametr for sort method.
4. Any bugs or question please report to przemek@otn.pl
|