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() - Підраховує кількість входжень кожного окремого значення у масиві