array_multisort

Opis

bool array_multisort ( array tbl1 [, mixed arg [, mixed ... [, array ...]]])

array_multisort() mo¿e byæ u¿yta do sortowania kilku tablic na raz lub wielowymiarowej tablicy na podstawie jednego z wiêkszej liczby wymiarów. Zachowywane s± przypisania kluczy.

Tablice wej¶ciowe s± traktowane jak kolumy tabeli, które maj± byæ posortowane wierszami - odpowiada to funkcjonalno¶ci warunku SQL ORDER BY. Pierwsza tablica jest tablic± priorytetow± do sortowania. Wiersze (warto¶ci) w tej tablic± które s± takie sane sortowane s± wed³ug nastêpnej tablicy wej¶ciowej i tak dalej.

Struktura argumentów tej funkcji nie jest zwyczajna, ale jest ona elastyczna. Pierwszy argument musi byæ tablic±. Ka¿dy nastêpny argument musi byæ tablic± lub flag± oznaczaj±c± porz±dek sortowania - jeden z poni¿szych.

Flagi porz±dku sortowania:

• SORT_ASC - sortuj w porz±dku rosn±cym

• SORT_DESC - sortuj w porz±dku malej±cym

Flagi typu sortowania:

• SORT_REGULAR - porównuj elementy normalnie

• SORT_NUMERIC - porównuj elementy numerycznie

• SORT_STRING - porówuj elementy jak stringi

Nie mo¿na podaæ ¿adnych dwóch flag tego samego typu dla jednej tablicy. Flagi sortowania podane pod argumencie-tablicy dotycz± tylko tej tablicy - s± one zerowane do domy¶lnych warto¶æi SORT_ASC i SORT_REGULAR po ka¿dym argumencie tablicowym.

Zwraca TRUE w przypadku sukcesu, FALSE w przypadku pora¿ki.

Przyk³ad 1. Sortowanie wielu tablic $tbl1 = array ("10", 100, 100, "a"); $tbl2 = array (1, 3, "2", 1); array_multisort ($tbl1, $tbl2);

W tym przypadku, po sortowaniu, pierwsza tablica bêdzie zawieraæ 10, "a", 100, 100, a druga 1, 1, "2", 3. Elementy drugiej tablicy odpowiadaj±ce identycznym elementom pierwszej tablicy (100 i 100) tak¿e zosta³y posortowane.

Przyk³ad 2. Sortowanie wielowymiarowych tablic $tbl = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); array_multisort ($tbl[0], SORT_ASC, SORT_STRING, $tbl[1], SORT_NUMERIC, SORT_DESC);

W tym przyk³adzie, po sortowaniu, pierwsza tablica zawiera 10, 100, 100, "a" (zosta³a posortowana wed³ug warto¶ci tekstowych w porz±dku rosn±cym), a druga 1, 3, "2", 1 (sortowana jak liczby w porz±dku malej±cym).