PauloRB.dev

Desenvolvedor de Software

Entendendo a Função list() no PHP | PauloRB.dev Entendendo a Função list() no PHP – PauloRB.dev
Entendendo a Função list() no PHP

Entendendo a Função list() no PHP

A função list() do PHP é uma forma prática de atribuir múltiplos valores de um array a variáveis individuais. Neste artigo, vamos explorar como essa função funciona, seus usos mais comuns e alternativas modernas disponíveis no PHP.

O Que é a Função list()?

A função list() permite extrair valores de um array e atribuí-los a variáveis individuais de maneira simplificada.

Sintaxe Básica:

list($var1, $var2, $var3) = array(valor1, valor2, valor3);

Cada variável recebe o valor correspondente da posição do array.

Exemplo de Uso:

$dados = ["Maria", 30, "Desenvolvedora"];
list($nome, $idade, $profissao) = $dados;

echo "Nome: $nome, Idade: $idade, Profissão: $profissao";

Saída:

Nome: Maria, Idade: 30, Profissão: Desenvolvedora

Importante: list() Só Funciona com Arrays Indexados

A função list() não funciona com arrays associativos. Se você tentar usá-la com um array associativo, os valores não serão extraídos corretamente.

Exemplo que não funciona:

$dados = ["nome" => "Carlos", "idade" => 25];
list($nome, $idade) = $dados; // Erro: valores indefinidos

Ignorando Valores no list()

Se você quiser pular certos valores do array, pode omitir variáveis dentro de list().

$dados = ["Ana", "Feminino", 28];
list($nome, , $idade) = $dados;

echo "Nome: $nome, Idade: $idade";

Saída:

Uso Combinado com explode()

list() é muito útil ao trabalhar com strings separadas por delimitadores, como datas.

$data = "2025-03-11";
list($ano, $mes, $dia) = explode("-", $data);

echo "Ano: $ano, Mês: $mes, Dia: $dia";

Saída:

Ano: 2025, Mês: 03, Dia: 11

Alternativa Moderna: Desestruturação com []

Desde o PHP 7.1, podemos usar [] para desestruturar arrays, substituindo list().

$valores = [10, 20, 30];
[$a, $b, $c] = $valores;

echo "A: $a, B: $b, C: $c";

Saída:

Essa sintaxe é mais intuitiva e moderna.

A função list() é útil para atribuir múltiplos valores de um array a variáveis de forma rápida. Entretanto, se estiver usando PHP 7.1 ou superior, prefira [] por ser uma alternativa mais moderna e legível.

Se gostou deste artigo, compartilhe com outros desenvolvedores e continue acompanhando mais dicas de PHP!

 

 

Mais Posts

Por que whereNull não funciona com updateOrCreate no Laravel (e como evitar bugs silenciosos)

Por que whereNull não funciona com updateOrCreate no Laravel (e como evitar bugs silenciosos)

O updateOrCreate() é um dos métodos mais utilizados no Eloquent para garantir que registros sejam atualizados ou criados sem duplicações.... Leia mais

Como Unir Múltiplos Arquivos PDF em um Único Documento Usando Python

Como Unir Múltiplos Arquivos PDF em um Único Documento Usando Python

No dia a dia, muitas vezes nos deparamos com a necessidade de unir vários arquivos PDF em um único documento.... Leia mais

Como atualizar multiplos registros com o método whereIn no Laravel 9 ?

Como atualizar multiplos registros com o método whereIn no Laravel 9 ?

O Laravel 9 é um framework PHP moderno e poderoso que oferece muitas ferramentas úteis para desenvolvedores web. Uma das... Leia mais

Usando a Função ROW_NUMBER e Outras Funções para Gerar Resultados Sequenciais no PostgreSQL

Usando a Função ROW_NUMBER e Outras Funções para Gerar Resultados Sequenciais no PostgreSQL

Quando trabalhamos com bancos de dados, muitas vezes precisamos gerar números sequenciais para nossos resultados. Isso pode ser útil para... Leia mais