PHP 8.4.2 Released!

Функции для работы с массивами

Смотрите также

Смотрите также описание функций is_array(), explode(), implode(), preg_split() и unset().

Содержание

  • array — Создаёт массив
  • array_all — Проверяет, каждый ли элемент массива array удовлетворяет callback-функции
  • array_any — Проверяет, содержит ли массив array хотя бы один элемент, который удовлетворяет callback-функции
  • array_change_key_case — Изменяет регистр ключей в массиве
  • array_chunk — Разбивает массив на части
  • array_column — Возвращает массив из значений одного столбца входного массива
  • array_combine — Создаёт новый массив, используя один массив в качестве ключей, а другой для его значений
  • array_count_values — Подсчитывает количество вхождений каждого отдельного значения в массиве
  • array_diff — Вычисляет расхождение массивов
  • array_diff_assoc — Вычисляет расхождение массивов с дополнительной проверкой индекса
  • array_diff_key — Вычисляет расхождение массивов, сравнивая ключи
  • array_diff_uassoc — Вычисляет расхождение массивов с дополнительной проверкой индекса через пользовательскую callback-функцию
  • array_diff_ukey — Вычисляет расхождение массивов, используя callback-функцию для сравнения ключей
  • array_fill — Заполняет массив значениями
  • array_fill_keys — Создаёт массив и заполняет его значениями с определёнными ключами
  • array_filter — Фильтрует элементы массива через callback-функцию
  • array_find — Возвращает первый элемент, который удовлетворяет callback-функции
  • array_find_key — Возвращает ключ первого элемента, который удовлетворяет callback-функции
  • array_flip — Меняет местами ключи с их значениями в массиве
  • array_intersect — Вычисляет пересечение массивов
  • array_intersect_assoc — Вычисляет пересечение массивов с дополнительной проверкой индекса
  • array_intersect_key — Вычисляет пересечение массивов, сравнивая ключи
  • array_intersect_uassoc — Вычисляет пересечение массивов с дополнительной проверкой индекса, сравнивая индексы через callback-функцию
  • array_intersect_ukey — Вычисляет пересечение массивов, используя callback-функцию для сравнения ключей
  • array_is_list — Проверяет, является ли данный array списком
  • array_key_exists — Проверяет, существует ли в массиве заданный ключ или индекс
  • array_key_first — Получает первый ключ массива
  • array_key_last — Получает последний ключ массива
  • array_keys — Возвращает все или некоторое подмножество ключей массива
  • array_map — Применяет callback-функцию к элементам массивов
  • array_merge — Сливает один или несколько массивов
  • array_merge_recursive — Рекурсивно сливает один или несколько массивов
  • array_multisort — Сортирует несколько массивов или многомерные массивы
  • array_pad — Дополняет массив значением до заданной длины
  • array_pop — Извлекает последний элемент массива
  • array_product — Вычисляет произведение значений массива
  • array_push — Добавляет один или несколько элементов в конец массива
  • array_rand — Выбирает один или несколько случайных ключей из массива
  • array_reduce — Итеративно уменьшает массив к единственному значению через callback-функцию
  • array_replace — Заменяет элементы массива элементами других массивов
  • array_replace_recursive — Рекурсивно заменяет элементы первого массива элементами переданных массивов
  • array_reverse — Возвращает массив с элементами в обратном порядке
  • array_search — Ищет значение в массиве, и если находит, возвращает ключ первого найденного элемента
  • array_shift — Извлекает первый элемент массива
  • array_slice — Выбирает срез массива
  • array_splice — Удаляет часть массива и заменяет её новыми элементами
  • array_sum — Вычисляет сумму значений массива
  • array_udiff — Вычисляет расхождение массивов, используя для сравнения callback-функцию
  • array_udiff_assoc — Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
  • array_udiff_uassoc — Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений и индексов callback-функцию
  • array_uintersect — Вычисляет пересечение массивов, используя для сравнения значений callback-функцию
  • array_uintersect_assoc — Вычисляет пересечение массивов с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
  • array_uintersect_uassoc — Вычисляет пересечение массивов с дополнительной проверкой индекса, используя для сравнения индексов и значений отдельные callback-функции
  • array_unique — Убирает повторяющиеся значения из массива
  • array_unshift — Добавляет один или несколько элементов в начало массива
  • array_values — Возвращает все значения массива
  • array_walk — Применяет пользовательскую функцию к каждому элементу массива
  • array_walk_recursive — Рекурсивно применяет пользовательскую функцию к каждому элементу массива
  • arsort — Сортирует массив в порядке убывания, сохраняя ассоциацию индексов
  • asort — Сортирует массив в порядке возрастания, сохраняя ассоциацию индексов
  • compact — Создаёт массив, содержащий названия переменных и их значения
  • count — Подсчитывает количество элементов в массиве или в объекте Countable
  • current — Возвращает текущий элемент массива
  • each — Возвращает текущую пару ключа и значения массива и сдвигает указатель на одну позицию вперёд
  • end — Устанавливает внутренний указатель массива на последний элемент
  • extract — Импортирует переменные массива в текущую таблицу символов
  • in_array — Проверяет, существует ли значение в массиве
  • key — Получает ключ массива
  • key_exists — Псевдоним array_key_exists
  • krsort — Сортирует массив по ключу в порядке убывания
  • ksort — Сортирует массив по ключу в порядке возрастания
  • list — Присваивает переменным значения как массиву
  • natcasesort — Сортирует массив алгоритмом естественной сортировки (natural order) без учёта регистра символов
  • natsort — Сортирует массив, для чего использует алгоритм «естественной сортировки»
  • next — Сдвигает внутренний указатель массива на одну позицию вперёд
  • pos — Псевдоним current
  • prev — Сдвигает внутренний указатель массива на одну позицию назад
  • range — Создаёт массив, который содержит диапазон элементов
  • reset — Устанавливает внутренний указатель массива на первый элемент
  • rsort — Сортирует массив в порядке убывания
  • shuffle — Перемешивает массив
  • sizeof — Псевдоним count
  • sort — Сортирует массив по возрастанию
  • uasort — Сортирует массив пользовательской функцией сравнения, сохраняя ассоциацию индексов
  • uksort — Сортирует массив по ключам пользовательской функцией сравнения
  • usort — Сортирует массив по значениям используя пользовательскую функцию для сравнения элементов
Добавить

Примечания пользователей 4 notes

up
10
et2225zas14 at susu dot ru
7 months ago
Be careful with type hints in callbacks when using array-traverse functions. In some cases, this may silently cause the data type of elements to change.

<?php
declare(strict_types=1);

// Missing fatal TypeError, No side effects
$unexpected = array_filter(['123', (string) PHP_INT_MAX], fn (int $item) => true);
var_dump($unexpected);

// Missing fatal TypeError, Typecasting side effect
$unexpectedTypecasting = array_map(fn (int $item) => $item, ['123', (string) PHP_INT_MAX]);
var_dump($unexpectedTypecasting);

// Missing fatal TypeError, Typecasting side effect
$unexpectedTypecasting = array_map(fn (string $item) => $item, [123, PHP_INT_MAX]);
var_dump($unexpectedTypecasting);

// Missing fatal TypeError, Typecasting side effect
$unexpectedTypecasting = array_reduce(['123', (string) PHP_INT_MAX], fn (?int $carry, int $item) => $item);
var_dump($unexpectedTypecasting);

$bigIntValue = bcadd((string) PHP_INT_MAX, '1');
// Fatal TypeError
$expectedTypeError = array_map(fn (int $item) => $item, [$bigIntValue]);
var_dump($expectedTypeError);
?>

The above example will output (PHP version 8.3.6, error_reporting E_ALL):

<?php
array(2) {
[
0]=>
string(3) "123"
[1]=>
string(19) "9223372036854775807"
}
array(
2) {
[
0]=>
int(123)
[
1]=>
int(9223372036854775807)
}
array(
2) {
[
0]=>
string(3) "123"
[1]=>
string(19) "9223372036854775807"
}
int(9223372036854775807)

Fatal error: Uncaught TypeError: {closure}(): Argument #1 ($item) must be of type int, string given
?>
up
21
permanovd at gmail dot com
6 years ago
A simple trick that can help you to guess what diff/intersect or sort function does by name.

[suffix] assoc - additional index check. Compares both value and index.

Example: array_diff_assoc, array_intersect_assoc.

[suffix] key - index only check. Ignores value of array, compares only indexes.

Example: array_diff_key, array_intersect_key.

[suffix] **empty** - no "key" or "assoc" word in suffix. Compares values only. Ignores indexes of array.

Example: array_diff, array_intersect.

[prefix] u - will do comparison with user defined function. Letter u can be used twice in some functions (like array_udiff_uassoc), this means that you have to use 2 functions (one for value, one for index).

Example: array_udiff_uassoc, array_uintersect_assoc.

This also works with array sort functions:

[prefix] a - associative. Will preserve keys.

Example: arsort, asort.

[prefix] k - key sort. Will sort array by keys.

Example: uksort, ksort.

[prefix] r - reverse. Will sort array in reverse order.

Example: rsort, krsort.

[prefix] u - sort by user defined function (same as for diff/intersect).

Example: usort, uasort.
up
5
renatonascto at gmail dot com
16 years ago
Big arrays use a lot of memory possibly resulting in memory limit errors. You can reduce memory usage on your script by destroying them as soon as you´re done with them. I was able to get over a few megabytes of memory by simply destroying some variables I didn´t use anymore.
You can view the memory usage/gain by using the funcion memory_get_usage(). Hope this helps!
up
-1
indioeuropeo at driverop dot com
5 years ago
I need to take an element from the Array and change its position within the Array by moving the rest of the elements as required.
This is the function that does it. The first parameter is the working Array. The second is the position of the element to move and the third is the position where to move the element.
The function returns the modified Array.
<?php
function array_move_elem($array, $from, $to) {
if (
$from == $to) { return $array; }
$c = count($array);
if ((
$c > $from) and ($c > $to)) {
if (
$from < $to) {
$f = $array[$from];
for (
$i = $from; $i < $to; $i++) {
$array[$i] = $array[$i+1];
}
$array[$to] = $f;
} else {
$f = $array[$from];
for (
$i = $from; $i > $to; $i--) {
$array[$i] = $array[$i-1];
}
$array[$to] = $f;
}

}
return
$array;
}

?>
Examples:
<?php
$array
= array('Cero','Uno','Dos','Tres','Cuatro','Cinco','Seis','Siete','Ocho','Nueve','Diez');
$array = array_move_elem($array, 3, 5); // Move element in position 3 to position 5...
print_r($array);

$array = array_move_elem($array, 5, 3); // Move element in position 5 to position 3, leaving array as it was... ;)
print_r($array);

?>
Return:
<?php
Array ( [0] => Cero [1] => Uno [2] => Dos [3] => Cuatro [4] => Cinco [5] => Tres [6] => Seis [7] => Siete [8] => Ocho [9] => Nueve [10] => Diez )
Array ( [
0] => Cero [1] => Uno [2] => Dos [3] => Tres [4] => Cuatro [5] => Cinco [6] => Seis [7] => Siete [8] => Ocho [9] => Nueve [10] => Diez )
?>
To Top