array_unique

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

array_unique — Прибирає значення, що повторюються, з масиву

Опис

array_unique(array $array, int $flags = SORT_STRING): array

Приймає вхідний масив array і повертає новий масив без значень, що повторюються.

Зверніть увагу, що ключі зберігатимуться. Якщо відповідно до заданих flags кілька елементів визначаються як ідентичні, то буде збережено ключ і значення першого такого елемента.

Зауваження: Два елементи вважаються однаковими в тому і тільки в тому випадку, якщо (string) $elem1 === (string) $elem2. Інакше кажучи: якщо вони однакове рядкове уявлення, буде використано перший елемент.

Список параметрів

array

Вхідний масив

flags

Можна використовувати необов'язковий другий параметр flagsдля изменения поведения сравнения с помощью следующих значений:

Прапори видів порівняння:

  • **SORT_REGULAR**- нормальне порівняння елементів (типи не змінюються)
  • **SORT_NUMERIC**- елементи порівнюються як числа
  • **SORT_STRING**- елементи порівнюються як рядки
  • **SORT_LOCALE_STRING**- Порівнює елементи як рядки, з урахуванням поточної локалі.

Значення, що повертаються

Повертає відфільтрований масив.

список змін

ВерсияОпис
7.2.0Якщо flagsравен**SORT_STRING**, ранее массивarray копіювався, а не унікальні елементи видалялися (зберігаючи значення цифрових індексів), але тепер створюється новий масив шляхом додавання унікальних елементів. Це може призвести до різних числових індексів.

Приклади

Приклад #1 Приклад використання array_unique()****

Loading...

Результат виконання наведеного прикладу:

Array
(
    [a] => green
    [0] => red
    [1] => blue
)

Приклад #2array_unique()** та типи:**

Loading...

Результат виконання наведеного прикладу:

array(2) {
  [0] => int(4)
  [2] => string(1) "3"
}

Примітки

Зауваження: Обратите внимание, чтоarray_unique() не призначена для роботи з багатовимірними масивами.

Дивіться також

  • array_count_values() - Підраховує кількість входжень кожного окремого значення у масиві