array_is_list

(PHP 8 >= 8.1.0)

array_is_listPrüft, ob das angegebene Array eine Liste ist

Beschreibung

array_is_list(array $array): bool

Überprüft, ob das angegebene array eine Liste ist. Ein Array wird als Liste betrachtet, wenn seine Schlüssel aus aufeinanderfolgenden Zahlen von 0 bis count($array)-1 besteht.

Parameter-Liste

array

Das auszuwertende Array.

Rückgabewerte

Gibt true zurück, wenn array eine Liste ist, andernfalls false.

Beispiele

Beispiel #1 array_is_list()-Beispiel

<?php

array_is_list
([]); // true
array_is_list(['apple', 2, 3]); // true
array_is_list([0 => 'apple', 'orange']); // true

// Das Array beginnt nicht bei 0
array_is_list([1 => 'apple', 'orange']); // false

// Die Schlüssel sind nicht in der richtigen Reihenfolge
array_is_list([1 => 'apple', 0 => 'orange']); // false

// Die Schlüssel sind nicht ganzzahlig
array_is_list([0 => 'apple', 'foo' => 'bar']); // false

// Die Schlüssel sind nicht fortlaufend
array_is_list([0 => 'apple', 2 => 'bar']); // false
?>

Anmerkungen

Hinweis:

Diese Funktion gibt bei leeren Arrays true zurück.

Siehe auch

add a note

User Contributed Notes 6 notes

up
53
phpnet at jesseschalken dot com
3 years 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.<?phpif (!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
22
divinity76+spam at gmail dot com
3 years ago
slightly optimized version of phpnet at jesseschalken dot com's excellent array_is_list:<?phpif (!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/9BPqLwhy 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
15
Matteo Galletti
3 years ago
Polyfill implementation for PHP versions lower than 8.1.<?phpif (!function_exists('array_is_list')){    function array_is_list(array $a)    {        return $a === [] || (array_keys($a) === range(0, count($a) - 1));    }}?>
up
-1
2317216477 at qq dot com
9 months ago
function isIndexed($array){    if (is_array($array)) {        $keys = array_keys($array);        return $keys === array_keys($keys);    }    return false;}function isAssoc($array){    if (is_array($array)) {        $keys = array_keys($array);        return $keys !== array_keys($keys);    }    return false;}these two function is more faster than divinity76+spam at gmail dot com's about three times in my computer for PHP 8.2.9:array(3) {  ["pre"]=>  float(0.8179779052734375)  ["post"]=>  float(0.8116860389709473)  ["index"]=>  float(0.3369460105895996)}:)
up
1
info at ensostudio dot ru
3 years ago
old school polyfill (:<?phpif (!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
0
maruerru
1 year ago
I think, this is the fastest polyfill:<?phpif (!function_exists('array_is_list')) {    function array_is_list(array $array)    {        return $array === array_values($array);    }}?>
To Top