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