English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Tutorial básico PHP

Tutorial avançado PHP

PHP & MySQL

Manual de referência PHP

Uso e exemplo da função PHP extract()

PHP Array Função Manual

A função extract() importa variáveis do array para o símbolo atual

Sintaxe

extract($array, $extract_type, $prefix)

Definição e uso

Esta função é usada para importar variáveis de um array para o símbolo atual. Ela aceita um array de arrays associativos, onde as chaves são nomeadas como nomes de variáveis e os valores como valores de variáveis. Para cada chave/Par, ele cria uma variável no símbolo atual, limitada pelos parâmetros extract_type e prefix.

Parâmetro

NúmeroParâmetros e descrições
1

array (obrigatório)

Especifica um array

2

extract_type (opcional)

A função extract() verifica nomes de variáveis inválidos e conflitos com nomes de variáveis existentes. Este parâmetro especifica como lidar com nomes inválidos e conflitos. Valores possíveis:

  • EXTR_OVERWRITE   -  Se houver conflito, cobre o valor existente.

  • EXTR_SKIP   - Se houver conflito, não cobre o valor existente.

  • EXTR_PREFIX_SAME -  Adiciona prefixo antes dos nomes de variáveis em conflito. Se houver conflito, adiciona o prefixo.

  • EXTR_PREFIX_ALL -   Adiciona prefixo a todos os nomes de variáveis.

  • EXTR_PREFIX_INVALID -  Adiciona prefixo antes de nomes de variáveis ilegais/não numéricos.

  • EXTR_IF_EXISTS -  Cobre os valores dos nomes de variáveis existentes apenas quando já existem nomes de variáveis com o mesmo nome na tabela de símbolos corrente. Outros não são tratados. Dê um exemplo, isso é muito útil: defina algumas variáveis válidas, então importe apenas essas variáveis definidas do $_REQUEST.

  • EXTR_PREFIX_IF_EXISTS - Cria nomes de variáveis com prefixo apenas quando já existem nomes de variáveis com o mesmo nome na tabela de símbolos corrente. Outros não são tratados.

  • EXTR_REFS  - Extrai variáveis como referência. Isso fornece uma indicação clara de que as variáveis importadas ainda referenciam o valor do parâmetro array. Pode ser usado sozinho ou combinado com outros sinais no flags usando OR.
    Se não for especificado flags, é assumido EXTR_OVERWRITE.

3

prefixo (opcional)

Se usar EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS no parâmetro extract_rules, é necessário especificar o prefixo.

Este parâmetro especifica o prefixo. O prefixo é separado automaticamente dos chaves do array por caracteres de sublinhado.

Retorno

Retorna o número de variáveis importadas com sucesso para a tabela de símbolos.

Exemplo online

 "azul", "tamanho" => "médio", "forma" => "esférico");
   extract(\$input, EXTR_PREFIX_SAME, "bbcx");
   echo "\$cor, \$tamanho, \$forma, \$bbcx_tamanho";
?>
Testar e ver‹/›

Resultado de saída:

azul, grande, esférico, médio

   PHP Array Função Manual