PHP 8.1.31 Released!

配列 関数

参考

is_array(), explode(), implode(), preg_split(), および join() も参照ください。

目次

  • array — 配列を生成する
  • array_all — array のすべての要素がコールバック関数を満たすかどうかを調べる
  • array_any — array のいずれかの要素がコールバック関数を満たすかどうかを調べる
  • array_change_key_case — 配列のすべてのキーの大文字小文字を変更する
  • array_chunk — 配列を分割する
  • array_column — 入力配列から単一のカラムの値を返す
  • array_combine — 一方の配列をキーとして、もう一方の配列を値として、ひとつの配列を生成する
  • array_count_values — 配列内に存在する、異なる値の出現回数を数える
  • array_diff — 配列の差を計算する
  • array_diff_assoc — 追加された添字の確認を含めて配列の差を計算する
  • array_diff_key — キーを基準にして配列の差を計算する
  • array_diff_uassoc — ユーザーが指定したコールバック関数を利用し、 追加された添字の確認を含めて配列の差を計算する
  • array_diff_ukey — キーを基準にし、コールバック関数を用いて配列の差を計算する
  • array_fill — 配列を指定した値で埋める
  • array_fill_keys — キーを指定して、配列を値で埋める
  • array_filter — コールバック関数を使用して、配列の要素をフィルタリングする
  • array_find — コールバック関数を満たす最初の要素を返す
  • array_find_key — コールバック関数を満たす最初の要素のキーを返す
  • array_flip — 配列のキーと値を反転する
  • array_intersect — 配列の共通項を計算する
  • array_intersect_assoc — 追加された添字の確認も含めて配列の共通項を確認する
  • array_intersect_key — キーを基準にして配列の共通項を計算する
  • array_intersect_uassoc — 追加された添字の確認も含め、コールバック関数を用いて 配列の共通項を確認する
  • array_intersect_ukey — キーを基準にし、コールバック関数を用いて 配列の共通項を計算する
  • array_is_list — 指定された配列がリストかどうかをチェックする
  • array_key_exists — 指定したキーまたは添字が配列にあるかどうかを調べる
  • array_key_first — 配列の最初のキーを得る
  • array_key_last — 配列の最後のキーを得る
  • array_keys — 配列のキーすべて、あるいはその一部を返す
  • array_map — 指定した配列の要素にコールバック関数を適用する
  • array_merge — ひとつまたは複数の配列をマージする
  • array_merge_recursive — 一つ以上の配列を再帰的にマージする
  • array_multisort — 複数または多次元の配列をソートする
  • array_pad — 指定長、指定した値で配列を埋める
  • array_pop — 配列の末尾から要素を取り除く
  • array_product — 配列の値の積を計算する
  • array_push — 一つ以上の要素を配列の最後に追加する
  • array_rand — 配列から一つ以上のキーをランダムに取得する
  • array_reduce — コールバック関数を繰り返し配列に適用し、配列をひとつの値にまとめる
  • array_replace — 渡された配列の要素を置き換える
  • array_replace_recursive — 渡された配列の要素を再帰的に置き換える
  • array_reverse — 要素を逆順にした配列を返す
  • array_search — 指定した値を配列で検索し、見つかった場合に対応する最初のキーを返す
  • array_shift — 配列の先頭から要素を一つ取り出す
  • array_slice — 配列の一部を展開する
  • array_splice — 配列の一部を削除し、他の要素で置換する
  • array_sum — 配列の中の値の合計を計算する
  • array_udiff — データの比較にコールバック関数を用い、配列の差を計算する
  • array_udiff_assoc — データの比較にコールバック関数を用い、 追加された添字の確認を含めて配列の差を計算する
  • array_udiff_uassoc — データと添字の比較にコールバック関数を用い、 追加された添字の確認を含めて配列の差を計算する
  • array_uintersect — データの比較にコールバック関数を用い、配列の共通項を計算する
  • array_uintersect_assoc — データの比較にコールバック関数を用い、 追加された添字の確認も含めて配列の共通項を計算する
  • array_uintersect_uassoc — データと添字の比較に個別のコールバック関数を用い、 追加された添字の確認も含めて配列の共通項を計算する
  • 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 — 大文字小文字を区別しない"自然順"アルゴリズムを用いて配列をソートする
  • natsort — "自然順"アルゴリズムで配列をソートする
  • next — 配列の内部ポインタを進める
  • pos — current のエイリアス
  • prev — 内部の配列ポインタをひとつ前に戻す
  • range — ある範囲の要素を含む配列を作成する
  • reset — 配列の内部ポインタを先頭の要素にセットする
  • rsort — 配列を降順にソートする
  • shuffle — 配列をシャッフルする
  • sizeof — count のエイリアス
  • sort — 配列を昇順にソートする
  • uasort — ユーザー定義の比較関数で配列をソートし、連想インデックスを保持する
  • uksort — ユーザー定義の比較関数を用いて、キーで配列をソートする
  • usort — ユーザー定義の比較関数を使用して、配列を値でソートする
add a note

User Contributed Notes 4 notes

up
10
et2225zas14 at susu dot ru
6 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