tutoriais mais recente desenvolvimento web
 

PHP extract() Function

<PHP matriz de referência

Exemplo

Atribuir os valores "Cat" , "Dog" e "Horse" para as variáveis $ a, $ b e US $ c:

<?php
$a = "Original";
$my_array = array("a" => "Cat" ,"b" => "Dog" , "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>
Exemplo executar »

Definição e Uso

O extract() função importa variáveis para a tabela de símbolos local de uma matriz.

Esta função usa chaves do array como nomes de variáveis ​​e valores como valores de variáveis. Para cada elemento que irá criar uma variável na tabela de símbolos corrente.

Esta função retorna o número de variáveis ​​extraídas em caso de sucesso.

Sintaxe

extract( array,extract_rules,prefix )

Parâmetro Descrição
array Requeridos. Especifica a matriz para usar
extract_rules Opcional. Os extract() função verifica para nomes de variáveis inválidas e colisões com nomes de variáveis existentes. Este parâmetro especifica como nomes inválidos e colidindo são tratados.

Valores possíveis:

  • EXTR_OVERWRITE - Padrão. Na colisão, a variável existente é sobrescrito
  • EXTR_SKIP - Na colisão, a variável existente não é substituído
  • EXTR_PREFIX_SAME - Na colisão, o nome da variável será dado um prefixo
  • EXTR_PREFIX_ALL - Todos os nomes de variáveis ​​será dado um prefixo
  • EXTR_PREFIX_INVALID - nomes de variáveis ​​Apenas inválidos ou numéricos será dado um prefixo
  • EXTR_IF_EXISTS - substituir Apenas variáveis ​​existentes na tabela de símbolos corrente, caso contrário não fazer nada
  • EXTR_PREFIX_IF_EXISTS - adicionar Só prefixo para as variáveis ​​se a mesma variável existe na tabela de símbolos corrente
  • EXTR_REFS - Extrai variáveis ​​como referências. As variáveis ​​importadas ainda estão fazendo referência os valores do parâmetro de matriz
prefix Opcional. Se EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS são utilizados no parâmetro extract_rules, um prefixo especificada é requerido.

Este parâmetro especifica o prefixo. O prefixo é automaticamente separado da chave de matriz por um caractere de sublinhado.

Detalhes técnicos

Valor de retorno: Retorna o número de variáveis ​​extraídas em caso de sucesso
PHP Versão: 4+
changelog: Os EXTR_REFS valor extract_rules foi adicionado em PHP 4.3.

Os valores extract_rules EXTR_IF_EXISTS e EXTR_PREFIX_IF_EXISTS foram adicionados em PHP 4.2.

A partir do PHP 4.0.5, esta função retorna agora o número de variáveis ​​extraídas.

O valor EXTR_PREFIX_INVALID extract_rules foi adicionado no PHP 4.0.5.

A partir do PHP 4.0.5, o valor extract_rules EXTR_PREFIX_ALL agora inclui variáveis numéricas também.

mais Exemplos

Exemplo 1

Usando todos os parâmetros:

<?php
$a = "Original";
$my_array = array("a" => "Cat" , "b" => "Dog" , "c" => "Horse");

extract($my_array, EXTR_PREFIX_SAME, "dup");

echo "\$a = $a; \$b = $b; \$c = $c; \$dup_a = $dup_a";
?>
Exemplo executar »
<PHP matriz de referência