PHP | función extraer()

La función extract() es una función incorporada en PHP. La función extract() hace una conversión de array a variable. Es decir, convierte claves de array en nombres de variables y valores de array en valores de variables. En otras palabras, podemos decir que la función extract() importa variables de una array a la tabla de símbolos .
Sintaxis : 

int extract($input_array, $extract_rule, $prefix)

Parámetros : La función extract() acepta tres parámetros, de los cuales uno es obligatorio y los otros dos son opcionales. Los tres parámetros se describen a continuación: 

1. $input_array : este parámetro es obligatorio. Esto especifica la array a usar.
2. $extract_rule : este parámetro es opcional. La función extract() comprueba nombres de variables no válidos y colisiones con nombres de variables existentes. Este parámetro especifica cómo se tratarán los nombres no válidos y en conflicto. Este parámetro puede tomar los siguientes valores: 
   • EXTR_OVERWRITE: Esta regla dice que si hay una colisión, sobrescriba la variable existente.
   • EXTR_SKIP: esta regla dice que si hay una colisión, no sobrescriba la variable existente.
   • EXTR_PREFIX_SAME: esta regla indica que si hay una colisión, anteponga el nombre de la variable de acuerdo con el parámetro $prefix.
   • EXTR_PREFIX_ALL: esta regla indica que se anteponen todos los nombres de variables de acuerdo con el parámetro $prefijo.
   • EXTR_PREFIX_INVALID: esta regla indica que solo se anteponen nombres de variables no válidos/numéricos según el parámetro $prefijo.
   • EXTR_IF_EXISTS: esta regla indica que se sobrescriba la variable solo si ya existe en la tabla de símbolos actual; de lo contrario, no haga nada.
   • EXTR_PREFIX_IF_EXISTS: esta regla indica que se creen nombres de variables con prefijo solo si la versión sin prefijo de la misma variable existe en la tabla de símbolos actual.
3. $prefijo : este parámetro es opcional. Este parámetro especifica el prefijo. El prefijo se separa automáticamente de la clave de array mediante un carácter de subrayado. Además, este parámetro solo se requiere cuando el parámetro $extract_rule se establece en EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID o EXTR_PREFIX_IF_EXISTS.

Valor de retorno : el valor de retorno de la función extract() es un número entero y representa la cantidad de variables extraídas o importadas con éxito de la array.
Ejemplos: 

Input : array("a" => "one", "b" => "two", "c" => "three")
Output :$a = "one" , $b = "two" , $c = "three"
Explanation: The keys in the input array will become the 
variable names and their values will be assigned to these
new variables.

Los siguientes programas ilustran el funcionamiento de extract() en PHP:
Ejemplo-1 : 

<?php
     
    // input array
    $state = array("AS"=>"ASSAM", "OR"=>"ORISSA", "KR"=>"KERELA");
     
    extract($state);
     
    // after using extract() function
    echo"\$AS is $AS\n\$KR is $KR\n\$OR is $OR";
     
?>

Producción:  

$AS is ASSAM
$KR is KERELA
$OR is ORISSA

Ejemplo-2 : 

<?php
     
    $AS="Original";
     
    $state = array("AS"=>"ASSAM", "OR"=>"ORISSA", "KR"=>"KERELA");
     
    // handling collisions with extract() function
    extract($state, EXTR_PREFIX_SAME, "dup");
     
    echo"\$AS is $AS\n\$KR is $KR\n\$OR if $OR \n\$dup_AS = $dup_AS";
     
?>

Producción:  

$AS is Original
$KR is KERELA
$OR is ORISSA 
$dup_AS = ASSAM

Referencia : 
http://php.net/manual/en/function.extract.php