Polyfills that call `array_keys()`, `array_values()` or `range()` are inefficient because they create new arrays unnecessarily.
Please use this polyfill instead which creates no new arrays and only does a single pass over the given array.
<?php
if (!function_exists("array_is_list")) {
function array_is_list(array $array): bool
{
$i = 0;
foreach ($array as $k => $v) {
if ($k !== $i++) {
return false;
}
}
return true;
}
}
?>
array_is_list
(PHP 8 >= 8.1.0)
array_is_list — 指定された配列がリストかどうかをチェックする
説明
指定された array がリストかどうかを判定します。
配列のキーが連続した数値 (0 から
count($array)-1) である場合、
リストと判定されます。
パラメータ
-
array -
評価する配列。
戻り値
配列がリストと判定された場合は true を返します。
そうでない場合は false を返します。
例
例1 array_is_list() example
<?php
array_is_list([]); // true
array_is_list(['apple', 2, 3]); // true
array_is_list([0 => 'apple', 'orange']); // true
// 配列が 0 から始まっていない場合
array_is_list([1 => 'apple', 'orange']); // false
// キーの順序が正しくない場合
array_is_list([1 => 'apple', 0 => 'orange']); // false
// キーが数値でない場合
array_is_list([0 => 'apple', 'foo' => 'bar']); // false
// 数値のキーが連続していない場合
array_is_list([0 => 'apple', 2 => 'bar']); // false
?>注意
注意:
この関数は、空の配列に対しても
trueを返します。
add a note
User Contributed Notes 5 notes
phpnet at jesseschalken dot com ¶
2 years ago
divinity76+spam at gmail dot com ¶
2 years ago
slightly optimized version of phpnet at jesseschalken dot com's excellent array_is_list:
<?php
if (!function_exists("array_is_list")) {
function array_is_list(array $array): bool
{
$i = -1;
foreach ($array as $k => $v) {
++$i;
if ($k !== $i) {
return false;
}
}
return true;
}
}
?>
benchmarks: https://3v4l.org/9BPqL
why is this faster you ask? because post-increment does more,
here is what pre-increment actually means:
step 1: increment the value by 1.
step 2: return the value.
here is what post-increment actually means:
step 1: create a copy of the original value.
step 2: increment the original value by 1.
step 3: return the copy.
another question might be "why didn't you write `if ($k !== ++$i) {` ? ... that is a good question! turns out that ++$i;if($k!==$i){...} is faster on PHP7 than if($k !== ++$i){...} for reasons unknown to me.. (if you have an answer, feel free to email me about it!)
(i have NOT checked if PHP8/jit auto-optimize this stuff, but at least back in PHP7 it's true that pre-increment is faster than post-increment, and this polyfill is primarily for PHP7)
Matteo Galletti ¶
2 years ago
Polyfill implementation for PHP versions lower than 8.1.
<?php
if (!function_exists('array_is_list'))
{
function array_is_list(array $a)
{
return $a === [] || (array_keys($a) === range(0, count($a) - 1));
}
}
?>
info at ensostudio dot ru ¶
2 years ago
old school polyfill (:
<?php
if (!function_exists('array_is_list')) {
function array_is_list(array $array)
{
if ($array === []) {
return true;
}
$keys = array_keys($array);
return $keys === array_keys($keys);
}
}
?>
