array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — 用给定的值填充数组
说明
用 value
参数的值填充 count
个元素到数组,
开始键名由 start_index
参数指定。
参数
start_index
-
返回的数组的第一个索引值。
如果
start_index
是负数,在 PHP 8.0.0 之前,返回的数组的第一个索引是start_index
, 而后面索引则从 0 开始;自 PHP 8.0.0 起, 负数键将会正常递增。(参见 例子) count
-
要插入元素的数量。必须大于或等于 0 且小于或等于
2147483647
。 value
-
用来填充的值。
返回值
返回填充后的数组。
错误/异常
如果 count
超出范围,将会抛出 ValueError。
更新日志
版本 | 说明 |
---|---|
8.0.0 |
如果 array_fill() 的 count
超出范围现在将会抛出 ValueError,
之前会引发 E_WARNING 且函数返回 false 。
|
示例
示例 #1 array_fill() 例子
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
以上示例会输出:
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )
示例 #2 开始索引为负数的 array_fill() 示例
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>
以上示例在 PHP 7 中的输出:
Array ( [-2] => pear [0] => pear [1] => pear [2] => pear )
以上示例在 PHP 8 中的输出:
Array ( [-2] => pear [-1] => pear [0] => pear [1] => pear )
注意 索引 -1
在 PHP 8.0.0 之前不存在。
注释
参见手册上数组一节里关于负数的键的详细解释。
+添加备注
用户贡献的备注 6 notes
csst0266 at cs dot uoi dot gr ¶
20 years ago
This is what I recently did to quickly create a two dimensional array (10x10), initialized to 0:
<?php
$a = array_fill(0, 10, array_fill(0, 10, 0));
?>
This should work for as many dimensions as you want, each time passing to array_fill() (as the 3rd argument) another array_fill() function.
anatoliy at ukhvanovy dot name ¶
10 years ago
If you need negative indices:
<?php
$b = array_fill(-2, 4, 'pear');//this is not what we want
$c = array_fill_keys(range(-2,1),'pear');//these are negative indices
print_r($b);
print_r($c);
?>
Here is result of the code above:
Array
(
[-2] => pear
[0] => pear
[1] => pear
[2] => pear
)
Array
(
[-2] => pear
[-1] => pear
[0] => pear
[1] => pear
)
mchljnk at NOSPAM dot gmail dot com ¶
11 years ago
Using objects with array_fill may cause unexpected results. Consider the following:
<?php
class Foo {
public $bar = "banana";
}
//fill an array with objects
$array = array_fill(0, 2, new Foo());
var_dump($array);
/*
array(2) {
[0]=>
object(Foo)#1 (1) {
["bar"]=>
string(6) "banana"
}
[1]=>
object(Foo)#1 (1) {
["bar"]=>
string(6) "banana"
}
} */
//now we change the attribute of the object stored in index 0
//this actually changes the attribute for EACH object in the ENTIRE array
$array[0]->bar = "apple";
var_dump($array);
/*
array(2) {
[0]=>
object(Foo)#1 (1) {
["bar"]=>
string(5) "apple"
}
[1]=>
object(Foo)#1 (1) {
["bar"]=>
string(5) "apple"
}
}
*/
?>
Objects are filled in the array BY REFERENCE. They are not copied for each element in the array.
user at NOSPAM dot example dot com ¶
3 years ago
As of PHP 8.0 the example code
<?php
$b = array_fill(-2, 4, 'pear');
print_r($b);
?>
now returns
Array
(
[-2] => pear
[-1] => pear
[0] => pear
[1] => pear
)
See https://wiki.php.net/rfc/negative_array_index and https://github.com/php/php-src/pull/3772
miguelxpain at gmail dot com ¶
13 years ago
I made this function named "array_getMax" that returns te maximum value and index, from array:
<?php
//using array_search_all by helenadeus at gmail dot com
function array_search_all($needle, $haystack)
{#array_search_match($needle, $haystack) returns all the keys of the values that match $needle in $haystack
foreach ($haystack as $k=>$v) {
if($haystack[$k]==$needle){
$array[] = $k;
}
}
return ($array);
}
function array_getMax($array){
$conteo=array_count_values($array);
if( count($conteo)==1 ){//returns full array when all values are the same.
return $array;
}
arsort($array);
//$antValue=null;
$maxValue=null;
$keyValue=null;
foreach($array as $key=>$value){
if($maxValue==null){
$maxValue=$value;
$keyValue=$key;
break;
}
}
$resultSearch=array_search_all($maxValue, $array);
return array_fill_keys($resultSearch, $maxValue);
}
//example
$arreglo=array('e1'=>99,'e2'=>'99','e3'=>1,'e4'=>1,'e5'=>98);
var_dump(array_getMax($arreglo));
//output
/*
array(2) {
["e1"]=>
int(99)
["e2"]=>
int(99)
}
*/
?>
I hope some one find this usefull
Hayley Watson ¶
7 years ago
Fill missing keys in a (numerically-indexed) array with a default value
<?php
function fill_missing_keys($array, $default = null, $atleast = 0)
{
return $array + array_fill(0, max($atleast, max(array_keys($array))), $default);
}
?>