ფუნქცია array_multisort

ფუნქცია array_multisort საშუალებას აძლევს ერთდროულად დაალაგოს რამდენიმე მასივი ან შეასრულოს რთული დალაგება მრავალგანზომილებიანი მასივების ერთი ან რამდენიმე კრიტერიუმით.

სინტაქსი

array_multisort(
	array1, 
	[sorting_order = SORT_ASC], 
	[sorting_type = SORT_REGULAR], 
	array2, 
	array3, 
	...
);

პარამეტრი sorting_order

პარამეტრი sorting_order განსაზღვრავს დალაგების მიმართულებას. აქაა მისი მნიშვნელობები:

პარამეტრი	აღწერა
`SORT_ASC`	დალაგება ზრდადობით (ნაგულისხმევი მნიშვნელობა).
`SORT_DESC`	დალაგება კლებადობით.

პარამეტრი sorting_type

პარამეტრი sorting_type განსაზღვრავს ელემენტების შედარების ტიპს. აქაა მისი მნიშვნელობები:

პარამეტრი	აღწერა
`SORT_REGULAR`	ელემენტების ჩვეულებრივი შედარება (ნაგულისხმევად).
`SORT_NUMERIC`	ელემენტების რიცხვითი შედარება.
`SORT_STRING`	ელემენტების სტრიქონული შედარება.
`SORT_LOCALE_STRING`	სტრიქონული შედარება მიმდინარე ლოკალის გათვალისწინებით.
`SORT_NATURAL`	სტრიქონების ბუნებრივი დალაგება (როგორც Explorer-ში).
`SORT_FLAG_CASE`	აერთიანებს SORT_STRING-თან ან SORT_NATURAL-თან რეგისტრისგან დამოუკიდებელი დალაგებისთვის.

მაგალითი

ორი მასივის დალაგება პარამეტრების მითითებით:

<?php
	$numbers = [10, 2, 15, 4];
	$letters = ['b', 'a', 'd', 'c'];
	array_multisort(
		$numbers, SORT_DESC, SORT_NUMERIC,
		$letters, SORT_ASC, SORT_STRING
	);
	print_r($numbers);
	print_r($letters);
?>

კოდის შესრულების შედეგი:

[15, 10, 4, 2]
['d', 'b', 'c', 'a']

მაგალითი

მრავალგანზომილებიანი მასივის დალაგება მოცემული ველის მიხედვით:

<?php
	$data = [
		['name' => 'John', 'age' => 25],
		['name' => 'Alice', 'age' => 22],
		['name' => 'Bob', 'age' => 30]
	];
	
	$ages = array_column($data, 'age');
	array_multisort($ages, SORT_ASC, $data);
	print_r($data);
?>

კოდის შესრულების შედეგი:

[
	['name' => 'Alice', 'age' => 22],
	['name' => 'John', 'age' => 25],
	['name' => 'Bob', 'age' => 30]
]

მაგალითი

მრავალგანზომილებიანი მასივის დალაგება ორი მოცემული ველის მიხედვით:

<?php
	$data = [
		['name' => 'John', 'age' => 25],
		['name' => 'alice', 'age' => 22],
		['name' => 'Bob', 'age' => 30]
	];
	
	$names = array_column($data, 'name');
	$ages = array_column($data, 'age');
	array_multisort(
		$names, SORT_ASC, SORT_STRING | SORT_FLAG_CASE,
		$ages, SORT_DESC,
		$data
	);
	print_r($data);
?>

კოდის შესრულების შედეგი:

[
	['name' => 'alice', 'age' => 22],
	['name' => 'Bob', 'age' => 30],
	['name' => 'John', 'age' => 25]
]

მაგალითი

სტრიქონების ბუნებრივი დალაგება:

<?php
	$files = ['file1.txt', 'file10.txt', 'file2.txt'];
	array_multisort($files, SORT_ASC, SORT_NATURAL);
	print_r($files);
?>

კოდის შესრულების შედეგი:

['file1.txt', 'file2.txt', 'file10.txt']

მაგალითი

რეგისტრისგან დამოუკიდებელი დალაგება:

<?php
	$words = ['Apple', 'banana', 'cherry', 'apricot'];
	array_multisort($words, SORT_ASC, SORT_STRING | SORT_FLAG_CASE);
	print_r($words);
?>

კოდის შესრულების შედეგი:

['Apple', 'apricot', 'banana', 'cherry']

ასევე იხილეთ

ფუნქცია sort,
რომელიც ალაგებს ელემენტების ზრდადობით
ფუნქცია rsort,
რომელიც ალაგებს ელემენტების კლებადობით
ფუნქცია ksort,
რომელიც ალაგებს გასაღებების ზრდადობით
ფუნქცია krsort,
რომელიც ალაგებს გასაღებების კლებადობით
ფუნქცია asort,
რომელიც ალაგებს ელემენტების ზრდადობით გასაღებების შენარჩუნებით
ფუნქცია arsort,
რომელიც ალაგებს ელემენტების კლებადობით გასაღებების შენარჩუნებით
ფუნქცია natsort,
რომელიც ალაგებს ბუნებრივი წესით
ფუნქცია natcasesort,
რომელიც ალაგებს ბუნებრივი წესით რეგისტრის გათვალისწინების გარეშე
ფუნქცია usort,
რომელიც ალაგებს კოლბექის მიხედვით
ფუნქცია uksort,
რომელიც ალაგებს კოლბექის მიხედვით გასაღებებით
ფუნქცია uasort,
რომელიც ალაგებს კოლბექის მიხედვით გასაღებების შენარჩუნებით