Функции для работы с массивами
Смотрите также
См. также is_array(), explode(), implode(), split(), preg_split() и unset().
Содержание
- array_change_key_case — Меняет регистр ключей в массиве
- array_chunk — Разбивает массив на части
- array_column — Return the values from a single column in the input array
- array_combine — Создает новый массив, используя один массив в качестве ключей, а другой в качестве соответствующих значений
- array_count_values — Подсчитывает количество всех значений массива
- array_diff_assoc — Вычисляет расхождение массивов с дополнительной проверкой индекса
- array_diff_key — Вычисляет расхождение массивов, сравнивая ключи
- array_diff_uassoc — Вычисляет расхождение массивов с дополнительной проверкой индекса, осуществляемой при помощи callback-функции
- array_diff_ukey — Вычисляет расхождение массивов, используя callback-функцию для сравнения ключей
- array_diff — Вычислить расхождение массивов
- array_fill_keys — Создает массив и заполняет его значениями, с определенными ключами
- array_fill — Заполняет массив значениями
- array_filter — Фильтрует элементы массива с помощью callback-функции
- array_flip — Меняет местами ключи с их значениями в массиве
- array_intersect_assoc — Вычисляет схождение массивов с дополнительной проверкой индекса
- array_intersect_key — Вычислить пересечение массивов, сравнивая ключи
- array_intersect_uassoc — Вычисляет схождение массивов с дополнительной проверкой индекса, осуществляемой при помощи callback-функции
- array_intersect_ukey — Вычисляет схождение массивов, используя callback-функцию для сравнения ключей
- array_intersect — Вычисляет схождение массивов
- array_key_exists — Проверяет, присутствует ли в массиве указанный ключ или индекс
- array_keys — Возвращает все или некоторое подмножество ключей массива
- array_map — Применяет callback-функцию ко всем элементам указанных массивов
- array_merge_recursive — Рекурсивное слияние двух или более массивов
- array_merge — Сливает один или большее количество массивов
- array_multisort — Сортирует несколько массивов или многомерные массивы
- array_pad — Дополнить размер массива определенным значением до заданной величины
- array_pop — Извлекает последний элемент массива
- array_product — Вычислить произведение значений массива
- array_push — Добавляет один или несколько элеметов в конец массива
- array_rand — Выбирает одно или несколько случайных значений из массива
- array_reduce — Итеративно уменьшает массив к единственному значению, используя callback-функцию
- array_replace_recursive — Рекурсивно заменяет элементы первого массива элементами переданных массивов
- array_replace — Замена элементов массива элементами других переданных массивов
- array_reverse — Возвращает массив с элементами в обратном порядке
- array_search — Осуществляет поиск данного значения в массиве и возвращает соответствующий ключ в случае удачи
- array_shift — Извлекает первый элемент массива
- array_slice — Выбирает срез массива
- array_splice — Удаляет часть массива и заменяет её чем-нибудь ещё
- array_sum — Вычисляет сумму значений массива
- array_udiff_assoc — Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
- array_udiff_uassoc — Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений и индексов callback-функцию
- array_udiff — Вычисляет расхождение массивов, используя для сравнения callback-функцию
- array_uintersect_assoc — Вычисляет пересечение массивов с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
- array_uintersect_uassoc — Вычисляет пересечение массивов с дополнительной проверкой индекса, используя для сравнения индексов и значений callback-функцию
- array_uintersect — Вычисляет пересечение массивов, используя для сравнения значений callback-функцию
- array_unique — Убирает повторяющиеся значения из массива
- array_unshift — Добавляет один или несколько элементов в начало массива
- array_values — Выбирает все значения массива
- array_walk_recursive — Рекурсивно применяет пользовательскую функцию к каждому элементу массива
- array_walk — Применяет пользовательскую функцию к каждому элементу массива
- array — Создает массив
- arsort — Сортирует массив в обратном порядке, сохраняя ключи
- asort — Сортирует массив, сохраняя ключи
- compact — Создает массив, содержащий названия переменных и их значения
- count — Подсчитывает количество элементов массива или что-то в объекте
- current — Возвращает текущий элемент массива
- each — Возвращает текущую пару ключ/значение из массива и смещает его указатель
- end — Устанавливает внутренний указатель массива на его последний элемент
- extract — Импортирует переменные из массива в текущую таблицу символов
- in_array — Проверяет, присутствует ли в массиве значение
- key_exists — Псевдоним array_key_exists
- key — Выбирает ключ из массива
- krsort — Сортирует массив по ключам в обратном порядке
- ksort — Сортирует массив по ключам
- list — Присваивает переменным из списка значения подобно массиву
- natcasesort — Сортирует массив, используя алгоритм "natural order" без учета регистра символов
- natsort — Сортирует массив, используя алгоритм "natural order"
- next — Передвигает внутренний указатель массива на одну позицию вперёд
- pos — Псевдоним current
- prev — Передвигает внутренний указатель массива на одну позицию назад
- range — Создает массив, содержащий диапазон элементов
- reset — Устанавливает внутренний указатель массива на его первый элемент
- rsort — Сортирует массив в обратном порядке
- shuffle — Перемешивает массив
- sizeof — Псевдоним count
- sort — Сортирует массив
- uasort — Сортирует массив, используя пользовательскую функцию для сравнения элементов с сохранением ключей
- uksort — Сортирует массив по ключам, используя пользовательскую функцию для сравнения ключей
- usort — Сортирует массив по значениям используя пользовательскую функцию для сравнения элементов
Коментарии
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!
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.
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 )
?>
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
?>