ფუნქცია array_multisort

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

სინტაქსი

phparray_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<?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);
?>

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

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

მაგალითი

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

php<?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);
?>

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

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

მაგალითი

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

php<?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);
?>

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

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

მაგალითი

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

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

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

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

მაგალითი

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

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

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

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

ასევე იხილეთ

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