Função list

A função list extrai elementos de um array em variáveis.

Sintaxe

phplist(mixed $var, mixed ...$vars): array

Exemplo

Vamos extrair os elementos do array em variáveis:

php<?php
  $arr = [1, 2, 3, 4, 5];
  list($a, $b, $c, $d, $e) = $arr;
?>

Como resultado, teremos a variável $a, a variável $b, a variável, a variável $c, a variável $d, a variável $e disponíveis:

php<?php
  echo $a; // exibirá 1
  echo $b; // exibirá 2
  echo $c; // exibirá 3
  echo $d; // exibirá 4
  echo $e; // exibirá 5
?>

Exemplo

Se precisar começar não pelo primeiro elemento do array - você pode usar uma vírgula:

php<?php
  $arr = [1, 2, 3, 4, 5];
  list(, $b, $c, $d, $e) = $arr;
?>

Como resultado, teremos a variável $b, a variável $c, a variável $d e a variável $e disponíveis:

php<?php
  echo $b; // exibirá 2
  echo $c; // exibirá 3
  echo $d; // exibirá 4
  echo $e; // exibirá 5
?>

Exemplo

Vamos gravar apenas o terceiro elemento do array em uma variável:

php<?php
  $arr = [1, 2, 3, 4, 5];
  list(, , $c) = $arr;
?>

Como resultado, teremos a variável $c disponível:

php<?php
  echo $c; // exibirá 3
?>

Veja também

  • a função extract,
    que divide um array em variáveis