PHP 8.4.0 RC2 available for testing

array_is_list

(PHP 8 >= 8.1.0)

array_is_listVerifica se um array é uma lista

Descrição

array_is_list(array $array): bool

Determina se o array fornecido é uma lista. Um array é considerado uma lista se suas keys consistem em números consecutivos de 0 a count($array)-1.

Parâmetros

array

O array que está sendo avaliado.

Valor Retornado

Retorna true se array for uma lista, false caso contrário.

Exemplos

Exemplo #1 array_is_list() example

<?php

array_is_list
([]); // true
array_is_list(['maçã', 2, 3]); // true
array_is_list([0 => 'maçã', 'laranja']); // true

// O array não começa em 0
array_is_list([1 => 'maçã', 'laranja']); // false

// As keys não estão na ordem correta
array_is_list([1 => 'maçã', 0 => 'laranja']); // false

// Keys não inteiras
array_is_list([0 => 'maçã', 'foo' => 'bar']); // false

// Keys não consecutivas
array_is_list([0 => 'maçã', 2 => 'bar']); // false
?>

Notas

Nota:

Esta função retorna true em arrays vazios.

Veja Também

add a note

User Contributed Notes 5 notes

up
46
phpnet at jesseschalken dot com
2 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.

<?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
23
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)
up
15
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));
}
}
?>
up
1
maruerru
1 year ago
I think, this is the fastest polyfill:

<?php

if (!function_exists('array_is_list')) {
function
array_is_list(array $array)
{
return
$array === array_values($array);
}
}

?>
up
2
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);
}
}
?>
To Top