Função PHP extrair()
Exemplo
Atribua os valores "Gato", "Cão" e "Cavalo" às variáveis $a, $b e $c:
<?php
$a = "Original";
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>
Definição e uso
A função extract() importa variáveis para a tabela de símbolos local de um array.
Esta função usa chaves de array como nomes de variáveis e valores como valores de variáveis. Para cada elemento ele criará uma variável na tabela de símbolos atual.
Esta função retorna o número de variáveis extraídas com sucesso.
Sintaxe
extract(array, extract_rules, prefix)
Valores de parâmetro
Parameter | Description |
---|---|
array | Required. Specifies the array to use |
extract_rules | Optional. The extract() function checks for invalid variable names and collisions with existing variable names. This parameter specifies how invalid and colliding names are treated. Possible values:
|
prefix | Optional. If EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID or EXTR_PREFIX_IF_EXISTS are used in the extract_rules parameter, a specified prefix is required.
This parameter specifies the prefix. The prefix is automatically separated from the array key by an underscore character. |
Detalhes técnicos
Valor de retorno: | Retorna o número de variáveis extraídas com sucesso |
---|---|
Versão do PHP: | 4+ |
Registro de alterações do PHP: | O valor extract_rules EXTR_REFS foi adicionado no PHP 4.3. Os valores extract_rules EXTR_IF_EXISTS e EXTR_PREFIX_IF_EXISTS foram adicionados no PHP 4.2. A partir do PHP 4.0.5, esta função agora retorna o número de variáveis extraídas. O valor extract_rules EXTR_PREFIX_INVALID 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
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";
?>
❮ Referência de array PHP