PHP 8.0.26 Released!

array_is_list

(PHP 8 >= 8.1.0)

array_is_list指定された配列がリストかどうかをチェックする

説明

array_is_list(array $array): bool

指定された array がリストかどうかを判定します。 配列のキーが連続した数値 (0 から count($array)-1) である場合、 リストと判定されます。

パラメータ

array

評価する配列。

戻り値

配列がリストと判定された場合は true を返します。 そうでない場合は false を返します。

例1 array_is_list() example

<?php

array_is_list
([]); // true
array_is_list(['apple'23]); // true
array_is_list([=> 'apple''orange']); // true

// 配列が 0 から始まっていない場合
array_is_list([=> 'apple''orange']); // false

// キーの順序が正しくない場合
array_is_list([=> 'apple'=> 'orange']); // false

// キーが数値でない場合
array_is_list([=> 'apple''foo' => 'bar']); // false

// 数値のキーが連続していない場合
array_is_list([=> 'apple'=> 'bar']); // false
?>

注意

注意:

この関数は、空の配列に対しても true を返します。

参考

add a note

User Contributed Notes 5 notes

up
30
phpnet at jesseschalken dot com
10 months ago
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;
    }
}

?>
up
10
divinity76+spam at gmail dot com
6 months 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)
up
16
Matteo Galletti
1 year 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));
    }
}
?>
up
0
info at ensostudio dot ru
1 year 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);
    }
}
?>
up
-7
iradu at unix-world dot org
9 months ago
// How about:

<?php

if(count(array_filter(array_keys($y_arr), 'is_string')) === 0) {
    echo
'non-associative ; is list';
} else {
    echo
'associative ; non list'
}
To Top