array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.array-pad.php', 1 => 'array_pad', ), 'up' => array ( 0 => 'ref.array.php', 1 => '配列 関数', ), 'prev' => array ( 0 => 'function.array-multisort.php', 1 => 'array_multisort', ), 'next' => array ( 0 => 'function.array-pop.php', 1 => 'array_pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/array/functions/array-pad.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — 指定長、指定した値で配列を埋める
array_pad() は、length
で指定した長さになるように値 value
で埋めて
array
のコピーを返します。
length
が正の場合、配列の右側が埋められます。
負の場合、配列の左側が埋められます。
length
の絶対値が
array
の長さ以下の場合、埋める処理は行われません。
array
値を埋めるもととなる配列。
length
新しい配列のサイズ。
value
array
が
length
より小さいときに、
埋めるために使用する値。
length
で指定した長さになるように値 value
で埋めて
array
のコピーを返します。
length
が正の場合、配列の右側が埋められます。
負の場合、配列の左側が埋められます。
length
の絶対値が
array
の長さ以下の場合、埋める処理は行われません。
バージョン | 説明 |
---|---|
8.3.0 | PHP 8.3 より前のバージョンでは、 一度に 1048576 個の要素しか追加できませんでした。 このバージョンからは、制限は配列の最大サイズのみになりました。 |
例1 array_pad() の例
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// 結果は、array(12, 10, 9, 0, 0) です。
$result = array_pad($input, -7, -1);
// 結果は、array(-1, -1, -1, -1, 12, 10, 9) です。
$result = array_pad($input, 2, "noop");
// 埋める処理は行われません。
?>