PHP.nl

extract

extract

Import variables into the current symbol table from an array

int **extract** array $array int $flags string $prefix

Import variables from an array into the current . symbol table

Checks each key to see whether it has a valid variable name. It also checks for collisions with existing variables in the symbol table.

Waarschuwing: > Do not use on untrusted data, like user input (e.g. , ). extract``$_GET``$_FILES

array An associative array. This function treats keys as variable names and values as variable values. For each key/value pair it will create a variable in the current symbol table, subject to and parameters. flags``prefix

   You must use an associative array; a numerically indexed array
   will not produce results unless you use  or
   .
  `EXTR_PREFIX_ALL``EXTR_PREFIX_INVALID`

flags The way invalid/numeric keys and collisions are treated is determined by the extraction . It can be one of the following values:

  `flags``EXTR_OVERWRITE`If there is a collision, overwrite the existing variable.

EXTR_SKIPIf there is a collision, don't overwrite the existing variable.

EXTR_PREFIX_SAMEIf there is a collision, prefix the variable name with . prefix

EXTR_PREFIX_ALL Prefix all variable names with . prefix

EXTR_PREFIX_INVALID Only prefix invalid/numeric variable names with . prefix

EXTR_IF_EXISTS Only overwrite the variable if it already exists in the current symbol table, otherwise do nothing. This is useful for defining a list of valid variables and then extracting only those variables you have defined out of , for example. $_REQUEST

EXTR_PREFIX_IF_EXISTSOnly create prefixed variable names if the non-prefixed version of the same variable exists in the current symbol table.

EXTR_REFS Extracts variables as references. This effectively means that the values of the imported variables are still referencing the values of the parameter. You can use this flag on its own or combine it with any other flag by OR'ing the . array``flags

   If  is not specified, it is
   assumed to be .
  `flags``EXTR_OVERWRITE`

prefix Note that is only required if is , , or . If the prefixed result is not a valid variable name, it is not imported into the symbol table. Prefixes are automatically separated from the array key by an underscore character. prefix``flags``EXTR_PREFIX_SAME``EXTR_PREFIX_ALL``EXTR_PREFIX_INVALID``EXTR_PREFIX_IF_EXISTS

Returns the number of variables successfully imported into the symbol table.

Voorbeeld: example

<?php
$size = "large";
$var_array = array(
    "color" => "blue",
    "size"  => "medium",
    "shape" => "sphere"
);

extract($var_array, EXTR_PREFIX_SAME, "wddx");

echo "$color, $size, $shape, $wddx_size\n";

?>

blue, large, sphere, medium

 The  wasn't overwritten because we specified
 , which resulted in
  being created.  If  was
 specified, then  wouldn't even have been created.
  would have caused  to have
 value "medium", and  would result in new variables
 being named ,
 , and
 .
`$size``EXTR_PREFIX_SAME``$wddx_size``EXTR_SKIP``$wddx_size``EXTR_OVERWRITE``$size``EXTR_PREFIX_ALL``$wddx_color``$wddx_size``$wddx_shape`

Waarschuwing: > Do not use on untrusted data, like user input (i.e. , , etc.). If you do, make sure you use one of the non-overwriting values such as and be aware that you should extract in the same order that's defined in within the . extract``$_GET``$_FILES``flags``EXTR_SKIPvariables_orderphp.ini

compact``list

Vorige ← end Volgende in_array →

Documentatie